iOSビルド

このプラグインのインストール手順とフルマークダウンガイドをコピーします。

Build and submit iOS apps to TestFlight and the App Store using Capgo’s dedicated Mac infrastructure.

学びます

You will learn how to upload your app via Capgo Native build
You will learn how to configure the certificates for Capgo Native Build

前提条件

Capgo の有効なサブスクリプションを持つアカウント
Capgo に既にアプリが登録されている (もしもそうでない場合は実行してください) bunx @capgo/cli@latest app add Mac コンピューターに Xcode がインストールされている (Linux/Windows マシンでビルドを設定することは可能ですが、まだドキュメントが作成されていません)
有効な Apple Developer アカウント (99 ドル/年) (Apple Developer アカウントの管理者またはオーナー権限が必要です)
Xcode を使用してアプリが正常にビルドできること
__CAPGO_KEEP_0__ アプリ
Capacitor アプリの設定済みのアイコン
注記

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

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

Appleアカウントの2要素認証を有効にします
正しい会員タイプを選択します:
- 個人/個人の経営者アプリの販売者名は、__CAPGO_KEEP_0__ストアで法律上の個人名になります
- 組織組織には、法的実体、D-U-N-S番号、公的企業ウェブサイト、企業ドメインのメールアドレス、Appleの契約に組織を縛る権限を持つ人物が必要です
Apple DeveloperとApp Store Connectにアクセスできるアカウントを使用してください:証明書、アプリレコード、APIキー、TestFlight
最終バンドルIDを早期に固定しておきましょう。後で変更する場合、App Storeの設定を再度行う必要があることが多いでしょう。
App Reviewの前に、次のApp Store Connectの項目を計画しておきましょう: サポートURL、プライバシーポリシーURL、年齢制限、スクリーンショット、輸出管理、App Reviewの連絡先情報

アプリを __CAPGO_KEEP_0__ でビルドすることを考える前に、まずアプリを設定し、手動で最初の TestFlight ビルドを実行する必要があります。手動ビルドを実行するには、いくつかのメリットがあります。

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__ に関連するビルドプロセスの問題を解決することができます
The first manual build
You will be able to figure out any issues with the build process linked to your app code

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

配布用証明書の設定

Xcodeを開く
クリック Xcode -> Settings... 代わりにショートカットを使用することもできます Cmd + ,
Xcodeに移動 Accounts
選択したAppleアカウント
__CAPGO_KEEP_0__
ボタンをクリックしてください Manage Certificates... ボタン
リストに配布用証明書が表示されていることを確認してください
表示されていない場合は、新しい証明書を作成する必要があります

Appleは、配布用証明書の最大数を3に制限しています。3枚以上の証明書を持っている場合は、1枚を削除して新しい証明書を作成する必要があります。このチュートリアルでは、その方法については説明しません。
1. ボタンをクリックしてください + ボタンをクリックしてください Apple Distribution
2. 証明書は自動で作成されます。リストで確認できます。前のステップを確認してみてください。

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

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

Xcodeでアプリを開く

実行 bunx cap open ios Xcodeのツールバーで
ボタン archive Xcodeのツールバーで

ボタン product -> archive Find and click on the
ビルドが完了するのを待ってください
ボタンをクリックしてください Distribute App ボタン
配布方法として TestFlight Internal Only ボタンをクリックしてください Distribute Xcode TestFlight 内部のみ配布方法
以下のフィールドを入力してください:

Name: アプリの名前 - App Storeで表示されます
1. __CAPGO_KEEP_0__
2. SKU - アプリのSKU - この値はApp Storeでアプリを識別するために使用されます
3. The primary language - アプリの主な言語
次に、 next ボタン
アプリレコードの作成が失敗した場合は、ウィンドウを閉じてアプリを再度アーカイブしてみてください。
アップロードを待ってください
全てがうまくいったら、以下の画面が表示されるはずです
ボタン Done あなたは、すべてがうまくいったと感じるかもしれませんが、実際にはまだいくつかのことが残っています。

ボタン

TestFlightに登録する
ビルドがテスト可能になるように、輸出管理の準備が整うようにしてください
App Store Connectの必要なメタデータを入力してください。例えば、サポートURL、プライバシーポリシーURL、年齢制限など
実際にサポートしているデバイスに合ったスクリーンショットを用意してください
プロダクションの提出前に、App Reviewの連絡先情報とテストクレデンシャルを追加してください

最初のステップから始めましょう。

TestFlightに登録する

「TestFlightに登録する」のセクション App Store Connect App Store Connect
Apple Developerアカウントでサインイン
__CAPGO_KEEP_0__のチームを選択してください。アプリのレコードを作成したときに使用したチームを選択してください。1つの開発者アカウントしかない場合は、このステップをスキップできます。
__CAPGO_KEEP_1__ Apps App Store Connectアプリ
App Store Connectアプリの選択
App Store Connectテストフライト TestFlight __CAPGO_KEEP_4__
__CAPGO_KEEP_6__ Internal Testers plus ボタン
新しいグループを作成する

グループに名前を付けたい場合は、「内部」などと呼ぶのが好きです。何にでも名前を付けられます。
ボタンをクリックする Invite testers ボタン
グループに自分自身を追加する

リストの中で自分自身を見つけ、自分の名前の横のチェックボックスを選択してください。自分自身が表示されない場合はページを更新してください。次に、 Add ボタンをクリックする
グループに追加されていることを確認してください

グループに自分自身が表示されるようになりました。

おめでとうございます 🎉 TestFlightに自分自身を追加しました。ただ1つ残す必要があります Capgo Native Buildを設定する前に。

法的情報の設定

あなたのアプリが標準的な暗号化方法以外の暗号化を使用していないことをAppleに約束する必要があります。アプリが標準的な暗号化方法以外の暗号化を使用している場合、カスタムアルゴリズムを使用している場合など、読むことをお勧めします。 Appleのドキュメント標準的な暗号化方法以外の暗号化を使用していないことを確認する方法は2つあります。

アプリをビルドするたびに手動で設定する方法
plistファイルを自動的に設定する方法 false.

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

前のセクションからすべてのステップを実行して、App Store ConnectのTestFlightセクションを見つける
をクリックしてください Builds -> iOS
非準拠情報が欠落しているビルドを見つけ、をクリックしてください Manage
あなたのアプリの説明を選択してください

私にとっては noneが異なるかもしれませんが
App Store Connectで準拠情報を保存 ready to test

App Store Connectでテスト準備

Open the Info.plist ファイル

Add the following key:

<key>ITSAppUsesNonExemptEncryption</key>
<false/>

ファイルを保存

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

ここから、ようやく始まりますほぼ実機でテストする準備ができています。実行する前に、以下のことを行ってください:

__CAPGO_KEEP_0__ __CAPGO_KEEP_0__ App StoreからiOS/iPadOSデバイスにインストールする
テスト用の招待を受け入れる

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

Appleから招待を受け入れるためのメールを受け取ることができます。

Appleから招待を受け入れるためのメールを開く
招待を受け入れるための View in TestFlight ボタン
クリックしてください Install ボタン
デバイスにアプリをインストールする

Xcode を使用してアプリを以前インストールした場合、以下の画面が表示される場合があります。ボタンをクリックしてください。 install TestFlight インストールアプリ
ボタンをクリックしてください
あなたはTestFlightでアプリをテストするための招待を承認しました。__CAPGO_KEEP_0__ Native Buildを設定して、アプリをTestFlightに送信することができます。 Open TestFlightでアプリをテストするための招待を承認しました。__CAPGO_KEEP_0__ Native Buildを設定して、アプリをTestFlightに送信することができます。

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

Capgo Native ビルドの設定を行わないと、TestFlightにアプリを提出することができません。ここでは、ビルドと提出するために必要な設定をいくつか紹介します。 Capgo CLIに渡す値のリストです。

パラメーター	説明
`--platform`	ビルドするプラットフォーム (`ios`)
`--apple-team-id`	Apple Developer Portalで見つけることができる App Store Connect __CAPGO_KEEP_0__ キーのパス ()
`--apple-key`	Path to your App Store Connect API Key file (`.p8` App Store Connect __CAPGO_KEEP_0__ キーのキーアイデンティファー
`--apple-key-id`	The Key ID of your App Store Connect API Key
`--apple-issuer-id`	配布用証明書のパス
`--certificate`	file`.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から始めましょう。見つけるのはとても簡単です。

Apple Developer Account に移動し、下にスクロールと
Capgoで Team ID

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

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

Capgoで App Store Connectユーザーとアクセスページ

私にとってリンクが機能しないことがあります。機能しない場合はページを再読み込みしてください。
ドロップダウンメニューで正しいチームを選択してください
1. 右上の名前をクリックしてください
2. 使用したいチームをクリックしてください
クリックしてください Integrations ボタン
注意 issuer

- これは後で必要になるので、保存してください クリックしてください targetLanguage

Japanese copy __CAPGO_KEEP_0__をコピーするボタン
プラスボタンをクリックしてください
キー名を設定し、管理者へのアクセスを設定し、生成ボタンをクリックしてください App manager と Generate ボタン
キーIDを保存してください

この 保存する - 後で必要になるため
キーをダウンロードする

この 保存する - 後で必要になるため

CAPGOとCLIで使用するのみ - 誰にも共有しない -

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

証明書

証明書をエクスポートする準備ができました。最初のステップの 1 つとして、このガイドの設定でディストリビューション証明書を設定しました。

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

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

__CAPGO_KEEP_0__で検索する証明書の名前は Apple Distribution: [Your Name/Company] (your team ID)
右クリックして、 Export
証明書を保存してください .p12 ファイル

この __CAPGO_KEEP_0__を保存しておく必要があります - 後で必要になるため
1. 証明書ファイルの名前を適切に選択してください
2. ファイル形式が Personal Information Exchange (.p12)
3. ボタン Save Keychain Accessで証明書を保存するダイアログ
パスワードを入力する
- パスワードを省略 (簡単にするために推奨): クリック OK パスワードなしで
- パスワードを設定: パスワードで証明書を保護したい場合は、ここでパスワードを設定できます。パスワード保護された .p12 ファイルは完全に Capgo CLI でサポートされています - ただし、パスワードを使用して --p12-password オプションを使用して、構成コマンドを実行するときにパスワードを提供してください。
「ログインキーチェーンパスワード」の質問に答える際に、Macにログインするために使用するパスワードを入力してください。

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

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

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

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

ここに進む Apple Developer プロファイル
ドロップダウンから正しいチームを選択
1. 右上の自分の名前をクリック
2. 使用するチームをクリック
正しいページにいることを確認表示されていない場合は、 profiles サイドバーの
クリック + ボタン
プロファイルの種類を選択してください選択してください App Store Connect と Continue ボタン
アプリを選択してください

ドロップダウンでアプリを探してください Continue ボタン
正しい配布証明書を選択してください

前のステップでエクスポートした証明書を選択してください Continue ボタン

選択する証明書がわからない場合は、Keychain Accessに戻って、エクスポートした証明書を探してください。そのあと、有効期限を確認してください。
プロファイルの名前を設定する

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

The profile name is automatically extracted by the Capgo CLI — you don’t need to remember it.
ボタン

ボタンをクリックしてプロファイルをダウンロード Download __CAPGO_KEEP_0__のプロファイルをダウンロードするにはボタンをクリック

このファイル 保存してください -後で必要になります

おめでとうございます 🎉 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)

CI/CD 設定がすでに完了している場合 Team ID, Apple key、Apple key ID、Apple issuer 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.

このセクションでは、__CAPGO_KEEP_0__ 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

2) リポジトリシークレットを作成する

In GitHub > Repository > Settings > Secrets and variables > Actions, add:

シークレット名	値
`CAPGO_TOKEN`	あなたのCapgo APIトークン
`APP_STORE_CONNECT_TEAM_ID`	チームID チームID
`APPLE_KEY_ID`	キーアイディ Appleキーアイディ、Appleキーアイディ、Apple発行者ID
`APPLE_ISSUER_ID`	発行者 ID Apple キー、Apple キー ID、および Apple 発行者 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 ワークフローで環境変数を使用する

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に提出する準備が整いました。

アドホック配布モード

デフォルトでは、Capgo は iOS アプリを App Store 配布用にビルドします (テストフライト + 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 / 発行者ID	No

同じ手順で進めますが、ステップ5で

を選択しますアドホックプロビジョニングプロファイルの作成アドホックプロビジョニングプロファイルの作成 アドホック __CAPGO_KEEP_0__の代わりに App Store:

以下のボタンをクリックしてください Apple Developer Profiles
__CAPGO_KEEP_1__をクリックしてください + ボタン
選択 アドホック アプリと配布証明書を選択してください
登録したいデバイスを選択してください
__CAPGO_KEEP_2__
プロファイルの名前とダウンロード

アドホックのクレデンシャルを保存

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

GitHub Actionsの場合、App Storeビルドよりも少ないシークレットが必要です:

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)

アプリに拡張機能 (共有拡張機能、ウィジェット、通知サービス拡張機能など) が含まれている場合、各拡張機能のターゲットには独自のプロビジョニングプロファイルが必要です。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:

Example: App + Share Extension
プロファイル名を自動で plist 内から抽出します
ファイルを Base64 でエンコードします
すべてを 1 つの "credential" として保存します CAPGO_IOS_PROVISIONING_MAP クレデンシャル

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

以前は "(single profile)" を使用していましたか、 BUILD_PROVISION_PROFILE_BASE64 ターミナルウィンドウ

bunx @capgo/cli build credentials migrate --platform ios

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

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

bunx @capgo/cli 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')"

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

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

開く Apple Developer Portal
正しいチームをドロップダウンから選択してください
ボタンをクリックしてください Profiles Apple Developer プロファイルのボタン
Apple Developer プロファイルの検索
Apple Developer プロファイルの編集 Edit ボタンをクリックしてください
__CAPGO_KEEP_1__ Save __CAPGO_KEEP_2__
ボタンをクリック Download ボタン
Capgo Native Buildのセットアップコマンドを再実行してください。新しくダウンロードしたプロファイルを使用してください。この問題は解決されるはずです。

その他の問題

「その他の問題」セクション

If for whatever reason you are having issues either with Capgo Native Build, configuring the credentials or building the app, please don’t hesitate to reach via our ページを編集.