bokuwalily Procedure
EAS無料枠ゼロでもクラウド不要・無料でTestFlightに出せる。Mac(Xcode)＋Apple Developer＋既存EASプロジェクト前提。
最短（まず試す）：重複Distribution証明書を消すだけ ★2026-06-19 実証
eas build --local が provisioning profile doesn't include signing certificate "Apple Distribution: …" で落ちる時、多くはcredentials.jsonもsighも不要。原因は単純な名前衝突：ログインキーチェーンに「Apple Distribution: 」が複数あり、ローカルアーカイブがEASプロファイル(EAS証明書入り)と別の証明書を掴むだけ。EASの--localは自前証明書を一時キーチェーンに入れて署名するので、衝突する別証明書をローカルから消せばデフォルトのremote資格情報のまま通る。
- 照合：
security find-identity -v -p codesigning | grep "Apple Distribution"で各証明書のSHA-1。eas credentials -p iosが出すEAS管理証明書のSerialと、ローカル証明書のSerial(security find-certificate -c "Apple Distribution: <Name> (TEAM)" -p | openssl x509 -noout -serial)を比較→違えば別物＝衝突原因。 - EAS管理でない方(古い重複)を削除：
security delete-identity -Z <SHA-1>（このMacでGUI不要・RC=0で通った。可逆＝Apple側には残り再DL可）。削除後ローカルにDistribution証明書が0枚でも問題なし（EASがビルド時に一時キーチェーンへ供給）。 - 必要なら
eas credentials -p ios→ Build Credentials →Provisioning Profile: Delete one from your project→All: Set up allでEAS証明書入りの新プロファイルを再生成（古いprofileが残っている場合）。 - 再ビルド：
eas build -p ios --profile production --local --non-interactive --output build.ipa（log開始75-90秒でdoesn't include signing certificateが0なら署名突破＝あとはコンパイル）。→Build successful＋ build.ipa 生成。 - 提出：
eas submit -p ios --profile production --path build.ipa --non-interactive（ascAppId設定済・2FA不要）。 ⚠️stray証明書は再混入する(複数回観測)。eas build --localのcredential準備が失敗ビルド時などにlogin keychainへ別Distribution証明書(serial違い)を書き戻すため、成功した次のビルドでまた落ちることがある。対処＝ローカルビルドを回す直前に毎回security find-identity -v -p codesigning | grep Distributionで確認し、EAS profileのSerialと違う証明書があればsecurity delete-identity -Z <SHA1>してから build。恒久対策はApple/EASのDistribution証明書を1枚に統一(eas credentials→Distribution Certificate: Delete one from your accountで古い方をrevoke→profile再生成)＝2枚あるとEASがビルド毎に別証明書を掴んで不整合になる。 これで直らない時のみ↓のcredentials.json/sighルートへ。
推奨（簡潔）：eas build --local ＋ ローカルcredentials.json
fastlane gym手組みより楽。EASがprebuild/pod/archive/exportを代行し、buildNumberもEAS remoteで自動採番。eas build --localが provisioning profile doesn't include signing certificate "Apple Distribution: …" で落ちる時の決定打。原因＝EASのリモートprofileはEAS発行証明書を埋め込むが、ローカルXcodeアーカイブはKeychainの別Distribution証明書を掴むため（eas credentialsでprofile再生成しても、EAS証明書を埋めるので直らない）。
- ローカルDistribution証明書を確認：
security find-identity -v -p codesigning | grep "Apple Distribution"→ 指紋(SHA-1)を記録。 - それを含むApp Store配布プロファイルを用意：リポに
*.mobileprovisionがあれば中身を照合 →security cms -D -i x.mobileprovision > p.plistし、DeveloperCertificates:0のSHA-1がローカル証明書と一致するか確認（plistlibでDER→sha1）。一致すればそれを使う。無ければ手順3(sigh)で生成。 - ローカル証明書だけのクリーンな.p12を書き出す（
security exportは全ID混在＋openssl3が読めないので要整形）：security export -k ~/Library/Keychains/login.keychain-db -t identities -f pkcs12 -P <pass> -o /tmp/all.p12（このMacではGUI許可不要で通った）openssl pkcs12 -in /tmp/all.p12 -passin pass:<pass> -legacy -nodes -out /tmp/all.pem（-legacy必須）- Distribution証明書とmodulus一致の秘密鍵だけ抽出し再パッケージ：
openssl pkcs12 -export -legacy -in dist-only.pem -out /tmp/dist.p12 -passout pass:<pass>
credentials.json（gitignore必須・秘密）をプロジェクト直下に：
.p12は{"ios":{"provisioningProfilePath":"x.mobileprovision","distributionCertificate":{"path":"/tmp/dist.p12","password":"<pass>"}}}/tmpの絶対パスでリポ外に置く。eas.jsonの該当buildプロファイルに"credentialsSource": "local"を追加。npx eas build --local --platform ios --profile production --non-interactive --output ./build/app.ipa→ ログにUsing local iOS credentials (credentials.json)→ 突合通過 →Build successful。- 提出：
npx eas submit --platform ios --profile production --path build/app.ipa --non-interactive（ascAppId設定済前提・2FA不要）。 - 検証：.ipaのAppIcon抽出はiOS最適化PNGなので
sips -s format pngで標準化してから目視。embedded.mobileprovisionの証明書SHA-1がローカル証明書と一致を確認。
代替（fastlane手組み）：
- App Idにcapability反映＋プロファイル整備（push等を足した直後のみ）：本人が
! eas build -p ios --profile productionを対話実行→Appleログイン→capability sync→「Generate new provisioning profile?」Yes→（枠エラーで最後落ちるが無視。creds整備が目的）。 - ローカル証明書を確認：
security find-identity -p codesigning -v | grep Distribution。"Apple Distribution: (TEAMID)" があればその指紋を使う。EAS発行の"iPhone Distribution"型はXcode26で弾かれるので、Mac Keychainの"Apple Distribution"を使うのが鍵。 - そのローカル証明書に合うApp Store配布プロファイルを生成（本人が
!で2FA入力）：! fastlane sigh renew --app_identifier <bundleId> --team_id <TEAMID> --platform ios --output_path /tmp/prof --filename app.mobileprovision→ sighが「EAS証明書はローカルに鍵なし」を検知し、ローカル証明書入りの新プロファイルを生成。UUID/Name/aps-environmentはsecurity cms -D -i ...mobileprovisionで確認。 - キーチェーン署名許可（codesignのGUIポップアップ＝ヘッダレスでハングするのを防止。本人がMacパス入力）：
! read -rs "PW?Macパス: "; security unlock-keychain -p "$PW" ~/Library/Keychains/login.keychain-db && security set-key-partition-list -S apple-tool:,apple: -s -k "$PW" ~/Library/Keychains/login.keychain-db; unset PW - buildNumberを既存TestFlight超えに：app.json
ios.buildNumberを手動で上げる（ローカルビルドはEAS remote versioningを使わないため必須）。 - prebuild＋手動署名gym（バックグラウンド可・DerivedDataキャッシュで2回目以降速い）：
npx expo prebuild -p ios --clean→cd ios && fastlane gym --workspace *.xcworkspace --scheme <Scheme> --configuration Release --output_directory /tmp/ipa --output_name app.ipa --export_options /tmp/export.plist --xcargs "CODE_SIGN_STYLE=Manual DEVELOPMENT_TEAM=<TEAMID> PROVISIONING_PROFILE_SPECIFIER=\"<ProfileName>\" CODE_SIGN_IDENTITY=\"Apple Distribution: <Name> (TEAMID)\""export.plist = method:app-store / teamID / signingStyle:manual / provisioningProfiles:{:} / uploadSymbols:true。 - 提出（2FA不要・ASC APIキー使用）：
eas submit -p ios --path /tmp/ipa/app.ipa --non-interactive（eas.json submit.production.ios.ascAppId 設定済前提）。 - 後片付け：
git checkout package.json（prebuildがscriptsをrun:に書換える）、rm -rf ios android（managed運用なら）。
Pitfalls
- 証明書2種の罠：EASは"iPhone Distribution"型を発行、Xcode26ローカルは"Apple Distribution"を要求→
profile doesn't include signing certificate連発。→ローカルの"Apple Distribution"＋sigh生成プロファイルで解決。 - codesignがハング(exit 144)：キーチェーン許可ポップアップをヘッダレスで押せず。→手順4を先に実行。
- buildNumber衝突：ローカルビルドはCFBundleVersion=1になりがち→既存TestFlight超えに手動採番。
- git push失敗(Device not configured/no oauth token)：keyringアクセス不可。本人が
! git pushで。 - fastlane/eas のApple 2FAは対話必須＝本人が
!で6桁入力。提出(eas submit)はASC APIキーで2FA不要。
Verification
- ipa確認：
unzip -q app.ipa -d x; /usr/libexec/PlistBuddy -c 'Print :CFBundleVersion' x/Payload/*.app/Info.plist（既存超えか）。 - gymログに
Successfully exported and signed the ipa file。 - eas submitログに
Submitted your app to Apple App Store Connect!＋ TestFlight URL。5-10分でApple処理→TestFlight反映。