メインコンテンツへスキップ

iOS ビルド

Capgo の専用 Mac インフラを使って、iOS アプリをビルドし、TestFlight と App Store に提出します。

  • Capgo Native Build を使用してアプリをアップロードする方法を学びます
  • Capgo Native Build 用の証明書を設定する方法を学びます
  • Capgo アカウント(開始するには無料トライアルで十分です)
  • Capgo にアプリが登録済みであること( bunx @capgo/cli@latest app add 未登録の場合)
  • Macは不要:Capgo Build がクラウド上で iOS アプリのコンパイルと署名を行うため、macOS、Windows、Linux から実行可能です
  • 有効な Apple Developer アカウント(年額 $99)(Apple Developer アカウントの管理者またはオーナー権限が必要です)
  • アプリのビルドが成功すること(ローカルの Xcode または Capgo Build で)
  • Capacitor アプリ
  • 設定済みのアプリ用アイコン(アイコンがないアプリは App Store にアップロードできません)

証明書の設定や最初のTestFlightへのuploadを行う前に、Appleアカウントとチームが準備できていることを確認してください:

  • 登録に使用するApple Accountで2ファクタ認証を有効にする
  • 適切なメンバーシップタイプを選択してください:
    • 個人 / 個人事業主: App Storeの販売者名が、あなたの法的な個人名になります
    • 組織: 法人、D-U-N-S 番号、公開された企業ウェブサイト、企業ドメインの業務用メールアドレス、Apple の契約に組織を拘束する権限を持つ担当者が必要です
  • 証明書、アプリレコード、API キー、TestFlight のために、Apple Developer と App Store Connect の両方にアクセスできるアカウントを使用してください
  • 最終的な Bundle ID は早めに確定させてください。後から変更すると、通常 App Store の設定をやり直すことになります
  • App Review 前に、次の App Store Connect 項目を準備してください: サポート URL、プライバシーポリシー URL、対象年齢、スクリーンショット、輸出コンプライアンス、App Review の連絡先
Apple Developer への登録を開始 WebでAppleの登録を続行 正しいApple Developerのエンティティタイプを選択してください 登録後のApp Store Connect

Capgo を使ったアプリのビルドを検討する前に、まずは環境をセットアップし、手動で最初の TestFlight ビルドを行う必要があります。 最初に手動ビルドを行うことには、いくつかのメリットがあります:

  • ローカルマシンに配布用証明書(distribution certificate)をセットアップできます
  • 未作成の場合は、App Store のレコードを作成できます
  • アプリ code に関連するビルドプロセスの問題を特定できます

開始する前に、ローカルマシンに配布用証明書がインストールされている必要があります。 かなり複雑ですが、以下で説明します。

  1. Xcode を開く

  2. 次をクリックします: Xcode -> Settings... または、ショートカットを使用することもできます Cmd + ,

    Xcodeの設定

  3. 以下に移動します: Accounts XcodeのAccountsタブ

  4. Apple Developer Accountに追加されているApple Accountを探します Xcodeで選択したApple Account

  5. アプリのデプロイに使用するチームを探します Xcodeでチームを探す

  6. 次の Manage Certificates... ボタンをクリックします Xcodeで証明書を管理

  7. リストに配布用証明書(distribution certificate)が表示されていることを確認してください Xcode配布用証明書

  8. 表示されていない場合は、新しい証明書を作成する必要があります

    1. 次の + ボタンをクリックし、次に Apple Distribution Xcodeで証明書を追加
    2. 証明書は自動的に作成されます。リストに表示されるので、前のステップを参考に確認してください。

配布用証明書のインストールが完了しました。これでビルドプロセスを開始できます。

  1. Xcodeでアプリを開く

    実行 bunx cap open ios Xcodeでアプリを開きます。

  2. 〜を探してクリックします archive ボタンをクリックします

    Xcodeツールバーから、〜を探してクリックします product -> archive ボタンをクリックしてください。

    Xcodeツールバー

  3. ビルドの完了を待機してください

  4. 次の Distribute App ボタンをクリックします

    Xcodeの「Distribute」ボタン

  5. 選択します TestFlight Internal Only を配布方法として選択し、クリックします Distribute ボタンをクリックします

    XcodeのTestFlight Internal Only配布方法

  6. アプリレコードを設定

    以下のフィールドを入力してください:

    1. Name: アプリ名(App Storeに表示されます)
    2. SKU: アプリのSKU(App Storeでの識別用)
    3. Primary Language: アプリのメイン言語

    次に、以下をクリックします next ボタンをクリックします

    Xcode TestFlightのAppレコード設定

  7. Appレコードの作成に失敗した場合は、ウィンドウを一度閉じてから再度アプリのアーカイブを試してください。

  8. アップロードが完了するまで待ちます

  9. すべて正常に完了すると、次の画面が表示されます Xcode TestFlightへのアップロード完了

  10. 次の Done ボタンをクリックします

これで全て完了し、すぐにTestFlightでアプリを確認できると思うかもしれませんが、まだいくつか完了させるべきステップがあります:

  1. TestFlightに自分をテスターとして追加する
  2. エクスポートコンプライアンスを完了させ、ビルドをテスト可能にする
  3. サポートURL、プライバシーポリシーURL、年齢制限などのApp Store Connectの必須メタデータを入力する
  4. 実際にサポートしているデバイスに合わせたスクリーンショットを用意する
  5. 本番提出の前に、App Review の連絡先情報とテスト用認証情報を追加してください

まずは最初の項目から始めましょう:

  1. 以下にアクセスしてください: App Store Connect ページ App Store Connect ログインページ

  2. Apple Developer アカウントでサインイン

  3. アプリのレコード作成時に使用したチームを選択してください。開発者アカウントが1つしかない場合は、このステップをスキップできます。 App Store Connect のチーム選択

  4. 次の Apps ボタンをクリックします App Store Connect のアプリボタン

  5. 前のステップで作成したアプリを探してクリックします App Store Connect アプリ選択

  6. 次の TestFlight ボタンをクリックします App Store Connect TestFlight ボタン

  7. 次の Internal Testers plus ボタンをクリックします App Store Connect 内部テスターのプラスボタン

  8. 新しいグループを作成

    グループ名は「internal」にしていますが、好きな名前を付けて構いません。

    App Store Connect で新しいグループを作成

  9. 次をクリックします: Invite testers ボタンをクリックします App Store Connect のテスター招待ボタン

  10. 自分をグループに追加する

    リストで自分の名前を探し、名前の横のチェックボックスをオンにします。(自分が表示されない場合は、ページを更新する必要があるかもしれません) 次に、以下をクリックします: Add ボタンをクリックしてください。

    App Store Connect のテスター招待チェックボックス

  11. グループに追加されたことを確認

    これで、グループ内に自分が表示されるはずです。

    App Store Connect でテスターを確認

おめでとうございます 🎉 TestFlight への追加が完了しました。Capgo Native Build を設定する前に、やることはあと 1 つだけです。

次に、アプリが非標準的な(カスタムアルゴリズムなど)暗号化を使用していないことをAppleに宣言する必要があります。もしアプリが非標準的な暗号化を使用している場合は、以下の Appleのドキュメント を確認して、対処方法を確認することをお勧めします。 方法は2つあります:

  1. アプリをビルドするたびに、手動で行う方法。
  2. plistファイルを構成して、この値を自動的に設定する方法。 false.

まずは最初の項目から始めましょう:

  1. 前のセクションの手順に従って、App Store ConnectのTestFlightセクションを見つけます

  2. 次をクリックします: Builds -> iOS App Store ConnectのiOSビルドボタン

  3. コンプライアンス情報が不足しているビルドを見つけ、以下をクリックします Manage App Store Connect でビルドを管理

  4. アプリに最も当てはまるオプションを選択してください

    私の場合、これは noneですが、あなたの場合は異なるかもしれません。 その後、保存をクリックしてください

    App Store Connect でコンプライアンス情報を保存

  5. アプリが次のように表示されているはずです ready to test

    App Store Connect でテスト準備完了

2つ目については、手順は以下の通りです:

  1. 次を開きます: Info.plist ファイル

  2. 次のキーを追加してください:

    <key>ITSAppUsesNonExemptEncryption</key>
    <false/>
  3. ファイルを保存してください

TestFlightアプリのインストールと招待の承諾

セクション「TestFlightアプリのインストールと招待の承諾」

これで、 ほぼ TestFlightでアプリをテストする準備が整いました。 その前に、次のことを行ってください:

  1. ダウンロード TestFlightアプリ iOS/iPadOSデバイスのApp Storeから
  2. アプリのテスト招待を承認する

デバイスにTestFlightアプリをインストールする方法の詳細は省略します。アプリのインストール方法が分からない場合は、Googleに分かりやすいガイドがあります。

招待を承認するには、Appleから招待リンクが記載されたメールが届きます。

  1. 招待リンクが記載されたAppleからのメールを開く

  2. 次をクリックします: View in TestFlight ボタンをクリックします TestFlightメール内のボタン

  3. 次の Install ボタンをクリックします TestFlightインストールボタン

  4. デバイスにアプリをインストールする

    以前にXcodeを使ってアプリをインストールした場合、次の画面が表示されることがあります。その場合は、 install ボタンをクリックしてください。 TestFlightでアプリをインストール

  5. アプリのインストールが完了するまで待ちます

  6. 次の Open ボタンをクリックします

おめでとうございます 🎉 TestFlightでアプリをテストするための招待を承諾しました。これで、Capgo Native Build を設定して、アプリをビルドしTestFlightに提出できるようになります。

アプリをビルドしてTestFlightに提出できるようにするには、Capgo Native Build でいくつか設定する必要があります。 以下は、Capgo CLI に渡す項目の一覧です:

パラメータ説明
--platformビルド用プラットフォーム (ios)
--apple-team-idApple Developer Team ID ( Apple Developer Portal で確認できます))
--apple-keyApp Store Connect API キーファイルのパス (.p8 ファイル)
--apple-key-idApp Store Connect API キーの Key ID
--apple-issuer-idApp Store Connect Issuer ID
--certificate配布用証明書 (distribution certificate) のパス (.p12 ファイル)
--ios-provisioning-profileProvisioning profile のマッピング (bundleId=path または単一のプロファイルのパス)

実行コマンド例:

ターミナル
bunx @capgo/cli@latest build credentials save \
--platform ios \
--apple-team-id YOUR_TEAM_ID \
--apple-key '/path/to/AuthKey_XXXXX.p8' \
--apple-key-id YOUR_KEY_ID \
--apple-issuer-id YOUR_ISSUER_ID \
--certificate '/path/to/certificate.p12' \
--ios-provisioning-profile '/path/to/profile.mobileprovision'

まずはTeam IDから始めましょう。見つけるのはとても簡単です。

  1. 以下に移動します: Apple Developer Account 下にスクロールして

  2. 〜を探します Team ID

    デベロッパーアカウント内のTeam IDの場所

Apple key、Apple key ID、Apple issuer ID

セクション「Apple key、Apple key ID、Apple issuer ID」

次に、Appleのキーについて進めます。

  1. 以下に移動します: App Store Connect ユーザーとアクセス ページ

  2. ドロップダウンから正しいチームを選択してください

    1. 右上の自分の名前をクリックします
    2. 使用するチームをクリックします Apple Developerキーのチーム選択
  3. 次の Integrations ボタンをクリックします App Store Connect連携ボタン

  4. 〜を探します issuer

    次の copy Issuerをコピーするボタン App Store ConnectのIssuerをコピー

  5. プラスボタンをクリック App Store Connectのキー追加ボタン

  6. キーの名前とアクセス権を設定 App manager 次をクリックします: Generate ボタンをクリックします App Store Connectのキー名、アクセス権をApp Managerに設定、生成ボタン

  7. Key IDを保存

    App Store Connect のキー ID をコピー

  8. キーをダウンロード

    App Store Connect ダウンロードキー

    App Store Connect ダウンロードキーの警告

おめでとうございます 🎉 Apple key、Apple key ID、Apple issuer ID を作成しました。

これで証明書をエクスポートする準備が整いました。ご記憶のとおり、このガイドの最初の手順の一つは配布用証明書の設定でした。

しかし、Apple のありがたい仕様で、証明書のエクスポート方法は作成方法と大きく異なります 🙃 それでは、設定を進めましょう:

  1. Keychain Access を開く

    1. クリック Command + Space 検索バーを表示する
    2. を検索し、 Keychain Access
    3. 次の Keychain Access アプリ
  2. 次の login カテゴリを選択し、以下をクリックします: My Certificates ボタンをクリックします Keychain Accessのログインカテゴリ

  3. リストから証明書を探します

    証明書名は以下の通りである必要があります: Apple Distribution: [Your Name/Company] (your team ID) Keychain Accessで証明書を検索

  4. 証明書を右クリックして、以下を選択します: Export Keychain Accessから証明書をエクスポート

  5. 証明書を次の形式で保存: .p12 ファイル

    1. 証明書ファイルには適切な名前を付けてください
    2. ファイル形式が次のように設定されていることを確認してください: Personal Information Exchange (.p12)
    3. 次の Save ボタンをクリックします

    Keychain Access の証明書保存ダイアログ

  6. パスワードを求められた際、以下のいずれかを選択できます:

    • パスワードをスキップ(簡略化のため推奨):以下をクリック OK パスワードを入力せずに実行
    • パスワードを設定:証明書をパスワードで保護したい場合は、ここで設定できます。パスワード保護された .p12 Capgo CLI はパスワード保護されたファイルを完全にサポートしています。設定コマンドの実行時に --p12-password オプションを使用してパスワードを指定してください。

    Keychain Access の証明書保存用ログインパスワードダイアログ

  7. 「login keychain password」を求められたら、Macへのログインパスワードを入力してください

    Macへのログインパスワードを入力します。その後、以下をクリックしてください: Allow ボタンをクリックしてください。

    Keychain Access の証明書保存用ログインパスワード

おめでとうございます 🎉 証明書のエクスポートが完了しました。

プロビジョニングプロファイル

「Provisioning profile」セクション

これで、provisioning profileをエクスポートする準備が整いました。Appleから取得する必要がある作業は、これで最後です。

  1. 以下に移動します: Apple Developer プロファイル

  2. ドロップダウンから正しいチームを選択してください

    1. 右上の自分の名前をクリックします
    2. 使用するチームをクリックします Apple Developerキーのチーム選択
  3. 正しいページにいることを確認してください。 表示が以下のようになっていない場合は、こちらをクリックしてください。 profiles サイドバーの

    Apple Developer プロファイルページ

  4. 次の + ボタンをクリックします Apple Developer プロファイル追加ボタン

  5. プロファイルの種類を選択 選択する App Store Connect 次をクリックします: Continue ボタンをクリックします

    Apple Developer プロファイル種類の選択

  6. ビルドするアプリを選択

    ドロップダウンからアプリを探してクリック Continue ボタンをクリックします

    Apple Developer アプリの選択

  7. 適切な配布用証明書を選択してください

    前のステップでエクスポートした証明書を選択し、 Continue ボタンをクリックします

    Apple Developerの配布用証明書を選択

    どの証明書を選択すべきかわからない場合は、Keychain Accessに戻ってエクスポートした証明書を確認してください。その際、有効期限も確認してください。

    Apple Developerの配布用証明書の有効期限

  8. プロファイルの名称設定

    プロファイルに名前を入力し、 Generate ボタンをクリックします

    Apple Developer プロファイル名

  9. プロファイルをダウンロード

    次の Download プロファイルをダウンロードするボタン

    Apple Developer プロファイルのダウンロード

完了です 🎉 これで Capgo Native Build の設定に必要な準備がすべて整いました。

完了です!これで Capgo Native Build を設定するための準備がすべて整いました。

実行するコマンドは以下の通りです:

ターミナル
bunx @capgo/cli@latest build credentials save \
--platform ios \
--apple-team-id UVTJ336J2D \
--apple-key ./capgo-tutorial/AuthKey_66FGQZB566.p8 \
--apple-key-id 66FGQZB566 \
--apple-issuer-id 0cd4db4a-5598-45b8-9d32-75cdf127d005 \
--certificate ./capgo-tutorial/capgo-build-tutorial-certificate.p12 \
--ios-provisioning-profile ./capgo-tutorial/capgo_native_build_tutorial.mobileprovision

正常に完了すると、以下の出力が表示されます:

Capgo CLI の認証情報保存完了

すでに完了している場合 チームID, Apple key、Apple key ID、Apple issuer ID, 証明書や プロビジョニングプロファイルCI/CDに必要な準備はすでに整っています。 このセクションでは、それらの値を GitHub Actions の secrets や環境変数として渡す方法について説明します。

1) 認証ファイルを1行のbase64形式に変換する

セクション「1) 認証情報ファイルを1行のbase64に変換」
ターミナル
# Distribution certificate (.p12)
base64 -i ./capgo-tutorial/capgo-build-tutorial-certificate.p12 | tr -d '\n' > certificate_base64.txt
# Provisioning profile (.mobileprovision)
base64 -i ./capgo-tutorial/capgo_native_build_tutorial.mobileprovision | tr -d '\n' > profile_base64.txt
# App Store Connect API key (.p8)
base64 -i ./capgo-tutorial/AuthKey_66FGQZB566.p8 | tr -d '\n' > apple_key_base64.txt

2) リポジトリシークレットを作成

セクション「2) リポジトリシークレットを作成」

では GitHub > Repository > Settings > Secrets and variables > Actions、追加:

シークレット名値
CAPGO_TOKENCapgo API トークン
APP_STORE_CONNECT_TEAM_ID〜のTeam ID チームID
APPLE_KEY_ID〜のKey ID Apple key、Apple key ID、Apple issuer ID
APPLE_ISSUER_ID〜のIssuer ID Apple key、Apple key ID、Apple issuer ID
BUILD_CERTIFICATE_BASE64内容: certificate_base64.txt
CAPGO_IOS_PROVISIONING_MAPCLI が生成 — 〜からコピー .capgo-credentials ファイル
APPLE_KEY_CONTENT内容: apple_key_base64.txt
P12_PASSWORD (任意)お使いの .p12 エクスポート時に設定したパスワード

3) GitHub Actions workflow で環境変数を使う

セクション「3) GitHub Actions workflow で環境変数を使う」
.github/workflows/ios-build.yml
name: iOS Cloud Build
on:
workflow_dispatch:
push:
branches: [main]
jobs:
ios-build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v6
- uses: oven-sh/setup-bun@v2
with:
bun-version: latest
- name: Request iOS build with Capgo
run: bunx @capgo/cli@latest build request --platform ios
env:
CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
APP_STORE_CONNECT_TEAM_ID: ${{ secrets.APP_STORE_CONNECT_TEAM_ID }}
APPLE_KEY_ID: ${{ secrets.APPLE_KEY_ID }}
APPLE_ISSUER_ID: ${{ secrets.APPLE_ISSUER_ID }}
BUILD_CERTIFICATE_BASE64: ${{ secrets.BUILD_CERTIFICATE_BASE64 }}
CAPGO_IOS_PROVISIONING_MAP: ${{ secrets.CAPGO_IOS_PROVISIONING_MAP }}
APPLE_KEY_CONTENT: ${{ secrets.APPLE_KEY_CONTENT }}
P12_PASSWORD: ${{ secrets.P12_PASSWORD }}

これで、最初のビルドを実行する準備が整いました。

以下のコマンドを実行して、アプリをビルドします:

ターミナル
bunx @capgo/cli@latest build request --platform ios

おめでとうございます 🎉 これでアプリのビルドが完了しました。App Storeへの申請準備は万端です。

通常のApp Storeビルドパスでは、ビルドをApp Store Connect/TestFlightにアップロードします。CIリリース時に、処理済みのTestFlightビルドをApp Storeのバージョンに紐付けてApp Reviewへ提出する場合は、 --submit-to-store-review リリースビルドで渡します:

ターミナル
npx @capgo/cli@latest build request com.example.app \
--platform ios \
--build-mode release \
--ios-distribution app_store \
--submit-to-store-review \
--store-release-name "1.2.3" \
--store-release-notes "General improvements" \
--store-release-notes-locale "en-US=General improvements" \
--store-release-notes-locale "nl-NL=Algemene verbeteringen" \
--store-release-notes-locale "fr-FR=Ameliorations generales" \
--no-ios-automatic-release

これには App Store Connect の API キー認証情報が必要です(APPLE_KEY_ID, APPLE_ISSUER_ID, APPLE_KEY_CONTENTや APP_STORE_CONNECT_TEAM_ID)。App-specific password を使用した upload や ad_hoc distribution では、レビュー用の build を提出できません。 --store-release-name は App Store のバージョンです。省略した場合、Capgo は MARKETING_VERSION Xcode プロジェクトから読み取ります。 --store-release-notes は App Store の「新機能」テキストのフォールバックです。各 --store-release-notes-locale "locale=notes" エントリでストアのローカライズ設定を上書きできます。 --ios-automatic-release を使用すると Apple の承認後に自動リリースされ、 --no-ios-automatic-release を使用すると手動リリースまで待機します。 --ios-testflight-groups は外部ベータ配布には引き続き利用可能ですが、App Store のレビュー提出には必須ではありません。

デフォルトでは、Capgo は App Store 配布(TestFlight + App Store)向けに iOS アプリをビルドします。社内テストや CI アーティファクトの収集などのために Ad-Hoc ビルドが必要な場合は、 --ios-distribution フラグを使用してください。

Ad-Hocモードを使用するタイミング

「ad-hocモードを使用するタイミング」セクション
  • 登録済みのデバイスにIPAを直接配布したい場合(TestFlightを使用しない)
  • App Store Connectの API キーを持っていない、または使用したくない場合
  • 以下の方法でビルド成果物を収集したい場合 --output-upload App Storeに提出することなく

Ad-hocビルドは、 要件が少なく、 App Storeビルドよりも:

認証情報必須ですか?
配布用証明書 (.p12)はい
Ad-hoc プロビジョニングプロファイル (.mobileprovision)はい
チームID (--apple-team-id)はい
App Store Connect の API キー (.p8)いいえ
Apple Key ID / Issuer IDいいえ

Ad-Hocプロビジョニングプロファイルの作成

「Creating an ad-hoc provisioning profile」セクション

以下の手順に従ってください: プロビジョニングプロファイル、ただしステップ5では次を選択: Ad Hoc の代わりに App Store:

  1. 以下に移動します: Apple Developer プロファイル
  2. 次をクリックします: + ボタンをクリックします
  3. 選択します Ad Hoc 、続いて Continue をクリックします
  4. アプリと配布用証明書を選択します
  5. 登録するデバイスを選択してください
  6. プロファイルに名前を付けてダウンロード
ターミナル
bunx @capgo/cli@latest build credentials save \
--platform ios \
--ios-distribution ad_hoc \
--apple-team-id YOUR_TEAM_ID \
--certificate './certificate.p12' \
--ios-provisioning-profile './adhoc_profile.mobileprovision'

いいえ --apple-key, --apple-key-id、または --apple-issuer-id が必要です。

ターミナル
bunx @capgo/cli@latest build request \
--platform ios \
--ios-distribution ad_hoc

IPAをビルド成果物として取得するには、以下を追加してください: --output-upload:

ターミナル
bunx @capgo/cli@latest build request \
--platform ios \
--ios-distribution ad_hoc \
--output-upload

GitHub Actionsでは、App Store向けのビルドよりも少ないSecretsで済みます:

.github/workflows/ios-adhoc-build.yml
name: iOS Ad-Hoc Build
on:
workflow_dispatch:
jobs:
ios-adhoc:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v6
- uses: oven-sh/setup-bun@v2
with:
bun-version: latest
- name: Request iOS ad-hoc build
run: bunx @capgo/cli@latest build request --platform ios --ios-distribution ad_hoc --output-upload
env:
CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
APP_STORE_CONNECT_TEAM_ID: ${{ secrets.APP_STORE_CONNECT_TEAM_ID }}
BUILD_CERTIFICATE_BASE64: ${{ secrets.BUILD_CERTIFICATE_BASE64 }}
CAPGO_IOS_PROVISIONING_MAP: ${{ secrets.CAPGO_IOS_PROVISIONING_MAP_ADHOC }}
CAPGO_IOS_DISTRIBUTION: ad_hoc

Extensionを含むアプリ(マルチターゲット署名)

「Extensions を含むアプリ (Multi-Target Signing)」セクション

アプリに extension (share extension、widget、notification service extension など) が含まれている場合、各 extension ターゲットに個別の provisioning profile が必要です。Capgo は、以下の repeatable --ios-provisioning-profile flag.

ターミナル
bunx @capgo/cli@latest build credentials save \
--platform ios \
--apple-team-id YOUR_TEAM_ID \
--apple-key '/path/to/AuthKey_XXXXX.p8' \
--apple-key-id YOUR_KEY_ID \
--apple-issuer-id YOUR_ISSUER_ID \
--certificate '/path/to/certificate.p12' \
--ios-provisioning-profile "com.example.app=./app_profile.mobileprovision" \
--ios-provisioning-profile "com.example.app.share-extension=./share_ext_profile.mobileprovision"

各 --ios-provisioning-profile フラグを使用して、bundle ID を provisioning profile ファイルに紐付けます。CLI:

  1. 各mobileprovisionファイルを読み込みます
  2. 埋め込まれたplistからプロファイル名を自動抽出します
  3. ファイルをBase64エンコードします
  4. すべてを一つの CAPGO_IOS_PROVISIONING_MAP 認証情報として保存します

以前に BUILD_PROVISION_PROFILE_BASE64 (シングルプロファイル) を使用していた場合は、以下を実行してください:

ターミナル
bunx @capgo/cli@latest build credentials migrate --platform ios

これにより、既存のシングルプロファイル認証情報を新しい CAPGO_IOS_PROVISIONING_MAP 形式に変換し、レガシーキーを削除します(BUILD_PROVISION_PROFILE_BASE64, APPLE_PROFILE_NAME).

移行後、次のコマンドで拡張プロファイルを追加します update (追加マージ):

ターミナル
bunx @capgo/cli@latest build credentials update \
--platform ios \
--ios-provisioning-profile "com.example.app.share-extension=./share_ext_profile.mobileprovision"

Provisioning profile に XYZ capability が含まれていません。

「Provisioning profile に XYZ capability が含まれていません。」というセクション

場合によっては、次のようなエラーが表示されることがあります:

Provisioning profile "YOUR_PROVISIONING_PROFILE_NAME" doesn't include the XYZ capability. (in target 'App' from project 'App')"

これは、provisioning profile の作成後に新しい capability を有効にしたことが原因です。 古い provisioning profile には、まだ新しい capability が含まれていません。

これを解決するには、provisioning profile を再生成する必要があります。

  1. 開く Apple Developer Portal
  2. ドロップダウンから正しいチームを選択してください Apple Developerキーのチーム選択
  3. 次の Profiles ボタンをクリックします Apple Developer のプロファイルボタン
  4. 再生成したいプロビジョニングプロファイルを探します Apple Developer でプロファイルを探す
  5. 次の Edit ボタンをクリックします Apple Developer でプロファイルを編集する
  6. 次の Save ボタンをクリックします Apple Developer プロファイルの保存
  7. 次の Download ボタンをクリックします Apple Developer プロファイルのダウンロード
  8. Capgo Native Build セットアップコマンドを再実行 新しくダウンロードしたプロファイルを使用して実行してください。

これで問題が解決するはずです。

Capgo Native Build、認証情報の構成、またはアプリのビルドに関して何らかの問題が発生した場合は、お気軽に以下の方法でご連絡ください。 サポート.

使用している場合 iOS ビルド CI/CD自動化を計画するには、次と連携してください Capgo での CI/CD 設定 Capgo CI/CDでのプロダクトワークフローについては、 Capgo Native Build Capgo Native Buildsでのプロダクトワークフローについては、 Capgo インテグレーション Capgo インテグレーションでのプロダクトワークフロー向けに、 CI/CD 連携 CI/CD Integrationの実装詳細については、 GitHub Actions 連携 GitHub Actions Integrationの実装詳細については。