メニューに進む

iOS ビルド

iOSアプリをTestFlightとApp Storeに送信するには、Capgoの専用Macインフラを使用します。

  • Capgo Native buildを使用してアプリをアップロードする方法を学びます。
  • Capgo Native Buildの証明書を設定する方法を学びます。
  • Capgoアカウント(無料試用版でも十分)
  • アプリがCapgoに登録済み(未登録の場合は実行してください) bunx @capgo/cli@latest app add MacコンピューターとXcodeがインストールされている(Linux/Windowsマシンでビルドを設定することも可能ですが、まだドキュメントが公開されていません)
  • Apple Developerアカウント($99/年)が有効(Apple Developerアカウントの管理者またはオーナー権限が必要)
  • Valid Apple Developer account ($99/year) (You must have admin or owner rights on the Apple Developer account)
  • Xcodeを使用してアプリが正常にビルドできる必要があります。
  • Capacitorアプリ
  • アプリの設定済みアイコン。アイコンが設定されていないアプリはApp Storeにアップロードできません。

Appleアカウントの2要素認証を有効にします。

  • 正しいメンバーシップタイプを選択します。
  • Choose the right membership type:
    • 個人/個人事業主: App Store での販売者名として、法律上の個人名が使用されます。
    • 組織: 法的実体、D-U-N-S番号、公的企業ウェブサイト、企業ドメインのワークメール、Apple の契約に組織を縛る権限を持つ人物が必要です。
  • Apple Developer と App Store Connect にアクセスできるアカウントを使用して、証明書、アプリレコード、API キー、テストフライトを設定します。
  • 最終バンドルIDを早めに固定しておきましょう。変更すると通常、App Store設定を再度行う必要があります。
  • App Review に提出する App Store Connect のアイテムを計画しておきましょう: サポートURL、プライバシーポリシーURL、年齢制限、スクリーンショット、輸出管理、App Review の連絡先情報
Apple Developer の登録を開始する Web 上で Apple の登録を続ける Apple Developer のエンティティタイプを正しく選択する 登録後の App Store Connect

Capgo をビルドする前に、まずセットアップし、手動で最初のテストフライトビルドを行う必要があります。 手動ビルドを行うことで、次のような利点があります:

  • 配布証明書をローカルマシンにインストールする
  • App Store のレコードを作成する (まだ作成していない場合)
  • code に関連するビルドプロセスの問題を解決する

__CAPGO_KEEP_0__ をビルドする前に、ローカルマシンに配布証明書をインストールする必要があります。 これはかなり複雑ですが、以下で説明します。

配布用証明書の設定

配布用証明書の設定
  1. Xcodeを開く

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

    Xcode設定

  3. 以下の手順に従ってください Accounts Apple Developerアカウントに追加されたAppleアカウントを探す

  4. 選択したAppleアカウント アプリを配布するために使用するチームを探す

  5. アプリを配布するために使用するチーム __CAPGO_KEEP_0__

  6. ボタンをクリックしてください Manage Certificates... ボタン Xcodeで証明書を管理する

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

  8. そうでない場合は、新しい証明書を作成する必要があります

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

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

TestFlight用の手動ビルド

TestFlight用の手動ビルド
  1. Xcodeでアプリを開く

    実行 bunx cap open ios アプリを開くには、

  2. をクリックしてください archive Xcodeのツールバーで、

    をクリックしてください。 product -> archive Xcodeのツールバー

    ツールバー

  3. ビルドが完了するのを待ってください

  4. Click on the Distribute App ボタン

    Xcode配布ボタン

  5. Select TestFlight Internal Only 配布方法としてを選択し、 Distribute ボタン

    テストフライトのみの内部配布方法

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

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

    1. アプリ名: アプリの名前 - App Storeで表示
    2. SKU: アプリのSKU - App Storeでアプリを識別するために使用
    3. アプリの主な言語

    次に、 next ボタン

    Xcode TestFlightでアプリを記録

  7. アプリの記録が失敗した場合は、ウィンドウを閉じてアプリを再度アーカイブしてみてください。

  8. アップロードが完了するのを待ってください

  9. 全てがうまくいったら、以下の画面が表示されるはずです Xcode TestFlightでアップロードが完了

  10. ボタン Done あなたは、すべてがうまくいったので、TestFlightでアプリを確認できるはずだと感じるかもしれませんが、まだいくつかのことが終わっていないのです。

TestFlightに自分を追加する

  1. __CAPGO_KEEP_0__
  2. 完全な輸出法遵守を確実にするため、ビルドがテスト可能になるように
  3. App Store Connect の必要なメタデータを埋め込むには、サポート URL、プライバシー ポリシー URL、年齢制限などを入力してください
  4. 実際にサポートしているデバイスに合ったスクリーンショットを用意してください
  5. 生産提出前に App Review の連絡先情報とテストクレデンシャルを追加してください

最初のステップとしては、

TestFlight に自分自身を追加すること

「TestFlight に自分自身を追加する」
  1. 以下の手順に従ってください App Store Connect App Store Connect のログイン画面 Apple Developer アカウントでログインしてください

  2. __CAPGO_KEEP_0__

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

  4. __CAPGO_KEEP_1__をクリックしてください。 Apps App Store Connectアプリの選択 __CAPGO_KEEP_2__をクリックしてください。

  5. App Store Connectのテストフライト __CAPGO_KEEP_3__をクリックしてください.

  6. App Store Connectのアプリの選択 TestFlight __CAPGO_KEEP_2__をクリックしてください。 App Store Connectのテストフライト

  7. __CAPGO_KEEP_3__をクリックしてください. Internal Testers plus __CAPGO_KEEP_1__をクリックしてください. App Store Connectの内部テスト者プラスボタン

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

    グループの名前は「内部」にします。好きな名前を付けられます。

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

  9. Click on Invite testers ボタン App Store Connectのテスター招待ボタン

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

    リストの中で自分自身を見つけ、自分の名前の横のチェックボックスを選択してください。 (自分自身が表示されない場合はページを更新してください) 次に、 Add ボタンをクリックしてください。

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

  11. グループに自分自身が追加されていることを確認

    グループの中で自分自身を確認してみてください。

    App Store Connectのテスターを検証する

テストフライトに自分を追加したので、もう1つだけのことが残っています\nCapgo Native Buildを設定する前に、以下の手順を実行してください。

コンプライアンス情報の設定

コンプライアンス情報の設定

あなたのアプリは、Apple における非標準 (カスタムアルゴリズムを含む) の暗号化を使用していないことを約束する必要があります。アプリが非標準暗号化を使用している場合、私は非標準暗号化を使用している場合の詳細を読むことをお勧めします。 Apple ドキュメント この方法を取り扱う方法についての説明があります。 この方法を取り扱う方法は2つあります。

  1. 毎回アプリをビルドするたびに手動で行うことができます。
  2. plistファイルを自動的にこの値に設定するように設定できます。 false.

最初に始めましょう。

  1. App Store ConnectでTestFlightのセクションを探すには、前のセクションのすべてのステップに従ってください。

  2. Click on 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. App Store Connectを開いてください Info.plist ファイル

  2. __CAPGO_KEEP_0__を追加してください

    <key>ITSAppUsesNonExemptEncryption</key>
    <false/>
  3. ファイルを保存

TestFlightアプリをインストールし、招待を承認

「TestFlightアプリをインストールし、招待を承認」セクション

ここから ほぼ TestFlightでアプリをテストする準備ができました。 テストする前に、以下のことを行ってください:

  1. Capgoで TestFlightアプリ App StoreからiOS/iPadOSデバイスで
  2. アプリのテストに招待されたことを承知する

Capgoでアプリのテストに招待されたことを承知する

Capgoでアプリのテストに招待されたことを承知する

  1. Capgoでアプリのテストに招待されたことを承知する

  2. Capgoでアプリのテストに招待されたことを承知する View in TestFlight Capgoでアプリのテストに招待されたことを承知する Capgoでアプリのテストに招待されたことを承知する

  3. button Install ボタン TestFlight インストール ボタン

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

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

  5. アプリのインストールを待ってください

  6. ボタンをクリックしてください Open おめでとうございます 🎉 あなたはTestFlightでアプリをテストするための招待を承認しました。ここで、__CAPGO_KEEP_0__ Native Buildを設定して、アプリをTestFlightに送信することができます。

Capgo Native Buildの設定

「Capgo Native Buildの設定」セクション

「Capgo Native Buildの設定」

TestFlightにアプリを提出するには、Capgo Native Buildを構成する必要があります。 ここでは、Capgo CLIに渡すもののリストを示します。

パラメーター説明
--platformビルドするプラットフォーム (ios)
--apple-team-idApple Developer Team ID (Apple Developer Portalで見つけることができます App Store Connectアカウントの__CAPGO_KEEP_0__ キーファイルのパス ()
--apple-keyPath to your App Store Connect API Key file (.p8 App Store Connectの__CAPGO_KEEP_0__ キーのキーID
--apple-key-idThe Key ID of your App Store Connect API Key
--apple-issuer-id配布用証明書のパス (
--certificateファイル.p12 __CAPGO_KEEP_0__
--ios-provisioning-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'

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

  1. Apple Developer Account に移動し 下にスクロール

  2. 見つける Team ID

    開発者アカウントのチームIDの場所

Appleキー、AppleキーID、およびApple発行者ID

セクション「Appleキー、AppleキーID、およびApple発行者ID」

さて、Appleキーについて説明しましょう。

  1. Go to App Store Connect user and access page App Store Connectのユーザーとアクセスページに移動してください

  2. Select the correct team in the dropdown

    1. Click on your name in the top right corner
    2. Click on the team you want to use Apple Developer keys team selection
  3. Click on the Integrations button App Store Connect integrations button

  4. Find the issuer

    ボタンをクリックして発行者をコピー copy App Store Connect の発行者をコピー +ボタンをクリック

  5. App Store Connect のキーを追加 キー名を設定し、権限を設定し

  6. とボタンをクリック App manager ボタンをクリックしてください. Generate App Store Connect のキーを追加 App Store Connectにキー名を追加し、App管理者へのアクセスを設定し、生成ボタン

  7. キーIDを保存

    App Store ConnectからキーIDをコピー

  8. キーをダウンロード

    App Store Connect download key

    App Store Connect download key warning

Congratulations 🎉 You have created the Apple key, Apple key ID and Apple issuer ID.

Now, you are ready to export the certificate. As you remember, one of the first steps of this guide was setting up the distribution certificate.

However, Apple in their infinite wisdom, decided that the way you export the certificate is quite different from the way you create them 🙃 Let’s get into setting it up:

  1. Keychain Accessを開く

    1. をクリック Command + Space 検索バーを開く
    2. を検索 Keychain Access
    3. をクリック Keychain Access アプリ
  2. カテゴリを選択し、をクリック login ボタン My Certificates Keychain Accessログインカテゴリ リストで証明書を探す

  3. __CAPGO_KEEP_0__

    証明書の名前は Apple Distribution: [Your Name/Company] (your team ID) Keychain Accessで証明書を検索

  4. 証明書を右クリックし、 Export Keychain Accessで証明書をエクスポート

  5. 証明書を .p12 ファイル

    1. 証明書ファイルの名前を適切に選択してください
    2. ファイル形式を設定する Personal Information Exchange (.p12)
    3. ボタンをクリック Save ボタン

    キーチェーンアクセスで証明書を保存するダイアログ

  6. パスワードを求められた場合、次のいずれかを選択できます。

    • パスワードを入力せずにスキップ (簡単にすることを推奨): パスワードを入力せずに OK パスワードを設定: パスワードで保護した
    • ファイルは完全にサポートされています。 __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ でパスワードを使用して、設定コマンドを実行するときにパスワードを指定してください。 .p12 files are fully supported by the Capgo CLI - just provide the password using the --p12-password 「ログインキーチェーンパスワード」を求められた場合、Macにログインするために使用するパスワードを入力してください

    option

  7. configuration command

    Macにログインする際に使用するパスワードを入力してください。次に、ボタンをクリックしてください。 Allow Keychain Accessで証明書のログインキーチェーンのパスワードを保存

    🎉おめでとう
証明書をエクスポートしました。

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

Apple Developer Profiles

  1. 正しいチームをドロップダウンから選択 右上の自分の名前をクリック

  2. 使用するチームをクリック

    1. __CAPGO_KEEP_0__
    2. __CAPGO_KEEP_0__ Apple Developerのキー管理チームの選択
  3. 正しいページにいることを確認してください ページが次のようであれば問題ありません。そうでない場合は profiles にクリックしてください

    サイドバー

  4. Apple Developerのプロフィールページ + プロフィールを追加する ボタン

  5. Apple Developerのプロフィール追加ボタン App Store Connect プロフィールの種類を選択してください プロフィールの種類を Continue とクリックしてください

    ボタン

  6. Apple Developerのプロフィールの種類の選択

    __CAPGO_KEEP_0__をドロップダウンから選択し、ボタンをクリックしてください。 Continue __CAPGO_KEEP_1__

    Apple Developerでアプリを選択

  7. 正しい配布証明書を選択してください

    前ステップでエクスポートした証明書を選択し、ボタンをクリックしてください。 Continue Apple Developerで配布証明書を選択

    証明書を選択する際に不明な場合は、Keychain Accessに戻り、エクスポートした証明書を探してください。次に、有効期限を確認してください。

    配布証明書の有効期限

    プロファイルに名前を付けます。

  8. プロファイルに名前を付けます。ボタンをクリックしてください。

    __CAPGO_KEEP_0__は保護されたトークンです。 Generate __CAPGO_KEEP_1__は保護されたトークンです.

    Apple Developer名のプロフィール

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

    ダウンロードする Download button

    Apple Developer download profile

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

If all went well, you will see the following output:

Capgo CLI の資格情報を保存した出力

既に完了した場合は Team ID, Apple キー、Apple キー ID、Apple 発行者 ID, 証明書, と プロビジョニング プロファイル, すでに CI/CD に必要なすべてのものを持っています。 このセクションでは、GitHub Actions のシークレットと環境変数として値を渡す方法について説明します。

ターミナル ウィンドウ
# 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

In GitHub > Repository > Settings > Secrets and variables > Actions、を追加します

シークレット名
CAPGO_TOKENあなたのCapgoAPIトークン
APP_STORE_CONNECT_TEAM_IDチームID チームID
APPLE_KEY_IDキーアイディー AppleキーアイディーとApple発行者ID
APPLE_ISSUER_ID発行者ID Apple key、Apple key ID、および Apple issuer ID
BUILD_CERTIFICATE_BASE64Content of certificate_base64.txt
CAPGO_IOS_PROVISIONING_MAPCLI からコピーされたもの — 生成元 .capgo-credentials ファイル
APPLE_KEY_CONTENTContent of apple_key_base64.txt
P12_PASSWORD (任意)あなたの .p12 パスワード(エクスポート時に設定した場合)
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レビューに提出する

The normal App Store build path uploads the build to App Store Connect/TestFlight. If your CI release should also attach the processed TestFlight build to the App Store version and submit it for App Review, pass --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

This requires App Store Connect API key credentials (APPLE_KEY_ID, APPLE_ISSUER_ID, APPLE_KEY_CONTENT, と APP_STORE_CONNECT_TEAM_ID). App-specific password uploads and ad_hoc 配布はレビューにビルドを提出できない。 --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はiOSアプリをApp Store配布用にビルドします (TestFlight + App Store)。内部テストやCIアーティファクト収集用のアドホックビルドが必要な場合は、 --ios-distribution フラグ

アドホックモードを使用するとき

セクション「アドホックモードを使用するとき」
  • 直接登録済みデバイスにIPAを配布したい (テストフライトなし)
  • App Store ConnectのAPIキーを使用しない、または使用できない
  • ビルドアーティファクトを収集したい --output-upload App Storeに提出しない

アドホックビルドには 要件が少ない App Store ビルドよりも多くの機能を提供します:

資格情報必要か?
配布証明書 (.p12)Yes
アドホック プロビジョニング プロファイル (.mobileprovision)Yes
チーム ID (--apple-team-id)Yes
App Store Connect API キー (.p8)No
Apple Key ID / 発行者 IDNo

同じステップに従って プロビジョニング プロファイルが、ステップ 5 で Ad Hoc を選択するのではなく App Store:

  1. に移動して Apple Developer Profiles
  2. をクリックして + ボタン
  3. を選択する Ad Hoc and click 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

アドホックビルドを使用したCI/CD

セクション:アドホックビルドを使用したCI/CD

GitHubアクションの場合、App Storeビルドよりも少ないシークレットが必要です:

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

アプリに拡張機能が含まれる場合 (Multi-Target Signing)

Section titled “Apps with Extensions (Multi-Target Signing)”

If your app includes extensions (share extensions, widgets, notification service extensions, etc.), each extension target needs its own provisioning profile. Capgo supports this via the repeatable --ios-provisioning-profile App + 拡張機能

Example: App + Share Extension

ターミナル画面
__CAPGO_KEEP_0__
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 CLI:のバンドルIDに紐づくプロビジョニングプロファイルファイルをマップします。

  1. 各mobileprovisionファイルを読み取ります
  2. プロファイル名を埋め込まれたplistから自動で抽出します
  3. ファイルをBase64エンコードします
  4. すべてを1つの 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"

セクション:プロビジョニング プロファイルには XYZ 能力が含まれていません。

エラーが表示される場合があります。

コピー

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

__CAPGO_KEEP_0__は新しい機能を有効にしましたが、プロビジョニング プロファイルが作成された後です。 プロビジョニング プロファイルはまだ新しい機能を含んでいません。

この問題を解決するには、プロビジョニング プロファイルを再生成する必要があります。

  1. Open Apple Developer Portal
  2. チームを選択してください Apple Developer keys team selection
  3. Click on the Profiles button Apple Developer profiles button
  4. プロビジョニング プロファイルを再生成したいものを探してください Apple Developer find profile
  5. Click on the Edit button Apple Developerのプロファイルを編集
  6. Click on the Save Apple Developerのプロファイルを保存 Apple Developer save profile
  7. Apple Developerのプロファイルをダウンロード Download __CAPGO_KEEP_0__のネイティブビルド設定コマンドを再実行 新しくダウンロードしたプロファイルを使用してください。
  8. Re-run the Capgo Native Build setup command その他の問題

This should fix the issue.

Other issues

その他の問題

何らかの理由で、Capgoネイティブビルド、クレデンシャル設定、またはアプリのビルドに関して問題が発生している場合は、ご不明な点がございましたら、 サポート.

iOSビルドから続ける

iOSビルドから続ける

iOSビルドを使用してCI/CDの自動化を計画している場合、 __CAPGO_KEEP_0__ CI/CD を__CAPGO_KEEP_0__ CI/CDの製品ワークフローと接続してください。 Capgoネイティブビルド をCapgoネイティブビルドの製品ワークフローと接続してください。 Capgo Native Builds Capgo CI/CD for the product workflow in Capgo CI/CD, Capgo Native Builds for the product workflow in Capgo Native Builds. Capgo統合 Capgo統合の製品ワークフローについて CI/CD統合 CI/CD統合の実装詳細について GitHubアクション統合 GitHubアクション統合の実装詳細について