🔹 build
このプラグインのインストール手順と完全なMarkdownガイドを含むセットアッププロンプトをコピー
🏗️ Capgo Cloud を使用して、iOS/Android の Native Build を管理します。
ビルドのアクセス権と出力
「ビルドのアクセス権と出力」というセクションNative cloud builds はすべての Capgo プランで利用可能です。ビルド用の認証情報は Capgo のサーバーには保存されず、ビルド時のみ使用され、完了後に削除されます。ビルドの出力は、オプションで有効期限付きのダウンロードリンクとともにアップロードできます。
先に認証情報を保存する
「先に認証情報を保存する」というセクションnpx @capgo/cli build credentials save --appId YOUR_APP_ID --platform iosnpx @capgo/cli build credentials save --appId YOUR_APP_ID --platform androidCI で出力 URL を取得する
「CI で出力 URL を取得する」というセクション合格 --output-record ダウンロードURLとQR code を保存するには、以下を使用します: build last-output 読み取るには:
npx @capgo/cli build request APP_ID --platform android --output-upload --output-record /tmp/build.jsonnpx @capgo/cli build last-output --path /tmp/build.json --field outputUrl🔹 必須
「 🔹 必須」というセクションnpx @capgo/cli@latest build needed🧭 Native Build が必要な場合は “yes” と出力して code 1 で終了し、それ以外の場合は “no” と出力して code 0 で終了します。コマンドが失敗した場合は code 2 で終了します。
例:
npx @capgo/cli@latest build needed com.example.app --channel production --verboseオプション:
| パラメーター | 種類 | 説明 |
|---|---|---|
| -a | string | アカウントにリンクするための API キー |
| -c | string | 比較対象のChannel。デフォルトは CapacitorUpdater.defaultChannel または公開デフォルトChannel です |
| —package-json | string | モノレポ用のpackage.jsonファイルへのパス(カンマ区切り) |
| —node-modules | string | モノレポ用の node_modules ディレクトリへのパス(カンマ区切り) |
| —verbose | boolean | 詳細なログ付きのverbose出力を有効にします |
| —supa-host | string | カスタムSupabaseホストURL(セルフホストまたは Capgo 開発用) |
| —supa-anon | string | カスタムSupabase anon key(セルフホスト用) |
🚀 Init
「 🚀 Init」セクションエイリアス: onboarding
npx @capgo/cli@latest build initビルド認証情報を対話形式で設定します(iOS: 証明書とプロファイルを自動設定。Android: keystoreとGoogle OAuthを使用してGCPサービスアカウントとPlay Consoleへの招待を準備)
オプション:
| パラメーター | 種類 | 説明 |
|---|---|---|
| -a | string | アカウントにリンクするための API キー |
| -p | string | オンボーディングする Platform (ios または android)。省略した場合、ネイティブフォルダが1つのみ存在すれば自動検出されます。それ以外の場合はプロンプトが表示されます。 |
| —supa-host | string | カスタムSupabaseホストURL(セルフホストまたは Capgo 開発用) |
| —no-analytics | boolean | この実行における build オンボーディングの analytics と terminal replay を無効にします |
🔹 リクエスト
「🔹 リクエスト」セクションnpx @capgo/cli@latest build requestCapgo Cloud に Native Build をリクエストします。 このコマンドはプロジェクトディレクトリを zip 圧縮し、ビルドのために Capgo へ upload します。 ビルドが完了すると、各アプリストアへ直接送信されます。 認証情報は Capgo のサーバーには保存されず、ビルド後に削除されます。ビルドをリクエストする前に、情報を保存しておいてください:
npx @capgo/cli build credentials save --appId APP_ID --platform ios例:
npx @capgo/cli@latest build request com.example.app --platform ios --path .オプション:
| パラメーター | 種類 | 説明 |
|---|---|---|
| —path | string | ビルド対象のプロジェクトディレクトリへのパス (デフォルト: カレントディレクトリ) |
| —node-modules | string | モノレポ用の node_modules ディレクトリへのパス(カンマ区切り) |
| —platform | string | ターゲットプラットフォーム: ios または android (必須) |
| —build-mode | string | ビルドモード: debug または release (デフォルト: release) |
| —build-certificate-base64 | string | iOS: Base64エンコードされた .p12 証明書 |
| —p12-password | string | iOS: 証明書のパスワード(証明書にパスワードがない場合は省略可) |
| —apple-id | string | iOS: App-specific passwordでのアップロードに使うApple IDメールアドレス(App Store Connect API キーの代替) |
| —apple-app-specific-password | string | iOS: TestFlightへのアップロード用App-specific password (xxxx-xxxx-xxxx-xxxx) |
| —apple-app-id | string | iOS: App Store Connectの数値形式のApp ID(—apple-idおよび—apple-app-specific-passwordとの併用が必須) |
| —apple-key-id | string | iOS: App Store Connect API Key ID |
| —apple-issuer-id | string | iOS: App Store Connect Issuer ID |
| —apple-key-content | string | iOS: Base64エンコードされたApp Store Connect API キー (.p8) |
| —app-store-connect-team-id | string | iOS: App Store Connect Team ID |
| —ios-scheme | string | iOS: ビルドするXcode scheme (デフォルト: App) |
| —ios-target | string | iOS: ビルド設定を読み取るXcode target (デフォルト: schemeと同じ) |
| —xcode-version | string | iOS: 指定したXcodeバージョンでビルド (例: 26, 26.0.1, 27)。メジャーバージョン指定時はマイナーバージョンを問わず適用。デフォルト: すべての環境。優先順位: CLI > 環境変数 (CAPGO_IOS_XCODE_VERSION) > 保存済みの認証情報 |
| —ios-distribution | string | iOS: Distributionモード |
| —ios-provisioning-profile | string | iOS: プロビジョニングプロファイルのパス、または bundleId=path のマッピング(複数指定可) |
| —android-keystore-file | string | Android: Base64エンコードされたkeystoreファイル |
| —keystore-key-alias | string | Android: Keystoreのキーエイリアス |
| —keystore-key-password | string | Android: Keystoreのキーパスワード |
| —keystore-store-password | string | Android: Keystoreのストアパスワード |
| —play-config-json | string | Android: Base64エンコードされたGoogle PlayサービスアカウントのJSON |
| —android-flavor | string | Android: ビルドするProduct flavor(例: production)。プロジェクトに複数のflavorがある場合に必須です。 |
| —android-track | string | Android: 今回のアップロードに使用するGoogle Playのトラック(internal, alpha, beta, production)。—submit-to-store-reviewを指定しない場合はデフォルトでinternal。—submit-to-store-reviewを指定し、トラックが未設定の場合はproduction。優先順位: CLI > env > 保存された認証情報 |
| —android-release-status | string | Android: Google Playのリリースステータス(draft, completed, inProgress, halted)。—submit-to-store-reviewを指定しない場合はデフォルトでdraft。—submit-to-store-reviewを指定し、ステータスが未設定の場合はcompleted。優先順位: CLI > env > 保存された認証情報 |
| —in-app-update-priority | string | Android: 今回のリリースにおけるGoogle Playのアプリ内アップデート優先度(整数 0–5。値が大きいほど緊急性が高い)。詳細は https://developer.android.com/guide/playcore/in-app-updates を参照してください。優先順位: CLI > env > 保存された認証情報 |
| —no-playstore-upload | boolean | このビルドでのPlay Storeへのアップロードをスキップします(保存されたPlay設定をnullにします)。—output-uploadが必要です。 |
| —submit-to-store-review | boolean | アップロード後、ビルドをドラフトや非アクティブな状態のままにするのではなく、ストアのリリース審査に提出します。Androidでは、デフォルトでproductionトラックのrelease_status completedとして送信されます(—android-track / PLAY_STORE_TRACK および —android-release-status / PLAY_STORE_RELEASE_STATUS で上書き可能)。iOSでは、処理済みのTestFlightビルドをApp Storeの審査に提出します。 |
| —store-release-name | string | ストアのリリース名/バージョンラベル。AndroidではGoogle Playのversion_nameとして送信されます。iOSでは、編集可能なバージョンを作成または再利用する際のApp Storeのバージョンとして使用されます。 |
| —store-release-notes | string | デフォルトのストアリリースノート。AndroidではPlayストアの変更履歴として使用され、iOSではApp Storeの「新機能」テキストのフォールバックとして使用されます。 |
| —store-release-notes-locale | string | ローカライズされたストアリリースノート(複数指定可能)。例: —store-release-notes-locale en-US="Bug fixes" —store-release-notes-locale ja-JP="バグ修正"。 |
| —ios-testflight-groups | string | iOS: 外部ベータ配布用のTestFlight外部グループ名またはIDをカンマ区切りで指定します(任意)。 |
| —ios-automatic-release | boolean | iOS: Appleの承認後、App Storeのバージョンを自動的にリリースします。デフォルトは手動リリースです。 |
| —no-ios-automatic-release | boolean | iOS: Appleの承認後、App Storeでのリリースを手動で行うまで待機します。 |
| —output-upload | boolean | このビルドのみ出力のアップロード動作を上書きします(有効化)。優先順位: CLI > 環境変数 > 保存された認証情報 |
| —no-output-upload | boolean | このビルドのみ出力のアップロード動作を上書きします(無効化)。優先順位: CLI > 環境変数 > 保存された認証情報 |
| —output-retention | string | このビルドのみ出力リンクのTTLを上書きします (1h〜7d)。例: 1h, 6h, 2d。優先順位: CLI > 環境変数 > 保存された認証情報 |
| —output-record | string | After a successful build, write a JSON record (jobId, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt) to a path. A PNG QR code is also written next to that path with the .qr.png suffix. Read fields back with build last-output. |
| —no-cache | boolean | ビルドキャッシュの復元をスキップ と このビルドの新しいキャッシュエントリを保存しません。ビルドキャッシュはアプリごとにデフォルトで有効です。 |
| —cache-key | string | 環境、ブランチ、またはAndroid flavorごとにビルドキャッシュを分割します(例: prod, staging)。アプリごとに1つの共通デフォルトキャッシュを使用する場合は省略してください。 |
| —no-skip-build-number-bump | boolean | 保存された認証情報を上書きし、このビルドのみビルド番号の自動インクリメントを再度有効にします。 |
| —skip-marketing-version-bump | boolean | アプリが既にリリース済みの際、マーケティングバージョン(CFBundleShortVersionString / versionName)の自動更新をスキップします。 |
| —sync-ios-version | boolean | iOS: プロジェクトをアップロードする前に、package.jsonからXcodeのMARKETING_VERSIONを同期します。 |
| —ai-analytics | boolean | ビルド失敗時に、診断のためログを Capgo AI に送信します。対話型ターミナルでは事前の確認をスキップし、CI環境では自動でアップロードして解析結果を stderr に出力します。 |
| —no-prescan | boolean | 自動のプリビルドスキャンをスキップします |
| —prescan-ignore-fatal | boolean | プリビルドスキャンを実行しますが、ビルドを中断させません(レポートのみ出力) |
| —prescan-skip | string | IDを指定して特定のプリビルドスキャンをスキップします(複数指定可、またはカンマ区切り)。他のチェックは実行されます。 |
| —prescan-warn | string | IDを指定して特定のプリビルドスキャンを警告レベルに下げます(複数指定可、またはカンマ区切り)。チェック自体は実行されます。 |
| —fail-on-warnings | boolean | プリビルドスキャンの警告を致命的なエラーとして扱います |
| —send-logs-to-support | boolean | CI/CD ビルドが失敗すると、ビルドログを自動で Capgo サポートにアップロードします(メールアドレス不要)。Capgo サポートに通知され、メールでフォローアップします。—ai-analytics と併用できます。 |
| —send-logs | boolean | —send-logs-to-support の非推奨エイリアス |
| -a | string | アカウントにリンクするための API キー |
| —supa-host | string | カスタムSupabaseホストURL(セルフホストまたは Capgo 開発用) |
| —supa-anon | string | カスタムSupabase anon key(セルフホスト用) |
| —verbose | boolean | 詳細なログ付きのverbose出力を有効にします |
ビルドキャッシュ: デフォルトでは、Capgo はアプリごとにコンパイル済みの Native Build アーティファクト(CocoaPods、Gradle、および関連する出力)を復元・保存します。詳細は --cache-key を使用して RC と本番環境のキャッシュを分離できます。また、 --no-cache を使用すると、一度限りのクリーンビルドが可能です。API の統合では、 cache_key または cache_enabled: false をビルドリクエストのペイロードに含めることができます。詳細は ビルドキャッシュ と トラブルシューティング:キャッシュの復元エラー.
🔹 Sync-ios-version
「 🔹 Sync-ios-version」というタイトルのセクションnpx @capgo/cli@latest build sync-ios-versionpackage.json からローカルの iOS Xcode MARKETING_VERSION を同期します。
例:
npx @capgo/cli@latest build sync-ios-version --path .オプション:
| パラメーター | 種類 | 説明 |
|---|---|---|
| —path | string | プロジェクトディレクトリへのパス (デフォルト: カレントディレクトリ) |
| —check | boolean | チェックのみ実行。MARKETING_VERSIONが同期されていない場合は、終了ステータスとして非ゼロを返します |
🔹 Prescan
「 🔹 Prescan」セクションnpx @capgo/cli@latest build prescanScan your project and saved credentials for problems that would fail a cloud build — before uploading anything.
Checks credentials (expiry, passwords, profile pairing), project state (cap sync, node_modules layout), and platform config. Runs automatically inside build requestこのコマンドを使用すると、単体(CI環境など)で実行できます。
詳細は プリスキャンチェック で全チェック項目と、各ルールを --skip / --warn 実行する方法を確認してください。
オプション:
| パラメーター | 種類 | 説明 |
|---|---|---|
| —platform | string | ターゲットプラットフォーム: ios または android (必須) |
| —path | string | プロジェクトディレクトリへのパス (デフォルト: カレントディレクトリ) |
| -a | string | アカウントにリンクするための API キー |
| —android-flavor | string | Android: ビルドで使用する product flavor |
| —ios-dist | string | iOS: 検証対象の distribution mode |
| —json | boolean | マシン読み取り可能なJSON形式でレポートを出力します |
| —fail-on-warnings | boolean | 警告が見つかった場合に終了ステータスを非ゼロにします (CI用) |
| —ignore-fatal | boolean | 診断モード: すべてを報告しますが、終了ステータスは常に0になります |
| —skip | string | 指定したIDのチェックをスキップします (複数指定可、またはカンマ区切り) |
| —warn | string | 指定したIDのチェックを警告レベルに下げます (複数指定可、またはカンマ区切り) |
| —verbose | boolean | 詳細なログ付きのverbose出力を有効にします |
| —supa-host | string | カスタムSupabaseホストURL(セルフホストまたは Capgo 開発用) |
| —supa-anon | string | カスタムSupabase anon key(セルフホスト用) |
🔹 Last-output
「🔹 Last-output」セクションnpx @capgo/cli@latest build last-output以前のビルドによって書き込まれたビルド出力レコードを読み取ります。 build request --output-recordデフォルトでは完全なJSONを表示します。—field を指定すると特定のフィールドのみ、—qr を指定すると ASCII QR
code を表示します。CI環境で、PRやIssueにダウンロードURLやQRコードを投稿するために取得する際に便利です。
例:
npx @capgo/cli build last-output —path /tmp/build.json
npx @capgo/cli build last-output —path /tmp/build.json —field outputUrl
npx @capgo/cli build last-output —path /tmp/build.json —qr
オプション:
| パラメーター | 種類 | 説明 |
|---|---|---|
| —path | string | —output-record で書き出された JSON レコードへのパス (必須) |
| —field | string | 特定のフィールドのみを表示 (jobId, appId, platform, buildMode, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt, schemaVersion) |
| —qr | boolean | レンダリングされた ASCII QR code を表示 (—field qrCodeAscii のショートカット) |
🔹 Credentials
「 🔹 Credentials」というタイトルのセクションローカルマシンに保存されているビルド用の Credentials を管理します。 🔒 SECURITY:
- Credentials は ~/.capgo-credentials/credentials.json (グローバル) または .capgo-credentials.json (ローカル) に保存されます
- ビルド時に Capgo へ送信されますが、永続的に保存されることはありません
- Capgo からはビルド直後に削除されます
- ビルド成果物をアップロードして、期間限定のダウンロードリンクを作成することも可能です 📚 ドキュメント: iOSの設定: https://capgo.app/docs/cli/cloud-build/ios/ Androidの設定: https://capgo.app/docs/cli/cloud-build/android/
🔹 Apple-key
「 🔹 Apple-key」というセクションエイリアス: asc-key
npx @capgo/cli@latest build credentials apple-keymacOS専用のガイド付きヘルパーで、App Store Connectのチーム API キーを作成します。 ネイティブウィンドウが開き、埋め込みブラウザ上でAppleのApp Store Connect UIを順を追って案内しながら、Issuer IDとKey IDを自動取得し、一度だけ表示される .p8 をインターセプトしてApple側で検証したうえで ~/.appstoreconnect/private_keys に保存します。 進捗統計は Capgo のアナリティクスに送信されます(CAPGO_DISABLE_TELEMETRY で無効化できます)。 npx @capgo/cli build credentials apple-key —appId com.example.app
例:
Example:オプション:
| パラメーター | 種類 | 説明 |
|---|---|---|
| -a | string | アカウントにリンクするための API キー |
| —appId | string | 取得したキーをこのアプリのiOSビルド認証情報に保存します |
| —local | boolean | グローバルファイルではなく、プロジェクトごとの .capgo-credentials.json に保存します |
| —json | boolean | 取得した Key ID / Issuer ID / .p8 のパスを JSON 形式で出力します |
🔹 保存
「 🔹 Save」セクションnpx @capgo/cli@latest build credentials saveiOS または Android のビルド認証情報をローカルに保存します。 保存先:
- ~/.capgo-credentials/credentials.json (デフォルト、グローバル)
- プロジェクトルートの .capgo-credentials.json (—local フラグ使用)
⚠️ ビルド前の必須事項: ビルドをリクエストする前に、必ず認証情報を保存してください。
🔒 これらの認証情報が Capgo のサーバーに永続的に保存されることはありません。
ビルド完了後、直ちに削除されます。
📚 セットアップガイド:
iOS: https://capgo.app/docs/cli/cloud-build/ios/
Android: https://capgo.app/docs/cli/cloud-build/android/
npx @capgo/cli build credentials save —platform ios
—certificate ./cert.p12 —p12-password “password”
—ios-provisioning-profile ./profile.mobileprovision
—apple-key ./AuthKey.p8 —apple-key-id “KEY123”
—apple-issuer-id “issuer-uuid” —apple-team-id “team-id” マルチターゲットの例 (app + widget extension): npx @capgo/cli build credentials save —platform ios
—ios-provisioning-profile ./App.mobileprovision
—ios-provisioning-profile com.example.widget=./Widget.mobileprovision
… npx @capgo/cli build credentials save —platform android
—keystore ./release.keystore —keystore-alias “my-key”
—keystore-key-password “key-pass”
—play-config ./service-account.json ローカルストレージ (プロジェクトごと): npx @capgo/cli build credentials save —local —platform ios …
例:
iOS Example:オプション:
| パラメーター | 種類 | 説明 |
|---|---|---|
| —appId | string | App ID (例: com.example.app) (必須) |
| —platform | string | Platform: ios または android (必須) |
| —certificate | string | iOS: .p12証明書ファイルへのパス |
| —ios-provisioning-profile | string | iOS: プロビジョニングプロファイルのパス、または bundleId=path (複数指定可) |
| —p12-password | string | iOS: 証明書のパスワード(証明書にパスワードがない場合は省略可) |
| —apple-key | string | iOS: .p8 App Store Connect API キーへのパス |
| —apple-key-id | string | iOS: App Store Connect API Key ID |
| —apple-issuer-id | string | iOS: App Store Connect Issuer ID |
| —apple-team-id | string | iOS: App Store Connect Team ID |
| —ios-distribution | string | iOS: ディストリビューションモード |
| —apple-id | string | iOS: App-specific passwordでのアップロードに使うApple IDメールアドレス(App Store Connect API キーの代替) |
| —apple-app-specific-password | string | iOS: TestFlightへのアップロード用App-specific password (xxxx-xxxx-xxxx-xxxx) |
| —apple-app-id | string | iOS: App Store Connectの数値形式のApp ID(—apple-idおよび—apple-app-specific-passwordとの併用が必須) |
| —keystore | string | Android: keystoreファイルへのパス (.keystore または .jks) |
| —keystore-alias | string | Android: Keystore キーのエイリアス |
| —keystore-key-password | string | Android: Keystore キーのパスワード |
| —keystore-store-password | string | Android: Keystore ストアのパスワード |
| —play-config | string | Android: Play Store サービスアカウント JSON へのパス |
| —android-flavor | string | Android: ビルドする Product flavor (例: production)。プロジェクトに複数の flavor がある場合に必須。 |
| —in-app-update-priority | string | Android: 次回リリース時の Google Play インアプリアップデート優先度 (整数 0–5; 高いほど緊急)。省略すると現在の値が維持されます。 |
| —local | boolean | グローバルの ~/.capgo-credentials/ ではなく、プロジェクトルートの .capgo-credentials.json に保存します |
| —output-upload | boolean | ビルド成果物 (IPA/APK/AAB) を Capgo ストレージにアップロードし、ダウンロードリンクを表示します |
| —no-output-upload | boolean | ビルド成果物 (IPA/APK/AAB) を Capgo ストレージにアップロードしません |
| —output-retention | string | リンクの有効期限 (TTL): 1h 〜 7d (デフォルト: 1h)。例: 1h, 6h, 2d |
| —skip-build-number-bump | boolean | 今後のビルドにおけるビルド番号/バージョンの code 自動インクリメントをスキップします |
| —no-skip-build-number-bump | boolean | ビルド番号の自動インクリメントを再度有効にします (デフォルトの動作) |
| —skip-marketing-version-bump | boolean | アプリが既にリリース済みの場合、今後のビルドでのマーケティングバージョンの自動更新をスキップします |
| —no-skip-marketing-version-bump | boolean | マーケティングバージョンの自動更新を再度有効にします(デフォルトの動作) |
📋 一覧表示
「 📋 List」セクションnpx @capgo/cli@latest build credentials list保存されているビルド認証情報を表示します(パスワードはマスクされます)。 現在保存されている認証情報(グローバルおよびローカルの両方)を表示します。 例: npx @capgo/cli build credentials list # すべてのアプリを表示 npx @capgo/cli build credentials list —appId com.example.app # 特定のアプリを表示
オプション:
| パラメーター | 種類 | 説明 |
|---|---|---|
| —appId | string | リスト表示するApp ID(省略時はすべて表示) |
| —local | boolean | ローカルの .capgo-credentials.json からのみ認証情報を取得 |
🔹 クリア
「 🔹 Clear」セクションnpx @capgo/cli@latest build credentials clear保存されているビルド用の認証情報を削除します。 ストレージから認証情報を削除します。 特定の認証情報を対象にするには —appId と —platform を使用してください。 例: npx @capgo/cli build credentials clear # すべてのアプリをクリア (global) npx @capgo/cli build credentials clear —local # ローカルの認証情報をクリア npx @capgo/cli build credentials clear —appId com.example.app —platform ios
オプション:
| パラメーター | 種類 | 説明 |
|---|---|---|
| —appId | string | クリアするApp ID(省略時はすべてのアプリをクリア) |
| —platform | string | クリアするプラットフォーム: ios または android(省略時はすべてのプラットフォームをクリア) |
| —local | boolean | グローバルではなく、ローカルの .capgo-credentials.json からクリアします |
🔹 更新
「 🔹 Update」セクションnpx @capgo/cli@latest build credentials updateすべてを再入力せずに、特定の認証情報を更新します。 変更したいフィールドだけを指定して、既存の認証情報を更新できます。 プラットフォームは指定したオプションから自動検出されます。 例: npx @capgo/cli build credentials update —ios-provisioning-profile ./new-profile.mobileprovision npx @capgo/cli build credentials update —local —keystore ./new-keystore.jks
オプション:
| パラメーター | 種類 | 説明 |
|---|---|---|
| —appId | string | App ID (省略時は capacitor.config から自動検出) |
| —platform | string | Platform: ios または android (オプションから自動検出) |
| —local | boolean | グローバルではなくローカルの .capgo-credentials.json を更新 |
| —certificate | string | P12 証明書ファイルへのパス |
| —ios-provisioning-profile | string | プロビジョニングプロファイルのパス、または bundleId=path(複数指定可、デフォルトは追加) |
| —overwrite-ios-provisioning-map | boolean | マージせずにプロビジョニングマップ全体を置き換える(デフォルト: マージ) |
| —p12-password | string | P12証明書のパスワード |
| —apple-key | string | App Store Connect API キー(.p8ファイル)へのパス |
| —apple-key-id | string | App Store Connect API キーID |
| —apple-issuer-id | string | App Store Connect Issuer ID |
| --apple-team-id | string | App Store Connect チーム ID |
| --apple-id | string | iOS: App-specific passwordでのアップロードに使うApple IDメールアドレス(App Store Connect API キーの代替) |
| --apple-app-specific-password | string | iOS: TestFlightへのアップロード用App-specific password (xxxx-xxxx-xxxx-xxxx) |
| --apple-app-id | string | iOS: App Store Connectの数値形式のApp ID(—apple-idおよび—apple-app-specific-passwordとの併用が必須) |
| --ios-distribution | string | iOS: Distribution モード |
| --keystore | string | keystore ファイルへのパス (.keystore または .jks) |
| —keystore-alias | string | Keystore キーのエイリアス |
| —keystore-key-password | string | Keystore key のパスワード |
| —keystore-store-password | string | Keystore ストアのパスワード |
| —play-config | string | Google Play サービスアカウントの JSON へのパス |
| —android-flavor | string | Android: ビルドする Product flavor(例: production)。プロジェクトに複数の flavor がある場合は必須です。 |
| —in-app-update-priority | string | Android: 今後のリリース向けの Google Play インアプリアップデート優先度(整数 0–5。値が大きいほど緊急度が高い)。 |
| —output-upload | boolean | ビルド成果物 (IPA/APK/AAB) を Capgo ストレージにアップロードし、ダウンロードリンクを表示します |
| —no-output-upload | boolean | ビルド成果物 (IPA/APK/AAB) を Capgo ストレージにアップロードしません |
| —output-retention | string | 出力リンクの有効期限 (TTL): 1h 〜 7d。例: 1h, 6h, 2d |
| —skip-build-number-bump | boolean | 今後のビルドにおけるビルド番号/バージョンの code 自動インクリメントをスキップします |
| —no-skip-build-number-bump | boolean | ビルド番号の自動インクリメントを再度有効にします (デフォルト) |
| —skip-marketing-version-bump | boolean | アプリがリリース済みの際、今後のビルドにおけるマーケティングバージョンの自動更新をスキップします |
| —no-skip-marketing-version-bump | boolean | マーケティングバージョンの自動更新を再度有効にする(デフォルトの動作) |
npx @capgo/cli@latest build credentials manage保存されたビルド認証情報をインタラクティブに管理します。
保存済みの認証情報の閲覧、設定内容の確認、CI/CD対応の .env ファイルのエクスポート、またはプラットフォームごとの認証情報の削除が可能です。以下のものと同じTUIを使用します: capgo init.
例:
npx @capgo/cli build credentials manage
npx @capgo/cli build credentials manage —appId com.example.app
npx @capgo/cli build credentials manage —appId com.example.app —platform ios
npx @capgo/cli build credentials manage —local
オプション:
| パラメーター | 種類 | 説明 |
|---|---|---|
| —appId | string | 管理するApp ID(省略した場合、選択のプロンプトが表示されます) |
| —platform | string | 管理するプラットフォーム: ios または android(省略した場合、選択のプロンプトが表示されます) |
| —local | boolean | ローカルの .capgo-credentials.json のみを参照します |
🔹 Migrate
「 🔹 Migrate」というタイトルのセクションnpx @capgo/cli@latest build credentials migrate従来のプロビジョニングプロファイルを新しいマルチターゲット形式に移行します。 BUILD_PROVISION_PROFILE_BASE64 を CAPGO_IOS_PROVISIONING_MAP に変換します。 Xcodeプロジェクトからメインのbundle IDを自動的に検出します。 npx @capgo/cli build credentials migrate —platform ios
例:
Example:オプション:
| パラメーター | 種類 | 説明 |
|---|---|---|
| —appId | string | App ID (省略時は capacitor.config から自動検出) |
| —platform | string | Platform (ios のみ対応) |
| —local | boolean | グローバルではなく、ローカルの .capgo-credentials.json から移行します |