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 は Apple Root CA - G3 にチェーンします（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
# 次のように表示されるはずです: 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

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト