コンテンツにスキップ

iOS ビルド

Capgoの専用Macインフラを使用して、iOSアプリをTestFlightとApp Storeにアップロードする方法を学びます。

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

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

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

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

  • Appleアカウントの2要素認証を有効にする
  • 正しい会員タイプを選択する
    • 個人/個人の経営者: 法的個人名はアプリストアでの販売者名になります。
    • 組織: 法的組織、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 の登録後

まず、Capgo をビルドすることを考えられる前に、まずセットアップし、手動で最初のテストフライトビルドを行う必要があります。 手動ビルドを行うことで得られるメリットは以下のとおりです:

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

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

  1. Xcode を開く

  2. クリック Xcode -> Settings... 代替方法は、ショートカットを使用することです。 Cmd + ,

    Xcode設定

  3. Xcodeに移動してください Accounts Apple Developer Accountに追加されているApple Accountを検索してください

  4. Apple Accountが選択されているXcode アプリをデプロイするために使用するチームを検索してください

  5. Xcodeでチームを検索 ボタンをクリックしてください

  6. Xcodeで証明書を管理 Manage Certificates... リストに配布用証明書が表示されることを確認してください __CAPGO_KEEP_0__

  7. __CAPGO_KEEP_0__ Xcode配布証明書

  8. 証明書を作成しない場合は、別の証明書を作成する必要があります。

    1. ボタンをクリックし、次に + Xcodeに証明書を追加 Apple Distribution 証明書は自動的に作成されます。リストで確認できます。前のステップで確認するようにしてください。
    2. 配布証明書をインストールしたので、ビルドプロセスを開始できます。

手動ビルドをテストフライト

セクションのタイトルは “手動ビルドをテストフライト”

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

    実行 bunx cap open ios Xcodeでアプリを開きます。

  2. とクリックしてください archive ボタン

    Xcodeツールバーで、とクリックしてください。 product -> archive ボタン。

    Xcodeツールバー

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

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

    Xcode Distributeボタン

  5. 選択 TestFlight Internal Only __CAPGO_KEEP_0__ Distribute __CAPGO_KEEP_0__

    Xcode TestFlightの内部配布のみ

  6. アプリの記録を設定

    以下の情報を入力してください:

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

    __CAPGO_KEEP_0__ next __CAPGO_KEEP_0__

    Xcode TestFlightのアプリ記録を設定

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

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

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

  10. Done 」をクリックしてください。

あなたは、すべてがうまくいったので、TestFlightでアプリを確認できるはずだと感じるかもしれませんが、まだいくつかの作業が残っています。

  1. TestFlightに自分を追加する
  2. ビルドがテスト可能になるように、輸出の規制を完了する
  3. アプリのサポートURL、プライバシーポリシーURL、年齢制限などのApp Store Connectの必要なメタデータを入力する
  4. 実際にサポートしているデバイスに合ったスクリーンショットを用意する
  5. App Reviewの連絡先情報やテストクレデンシャルを追加し、製品の提出前に準備する

Let’s start with the first one:

TestFlightに追加する

TestFlight追加のセクション
  1. Go to the App Store Connect ページ App Store Connectログインページ

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

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

  4. Click on the Apps __CAPGO_KEEP_0__ App Store Connect apps

  5. App Store Connectで作成したアプリを探してクリックしてください App Store Connect app selection

  6. App Store Connectの TestFlight button App Store Connect testflight

  7. App Store Connectの Internal Testers plus button App Store Connect internal testers plus

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

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

    App Store Connect create new group

  9. クリックしてください Invite testers ボタン App Store Connectのテスターを招待するボタン

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

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

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

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

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

    App Store Connectのテスターの確認

Congratulations 🎉 You have added yourself to TestFlight. Now, there is just one more thing you need to do before you can configure Capgo Native Build.

__CAPGO_KEEP_0__ Native Buildを設定するために必要な情報を設定する

設定の準備

現在、Appleにアプリが非標準の暗号化(カスタムアルゴリズムなど)を使用していないことを約束する必要があります。アプリが非標準暗号化を使用している場合、以下のドキュメントを参照することをお勧めします。 Appleドキュメント この方法は2つあります。

  1. 手動で毎回アプリをビルドすること
  2. plistファイルを自動で設定すること false.

まず、手動で毎回アプリをビルドする方法を説明します。

  1. 前のセクションからすべてのステップを実行し、App Store ConnectのTestFlightセクションを探します。

  2. App Store ConnectのiOSビルドボタンをクリックします。 Builds -> iOS 非準拠情報が欠落しているビルドを探し、App Store Connectのビルドを管理します。

  3. App Store ConnectのビルドiOSボタン Manage App Store Connectのビルドを管理

  4. 選択したオプションがあなたのアプリに最も適しているかどうか

    私にとっては、これは noneですが、あなたの場合では異なる可能性があります。 次に、保存をクリック

    App Store Connectの保存準備情報

  5. あなたのアプリはもう ready to test

    App Store Connectのテスト用に準備

2番目のオプションについては、以下の手順を実行してください。

  1. Open the Info.plist ファイル

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

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

TestFlightアプリをインストールし、招待を受け入れる

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

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

  1. iOS/iPadOSデバイス上のApp Storeから TestFlightアプリ をダウンロードする
  2. テスト用の招待を承知する

TestFlightアプリをインストールする方法の詳細については説明しません。アプリをインストールする方法がわからない場合は、Googleは素晴らしいガイドを提供しています。

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

  1. Appleからメールを開き、招待を承知するためのリンクをクリック

  2. クリック View in TestFlight TestFlight招待メール クリック

  3. button Install TestFlightインストール クリック

  4. button

    TestFlightインストールボタン install button. TestFlightでインストールする

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

  6. Open 」をクリックしてください

おめでとうございます 🎉 TestFlightでアプリをテストするための招待を承認しました。ここで、Capgo Native Buildを設定して、アプリをTestFlightに送信することができます。

Capgo Native Buildの設定

「Capgo Native Buildの設定」

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

パラメーター説明
--platformビルドするプラットフォームios)
--apple-team-idApple Developer チーム ID (Apple Developer ポータルで見つける) Apple Developer ポータル)
--apple-keyAPI アプリ ストア コネクト キー ファイルのパス (.p8 ファイル
--apple-key-idAPI アプリ ストア コネクト キーの Key ID
--apple-issuer-idアプリ ストア コネクト 発行者 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

チームID

チームIDを取得しましょう。取得するのは簡単です。

  1. 移動 Apple Developerアカウント 下にスクロール

  2. チームIDの場所を Team ID

    Apple開発者アカウント

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

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

Appleキーの取得に進みましょう。

  1. Go to App Store Connect user and access page

  2. Select the correct team in the dropdown

    1. 右上隅のあなたの名前をクリックしてください
    2. 使用したいチームをクリックしてください Apple Developerのキーチームの選択
  3. クリックしてください Integrations ボタン App Store Connectの統合ボタン

  4. 以下の issuer

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

  5. ボタンをクリックしてキーを追加 __CAPGO_KEEP_0__のApp Store Connectキー追加

  6. キー名を設定し、管理者へのアクセスを設定し、 App manager ボタンをクリックして Generate __CAPGO_KEEP_0__のキー名を設定し、管理者へのアクセスを設定し、生成 キーIDを保存

  7. 注意

    App Store Connect コピー キー ID

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

    App Store Connect ダウンロードキー

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

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

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

しかし、Appleは、証明書を作成する方法とエクスポートする方法がかなり異なることに気づきました 🙃 では、設定方法を説明しましょう:

  1. Keychain Accessを開く

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

  3. __CAPGO_KEEP_0__

    Keychain Accessで証明書を探す Apple Distribution: [Your Name/Company] (your team ID) 右クリックして証明書を選択し、

  4. Keychain Accessで証明書をエクスポート Export __CAPGO_KEEP_0__

  5. 証明書を保存してください .p12 __CAPGO_KEEP_0__

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

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

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

    • パスワードを入力せずにスキップ (簡単にすることを推奨): クリック OK パスワードを入力せずに
    • パスワードを設定: パスワードで保護されたファイルを使用したい場合は、ここでパスワードを設定できます。パスワードで保護された .p12 ファイルは完全に Capgo CLI でサポートされています - ただし、パスワードを使用して設定コマンドを実行する際にパスワードを指定してください。 --p12-password Keychain Access 保存証明書パスワードダイアログ

    「ログインキーチェーンパスワード」が求められた場合、Mac にログインするために使用するパスワードを入力してください。

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

    ボタンをクリックしてください。 Allow Keychain Access 保存証明書ログインキーチェーンパスワード

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

パスワードを入力せずに

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

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

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

  1. ここに進む Apple Developer プロファイル

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

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

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

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

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

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

  6. アプリをドロップダウンから見つけてくださいそしてボタン

    Apple Developer アプリを選択 Continue 正しい配布証明書を選択してください

    __CAPGO_KEEP_0__

  7. __CAPGO_KEEP_1__

    前のステップでエクスポートした証明書を選択し、 Continue __CAPGO_KEEP_0__

    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 の設定がすでに完了している場合 チーム 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.

1) __CAPGO_KEEP_0__ を単一の base64 に変換する

セクション: 1) __CAPGO_KEEP_0__ を単一の 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) リポジトリ シークレットを作成する

リポジトリ内に GitHub > Repository > Settings > Secrets and variables > Actions、に追加します:

__CAPGO_KEEP_0__ __CAPGO_KEEP_1__ シークレット
CAPGO_TOKENあなたの Capgo API トークン
APP_STORE_CONNECT_TEAM_IDチーム ID チーム ID
APPLE_KEY_IDキーアイディー Apple キー、Apple キーアイディー、および Apple 発行者 ID
APPLE_ISSUER_ID発行者 ID Apple キー、Apple キーアイディー、および Apple 発行者 ID
BUILD_CERTIFICATE_BASE64コンテンツ certificate_base64.txt
CAPGO_IOS_PROVISIONING_MAPCLI によって生成されました — __CAPGO_KEEP_1__ からコピー .capgo-credentials ファイル
APPLE_KEY_CONTENTコンテンツの 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 Connect/TestFlightにアップロードします。CIリリースで、処理済みのTestFlightビルドをApp Storeバージョンに付加し、App Reviewに提出する場合は、 --submit-to-store-review with a release build:

ターミナル画面
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 App ストア版です; これを省略すると、__CAPGO_KEEP_0__ は Xcode プロジェクトから読み取ります。 --store-release-name is the App Store version; if omitted, Capgo reads MARKETING_VERSION Apple の承認後に自動的にリリースするか、または手動でリリースするまで待つことができます。 --store-release-notes 外部ベータ配布用にまだ利用可能ですが、App Store のレビュー提出には必要ありません。 --store-release-notes-locale "locale=notes" アドホック配布モード --ios-automatic-release App Store Connect __CAPGO_KEEP_0__ キー資格情報 ( --no-ios-automatic-release , および --ios-testflight-groups ) が必要です。

App ストア版です; これを省略すると、__CAPGO_KEEP_0__ は Xcode プロジェクトから読み取ります。

アドホック配布モード

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

アドホックモードの使用時期

アドホックモードの使用時期
  • 登録済みデバイスに直接IPAを配布したい (テストフライトなし)
  • APIのApp Store Connectキーを使用しない、または使用できない
  • App Storeに提出しない --output-upload 要件

「要件」セクション

アドホックビルドは

App Storeビルドよりも 要件が少ない 資格情報

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

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

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

同じステップに従ってください。 プロビジョニングプロファイル、ですがステップ5で アドホック __CAPGO_KEEP_0__の代わりに App Store:

  1. Go to Apple Developer Profiles
  2. __CAPGO_KEEP_0__をクリック + ボタン
  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

アドホックビルドを使用した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 例: アプリ + 共有拡張機能

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 flag maps a bundle ID to its provisioning profile file. The CLI:

  1. Reads
  2. プロファイル名を plist 内の埋め込みから自動抽出します。
  3. ファイルを Base64 でエンコードします。
  4. すべてを 1 つの "credential" として保存します。 CAPGO_IOS_PROVISIONING_MAP ヒント

「シングル プロファイルからマイグレーション」のセクション

以前は "(single profile)" を使用していました、以下のコマンドを実行してください。

ターミナル ウィンドウ BUILD_PROVISION_PROFILE_BASE64 プロファイル名を plist 内の埋め込みから自動抽出します。

ファイルを Base64 でエンコードします。
bunx @capgo/cli@latest build credentials migrate --platform ios

既存のシングルプロファイル認証情報を新しい形式に変換し、レガシーキーを削除します。 CAPGO_IOS_PROVISIONING_MAP 移行後、次のコマンドを使用して拡張プロファイルを追加します (加算的マージ):BUILD_PROVISION_PROFILE_BASE64, APPLE_PROFILE_NAME).

ターミナルウィンドウ update __CAPGO_KEEP_0__

ヒント
bunx @capgo/cli@latest build credentials update \
--platform ios \
--ios-provisioning-profile "com.example.app.share-extension=./share_ext_profile.mobileprovision"

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

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

時々、次のようなエラーが表示されます。

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

このエラーは、プロビジョニング プロファイルが作成された後、新しい機能を有効にしたため発生します。 既存のプロビジョニング プロファイルには、新しい機能が含まれていません。

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

  1. 開く Apple Developer Portal
  2. 正しいチームをドロップダウンから選択してください Apple Developer キー チームの選択
  3. ボタンをクリックしてください Profiles ボタン Apple Developer プロファイルのボタン
  4. 再生成したいプロビジョニング プロファイルを探してください Apple Developer プロファイルの検索
  5. ボタンをクリックしてください Edit Apple Developer プロファイルの編集 ボタンをクリックしてください
  6. __CAPGO_KEEP_0__ Save __CAPGO_KEEP_0__ Apple Developerのプロファイルを保存
  7. __CAPGO_KEEP_0__のボタンをクリック Download ボタン Apple Developerのプロファイルをダウンロード
  8. Capgoのネイティブビルド設定コマンドを再実行してください 新しくダウンロードしたプロファイルで再度実行してください。

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

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

iOSビルドから続けてください

iOS ビルドから続ける

__CAPGO_KEEP_0__ を使用している場合 iOS ビルド __CAPGO_KEEP_0__ CI/CD Capgo CI/CD の製品ワークフローに Capgo ネイティブ ビルド Capgo ネイティブ ビルドの製品ワークフローに Capgo インテグレーション Capgo インテグレーションの製品ワークフローに for the product workflow in Capgo Integrations, CI/CD インテグレーションの実装詳細に CI/CD インテグレーション GitHub アクション統合 GitHub アクション統合の実装詳細について。