Question 1

Linux에서 xtool로 Apple ID 로그인 시 발생하는 CERTIFICATE_VERIFY_FAILED 오류를 해결하는 방법

Accepted Answer

이 오류는 로그인 흐름에서 사용되는 `gsd.apple.com`이 **Apple Root CA - G3**에서 끝나는 인증서 체인을 제공하기 때문에 발생합니다. 이 루트 CA는 Ubuntu의 `ca-certificates` 번들에 포함되어 있지 않습니다(macOS는 시스템 키체인을 통해 신뢰하므로 이 문제는 Linux에서만 발생합니다). xtool의 `Client.tlsConfiguration`은 2006년 Apple Root CA만 `additionalTrustRoots`에 추가했습니다.

**수정 방법:** `Sources/XKit/HTTPClientProtocol/AsyncHTTPClient+HTTP.swift`에서 신뢰할 수 있는 루트에 Apple Root CA - G3를 추가합니다:

```swift
// gsd.apple.com chains to Apple Root CA - G3 (not the 2006 Apple Root CA).
// swiftlint:disable:next force_try
let appleRootG3CA = try! NIOSSLCertificate(bytes: Array(appleRootG3PEM.utf8), format: .pem)
tlsConfiguration.additionalTrustRoots = [.certificates([appleRootCA, appleRootG3CA])]
```

https://www.apple.com/certificateauthority/AppleRootCA-G3.cer에서 인증서를 다운로드하여 `private let appleRootG3PEM = """ ... """` 상수로 임베드합니다. SHA-256 지문을 확인합니다: `63:34:3A:BF:B8:9A:6A:03:EB:B5:7E:9B:3F:5F:A7:BE:7C:4F:5C:75:6F:30:17:B3:A8:C4:88:C3:65:3E:91:79`.

**수정 확인:**
```bash
openssl s_client -connect gsd.apple.com:443 -servername gsd.apple.com -CAfile AppleRootCA-G3.pem
# Should report: Verify return code: 0 (ok)
```

재빌드 후 로그인이 TLS 핸드셰이크를 통과합니다(가짜 계정은 이제 핸드셰이크 오류 대신 `-20101`로 거부되며, 실제 Apple ID 로그인은 성공합니다).

Question 2

xtool 설정 중 'Error: Key is invalid: invalidPEMDocument' 오류를 해결하는 방법은?

Accepted Answer

이 오류는 인증 과정에서 잘못된 파일 경로를 입력했을 때 발생합니다. Key ID와 Issuer ID를 입력한 후 xtool이 `AuthKey.p8` 파일(App Store Connect에서 다운로드한 파일)의 경로를 묻습니다. `Xcode.xip` 파일이 아닙니다. 실수로 Xcode.xip 경로를 입력하면 유효한 PEM/AuthKey 파일이 아니기 때문에 `invalidPEMDocument` 오류가 발생합니다. 해결 방법: 설정을 다시 실행하고 키를 입력하라는 메시지가 표시되면 `AuthKey_XXXXXXXXXX.p8`의 전체 경로를 입력하세요. `Xcode.xip` 경로는 인증이 완료된 후 별도로 묻습니다.

Question 3

Linux에서 Xcode 27 / iOS 27 SDK로 빌드할 때 발생하는 'unknown architecture' 및 'undefined symbol: main' 링커 오류를 해결하는 방법

Accepted Answer

번들에 포함된 LLD 20 링커는 iOS 27 SDK의 `.tbd` 스텁에 선언된 `arm64e.x1-ios` 타겟을 파싱하지 못하므로, `libSystem.tbd` 파싱에 실패한 뒤 오해를 불러일으키는 `undefined symbol: main` 오류를 보고합니다 — 코드 자체에는 문제가 없습니다. **근본적인 해결 방법:** xtool을 업데이트하세요 — 이 문제는 PR #270을 통해 업스트림에서 수정되었으며, 해당 PR은 LLVM 패치(llvm/llvm-project#222721)를 darwin-tools-linux-llvm에 가져옵니다. 업데이트 후 `xtool sdk install`을 다시 실행하세요. **xtool ≤1.20.0용 우회 방법:** SDK에 있는 675개의 `.tbd` 파일 모두에서 인식되지 않는 타겟을 제거한 후 다시 빌드하세요: `grep -rl 'arm64e\.x1-ios' "$SDK_ROOT" | while read -r f; do sed -i 's/, *arm64e\.x1-ios//g; s/arm64e\.x1-ios, *//g; s/arm64e\.x1-ios//g' "$f"; done`. 이 수정 사항은 `xtool sdk install`을 실행할 때마다 다시 적용해야 한다는 점에 유의하세요. Swift 툴체인의 LLD 21로 대체하는 방법은 통하지 않습니다(`This version of lld does not support linking for platform iOS`).

Question 4

비밀번호로 xtool auth login을 실행할 때 GsService2에서 발생하는 HTTP 503 오류를 해결하는 방법은?

Accepted Answer

이는 xtool v1.23.0 및 이전 버전의 알려진 버그로, Apple의 엣지 서버가 자격 증명을 평가하기 전에 클라이언트 식별 헤더를 기반으로 로그인 요청을 거부하는 문제입니다. 수정 사항은 xtool v1.24.0에 포함되었습니다(PR #406을 통해). xtool을 v1.24.0 이상으로 업그레이드하고 `xtool auth login`을 다시 실행하세요. 참고: 이 503 오류는 anisette 서버 또는 네트워크/자격 증명과 관련이 없으며, 업그레이드가 유일한 해결 방법입니다.

Question 5

Linux에서 xtool로 빌드할 때 'arm_neon.h __builtin_bit_cast source type int does not match int64_t' 오류를 해결하는 방법은?

Accepted Answer

이 문제는 `xtool sdk install`이 PATH에서 찾은 `clang`(예: Clang 22)에서 Clang 리소스 헤더를 복사하는 반면, 사용 중인 Swift 툴체인에는 더 오래된 Clang이 내장되어 있기 때문에 발생합니다(Swift 6.4에는 Clang 21이 내장됨). 일치하지 않는 헤더로 인해 컴파일이 실패합니다. 해결 방법: SDK의 리소스 헤더를 Swift에 내장된 Clang 버전과 일치하는 헤더로 교체하세요. Swift 6.4(Clang 21)의 경우 `clang21`을 설치하고(예: Arch에서는 `pacman -S clang21`, 21.1.8 제공) 해당 헤더를 설치된 SDK의 include 디렉터리에 복사하세요. 즉, `/usr/lib/llvm21/lib/clang/21/include`를 복사하여 SDK의 `usr/lib/clang/21/include` 내용을 교체합니다. 이 작업 후에는 `arm_neon.h`/`_Builtin_intrinsics` 오류가 사라지고 빌드가 진행됩니다. Swift에 내장된 Clang 버전을 확인하려면 툴체인에서 `libclang.so.21.0.0`을 찾아보세요. 장기적으로는 xtool이 툴체인 자체의 헤더를 사용하거나 버전 불일치 오류를 내며 실패하도록 해야 합니다(issue #273에서 추적 중).

xtool

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트