メニューに進む

iOS ビルド

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

  • Capgoネイティブビルドを使用してアプリをアップロードする方法を学びます。
  • Capgoネイティブビルドの証明書を設定する方法を学びます。
  • Capgoアカウント (無料試用版でも十分です)
  • Capgoにアプリが既に登録されている (run bunx @capgo/cli@latest app add アプリがまだ登録されていない場合は
  • 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で正常にビルドできる
  • A Capacitor app
  • アプリの設定済みアイコン。アイコンが設定されていないアプリはApp Storeにアップロードできません。

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

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

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

  • 2要素認証を有効にして、Apple Accountを使用して登録する
  • 正しい会員種類を選択してください:
    • 個人/個人の経営者: 法的個人名がアプリストアでの販売者名になります
    • 組織: 法的組織、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 に関連するビルドプロセスの問題をすべて解決できます。

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

ディストリビューション証明書の設定

「ディストリビューション証明書の設定」のセクション
  1. Xcodeを開く

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

    Xcode設定

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

  4. 選択されたAppleアカウント Xcodeアカウント

  5. アプリをデプロイするために使用するチームを探してください Xcodeでチームを検索

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

  7. 証明書をリストで確認してください Xcodeで配布用証明書

  8. リストで配布用証明書が見つからない場合、新しい証明書を作成する必要があります

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

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

セクションタイトル “Manual build to TestFlight”

Xcodeでアプリを開く
  1. 実行

    Xcodeでアプリを開く。 bunx cap open ios Xcodeツールバーで

  2. ボタン archive Xcodeツールバーで

    ボタン product -> archive iOS用ビルダーの設定

    Xcodeツールバー

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

  4. Xcodeの Distribute App ボタン

    Xcodeの配布ボタン

  5. 配布方法として TestFlight Internal Only ボタン Distribute Xcodeのテストフライトの内部配布方法

    アプリのレコードを設定

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

    Xcodeのツールバー

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

    次に、 next ボタン

    Xcode TestFlight configure app record

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

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

  9. 全てがうまくいった場合は、以下の画面が表示されるはずです Xcode TestFlight upload complete

  10. ボタン Done __CAPGO_KEEP_0__

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

  1. TestFlightに自分を追加する
  2. 出荷の準備が整うまでのビルドをテストできるようにする
  3. App Store Connectの必要なメタデータを埋めます。例えば、サポートURL、プライバシーポリシーURL、年齢制限など
  4. 対応するデバイスのスクリーンショットを用意する
  5. App Reviewの連絡先情報とテストクレデンシャルを追加する

まず最初のステップに進みましょう

TestFlightに自分を追加する

TestFlightに自分を追加する
  1. App Store Connect App Store Connect App Store Connect App Store Connectログインページ

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

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

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

  5. App Store Connectアプリ選択 ボタン

  6. App Store Connectテストフライトボタン TestFlight __CAPGO_KEEP_0__ __CAPGO_KEEP_1__

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

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

    グループの名前は「内部」にしたいです。任意の名前を付けられます。

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

  9. ボタン Invite testers App Store Connectのテスターに招待するボタン グループに自分自身を追加する

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

    ボタンをクリックしてください。 Add button.

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

  11. グループに追加されていることを確認してください

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

    App Store Connectのテスターの確認

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

現在、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. アプリは「App Store Connect テスト用に準備完了」と表示されるはずです ready to test

    App Store Connect ready to test

2 番目の場合の手順はこちらです:

  1. ファイルを開く Info.plist ファイル

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

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

TestFlight アプリのインストールと招待の受付

TestFlight アプリのインストールと招待の受付の手順

今、 __CAPGO_KEEP_0__ テスト用のアプリをテストフライトでテストする準備ができました。

  1. 以下の手順を実行する必要があります。 テストフライトアプリ iOS/iPadOSデバイスでApp Storeからダウンロードする
  2. アプリをテストするための招待を受け入れる

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

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

  1. Appleから届いたメールを開き、招待を受け入れるためのリンクをクリックする

  2. ボタン View in TestFlight ボタン テストフライトメールボタン

  3. クリックしてください Install ボタン テストフライトインストールボタン

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

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

  5. ボタンをクリックしてください

  6. ボタンをクリックしてください 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 CLI に渡すもののリストを示します。

パラメーター説明
--platformビルドするプラットフォーム (ios)
--apple-team-idApple 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__ キーのキーアイデンティティ
--apple-key-idThe Key ID of your App Store Connect API Key
--apple-issuer-id__CAPGO_KEEP_0__
--certificateiOS向けのディストリビューション証明書のパス(.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. Apple Developer Accountに移動してください __CAPGO_KEEP_0__ とスクロールしてください

  2. を探してください Team ID

    開発者アカウントの

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

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

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

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

  4. iOS用ビルダーの設定 issuer

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

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

  6. __CAPGO_KEEP_0__ App managerGenerate ボタン App Store Connectに追加するキー名を設定し、アプリマネージャへのアクセスを許可し、ボタン

  7. キーIDを保存

    キーをダウンロード

  8. 注意

    App Store Connect ダウンロードキー

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

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

証明書

証明書

今、証明書をエクスポートする準備ができました。

しかし、Appleは、証明書をエクスポートする方法は、証明書を作成する方法とはまったく異なります。

  1. Keychain Accessを開きます

    1. をクリックして検索バーを開きます Command + Space で検索します
    2. をクリックして検索結果を開きます Keychain Access
    3. アプリ Keychain Access macOSで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 ボタン

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

  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 パスワードを入力せずにスキップする (簡単にすることを推奨): クリック

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

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

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

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

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

プロビジョニングプロファイルのセクション

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

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

    1. 右上隅のあなたの名前をクリックしてください
    2. 使用するチームをクリックしてください Apple Developerのチーム選択
  3. 正しいページにいることを確認してください これが見えなければ、 profiles サイドバー

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

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

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

    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 のクレデンシャルを保存した出力

CI/CD setup (GitHub Actions)

CI/CD設定(GitHub Actions)

「CI/CD設定(__CAPGO_KEEP_0__ Actions)」というセクション Team ID, Apple key, Apple key ID and Apple issuer ID, Certificate, and Provisioning profile, you already have everything needed for CI/CD. This section only covers how to pass those values as GitHub Actions secrets and environment variables.

1) Credentialファイルをシングルライン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) リポジトリシークレットを作成します。」

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

シークレット名
CAPGO_TOKENあなたのCapgoAPIトークン
APP_STORE_CONNECT_TEAM_IDチームID チームID
APPLE_KEY_IDキーID Apple key, Apple key ID, and Apple issuer ID
APPLE_ISSUER_IDApple key ID から Apple key, Apple key ID, and Apple issuer ID
BUILD_CERTIFICATE_BASE64ファイルの内容 certificate_base64.txt
CAPGO_IOS_PROVISIONING_MAPCLI によって生成されます — 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 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_IDApp Storeにアップロードするためのアプリ固有のパスワードと ad_hoc 配布はレビュー用にビルドを提出することができません。 --store-release-name App Storeバージョンです。省略した場合、CapgoはXcodeプロジェクトから読み取ります。 MARKETING_VERSION from the Xcode project. --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のレビュー提出には必要ありませんが、外部ベータ版の配布はまだ利用可能です。

内部テストまたはCIアーティファクト収集用にアドホックビルドが必要な場合は、

代わりに使用できます。

By default, Capgo builds iOS apps for App Store distribution (TestFlight + App Store). If you need ad-hoc builds instead (for internal testing or CI artifact collection), you can use the --ios-distribution 注意

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

アドホックモードを使用するときはどの時ですか
  • アドホックモードを使用するとき
  • You don’t have or don’t want to use an App Store Connect API key
  • App Store ConnectのCapgoキーを使用したくない --output-upload ビルドアーティファクトを収集したい

App Storeに提出しない

要件

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

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

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

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

同じ手順を プロビジョニングプロファイルアドホックプロビジョニングプロファイル の代わりに App Store に移動:

  1. Apple Developer Profiles をクリック
  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

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

/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 例: アプリ + 共有拡張機能

ターミナル画面
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 資格情報として保存します

以前はシングルプロファイルを使用していました 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機能が含まれていません。

__CAPGO_KEEP_0__

時々、次のエラーが表示される場合があります。

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 Apple Developer プロファイルのボタン 再生成したいプロビジョニング プロファイルを探す
  4. protectedTokens 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_KEEP_0__ CI/CD をCapgo CI/CDの製品ワークフローと接続してください。 Capgo CI/CD Capgo Native Builds Capgo Native Buildsの製品ワークフロー向け Capgo Integrations Capgo Integrationsの製品ワークフロー向け CI/CD統合 CI/CD統合の実装詳細について GitHub Actions Integration GitHub Actions Integrationの実装詳細について