コンテンツにジャンプ

iOS ビルド

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

学習内容

学習内容
  • アプリをCapgoネイティブビルドでアップロードする方法を学びます。
  • Capgoネイティブビルドの証明書を設定する方法を学びます。

前提条件

前提条件
  • Capgoアカウント(無料試用版でも十分)
  • アプリがCapgoに登録されている(未登録の場合、run "if not"を実行してください) bunx @capgo/cli@latest app add もしない場合
  • Macが必要ない: Capgo iOSアプリをクラウドでコンパイルおよび署名するため、macOS、Windows、またはLinuxから実行できます。
  • Apple Developerアカウント ($99/年) (Apple Developerアカウントに管理者またはオーナーの権限が必要です)
  • アプリがXcodeでローカルにビルドされるか、またはCapgo Buildでビルドされることを確認してください
  • Capacitor アプリ
  • アプリの設定済みアイコン。アップロードするにはアイコンが必要です

Appleのポータルで開始する前

Appleのポータルで開始する前

Appleアカウントとチームが準備されていることを確認する前に、証明書を設定したり、最初のTestFlightアップロードをトリガーしたりする前に:

  • Appleアカウントに2要素認証を有効にします
  • 適切な会員種類を選択してください:
    • 個人/個人事業主:アプリストアでの販売者名として、法的個人名が使用されます
    • 組織:法的組織、D-U-N-S番号、公的企業ウェブサイト、企業ドメインのワークメール、Appleの契約に組織を縛る権限を持つ人物が必要です
  • Apple DeveloperとApp Store Connectにアクセスできるアカウントを使用してください。証明書、アプリレコード、APIキー、テストフライト
  • 最終的なバンドルIDを早期に固定してください。後で変更すると、アプリストア設定を再実行する必要があります
  • アプリレビュー前に、以下のApp Store Connectのアイテムを計画してください:サポートURL、プライバシーポリシーURL、年齢制限、スクリーンショット、輸出管理、そしてアプリレビュー連絡先
Apple Developerの登録を開始する Web上でAppleの登録を続ける Apple Developerのエンティティタイプを正しく選択する 登録後はApp Store Connect

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

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

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

配布用証明書の設定

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

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

    Xcode設定

  3. に移動 Accounts Apple Developer Accountに追加されたAppleアカウントを検索

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

  5. 配布用証明書の設定 Xcodeのチームを探す

  6. リストの Manage Certificates... ボタンをクリック Xcodeの証明書を管理

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

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

    1. リストの + ボタンをクリックし、 Apple Distribution Xcodeに証明書を追加
    2. 証明書は自動的に作成されます。リストで確認できます。前のステップを確認してみましょう。

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

手動ビルドをTestFlightに送信

セクション:手動ビルドをTestFlightに送信
  1. Xcodeでアプリを開く

    実行 bunx cap open ios コンテキスト:Xcodeでアプリを開く

  2. アプリをXcodeで開く archive 実行

    コンテキスト:Xcodeでアプリを開く product -> archive アプリをXcodeで開く。

    Xcodeツールバー

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

  4. ボタンをクリックしてください Distribute App ボタン

    Xcode配布ボタン

  5. 配布方法として TestFlight Internal Only Xcode TestFlight 内部のみの配布方法 Distribute ボタン

    アプリレコードを設定してください

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

    Name: アプリの名前 - App Storeで表示されます

    1. Xcodeの配布設定
    2. SKU - アプリのSKU - このSKUはApp Storeでアプリを識別するために使用されます
    3. 主な言語 - アプリの主な言語

    次に、 next ボタン

    Xcode TestFlightのアプリレコードを作成

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

  8. アップロードを待ってください

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

  10. 次に、 Done ボタン

アプリが正常にアップロードされたと信じてしまい、TestFlightでアプリを確認できるはずだと考えますが、まだいくつかの作業が残っています

  1. TestFlightに登録する
  2. 輸出管理に適合するので、ビルドがテスト可能になる
  3. App Store Connectの必要なメタデータを入力してください。例えば、サポートURL、プライバシーポリシーURL、年齢制限
  4. 実際にサポートしているデバイスに合ったスクリーンショットを用意する
  5. App Reviewの連絡先情報とテストクレデンシャルをプロダクション提出前に追加する

最初のステップは

  1. 「 アプリストア接続 」 ページに移動する

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

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

  4. ボタン Apps button 前のステップで作成したアプリを探してクリックしてください

  5. App Store Connectアプリの選択 App Store Connectテストフライトのボタン

  6. ボタン TestFlight button App Store Connectアプリの選択

  7. ボタン Internal Testers plus ボタン App Store Connect 内部テスターの追加ボタン

  8. グループを作成

    グループに名前を付けたい場合は、「内部」などと呼ぶことができます。何にでも名前を付けられます。

    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でテストフライトセクションを見つけてください。

  2. クリックしてください。 Builds -> iOS App Store ConnectでiOSビルドボタンをクリックしてください。

  3. 非準拠情報が含まれているビルドを見つけ、クリックしてください。 Manage App Store Connectでビルドを管理してください。

  4. アプリの説明を選択してください。

    私にとってはこれが正解です。 noneがもし違う場合、ご自身で判断してください。 次に、保存してください。

    App Store Connectで準拠情報を保存してください。

  5. アプリは「App Store Connectでテスト可能」になります。 ready to test

    2番目のステップについては、以下の手順を実行してください。

App Store ConnectでiOSビルドボタン

  1. 「開く」 Info.plist ファイル

  2. 以下のキーを追加します。

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

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

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

ここで、 ほぼ 実行可能

  1. テストフライトでアプリをテストする準備ができています。 その前に、以下のことを行う必要があります。 ダウンロード テストフライトアプリ
  2. iOS/iPadOSデバイスのApp Storeからアプリをダウンロード

アプリのテストに招待されたことを受け入れます

テストフライトアプリのインストール方法の詳細は省略します。アプリをインストールする方法がわからない場合は、Googleが提供しているガイドを参照してください。

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

  2. クリックして View in TestFlight ボタン テストフライトメールボタン

  3. iOS用ビルダーの設定 Install ボタン テストフライトインストールボタン

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

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

  5. インストール完了ボタンをクリックしてください

  6. iOS用ビルダーの設定 Open おめでとうございます 🎉 テストフライトにアプリをテストするための招待を承諾しました。__CAPGO_KEEP_0__ネイティブビルドを設定して、アプリをテストフライトにアップロードすることができます。

Capgoネイティブビルドの設定

CapgoでCapgoのネイティブビルドを設定する

「Capgoネイティブビルドの設定」

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

パラメーター説明
--platformビルドするプラットフォーム(ios)
--apple-team-idApple Developer Portalで見つけることができる アプリストアコネクト__CAPGO_KEEP_0__キーファイルのパス()
--apple-keyApp Store Connect API キーファイル (.p8 file)
--apple-key-idCapgoのApp Store Connect API キーのKey ID
--apple-issuer-id配布用証明書のパス(
--certificate__CAPGO_KEEP_0__.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から始めましょう。見つけるのはとても簡単です。

  1. いく に移動し、下にスクロール プロファイル

  2. iOS用のCapgoビルダー Team ID

    開発者アカウントのTeam IDの場所を探してください

Apple key、Apple key ID、Apple issuer IDのセクション

セクションのタイトルは「Apple key、Apple key ID、Apple issuer ID」

さて、Apple keyに進みましょう

  1. 行きましょう App Store Connectユーザーとアクセスページ

  2. ドロップダウンメニューで正しいチームを選択

    1. 右上の自分の名前をクリック
    2. 使用したいチームをクリック Apple Developerキーのチーム選択
  3. クリック Integrations ボタン App Store Connect統合ボタン

  4. 検索 issuer

    コピーするための copy App Store Connectのコピー用発行者 プラスボタンをクリックしてください

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

  6. ボタンをクリックしてください App manager App Store Connectのキー設定 Generate ボタン App Store Connectにキー名を追加し、アプリマネージャへのアクセスを設定し、ボタンを生成する

  7. キーIDを保存する

    App Store ConnectにキーIDをコピーする

  8. キーをダウンロードする

    App Store Connect ダウンロードキー

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

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

証明書をエクスポートする準備ができました。記憶しているように、このガイドの最初のステップの1つは、配布用証明書の設定でした。

しかし、アップルは、証明書をエクスポートする方法は、証明書を作成する方法とはかなり異なります 🙃 設定の説明に入りましょう:

  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 file

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

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

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

    • パスワードを入力せずにスキップする (簡単にすることをお勧めします): OK パスワードを入力せずにクリック
    • パスワードを設定: パスワードで証明書を保護したい場合は、ここでパスワードを設定できます。パスワード保護済み .p12 ファイルは完全にサポートされています。Capgo CLI では、パスワードを使用して提供するだけです。 --p12-password 証明書ファイルの名前を適切に選択してください

    ファイル形式を設定してください

  7. Macにログインする際に使用するパスワードを入力してください。

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

    Keychain Accessで証明書を保存する際のログインキーチェーンパスワードを入力してください。

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

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

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

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

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

  2. 右上の自分の名前をクリックしてください。

    1. プロビジョニングプロファイル
    2. をクリックしてください Apple Developerのチーム選択
  3. 正しいページにいることを確認してください これが見えなければ、 profiles サイドバーの

    Apple Developerのプロファイルページ

  4. をクリックしてください + ボタン Apple Developerのプロファイル追加ボタン

  5. プロファイルの種類を選択してください 選択して App Store Connect Apple Developerのプロファイルの種類を選択 Continue ボタン

    ボタン

  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 の資格情報の保存出力

「CI/CD の設定(GitHub Actions)」のセクション

CI/CD セットアップ(GitHub Actions)

チーム ID チームID, Apple key, Apple key ID, Apple issuer ID, 証明書, そして プロビジョニング プロファイルCI/CDの設定はすでに完了しています。 このセクションでは、GitHub Actionsシークレットと環境変数として値を渡す方法について説明します。

1) 単一のベース64文字のファイルに資格情報ファイルを変換してください。

1) 基本64に単一行の認証情報ファイルを変換する
1) 基本64に単一行の認証情報ファイルを変換する
# 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) リポジトリシークレットを作成する」

In GitHub > Repository > Settings > Secrets and variables > Actions, add:

シークレット名値
CAPGO_TOKENCapgo API のトークン
APP_STORE_CONNECT_TEAM_IDチームID キーアイデンティティ
APPLE_KEY_IDKey ID from Appleキーのキーアイデンティティと発行者ID
APPLE_ISSUER_ID発行者IDから Appleキー、AppleキーID、Apple発行者ID
BUILD_CERTIFICATE_BASE64内容は certificate_base64.txt
CAPGO_IOS_PROVISIONING_MAP生成元は CLI — 以下のコピー .capgo-credentials ファイル
APPLE_KEY_CONTENT内容は apple_key_base64.txt
P12_PASSWORD (任意)あなたの .p12 パスワードがエクスポート時に設定されている場合

3) GitHub Actionsワークフローで環境変数を使用する

セクション「3) GitHub Actionsワークフローで環境変数を使用する」
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 への提出

App Store の標準的なビルド パスは、ビルドを App Store Connect / TestFlight にアップロードします。CI リリースが、処理された TestFlight ビルドを App Store バージョンに接続して App Review に提出する場合、App Store Connect __CAPGO_KEEP_0__ キー認証情報を含めて --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)。アプリ固有のパスワードアップロードと ad_hoc 配布はレビュー用にビルドを提出できません。 --store-release-name App Store バージョンです。省略した場合、Capgo は MARKETING_VERSION Xcode プロジェクトから読み取ります。 --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配布用にビルドします (テストフライト + App Store)。アドホックビルドが必要な場合は (内部テストまたはCIアーティファクト収集)、 --ios-distribution フラグを使用できます。

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

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

アドホックビルドには iOSビルドの要件が少なくなります。 App Storeビルドよりも少ない要件です:

資格情報必要ですか?
配布証明書(.p12)はい
ページ/エリア: Capgoのソリューションマーケティングページ。役割: ショートUIラベルまたはナビゲーションアイテム。見つける場所: page solutions/beta-testing.astro。メッセージキー `solutions_beta_testing_compare_native_tf` (ソリューション ベータテスト 比較ネイティブ Tf)。.mobileprovision)はい
チーム ID (--apple-team-id)はい
App Store Connect API キー (.p8)チームID(
Apple Key ID / Issuer IDNo

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

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

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

  1. App Store に移動してください
  2. クリックして + ボタンをクリックしてください
  3. 選択 アドホック 続けてクリック
  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アクションの場合、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)

「拡張機能を含むアプリ (Multi-Target Signing)」のセクション

アプリに拡張機能 (共有拡張機能、ウィジェット、通知サービス拡張機能など) が含まれている場合、各拡張機能のターゲットには独自のプロビジョニングプロファイルが必要です。Capgoは、この機能を繰り返し使用することでサポートしています。 --ios-provisioning-profile flag.

「例:アプリ + 共有拡張機能」セクション

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:

  1. 各モバイルプロビジョニングファイルを読み取ります
  2. プロファイル名を埋め込まれたplistから自動で抽出します
  3. ファイルをBase64でエンコードします
  4. すべてを単一の CAPGO_IOS_PROVISIONING_MAP 資格情報として保存します

以前は「Single Profile」を使用していました BUILD_PROVISION_PROFILE_BASE64 「Single Profile」を使用していました場合、以下のコマンドを実行してください

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

既存のシングルプロファイルの資格情報を新しい形式に変換し、レガシーキーを削除します CAPGO_IOS_PROVISIONING_MAP 「レガシーキー」(BUILD_PROVISION_PROFILE_BASE64, APPLE_PROFILE_NAME).

マイグレーション後、拡張プロファイルを次のコマンドで追加します update コマンド (additive merge):

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

プロビジョニング プロファイルには、XYZ機能が含まれていません。

エラーが発生する場合があります。

Section titled “”

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

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

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

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

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

その他の問題

「その他の問題」

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

iOSビルドから続けて

「iOSビルドから続けて」

iOSビルドを使用してCI/CDの自動化を計画している場合、__CAPGO_KEEP_0__ CI/CD iOS ビルド の製品ワークフローに__CAPGO_KEEP_0__ネイティブビルドを接続してください Capgo CI/CD Capgoネイティブビルド Capgo CI/CD Capgo製品のワークフローにおけるCapgoネイティブビルド Capgo統合 Capgo製品のワークフローにおけるCapgo統合 CI/CD統合 Capgo製品の実装詳細におけるCI/CD統合のため GitHub アクション統合 Capgoの実装詳細については、GitHub アクション統合。