コンテンツに進む

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アカウントに2要素認証を有効にする

  • Appleアカウントに2要素認証を有効にする
  • メンバーの種類を選択してください:
    • 個人/個人事業主: 法的個人名はApp Storeで販売者名になります
    • 組織: 法的組織、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_KEEP_0__ の内部動作を完全に理解したい人向けです。

最初の手動ビルド

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:

  • __CAPGO_KEEP_0__ をビルドする前に、まずセットアップし、手動で最初の TestFlight ビルドを行う必要があります。 手動ビルドを行うには、次のメリットがあります:
  • 署名証明書をローカルマシンにセットアップします
  • You will be able to figure out any issues with the build process linked to your app code

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

配布用証明書の設定

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

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

    Xcode設定

  3. に移動 Accounts Xcodeアカウントタブ

  4. Apple Developerアカウントに追加されたAppleアカウントを検索 選択されたAppleアカウントのXcode

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

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

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

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

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

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

  1. Xcodeでアプリを開く

    実行 bunx cap open ios コンテキスト:Xcodeでアプリを開く。ページ/エリア:Capgoマーケティングウェブサイト。ロール:長いマーケティングまたは法的文章。見つける場所:ページalternatives/codepush.astro。Capgo製品/ブランドと開発者用語を完全に保持します。

  2. 手動ビルドをTestFlightに送信 archive button

    手動ビルドをTestFlightに送信 product -> archive button.

    Xcodeツールバー

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

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

    Xcode配布ボタン

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

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

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

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

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

    次に、 next ボタン

    Xcode TestFlightのアプリレコード

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

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

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

  10. ボタン Done ボタン

あなたは、すべてがうまくいったと感じるかもしれませんが、まだ何が残っているかを知る必要があります。

  1. TestFlightに登録する
  2. 出荷の準備が整うようにexport complianceを完了する
  3. App Store Connectの必要なメタデータを入力する(サポートURL、プライバシーポリシーURL、年齢制限)
  4. 実際にサポートしているデバイスに合ったスクリーンショットを用意する
  5. App Reviewの連絡先情報やテストクレデンシャルを追加する

最初のステップはこちらです:

  1. App Store Connect ページ page App Store Connect

  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を設定する前に、最後のステップがあります。

現在、Appleにアプリが標準的な暗号化方法以外の暗号化アルゴリズムを使用していないことを約束する必要があります。アプリが標準的な暗号化方法以外の暗号化アルゴリズムを使用している場合、以下のドキュメントを参照してください。 Appleのドキュメント この方法の2つの方法があります:

  1. 毎回アプリをビルドするたびに手動で実行する
  2. plistファイルを自動的に設定する false.

まず最初の方法から始めましょう

  1. 前のセクションのすべてのステップに従って、App Store Connectでテストフライトセクションを見つけてください。

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

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

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

    私にとってはこれですが、あなたの場合は異なるかもしれません。 次に、保存をクリックしてください。 noneApp Store Connect 非準拠情報保存

    アプリは現在 "テスト用に準備中" と表示されるはずです。

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

    App Store Connect

App Store Connect

  1. iOS用Capgoビルダー Info.plist ファイルを開く

  2. ファイル

    <key>ITSAppUsesNonExemptEncryption</key>
    <false/>
  3. コピー

Appleの公式ドキュメントに従って、暗号化エクスポート規制への適合性をAppleに通知する方法について説明しています。

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

TestFlightアプリをインストールし、招待を受け入れる ほぼ テストフライトでアプリをテストする準備ができています。 まず、以下のことを実行する必要があります:

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

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

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

  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-idThe Key ID of your App Store Connect API Key
--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

「チーム ID」

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

  1. いく に移動し、下部にスクロール コピーする

  2. iOS用ビルダーの設定 Team ID

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

Apple key、Apple key ID、Apple issuer IDの場所

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

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

  1. Go to 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 Keychain Accessログインカテゴリ My Certificates button __CAPGO_KEEP_1__

  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 パスワードを入力せずにスキップ
    • パスワードを設定する: パスワードを設定する場合はここで設定してください。パスワード付きのファイルは完全に __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ でサポートされています。ただし、パスワードを使用するには、 .p12 ファイルは完全にサポートされています。Capgo CLI では、パスワードを使用してください。 --p12-password Keychain Access save certificate dialog

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

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

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

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

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

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

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

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

  1. Go to Apple Developer Profilesに移動してください。

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

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

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

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

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

    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 ビルドを設定するために必要なすべてのものを手に入れました。

コマンドを実行する必要があります。

実行する必要があるコマンドは次のとおりです。
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 のクレデンシャルを保存した出力

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

1) 単一のベース64の文字列に認証情報ファイルを変換する

1) 1 行の base64 に credential ファイルを変換する
1) 1 行の base64 に credential ファイルを変換する
# 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

/ja/docs/builder/ios/

Live Update

Cloudflare GitHub > Repository > Settings > Secrets and variables > ActionsCapacitor

GitHubCapgo
CAPGO_TOKENYour Capgo API token
APP_STORE_CONNECT_TEAM_IDAPI SDK
APPLE_KEY_IDCLI npm
APPLE_ISSUER_ID発行者IDから Appleキー、AppleキーID、およびApple発行者ID
BUILD_CERTIFICATE_BASE64内容は certificate_base64.txt
CAPGO_IOS_PROVISIONING_MAPCLIによって生成されました — ここからコピー .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 への提出

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-specific パスワードのアップロードと ad_hoc App Store バージョンです。省略した場合、__CAPGO_KEEP_0__ は Xcode プロジェクトから読み取ります。 --store-release-name iOSバージョンはApp Storeバージョンです。Capgo が省略された場合、Capgo は MARKETING_VERSION 各 --store-release-notes の --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に提出しない

context iOS向けのCapgoビルダー App Storeビルドよりも少ない要件

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

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

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

同じステップに従ってください プロビジョニングプロファイルプロビジョニングプロファイル 5番目のステップで アドホック アプリストア:

  1. Go to ボタン
  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)

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 flag.

protectedTokens

items
ターミナル画面
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 資格情報

iOS向けのCapgoビルダー

「iOS向けのCapgoビルダー」

以前は「シングルプロファイル」を使用していました BUILD_PROVISION_PROFILE_BASE64 (シングルプロファイル)の場合、以下のコマンドを実行してください

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

Capgoでは、既存の単一プロファイルの資格情報を新しいプロファイルに変換します。 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機能が含まれていません。

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

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

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 ポータル - プロファイルの検索 クリックしてください
  5. iOS用のCapgoビルダー Edit ボタン Apple Developerのプロフィールを編集
  6. iOS用のCapgoビルダー Save ボタン Apple Developerのプロフィールを保存
  7. iOS用のCapgoビルダー Download ボタン Apple Developerのプロフィールをダウンロード
  8. Capgo Native Buildのセットアップコマンドを再実行 新しくダウンロードしたプロファイルで再実行してください。

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

その他の問題

「その他の問題」

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

iOSビルドから続ける

「iOSビルドから続ける」

あなたが使用している iOSビルド CI/CDの自動化を計画する場合、__CAPGO_KEEP_0__ CI/CD Capgo CI/CD Capgoネイティブビルド をCapgo CI/CD Capgo iOS ビルドのワークフローについて Capgo インテグレーション Capgo インテグレーション CI/CD インテグレーション CI/CD インテグレーションの実装詳細について GitHub アクション インテグレーション GitHub アクション インテグレーションの実装詳細について