🔹 ビルド
インストール手順と、このプラグインの完全なMarkdownガイドを含むセットアッププロンプトをコピーします。
🏗️ Capgo CloudでネイティブiOS/Androidビルドを管理します。
ビルドへのアクセスと出力
セクション「ビルドへのアクセスと出力」ネイティブクラウドビルドはすべての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ネイティブビルドが必要な場合は「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 キー (セルフホスト用) |
🚀 初期化
セクション「🚀 Init」エイリアス: onboarding
npx @capgo/cli@latest build init対話的にビルド認証情報を設定します(iOS: 証明書とプロファイルの自動化、Android: keystoreとGoogle OAuthによるGCPサービスアカウントのプロビジョニングとPlay Console招待)
オプション:
| パラメータ | 種類 | 説明 |
|---|---|---|
| -a | string | アカウントに紐付ける API キー |
| -p | string | オンボーディングするプラットフォーム(iosまたはandroid)。省略した場合、ネイティブフォルダが1つしかない場合は自動検出され、それ以外の場合はプロンプトが表示されます。 |
| —supa-host | string | カスタム Supabase ホスト URL (セルフホストまたは Capgo 開発用) |
| —no-analytics | boolean | この実行ではビルドの onboarding アナリティクスとターミナルリプレイを無効にします |
🔹 リクエスト
「🔹 Request」セクションnpx @capgo/cli@latest build requestCapgo Cloud から Native Build をリクエストします。 このコマンドはプロジェクトディレクトリを zip 圧縮し、ビルド用に Capgo へアップロードします。 ビルドは処理され、アプリストアへ直接送信されます。 認証情報は 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 ディレクトリへのパス(カンマ区切り) |
| —プラットフォーム | 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用パスワードでアップロードする際のApple IDメールアドレス (App Store Connect の API キーの代替) |
| —apple-app-specific-password | string | iOS: TestFlightへのアップロード用のApp用パスワード (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 キー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 チーム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: 配布モード |
| —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 fr-FR="Corrections"。 |
| —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 | このbuildに限り出力uploadの動作を上書きします(有効化)。優先順位: CLI > env > 保存済み認証情報 |
| —no-output-upload | boolean | このbuildに限り出力uploadの動作を上書きします(無効化)。優先順位: CLI > env > 保存済み認証情報 |
| —output-retention | string | このbuildに限り出力リンクのTTLを上書きします(1h〜7d)。例: 1h、6h、2d。優先順位: CLI > env > 保存済み認証情報 |
| —output-record | string | build成功後、JSONレコード(jobId, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt)を指定パスに書き出します。そのパスの隣にPNG QR code も書き出されます。 .qr.png サフィックス。フィールドを読み戻すには 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 チェックをスキップします(繰り返し指定またはカンマ区切り可)。他のチェックは引き続き実行されます。 |
| —prescan-warn | string | ID を指定して特定の prescan チェックを警告にダウングレードします(繰り返し指定またはカンマ区切り可)。チェックは引き続き実行されます。 |
| —fail-on-warnings | boolean | prescanの警告を致命的エラーとして扱う |
| —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 キー (セルフホスト用) |
| —verbose | boolean | 詳細ログ付きのverbose出力を有効にします |
ビルドキャッシュ: デフォルトでは、Capgo がアプリごとにコンパイル済みのネイティブアーティファクト(CocoaPods、Gradle、関連する出力)を復元・保存します。RC と本番のキャッシュを分けるには --cache-key を使用してください。また、 --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 が同期していない場合、非ゼロで終了します |
🔹 プリスキャン
セクション「 🔹 プリスキャン」npx @capgo/cli@latest build prescanアップロード前に、クラウドビルドで失敗する可能性のある問題をプロジェクトと保存済み認証情報からスキャンします。
認証情報(有効期限、パスワード、プロファイルのペアリング)、プロジェクトの状態(cap sync、node_modules の構成)、プラットフォーム設定を確認します。自動的に実行されます build request。このコマンドは単独で実行します(例: CI)。
詳細は プリスキャンチェック を参照してください。完全なチェックカタログと --skip / --warn 個々のルールの設定方法について。
オプション:
| パラメータ | 種類 | 説明 |
|---|---|---|
| —プラットフォーム | 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 キー (セルフホスト用) |
🔹 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」セクションマシンにローカル保存されたビルド認証情報を管理します。 🔒 セキュリティ:
- 認証情報は ~/.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キー
セクション「 🔹 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 を自動取得し、1 回限りの .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 形式で出力します |
🔹 保存
セクション「🔹 保存」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” マルチターゲットの例(アプリ + ウィジェット拡張機能): 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)(必須) |
| —プラットフォーム | string | プラットフォーム: 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 キーID |
| —apple-issuer-id | string | iOS: App Store Connect の Issuer ID |
| —apple-team-id | string | iOS: App Store Connect チームID |
| —ios-distribution | string | iOS: 配布モード |
| —apple-id | string | iOS: App用パスワードでアップロードする際のApple IDメールアドレス (App Store Connect の API キーの代替) |
| —apple-app-specific-password | string | iOS: TestFlightへのアップロード用のApp用パスワード (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 の整数。大きいほど緊急度が高い)。省略すると Play の既存の値は変更されません。 |
| —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 | マーケティングバージョンの自動インクリメントを再有効化(デフォルトの動作) |
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 # すべてのアプリをクリア(グローバル) npx @capgo/cli build credentials clear —local # ローカルの認証情報をクリア npx @capgo/cli build credentials clear —appId com.example.app —platform ios
オプション:
| パラメータ | 種類 | 説明 |
|---|---|---|
| —appId | string | クリアする App ID(省略時はすべてのアプリをクリア) |
| —プラットフォーム | 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 から自動検出) |
| —プラットフォーム | string | プラットフォーム: 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 の発行者 ID |
| —apple-team-id | string | App Store Connect チーム ID |
| —apple-id | string | iOS: App用パスワードでアップロードする際のApple IDメールアドレス (App Store Connect の API キーの代替) |
| —apple-app-specific-password | string | iOS: TestFlightへのアップロード用のApp用パスワード (xxxx-xxxx-xxxx-xxxx) |
| —apple-app-id | string | iOS: App Store Connect の数値のApp ID (—apple-id と —apple-app-specific-password との併用が必須) |
| —ios-distribution | string | iOS: 配布モード |
| —keystore | string | keystore ファイルへのパス (.keystore または .jks) |
| —keystore-alias | string | Keystoreのキーエイリアス |
| —keystore-key-password | string | Keystoreのキーパスワード |
| —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(省略時は選択プロンプトが表示されます) |
| —プラットフォーム | string | 管理対象のプラットフォーム: ios または android(省略時は選択プロンプトが表示されます) |
| —local | boolean | ローカルの .capgo-credentials.json のみ参照 |
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 から自動検出) |
| —プラットフォーム | string | Platform (ios のみ対応) |
| —local | boolean | グローバルではなく、ローカルの .capgo-credentials.json から移行します |