コンテンツにジャンプ

iOSビルド

Capgoの専用Macインフラを使用してiOSアプリをビルドして、TestFlightやApp Storeに公開します。

学びたいこと

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

前提条件

前提条件
  • Capgoアカウント (無料試用版でも十分です)
  • アプリがCapgoに登録されている (run bunx @capgo/cli@latest app add もしない場合
  • Capgoビルドを使用すると、Macが必要なくてもiOSアプリをクラウドでコンパイルして署名できます。
  • Apple Developer アカウント ($99/年) (Apple Developer アカウントで管理者またはオーナーの権限が必要です)
  • アプリが Xcode でローカルにビルド成功する (または Capgo ビルド)
  • Capacitor アプリ
  • アプリのアイコン。アップロードできないアプリは App Store にはアップロードできない。

Apple のポータルで開始する前に

セクション: Apple のポータルで開始する前に

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

  • 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の登録を開始する ウェブ上でAppleの登録を続ける Apple Developerのエンティティタイプを正しく選択する 登録後、App Store Connect

最初の手動ビルド

最初の手動ビルド

まず、Capgo をセットアップし、手動で最初のテストフライトビルドを実行する必要があります。 手動ビルドを行うことで、次のような利点があります:

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

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

配布用証明書の設定

配布用証明書の設定
  1. Xcodeを開きます

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

    Xcode設定

  3. に移動 Accounts アカウント

  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マーケティングウェブサイト。ロール: 長いマーケティングまたは法的文章。見つける場所: page 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. アプリ名: App Storeで表示されるアプリの名前
    2. アプリのSKU - アプリのSKU - この値は、App Storeでアプリを識別するために使用されます。
    3. 主な言語 - アプリの主な言語

    次に、 next ボタン

    Xcode TestFlightのアプリレコードを作成します

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

  8. アップロードを待ちます

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

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

あなたは、すべてがうまくいったら、TestFlightでアプリを確認できるはずだと考えますが、まだいくつかの作業が残っています。

  1. TestFlightに登録する
  2. 輸出管理の準備が整うので、ビルドがテスト可能になる
  3. App Store Connectの必要なメタデータを入力する(サポートURL、プライバシーポリシーURL、年齢制限)
  4. 実際にサポートしているデバイスに合ったスクリーンショットを用意する
  5. App Reviewの連絡先情報とテストクレデンシャルを追加し、生産提出前に準備する

最初のステップとしては、

  1. 以下のページに移動する App Store Connect ページ 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でTestFlightセクションを見つけてください。

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

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

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

    私にとっては noneがちょうどいいかもしれませんが、あなたの場合は異なるかもしれません。 次に、保存してください。

    App Store Connectで準拠情報を保存してください。

  5. アプリは今、 ready to test

    と表示されるはずです。

2番目のものについては、以下の手順を実行してください。

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

  2. ファイル

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

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

TestFlightアプリをインストールし、招待を承認する

TestFlightアプリをインストールし、招待を承認する ほぼ 実行可能

  1. テストフライトでアプリをテストする準備ができています。 その前に、以下のことを行う必要があります。 ダウンロード テストフライトアプリ
  2. iOS/iPadOSデバイスのApp Storeからアプリをダウンロード

アプリのテストに招待されたことを受け入れ

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

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

  2. クリックして View in TestFlight ボタン テストフライトメールボタン

  3. iOS用ビルダーの設定 Install ボタン テストフライトインストールボタン

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

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

  5. インストール完了ボタンをクリックしてください

  6. iOS用ビルダーの設定 Open おめでとうございます 🎉 テストフライトにアプリをテストするための招待を承認しました。__CAPGO_KEEP_0__ネイティブビルドを設定して、アプリをテストフライトに送信することができます。

Capgoネイティブビルドの設定

CapgoでCapgoのネイティブビルドを設定する

「Capgoネイティブビルドの設定」

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:

ParameterDescription
--platformCapgo Native Buildの対象プラットフォーム(ios)
--apple-team-idApple Developer Portalで見つける Capgo Native BuildのApp Store Connect Keyファイルのパス()
--apple-keyApp Store Connect API キーファイル (.p8 file)
--apple-key-idApp Store Connect のキーアイデンティティのキーアイデンティティ API
--apple-issuer-idCapgo Native Buildの配布用証明書のパス(
--certificatefile).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. Go to Go to Apple Developer Account

  2. iOS用ビルダー Team ID

    開発者アカウントの

Apple key、Apple key ID、Apple issuer IDの

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

ここで、Apple keyについて説明します。

  1. いく 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 つとして、ディストリビューション証明書を設定しました。

しかし、Appleは、証明書をエクスポートする方法は、証明書を作成する方法とはかなり異なります 🙃 設定の説明に入りましょう:

  1. Keychain Accessを開く

    1. クリック Command + Space 検索バーを開く
    2. 検索 Keychain Access
    3. 検索バーの Keychain Access アプリ
  2. カテゴリを選択し、 login ボタン My Certificates button __CAPGO_KEEP_0__

  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 ファイルは完全にサポートされています。Capgo CLI では、パスワードを使用してください。 --p12-password パスワードを入力せずにスキップする (簡単にすることを推奨):

    パスワードを入力せずにクリックする

  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 Apple Developerのプロファイル種類を選択 Continue ボタン

    ボタン

  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 の資格情報の保存出力

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

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

1) 1 行の base64 に変換する
1) 1 行の 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,

シークレット名値
CAPGO_TOKENCapgo API のトークン
APP_STORE_CONNECT_TEAM_IDチームID キーアイデンティティ
APPLE_KEY_IDキーアイデンティティ Appleキーアイデンティティ、AppleキーアイデンティティID、Apple発行者ID
APPLE_ISSUER_ID発行者IDから Appleキー、AppleキーID、Apple発行者ID
BUILD_CERTIFICATE_BASE64内容は certificate_base64.txt
CAPGO_IOS_PROVISIONING_MAP生成されたものは 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_ID)。App スペシフィック パスワードのアップロードと ad_hoc ディストリビューションは、ビルドをレビューするために提出できません。 --store-release-name App Store バージョンです。省略した場合、Capgo は MARKETING_VERSION Xcode プロジェクトから読み取ります。 --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のレビュー提出には必要ありません。

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

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

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

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

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

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

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

同じステップに従ってください プロビジョニングプロファイルコンテキスト:Capgo Builder /ネイティブクラウドビルド製品ページ。役割:短いUIラベルまたはナビゲーションアイテム。見つける:ページnative-build.astro。メッセージキー`native_build_v2_wiz_ios_s3_l` (ネイティブビルドV2ワイズiOSS3L)。 , ですがステップ5で選択 アドホック の代わりに:

  1. App Store Apple Developer Profilesに移動
  2. ボタンをクリック + Go to
  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をビルドアーティファクトとして収集するには、__CAPGO_KEEP_0__に追加します。 --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)」のセクション

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

「例: アプリ + 共有拡張機能」

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

Migrate from Single Profile

「Migrate from Single Profile」

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

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

Capgoでは、既存の単一プロファイルの資格情報を新しいプロファイルに変換します。 CAPGO_IOS_PROVISIONING_MAP 既存の 1 つのプロファイルの資格情報を新しい形式に変換し、レガシーキーを削除します。BUILD_PROVISION_PROFILE_BASE64, APPLE_PROFILE_NAME).

レガシーキー:「 update 移行後、拡張プロファイルを追加するには、次のコマンドを実行してください (additive merge):

ターミナル画面
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 button 再生成したいプロビジョニング プロファイルを探す
  4. Apple Developer ポータルでプロファイルの検索 Copy to clipboard
  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_KEEP_0__ CI/CDの製品ワークフローに__CAPGO_KEEP_0__ネイティブビルドを組み込んでください。 iOSビルド __CAPGO_KEEP_0__ CI/CD Capgo CI/CD Capgoネイティブビルド Capgo ネイティブビルド Capgo iOS ビルドのための製品ワークフロー Capgo インテグレーション Capgo インテグレーション CI/CD インテグレーション CI/CD インテグレーションの実装詳細 GitHub アクション インテグレーション GitHub アクション インテグレーションの実装詳細