メニューに進む

iOS ビルド

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

What you will learn

学びたいこと
  • Capgo Native Buildを使用してアプリをアップロードする方法を学びます。
  • Capgo Native Buildの証明書を設定する方法を学びます。

必要なもの

必要なもの
  • Capgoアカウント(無料試用版でも十分です)
  • アプリがCapgoに登録されている(登録されていない場合は実行してください) bunx @capgo/cli@latest app add MacコンピューターとXcodeがインストールされている(Linux/Windowsマシンでビルドを設定することも可能ですが、まだドキュメントが公開されていません)
  • Apple Developerアカウント($99/年)が有効なもの(Apple Developerアカウントの管理者またはオーナー権限が必要)
  • __CAPGO_KEEP_0__
  • アプリは、Xcodeを介して正常にビルドできる必要があります
  • Capacitorアプリ
  • アプリの設定済みアイコン。アイコンがなければApp Storeにアップロードすることができません

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

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

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

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

Before we can start thinking about building the app with Capgo, we should first set it up, and do a first TestFlight build by hand. There are some advantages to doing a manual build first:

  • You will setup the distribution certificate on your local machine
  • You will create the App Store record if you haven’t done it yet
  • You will be able to figure out any issues with the build process linked to your app code

Before we can begin, you must have the distribution certificate installed on your local machine. This is quite a bit complex, but I will explain it below.

配布用証明書の設定

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

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

    Xcodeの設定

  3. 設定を開く Accounts Xcodeのアカウントタブを開く

  4. Apple Developerアカウントに追加されたAppleアカウントを探す 選択したAppleアカウントの詳細

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

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

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

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

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

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

Manual build to TestFlight

Manual build to TestFlight
  1. Xcodeでアプリを開きます。

    Run bunx cap open ios Xcodeのツールバーで

  2. button archive Xcodeのツールバーで

    button product -> archive Xcodeのツールバー

    Xcodeのツールバー

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

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

    Xcode配布ボタン

  5. 以下の項目を選択してください TestFlight Internal Only 配布方法として「Xcode TestFlight 内部のみ」にチェックを入れてください Distribute ボタン

    Xcode TestFlight 内部のみ配布方法

  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 ConnectApp Store Connect

  2. ページに移動してください。

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

  4. __CAPGO_KEEP_1__をクリックしてください。 Apps __CAPGO_KEEP_2__ __CAPGO_KEEP_2__アプリの表示

  5. __CAPGO_KEEP_0__をクリックしてください。 __CAPGO_KEEP_2__

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

  7. __CAPGO_KEEP_1__をクリックしてください. Internal Testers plus __CAPGO_KEEP_2__テストフライトの選択 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のドキュメント 非標準暗号化を使用していないことを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. __CAPGO_KEEP_0__を追加してください

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

TestFlightアプリのインストールと招待の受け入れ

セクション「TestFlightアプリのインストールと招待の受け入れ」

ここであなたは ほぼ テストフライトでアプリをテストする準備ができました。 まず、以下のことを実行する必要があります:

  1. Capgoで テストフライトアプリ iOS/iPadOSデバイスのApp Storeからダウンロードする
  2. アプリをテストするための招待を受け入れる

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

Appleから招待を受け入れるためのメールを受け取る

  1. Appleから招待を受け入れるためのメールを開く

  2. ボタン View in TestFlight 招待を受け入れるためのメール ボタン

  3. テストフライトの招待を受け入れる Install ボタン TestFlight インストールボタン

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

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

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

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

Capgo Native Buildの設定

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

Capgo

TestFlightにアプリを送信するには、Capgo Native Buildを設定する必要があります。 ここでは、Capgo CLIに渡す必要があるもののリストを示します。

パラメーター説明
--platformビルドするプラットフォーム (ios)
--apple-team-idApple Developer Team ID (Apple Developer Portalで見つけることができます Apple Developer Portal)
--apple-keyApp Store Connect API Keyファイルのパス (.p8 ファイル
--apple-key-idApp Store Connect API KeyのKey ID
--apple-issuer-idApp Store Connect発行者ID
--certificate配布用証明書のパス (.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 に移動し 下にスクロール

  2. 見つける Team ID

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

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

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

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

  1. App Store Connectユーザーとアクセスページに移動してください 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

    __CAPGO_KEEP_1__ボタンをクリックして、発行者をコピー copy App Store Connectの発行者をコピー __CAPGO_KEEP_2__ボタンをクリックして、キーを追加

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

  6. __CAPGO_KEEP_3__ボタンをクリックして App manager __CAPGO_KEEP_4__ボタンをクリックしてください Generate __CAPGO_KEEP_5__ボタンをクリックしてください 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. __CAPGO_KEEP_0__ Command + Space Keychain Accessを開く
    2. をクリックして検索バーを開きます Keychain Access
    3. を検索 Keychain Access をクリックして
  2. Keychain AccessをmacOSで開くデモ login を選択して My Certificates カテゴリとをクリックして ボタン

  3. Keychain Accessログインカテゴリで検索

    証明書の名前は 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 option

    configuration command

  7. button

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

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

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

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

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

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

  1. Apple Developer Profiles チームのドロップダウンで正しいチームを選択

  2. 右上の自分の名前をクリック

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

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

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

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

    Apple Developerのアプリを選択してください

  6. build

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

    Apple Developerでアプリを選択

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

    __CAPGO_KEEP_0__ Continue Apple Developerで配布証明書を選択

    不明な場合は、Keychain Accessに戻って、前のステップでエクスポートした証明書を探してください。次に、有効期限を確認してください。

    __CAPGO_KEEP_0__

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

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

    __CAPGO_KEEP_0__ Generate __CAPGO_KEEP_0__

    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

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

Capgo CLI の資格情報を保存する出力

既にチーム ID、Apple キー、Apple キー ID、Apple 発行者 ID を入力した場合は、 チーム 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

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

シークレット名
CAPGO_TOKENあなたの Capgo API トークン
APP_STORE_CONNECT_TEAM_IDチームID チームID
APPLE_KEY_IDキーアイディ Appleキーアイディ、Appleキーアイディ、Apple発行者ID
APPLE_ISSUER_ID発行者ID Apple key, Apple key ID and Apple issuer ID
BUILD_CERTIFICATE_BASE64コンテンツ certificate_base64.txt
CAPGO_IOS_PROVISIONING_MAPCLIからコピー .capgo-credentials ファイル
APPLE_KEY_CONTENTコンテンツ apple_key_base64.txt
P12_PASSWORD (任意)パスワードを入力してください (exportの際に設定されていた場合) .p12 3) Actionsワークフローで__CAPGO_KEEP_0__の環境変数を使用する

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

GitHub/workflows/ios-build.yml
.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

この機能は、App Store Connect API キー認証情報 (APPLE_KEY_ID, APPLE_ISSUER_ID, APPLE_KEY_CONTENT) が必要です。App Store Connect のアップロードと APP_STORE_CONNECT_TEAM_IDディストリビューションは、ビルドをレビューするために提出することはできません。 ad_hoc App Store バージョンです。省略した場合、__CAPGO_KEEP_0__ は --store-release-name is the App Store version; if omitted, Capgo reads MARKETING_VERSION App Store の代替 What’s New テキストです。各 --store-release-notes エントリは、ストアのローカライズ用にそれを上書きできます。 --store-release-notes-locale "locale=notes" with a release build: --ios-automatic-release Apple承認後自動リリースするか、または --no-ios-automatic-release 手動リリースを待つ。 --ios-testflight-groups は、外部ベータ配布用に利用可能ですが、App Storeのレビュー提出には必要ありません。

デフォルトでは、CapgoはiOSアプリをApp Store配布用にビルドします (TestFlight + App Store)。内部テストやCIアーティファクト収集のためにアドホックビルドが必要な場合は、 --ios-distribution フラグを使用できます。

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

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

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

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

警告を抑制するには、パスを渡してください。

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

同じ手順に従ってくださいが、ステップ 5 で プロビジョニング プロファイルを選択します。 アドホック アプリ ストア Go to:

  1. Apple Developer Profiles Click the
  2. button + Select
  3. をクリックします。 アドホック と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'

No --apple-key, --apple-key-id、または --apple-issuer-id 必要ありません。

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

__CAPGO_KEEP_0__を使用して、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)

拡張機能を含むアプリ (Multi-Target Signing) というセクション

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

例:アプリ + 共有拡張機能 というセクション

ターミナル画面
Terminal window
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. すべてを単一の CAPGO_IOS_PROVISIONING_MAP 資格情報

シングルプロファイルからマイグレーション

Section titled “Single Profile からマイグレーション”

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

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

既存の Single-profile の資格情報を新しい形式に変換し、レガシーキーを削除します。 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 Cloudflare のプロファイルを再度ダウンロードしてください。 このプロファイルを使用して、__CAPGO_KEEP_0__ Native Build のセットアップコマンドを再実行してください。
  8. Re-run the Capgo Native Build setup command その他の問題あります.

This should fix the issue.

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

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