iOS ビルド

インストール

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

学びたいこと

Capgoネイティブビルドを使用してアプリをアップロードする方法を学びます。
Capgoネイティブビルドの証明書を設定する方法を学びます。

前提条件

Capgoアカウント (無料試用版でも十分です)
Capgoにアプリが既に登録されている (run)、(なければ) bunx @capgo/cli@latest app add if not)
A Mac computer with Xcode installed (it’s possible to setup the build on a linux/windows machine, but it’s not yet documented)
有効なApple Developerアカウント（$99/年）(Apple Developerアカウントに管理者またはオーナーの権限が必要)
アプリがXcodeで正常にビルドできること
Capacitorアプリ
アプリにアイコンが設定されていること。アイコンが設定されていないアプリはApp Storeにアップロードできない。

Appleのポータルで始める前に

Appleアカウントとチームが準備できていることを確認してから、証明書を設定したり、最初のTestFlightアップロードをトリガーしたりしません。

2要素認証をAppleアカウントに有効にしてください。
正しい会員種類を選択してください:
- 個人/個人の経営者: 法的個人名はアプリストアでの販売者名になります。
- 組織: 法的組織、D-U-N-S番号、公的企業ウェブサイト、企業ドメインのメールアドレス、そしてAppleの契約に組織を縛る権限を持つ人物が必要です。
Apple DeveloperとApp Store Connectにアクセスできるアカウントを使用してください。証明書、アプリレコード、APIキー、そしてテストフライトに。
最終的なバンドルIDを早めに固定してください。後で変更する場合、通常はApp Storeの設定を再度実行する必要があります。
App Review前に準備する必要があるApp Store Connectのアイテムを計画してください。サポートURL、プライバシーポリシーURL、年齢制限、スクリーンショット、輸出管理、そしてApp Reviewの連絡先情報。

手動でこれらの作業を行う必要はありません。 Capgo のインストールでは、iOS の署名資格情報 (配布証明書 + プロビジョニングプロファイル) を自動的に作成および構成します。これは推奨されるパスです:

bunx @capgo/cli@latest build init --platform ios

手動のウォークスルーは、インストールを自分で設定したい、または Capgo の内部動作を完全に理解したい人向けです。

最初の手動ビルド

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

署名資格情報の設定をローカルマシンに実施します
App Store のレコードを作成する必要があります (まだ作成していない場合)
アプリケーション code に関連するビルドプロセスの問題をすべて解決できます。

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

配布用証明書の設定

Xcodeを開く
クリック Xcode -> Settings... ショートカットを使用することもできます Cmd + ,
Xcode設定画面に移動 Accounts
選択されたAppleアカウント
アプリをデプロイするチームを探してください
ボタンをクリックしてください Manage Certificates... ボタン
リストに配布用証明書が表示されることを確認してください
リストに表示されていない場合は、新しい証明書を作成する必要があります

Appleは配布用証明書の数に制限があります。3つ以上の証明書がある場合は、1つを削除して新しい証明書を作成する必要があります。このチュートリアルではその方法については説明しません。
1. ボタン + ボタンを押してから Apple Distribution
2. 証明書は自動的に作成されます。リストで確認してください。前のステップを確認して、リストに表示されていることを確認してください。

ディストリビューション証明書をインストールしたので、ビルドプロセスを開始できます。

セクション「マニュアルビルドをテストフライト」

実行

Xcodeでアプリを開く bunx cap open ios Xcodeのツールバーで
ボタン archive Xcodeのツールバーで

セクション「マニュアルビルドをテストフライト」 product -> archive iOS用ビルダーの設定
ビルドを完了するのを待ってください
ボタンをクリックしてください Distribute App ボタン
配布方法として TestFlight Internal Only ボタンをクリックしてください Distribute XcodeのTestFlightの内部配布方法
以下のフィールドを入力してください:

__CAPGO_KEEP_0__
1. Name: アプリ名 - App Storeで表示されるアプリ名
2. SKU - アプリのSKU - App Storeでアプリを識別するために使用される
3. The primary language - アプリの主な言語
次に、 next ボタン
アプリレコードの作成が失敗した場合は、ウィンドウを閉じてアプリを再度アーカイブしてみてください。
アップロードを待ってください
全てがうまくいったら、以下の画面が表示されるはずです
ボタン Done __CAPGO_KEEP_0__

あなたは、すべてがうまくいっているように思うかもしれませんが、TestFlightでアプリを確認できるようになるのはまだまだ先です。

TestFlightに自分を追加する
テスト可能なビルドになるように、輸出管理を完了する
App Store Connectの必要なメタデータを入力する（サポートURL、プライバシーポリシーURL、年齢制限など）
コンテキスト：解決策ページのアプリ例セクション。役割：短いUIラベルまたはナビゲーションアイテム。見られる場所：コンポーネント解決策/解決策アプリ例.astro。メッセージキー `solution_app_examples_rating` (解決策アプリ例の評価)。
実際にサポートしているデバイスに合ったスクリーンショットを用意する

生産提出前にApp Reviewの連絡先情報とテストクレデンシャルを追加する

では最初のステップから始めましょう。

「TestFlightに自分を追加する」のセクション App Store Connectのページ
Apple Developerアカウントでサインイン
アプリレコードを作成したときに使用したチームを選択してください。1つの開発者アカウントのみの場合は、このステップをスキップできます。
ボタン Apps App Store Connectアプリのボタン
App Store Connectアプリの選択
App Store Connectテストフライトのボタン TestFlight __CAPGO_KEEP_0__
App Store Connectの内部テスト者プラスボタンをクリックしてください。 Internal Testers plus ボタン
グループを作成する

グループに名前を付けるのを好きにしてください。私はグループに「内部」という名前を付けます。
ボタン Invite testers App Store Connectのテスターを招待するボタン
リストの中で自分自身を見つけ、自分の名前の横のチェックボックスを選択してください。自分自身が表示されない場合はページを更新してください。

ボタン Add __CAPGO_KEEP_0__
グループに追加されていることを確認してください

グループに自分自身が表示されるようになりました

おめでとうございます 🎉 TestFlightに自分自身を追加しました。ただ、Capgo Native Buildを設定する前に、最後のステップがあります。

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

現在、Appleにアプリが標準以外の暗号化（カスタムアルゴリズムなど）を使用していないことを約束する必要があります。アプリが標準以外の暗号化を使用している場合、以下のドキュメントを参照してください。 Appleのドキュメントこの方法についての説明があります。この方法で実行することができます。

手動で毎回アプリをビルドすることによって実行することができます。
plistファイルを設定して、この値を自動的に設定することができます。 false.

はじめに、最初のものを始めましょう:

前のセクションからすべてのステップを実行し、App Store ConnectでTestFlightセクションを見つけてください
クリックしてください Builds -> iOS
非準拠情報が含まれているビルドを見つけ、クリックしてください Manage
アプリの説明を選択してください

私にとっては noneがちょうどいいかもしれませんが、あなたの場合は違うかもしれません。次に、保存してください
アプリは、 ready to test

2番目のものについては、以下の手順があります。

Open the Info.plist file

file

<key>ITSAppUsesNonExemptEncryption</key>
<false/>

Copy to clipboard

は、Appleの公式ドキュメントで、暗号化の輸出規制への適合性をAppleに知らせる方法について説明しています。

さて、 あと少し あなたはTestFlightでアプリをテストする準備ができています。まず、以下のことを実行してください:

TestFlightアプリ App StoreからiOS/iPadOSデバイスでダウンロードするアプリをテストするための招待を受け入れる
TestFlightアプリをインストールする方法の詳細については説明しません。アプリをインストールする方法がわからない場合は、Googleが提供しているガイドを参照してください。

招待を受け入れる方法については、Appleからメールが届き、招待を受け入れるためのリンクが含まれています。

Appleから招待を受け入れるためのリンクが含まれているメールを開く

招待を受け入れる
ボタン View in TestFlight クリックする
ボタンをクリックしてください Install ボタン
あなたのデバイスにアプリをインストールする

あなたがXcodeを使用してアプリをインストールしたことがある場合、以下の画面が表示されます。ボタンをクリックしてください。 install テストフライトインストールアプリ
ボタンをクリックしてください
ボタンをクリックしてください Open おめでとうございます 🎉 あなたはテストフライトへの招待を承諾しました。__CAPGO_KEEP_0__ Native Buildを設定して、アプリをテストフライトに送信することができます。

Congratulations 🎉 You have accepted the invitation to test your app in TestFlight. Now, you can configure Capgo Native Build to build and submit your app to TestFlight.

Capgo Native ビルドの設定

Capgo Native ビルドでアプリをビルドしてテストフライトに提出できるようにするには、いくつかの設定を変更する必要があります。ここでは、Capgo CLI に渡すもののリストを示します。

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

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

Apple Developer Accountに移動してください context:/ja/docs/builder/ios/ とスクロールしてください
開発者アカウントで Team ID

Appleキー、AppleキーID、Apple発行者ID

ここで、Appleキーについて説明します。

Go to App Store Connectユーザーとアクセスページ

リンクが機能しない場合、再読み込みしてください。
正しいチームをドロップダウンから選択してください
1. 右上の自分の名前をクリックしてください
2. 使用したいチームをクリックしてください
クリックしてください Integrations ボタン
iOS用ビルダー issuer

This 保存しておく必要があります これは後で必要になるため

ボタンをクリックして発行者をコピーする copy App Store Connectの発行者をコピーする
App Store Connectのキーを追加する
__CAPGO_KEEP_0__ App manager と Generate ボタン
キーIDを保存

これ 保存しておく必要があります - 後で必要になります App Store ConnectからキーIDをコピー
注意

この 保存しておく必要があります これは後で必要になるため

誰にも共有しないでください - CAPGO CLI 内でしか使用しないでください

おめでとうございます 🎉 Apple キー、Apple キー ID、Apple 発行者 ID を作成しました

証明書

はじめに、証明書をエクスポートする準備ができました。これらのガイドの最初のステップの 1 つとして、配布証明書を設定しましたことを思い出してください。

しかし、Appleは、証明書をエクスポートする方法は、証明書を作成する方法とはまったく異なります。これは、Appleの無限の知恵のうちの 1 つです。では、設定を始めましょう:

Keychain Accessを開く
1. クリック Command + Space 検索バーを開く
2. 検索 Keychain Access
3. 検索結果から Keychain Access アプリ
カテゴリを選択し、ボタンをクリック login __CAPGO_KEEP_0__ My Certificates __CAPGO_KEEP_0__
リストで証明書を探してください

証明書の名前は Apple Distribution: [Your Name/Company] (your team ID)
証明書に右クリックして Export
証明書を保存してください .p12 ファイル

これ 保存する必要があります - その後必要になります
1. 証明書ファイルの名前を適切に選択してください
2. ファイル形式が次のようになっていることを確認してください Personal Information Exchange (.p12)
3. ボタンをクリックしてください Save ボタン
パスワードを求められますが、次のいずれかを選択できます
- パスワードを入力せずにスキップする (簡単にすることを推奨): クリック OK パスワードを入力せずにスキップ
- パスワードを設定する: パスワードを設定すると、証明書を保護できます。パスワード保護されたファイルは、完全に __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ でサポートされています。ただし、パスワードを使用するには、構成コマンドを実行する際にオプションを指定する必要があります。 .p12 files are fully supported by the Capgo CLI - just provide the password using the --p12-password パスワードを設定する: パスワードを設定すると、証明書を保護できます。パスワード保護されたファイルは、完全に {0} {1} でサポートされています。ただし、パスワードを使用するには、構成コマンドを実行する際にオプションを指定する必要があります。
Macにログインする際に使用するパスワードを入力してください

Macにログインする際に使用するパスワードを入力してください。次に、ボタンをクリックしてください。 Allow ボタン

🎉おめでとうございます証明書をエクスポートしました

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

Appleから必要な最後のものを取得するために、プロビジョニングプロファイルをエクスポートする準備ができました

Apple Developer Profiles 正しいチームをドロップダウンから選択してください
プロビジョニングプロファイル
1. 右上隅のあなたの名前をクリックしてください
2. 使用するチームをクリックしてください
正しいページにいることを確認してくださいこれが見えなければ、ここをクリックしてください profiles サイドバー
プロファイルをクリックしてください + ボタン
プロファイルのタイプを選択してください選択して App Store Connect ボタン Continue Apple Developerのプロファイル追加ボタン
ビルドしたいアプリを選択

ドロップダウンからアプリを探し、ボタンをクリック Continue ボタン
正しい配布証明書を選択

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

配布証明書の有効期限がわからない場合は、Keychain Accessに戻り、前ステップでエクスポートした証明書を探し、有効期限を確認
プロファイルの名前を設定

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

プロファイル名は、自動的にCapgo CLIによって抽出されます。覚える必要はありません。
プロファイルをダウンロードする

ボタンをクリックしてプロファイルをダウンロードしてください。 Download 注意

iOS向けのプロファイルをダウンロードする 保存する必要があります 後で必要になるため、保存しておいてください

おめでとうございます 🎉 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 のクレデンシャルを保存した出力

CI/CD setup (GitHub Actions)

「CI/CD設定（__CAPGO_KEEP_0__ Actions）」というセクションチームID, Apple キー、Apple キー ID、Apple 発行者 ID, 証明書, そしてプロビジョニングプロファイル, you already have everything needed for CI/CD. This section only covers how to pass those values as GitHub Actions secrets and environment variables.

CI/CD 用にすでに必要なすべてのものを持っています。このセクションでは、値を __CAPGO_KEEP_0__ 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

2) Create repository secrets

Section titled “2) Create repository secrets” GitHub > Repository > Settings > Secrets and variables > Actions2) リポジトリシークレットを作成するセクション

In	In
`CAPGO_TOKEN`	Your Capgo API token
`APP_STORE_CONNECT_TEAM_ID`	シークレット名 Value
`APPLE_KEY_ID`	値 Apple key, Apple key ID, and Apple issuer ID
`APPLE_ISSUER_ID`	Issuer ID from Apple key, Apple key ID, and Apple issuer ID
`BUILD_CERTIFICATE_BASE64`	Content of `certificate_base64.txt`
`CAPGO_IOS_PROVISIONING_MAP`	Generated by CLI — copy from `.capgo-credentials` file
`APPLE_KEY_CONTENT`	Content of `apple_key_base64.txt`
`P12_PASSWORD` Your	password if set during export `.p12` 3) __CAPGO_KEEP_0__ Actions workflowで環境変数を使用する

Section titled “3) GitHub Actions workflowで環境変数を使用する”

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 ビルドパスは、ビルドを 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

This requires App Store Connect API key credentials (APPLE_KEY_ID, APPLE_ISSUER_ID, APPLE_KEY_CONTENTApp Store へのアップロードと配布は、ビルドを App Review に提出することはできません。 APP_STORE_CONNECT_TEAM_IDApp Store バージョンです。 __CAPGO_KEEP_0__ が省略された場合、Xcode プロジェクトから読み取られます。 ad_hoc App Store への提出 --store-release-name is the App Store version; if omitted, Capgo reads MARKETING_VERSION App Store への提出 --store-release-notes App Storeのデフォルトの「What’s New」テキストであり、各 --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 フラグを使用できます。

モードのみをサポートしています。

アドホックモードを使用するときはどの時ですか
You don’t have or don’t want to use an App Store Connect API key
App Store Connect__CAPGO_KEEP_0__キーを使用しない --output-upload App Storeに提出しない

ビルドアーティファクトを収集したい

アドホックビルドは App Store ビルドよりも 少ない要件があります:

資格情報	必要ですか?
配布証明書（`.p12`)	はい
アドホックプロビジョニングプロファイル（`.mobileprovision`)	はい
チームID（`--apple-team-id`)	はい
App Store Connect API キー（`.p8`)	なし
Apple Key ID / Issuer ID	なし

アドホックプロビジョニングプロファイルの作成

同じ手順をプロビジョニングプロファイルコンテキスト: Capgo Builder / ネイティブクラウドビルド製品ページ。役割: 短いUIラベルまたはナビゲーションアイテム。見られる場所: native-build.astro ですが、ステップ5で アドホック の代わりに:

App Store Apple Developer Profilesに移動
クリック + ボタン
選択 アドホック 続けてクリックしてください
アプリと配布証明書を選択してください
登録したいデバイスを選択してください
プロファイルの名前とダウンロード

アドホックのクレデンシャルを保存

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 とアドホックビルド

For GitHub Actions, you need fewer secrets than App Store builds:

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）」

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 Copy to clipboard

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 フラグは、バンドルIDをプロビジョニングプロファイルファイルにマップします。 CLI:

各モバイルプロビジョニングファイルを読みます
プロファイル名を埋め込まれたplistから自動で抽出します
ファイルをBase64でエンコードします
すべてを単一の 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 Cloudflare

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')"

この問題は、プロビジョニングプロファイルが作成された後、新しい機能を有効にしたためです。

古いプロビジョニングプロファイルにはまだ新しい機能が含まれていないためです。

この問題を解決するには、プロビジョニングプロファイルを再生成する必要があります。 Open
Apple Developer Portal
Apple Developer keys team selection Profiles ボタンをクリック
再生成したいプロビジョニングプロファイルを探してください
ボタンをクリック Edit ボタン
ボタンをクリック Save ボタン
ボタンをクリック Download ボタン
再度Capgoネイティブビルド設定コマンドを実行新しくダウンロードしたプロフィールで実行してください

この問題は解決するはずです。

その他の問題

あなたが Capgo Native Build、クレデンシャル設定、またはアプリのビルドに関して何らかの理由で問題を抱えている場合、Capgo Native Build の設定やクレデンシャル設定、またはアプリのビルドに関してのサポートにご連絡ください。サポート.

iOS Builds から続けてください。

あなたが使用しているのは iOS Builds __CAPGO_KEEP_0__ CI/CD Capgo CI/CD Capgo CI/CD Capgo Native Builds for the product workflow in Capgo Native Builds, Capgo Integrations for the product workflow in Capgo Integrations, CI/CD統合 CI/CD統合の実装詳細について GitHub Actions Integration for the implementation detail in GitHub Actions Integration.