コンテンツにジャンプ

iOS ビルド

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

学びたいこと

「学びたいこと」
  • Capgoネイティブビルドを使用してアプリをアップロードする方法を学びます。
  • Capgoネイティブビルドの証明書を設定する方法を学びます。

前提条件

「前提条件」
  • Capgoアカウント (無料試用版でも十分です)
  • Capgoにアプリが登録されていること (run if not) bunx @capgo/cli@latest app add __CAPGO_KEEP_0__
  • 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アカウントを選択
  • 正しい会員種類を選択してください:
    • 個人/個人の所有者: ご自身の法的個人名がアプリストアでの販売者名になります
    • 組織: 法的組織、D-U-N-S番号、公的企業ウェブサイト、企業ドメインのメールアドレス、そしてAppleの契約に組織を縛る権限を持つ人物が必要です
  • Apple DeveloperとApp Store Connectにアクセスできるアカウントを使用してください。証明書、アプリレコード、APIキー、テストフライトに
  • 最終的なバンドルIDを早めに固定してください。後で変更すると通常、アプリストアの設定を再度実行する必要があります
  • App Review前に準備するアプリストアコネクトのアイテムを計画してください。サポートURL、プライバシーポリシーURL、年齢制限、スクリーンショット、輸出管理、App Reviewの連絡先情報
Apple Developer の登録を開始する ウェブ上で Apple の登録を続ける Apple Developer のエンティティタイプを正しく選択する 登録後は App Store Connect を使用する

Capgo をビルドする前に、まずセットアップして、手動で最初の TestFlight ビルドを行う必要があります。 手動ビルドを行うことで得られるメリットは次のとおりです:

  • 配布証明書をローカルマシンに設定します
  • App Store のレコードを作成する必要があります (まだ作成していない場合は)
  • アプリケーションcodeに関連するビルドプロセスの問題をすべて解決できます。

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

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

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

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

    Xcode設定

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

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

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

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

  7. 証明書を確認 リストに配布用証明書が表示されていない場合、新しい証明書を作成する必要があります

  8. 配布用証明書

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

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

セクション「手動ビルドをテストフライト」

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

    Xcodeでアプリを開く。 bunx cap open ios ボタン

  2. ボタン archive Xcodeのツールバーでボタンを探してクリック

    証明書を追加 product -> archive iOS用ビルダーの設定

    Xcodeツールバー

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

  4. Xcodeの Distribute App ボタン

    Xcodeの

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

    アプリのレコードの設定

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

    iOS用のビルダー設定

    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. コンテキスト:解決策ページのアプリ例セクション。役割:短いUIラベルまたはナビゲーションアイテム。見られる場所:コンポーネント解決策/ソリューションアプリ例.astro。メッセージキー`solution_app_examples_rating` (ソリューションアプリ例の評価)。
  5. 実際にサポートしているデバイスに合ったスクリーンショットを用意する

プロダクションの提出前に、App Reviewの連絡先情報とテストクレデンシャルを追加する

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

TestFlightに自分を追加する
  1. 「TestFlightに自分を追加する」のセクション 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 App Store Connectアプリの選択 ボタン

  7. App Store Connectの内部テスト者にボタンをクリックしてください。 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の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. 以下のキーを追加します。

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

Configuring Capgo Native Build

Configuring Capgo Native Build

There are a few things you need to configure in Capgo Native Build to be able to build and submit your app to TestFlight. Here is a list of the things you will pass to the Capgo CLI:

パラメーター説明
--platformビルドするプラットフォーム (ios)
--apple-team-idApple Developer Portalで見つけることができる App Store Connect __CAPGO_KEEP_0__ Keyファイルのパス ()
--apple-keyPath to your App Store Connect API Key file (.p8 App Store Connect __CAPGO_KEEP_0__ KeyのKey ID
--apple-key-idThe Key ID of your App Store Connect API Key
--apple-issuer-idCapgo
--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 Go to と下にスクロール

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

    開発者アカウントの

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

「Appleキー、AppleキーID、Apple発行者ID」のセクション

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

  1. アプリストアコネクトユーザーとアクセスページへ 注意

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

    1. 使用したいチームをクリックしてください。
    2. Apple Developerキーのチーム選択 ボタン
  3. App Store Connect統合ボタン Integrations __CAPGO_KEEP_0__ __CAPGO_KEEP_1__

  4. iOS用ビルダー issuer

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

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

  6. __CAPGO_KEEP_0__ App managerGenerate ボタン App Store Connectの

  7. アクセス権限を設定し、

    App Store Connectの

  8. キーIDをコピーしてください

    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 ファイル

    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 save certificate dialog

    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 button Continue Apple Developerのプロファイル追加ボタン

    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設定(GitHub Actions)」のセクション

Section titled “CI/CD setup (GitHub Actions)”

を完了している場合 チーム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.

CI/CD用にすでに必要なものはすべて揃っています。このセクションでは、__CAPGO_KEEP_0__ Actionsシークレットと環境変数として値を渡す方法について説明します。

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

Section titled “2) Create repository secrets” GitHub > Repository > Settings > Secrets and variables > Actions2) リポジトリシークレットを作成する

InIn
CAPGO_TOKENYour Capgo API token
APP_STORE_CONNECT_TEAM_IDシークレット名 Value
APPLE_KEY_IDAppleキー、アップルキーID、そしてアップル発行者ID
APPLE_ISSUER_ID発行者IDから Appleキー、アップルキーID、そしてアップル発行者ID
BUILD_CERTIFICATE_BASE64内容 certificate_base64.txt
CAPGO_IOS_PROVISIONING_MAP生成されたものはCLI — 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 に提出する場合、次の手順に従ってください。 --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 へのアップロードと配布は、ビルドを App Review に提出することはできません。 ad_hoc App Store バージョンです。 __CAPGO_KEEP_0__ が省略されている場合、Xcode プロジェクトから読み取られます。 --store-release-name is the App Store version; if omitted, Capgo reads MARKETING_VERSION App Store への提出 --store-release-notes はApp Storeのデフォルトの「What’s New」テキストであり、各 --store-release-notes-locale "locale=notes" はApp Storeのローカライズ用にそれを上書きできます。 --ios-automatic-release を使用して、Appleの承認後に自動的にリリースするか、または手動でリリースを待つことができます。 --no-ios-automatic-release は、外部ベータ配布用にまだ利用可能ですが、App Storeのレビュー提出には必要ありません。 --ios-testflight-groups 内部テストまたは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 注意

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

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

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

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

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

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

同じ手順を プロビジョニングプロファイルコンテキスト: Capgo Builder / ネイティブクラウドビルド製品ページ。役割: 短いUIラベルまたはナビゲーションアイテム。見られる場所: page native-build.astro。メッセージキー `native_build_v2_wiz_ios_s3_l` (Native Build V2 Wiz Ios S3 L)。 , ですがステップ5で アドホック の代わりに:

  1. App Store 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 needed.

ターミナル画面
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に組み込む」

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機能が含まれていません。

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

__CAPGO_KEEP_0__

__CAPGO_KEEP_1__

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

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 keys team selection
  3. ボタンをクリック Profiles Apple Developer profiles button 再生成したいプロビジョニング プロファイルを検索
  4. button Apple Developerのプロフィールを検索
  5. プロフィールを Edit ボタン Apple Developerのプロフィールを編集
  6. プロフィールを Save ボタン Apple Developerのプロフィールを保存
  7. プロフィールを Download ボタン Apple Developerのプロフィールをダウンロード
  8. 再度Capgoネイティブビルド設定コマンドを実行 新しくダウンロードしたプロフィールを使用してください。

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

あなたが Capgo Native Build、クレデンシャル設定、またはアプリのビルドに関して何らかの理由で問題を抱えている場合、Capgo Native Buildの設定やクレデンシャル設定、またはアプリのビルドに関してのサポートにご連絡ください。 サポート.

あなたが iOS Builds を使用してCI/CDの自動化を計画する場合、__CAPGO_KEEP_0__ CI/CD と接続し、Capgo CI/CD for the product workflow in Capgo CI/CD, Capgo Native Builds Capgo Native Buildsの製品ワークフロー Capgo Integrations Capgo Integrationsの製品ワークフロー CI/CD Integration CI/CD Integrationの実装詳細 GitHub Actions Integration GitHub Actions Integrationの実装詳細