🔹 ビルド
このプラグインのセットアップのためのコピー可能な質問とインストールのステップ、そして完全なマークダウンガイドを含む。
🏗️ 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 androidビルドクレデンシャルを保存する
パスPass --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🧭 1 という値で native ビルドが必要な場合に “yes” を出力し、code で終了します。そうでない場合に “no” を出力し、code で終了します。コマンドの失敗は code で終了します。
例:
npx @capgo/cli@latest build needed com.example.app --channel production --verboseオプション:
| パラメーター | タイプ | 説明 |
|---|---|---|
| -a | string | APIキーを使用してアカウントにリンク |
| -c | string | 比較対象のチャンネル。デフォルトはCapacitorUpdater.defaultChannelまたはパブリックデフォルトチャンネル |
| —package-json | string | モノレポ用のpackage.jsonファイルのパス(カンマ区切り) |
| —node-modules | string | モノレポ用のnode_modulesディレクトリのパス(カンマ区切り) |
| —verbose | boolean | 詳細なログとともに詳細な出力を有効にする |
| —supa-host | string | カスタム Supabase ホスト URL (自社ホスティングまたはCapgo開発用) |
| —supa-anon | string | カスタム Supabase anon キー (自社ホスティング用) |
🚀 Init
セクション「 🚀 Init」Alias: onboarding
npx @capgo/cli@latest build initiOS: 証明書とプロファイルの自動化; Android: キーストアと Google OAuth で GCP サービス アカウントと Play Console の招待
オプション:
| パラメーター | タイプ | 概要 |
|---|---|---|
| -a | string | APIキーを使用してアカウントにリンク |
| -p | string | プラットフォームをオンボード (ios または android)。省略すると、1 つのネイティブ フォルダのみが存在する場合に自動検出され、他の場合はプロンプトが表示されます。 |
| —supa-host | string | カスタム Supabase ホスト URL (自社ホスティングまたは Capgo 開発用) |
| —no-analytics | boolean | この実行でビルド オンボード分析とターミナル リプレイを無効にする |
🔹 リクエスト
「 🔹 リクエスト」セクションnpx @capgo/cli@latest build requestCapgo クラウドからネイティブ ビルドを要求します。 このコマンドはプロジェクト ディレクトリを 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 .オプション:
| パラメーター | 種類 | 説明 |
|---|---|---|
| —パス | 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: Apple IDのメールアドレス (アプリ固有のパスワードアップロードの代替として、App Store Connect API キー) |
| —apple-app-specific-password | string | iOS: App-specificパスワード (xxxx-xxxx-xxxx-xxxx) for TestFlight uploads |
| —apple-app-id | string | iOS: App Store Connectの数値アプリ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の発行者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 を使用してビルド (default: App) |
| —ios-target | string | iOS: Xcode のターゲットを使用してビルド設定を読み取る (default: scheme と同じ) |
| —ios-distribution | string | iOS: 分配モード |
| —ios-provisioning-profile | string | iOS: 証明書プロファイルのパスまたは bundleId=path マッピング (繰り返し) |
| —android-keystore-file | string | Android: Base64 でエンコードされたキーストアファイル |
| —keystore-key-alias | string | Android: Keystore key alias |
| —keystore-key-password | string | Android: Android キーストア キー パスワード |
| —keystore-store-password | string | Android: Android キーストア ストア パスワード |
| —play-config-json | string | Android: Google Play サービス アカウント JSON の Base64 エンコード |
| —android-flavor | string | Android: ビルドする製品フラバー (例: 本番)。プロジェクトが複数のフラバーを持つ場合に必要です。 |
| —android-track | string | Android: Google Play track for this upload (internal, alpha, beta, production). Default without —submit-to-store-review: internal. With —submit-to-store-review and no track set: production. Precedence: CLI > env > saved credentials |
| —android-release-status | string | Android: Google Play のリリースステータス (draft, completed, inProgress, halted). —submit-to-store-review が指定されていない場合のデフォルトは draft です。 —submit-to-store-review とステータスが設定されていない場合: completed です。優先順位: CLI > env > saved credentials |
| —in-app-update-priority | string | Android: Google Play のインアプリ更新優先度 (整数 0–5; 高いほど急いで更新します). 详细信息请参见 https://developer.android.com/guide/playcore/in-app-updates. 優先順位: CLI > env > saved credentials |
| —no-playstore-upload | boolean | このビルドのPlay Storeのアップロードをスキップします (保存されたPlay Configをnullにします). —output-upload が必要です. |
| —submit-to-store-review | boolean | アップロード後、ストアリリースをレビューのために提出するのではなく、ドラフト/非アクティブビルドとして残します。 Androidでは、デフォルトではプロダクショントラックにリリースステータスを設定します (—android-track / PLAY_STORE_TRACK および —android-release-status / PLAY_STORE_RELEASE_STATUS でオーバーライドできます). iOSでは、処理済みのTestFlightビルドをApp Storeレビューに提出します. |
| —store-release-name | string | ストアリリース名/バージョンラベル。 AndroidではGoogle Playのバージョン名として送信され、iOSではApp Storeのバージョンを作成または再利用する際に使用されます. |
| —store-release-notes | string | デフォルトのストアリリースノート。AndroidではPlayの変更履歴として使用され、iOSではApp Storeの新機能テキストとして使用されます。 |
| —store-release-notes-locale | string | ローカライズされたストアリリースノート（繰り返し）、例えば —store-release-notes-locale en-US=「バグ修正」 —store-release-notes-locale fr-FR=「修正」。 |
| —ios-testflight-groups | string | iOS: 外部ベータ配布用のオプションのカンマ区切りのテストフライト外部グループ名またはID。 |
| —ios-automatic-release | boolean | iOS: Appleの承認後に自動的にApp Store版をリリースする。デフォルトは手動リリース。 |
| —no-ios-automatic-release | boolean | iOS: Appleの承認後に手動リリースを待つApp Store版を保つ。 |
| —output-upload | boolean | このビルドのみの出力アップロードの動作をオーバーライドする（有効）。優先順位：CLI > env > 保存済みクレデンシャル |
| —no-output-upload | boolean | このビルドのみの出力アップロード動作をオーバーライド (無効化). 優先順位: CLI > 環境変数 > 保存済み資格情報 |
| ---出力保持 | string | このビルドのみの出力リンクTTLをオーバーライド (1時間から7日). 例: 1時間, 6時間, 2日. 優先順位: CLI > 環境変数 > 保存済み資格情報 |
| ---出力レコード | string | ビルドが成功した後、JSONレコード (jobId, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt) をパスに書き込む。PNG QR code もそのパスに付加される。 .qr.png ---キャッシュ build last-output. |
| キャッシュを読み戻さない | boolean | キャッシュを読み戻さずにこのビルドの新しいキャッシュエントリを保存しない。キャッシュはデフォルトでアプリごとに有効になっている。 ---キャッシュキー ビルドキャッシュを環境、ブランチ、またはAndroidのフラビア (例えば |
| --- | string | --- prod, staging. Omit for one shared default cache per app. |
| —no-skip-build-number-bump | boolean | このビルドのみで自動的なビルド番号のインクリメントを再有効にするために、保存済みの資格情報を上書きします。 |
| —skip-marketing-version-bump | boolean | アプリが既にリリースされている場合、自動的なマーケティングバージョン (CFBundleShortVersionString / versionName) のバンプをスキップします。 |
| —sync-ios-version | boolean | iOS: Xcode MARKETING_VERSION を package.json から取得し、プロジェクトをアップロードする前にプロジェクトを同期します。 |
| —ai-analytics | boolean | ビルドが失敗した場合、Capgo AI にログを送信して診断します。インタラクティブなターミナルでは、事前に確認する必要がなく、CI では自動的にアップロードし、エラーストリームに分析結果を出力します。 |
| —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サポートに通知され、メールで連絡する。 |
| —send-logs | boolean | —send-logs-to-supportの古いエイリアス |
| -a | string | アカウントにリンクするためのAPIキー |
| —supa-host | string | 自宅ホスティングまたはCapgo開発用のカスタムスパバースホストURL |
| —supa-anon | string | 自宅ホスティング用のカスタムスパバースアノンキー |
| —verbose | boolean | 詳細なログとともに詳細な出力を有効にする |
ビルドキャッシュ: Capgoはデフォルトでアプリごとにコンパイルされたネイティブアーティファクト(CocoaPods、Gradle、関連出力)を保存し、復元します。 --cache-key キャッシュをRCとプロダクションで分離するには --no-cache CLIのための1回限りのクリーンビルドのために。API統合は通過できます。 cache_key or cache_enabled: false ビルド要求パケット内に含まれる。 ビルドキャッシュ そして トラブルシューティング: キャッシュの復元が間違っている.
🔹 Sync-ios-version
タイトル「 🔹 Sync-ios-version」npx @capgo/cli@latest build sync-ios-versioniOS Xcode MARKETING_VERSION を package.json から同期する。
例:
npx @capgo/cli@latest build sync-ios-version --path .オプション:
| パラメータ | 種類 | 説明 |
|---|---|---|
| —パス | string | プロジェクトディレクトリへのパス（デフォルト：現在のディレクトリ） |
| —チェック | boolean | チェックのみ；MARKETING_VERSIONが同期されていない場合にゼロ以外の値を返す |
🔹 プレースキャン
ターミナルウィンドウnpx @capgo/cli@latest build prescanプロジェクトと保存された資格情報をスキャンして、クラウドビルドを失敗させる可能性のある問題を検出 — アップロードする前に。 build requestCapgo CLIのビルドコマンドは、CIなどで独立して実行することができます。 See Prescan チェック --skip / --warn チェックの完全なカタログと各ルールの詳細については
オプション:
| パラメーター | タイプ | — プラットフォーム |
|---|---|---|
| —platform | string | — パス |
| パス | string | プロジェクトディレクトリへのパス (デフォルト: 現在のディレクトリ) |
| -a | string | API アカウントにリンクするためのキー |
| —android-flavor | string | Android: ビルドに使用する製品フラバー |
| —ios-dist | string | iOS: 検証するために使用する配布モード |
| —json | boolean | 機械読み取り可能な JSON レポートを出力 |
| —fail-on-warnings | boolean | 警告が見つかった場合にゼロ以外の値を返す (CI 用) |
| —ignore-fatal | boolean | 診断モード: すべての情報を報告し、常に 0 を出力します |
| —skip | string | 特定のチェックをスキップする (ID を繰り返しまたはカンマで区切る) |
| —warn | string | 特定のチェックを警告に下げる (ID を繰り返しまたはカンマで区切る) |
| —verbose | boolean | 詳細なログとともに詳細な出力を有効にする |
| —supa-host | string | 自作のSupabaseホストURL（自主運用またはCapgo開発用） |
| —supa-anon | string | カスタム Supabase anon キー (自社ホスティング用) |
🔹 最後の出力
Section titled “ 🔹 最近の出力”npx @capgo/cli@latest build last-output前の出力レコードを書き出した build request --output-record.
デフォルトでは、JSON全体を表示します。 —field を使用すると、単一のフィールド、または —qr を使用すると、ASCII QR
code を表示します。 CI でダウンロード URL または QR を取得して PR または問題に投稿するのに便利です。
例:
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
オプション:
| パラメーター | 種類 | Description |
|---|---|---|
| 説明 | string | —path |
| —field | string | 1 つのフィールドを出力 (選択肢: jobId, appId, platform, buildMode, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt, schemaVersion) |
| —qr | boolean | Print the rendered ASCII QR code (shortcut for —field qrCodeAscii) |
🔹 セクション「 🔹 認証情報」
ローカルマシン上に保存されているビルド認証情報を管理します。 🔒 セキュリティ:マシン上に保存されているビルド認証情報を管理する。
- ~/.capgo-credentials/credentials.json（グローバル）または .capgo-credentials.json（ローカル）に保存されました。
- ビルド後すぐに Capgo から削除されます
- ビルド後、Capgoから即座に削除されます。
- https://__CAPGO_KEEP_0__.app/docs/__CAPGO_KEEP_1__/cloud-build/ios/ https://capgo.app/docs/cli/cloud-build/ios/ __CAPGO_KEEP_0__ https://capgo.app/docs/cli/cloud-build/android/
🔹 Appleキー
セクション：「 Appleキー」Alias: asc-key
npx @capgo/cli@latest build credentials apple-keyApp Store Connect チーム API キーを作成するためのマクロシマシン ヘルパー (macOS 限定)。 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 in project root (with —local flag)
⚠️ REQUIRED BEFORE BUILDING: You must save credentials before requesting a build.
🔒 These credentials are NEVER stored on Capgo servers permanently.
They are deleted immediately after the build completes.
📚 Setup guides:
iOS: https://capgo.app/docs/cli/cloud-build/ios/
iOS: https://capgo.app/docs/cli/cloud-build/ios/
npx @capgo/cli build credentials save --platform ios
https://__CAPGO_KEEP_0__.app/docs/__CAPGO_KEEP_1__/cloud-build/android/
npx @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__ build credentials save —platform ios
—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 (必須) |
| —証明書 | string | iOS：.p12 証明書ファイルのパス |
| —iOSプロビジョニングプロファイル | string | iOS：プロビジョニングプロファイルのパスまたは bundleId=path (繰り返し) |
| —p12パスワード | string | iOS：証明書のパスワード (証明書にパスワードがない場合は省略可能) |
| —apple-key | string | iOS: App Store Connectの.p8ファイルのAPIキーへのパス |
| —apple-key-id | string | iOS: App Store ConnectのAPIキーID |
| —apple-issuer-id | string | iOS: App Store Connectの発行者ID |
| —apple-team-id | string | iOS: App Store ConnectのチームID |
| —ios-distribution | string | iOS: ディストリビューションモード |
| —apple-id | string | iOS: App Store Connect の API キーに代わるアプリ固有パスワードのアップロード用の Apple ID メールアドレス |
| —apple-app-specific-password | string | iOS: App-specific password (xxxx-xxxx-xxxx-xxxx) for TestFlight uploads |
| —apple-app-id | string | iOS: Numeric 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: ビルドする製品フラバー (例: 生成用). 必須です。プロジェクトが複数のフラバーを持つ場合 |
| —in-app-update-priority | string | Android: Google Play のインアプリ更新の優先度 (整数 0–5; 高いほど急いで更新) |
| —local | boolean | プロジェクトルートの .capgo-credentials.json に保存するのではなく、グローバル ~/.capgo-credentials/ に保存する |
| —output-upload | boolean | Capgo ストレージにビルド出力 (IPA/APK/AAB) をアップロードし、ダウンロードリンクを表示 |
| —no-output-upload | boolean | ビルド出力 (IPA/APK/AAB) を Capgo ストレージにアップロードしない |
| —出力保持期間 | string | 出力リンク有効期間: 1時間から7日 (標準: 1時間)。例: 1時間、6時間、2日 |
| —ビルド番号自動インクリメントスキップ | boolean | 将来のビルドで自動ビルド番号/バージョン code のインクリメントをスキップします |
| —ビルド番号自動インクリメントスキップ無効 | boolean | 将来のビルドで自動ビルド番号インクリメントを再度有効にします (標準動作) |
| —マーケティングバージョン自動インクリメントスキップ | boolean | 将来のビルドでアプリが既にリリースされている場合に自動マーケティングバージョンアップをスキップします |
| —マーケティングバージョン自動インクリメントスキップ無効 | boolean | 自動マーケティングバージョンアップを再度有効にします (標準動作) |
📋 リスト
「📋 リスト」セクションnpx @capgo/cli@latest build credentials list保存済みビルドクレデンシャルの一覧を表示 (パスワードはマスクされます)。 現在保存されているクレデンシャル (グローバルとローカル両方) を表示します。 例: npx @capgo/cli build credentials list # 全アプリをリスト npx @capgo/cli build credentials list —appId com.example.app # 特定のアプリをリスト
オプション:
| パラメーター | 種類 | context |
|---|---|---|
| —appId | string | 説明 |
| —appId | boolean | .capgo-credentials.jsonからローカルに保存された資格情報をリストします。 |
🔹 —local
Section titled “ Clear”npx @capgo/cli@latest build credentials clearSaved build credentialsを削除します。 ストレージからクレデンシャルを削除します。 —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
Options:
| Param | Type | 説明 |
|---|---|---|
| —appId | string | クリアするアプリID (省略可、全アプリをクリア) |
| —platform | string | クリアするプラットフォーム: ios または android (省略可、全プラットフォームをクリア) |
| —ローカル | boolean | グローバルではなくローカルの .capgo-credentials.json からクリアする |
🔹 更新
「 🔹 更新」のセクション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
オプション:
| パラメーター | 種類 | Description |
|---|---|---|
| 説明文 | string | App ID (自動で capacitor.config から取得されます。省略した場合) |
| —プラットフォーム | string | プラットフォーム: ios または android (オプションから自動で取得) |
| —ローカル | boolean | ローカル .capgo-credentials.json を更新するのではなく、グローバルを更新 |
| —証明書 | string | P12 証明書ファイルのパス |
| —ios プロビジョニング プロファイル | string | プロビジョニング プロファイルのパスまたは bundleId=path (繰り返し、追加するデフォルト) |
| —ios プロビジョニング マップのオーバーライト | boolean | プロビジョニング マップをすべて置き換えるのではなく、マージ (デフォルト: マージ) |
| —p12 パスワード | 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: Apple ID アプリ固有のパスワードのアップロード用メールアドレス (App Store Connect API キーの代替) |
| —apple-app-specific-password | string | iOS: App-specific password (xxxx-xxxx-xxxx-xxxx) for TestFlight アップロード |
| —apple-app-id | string | iOS: —apple-app-id の数値アプリ ストア コネクト アプリ ID (—apple-id と —apple-app-specific-password とともに必要) |
| —ios-distribution | string | iOS: 分布モード |
| —keystore | string | iOS: Keystore file path (.keystore or .jks) |
| —keystore-alias | string | iOS: Keystore key alias |
| —keystore-key-password | string | iOS: Keystore key password |
| —keystore-store-password | string | キーストアストアパスワード |
| —play-config | string | Google Play service account JSONのパス |
| —android-flavor | string | Android: ビルドする製品フラバー (例: 本番)。プロジェクトが複数のフラバーを持つ場合、必須です。 |
| —in-app-update-priority | string | Android: Google Play in-app update の優先度 (整数 0–5; 高い値 = 急いで更新) |
| —output-upload | boolean | ビルド出力 (IPA/APK/AAB) をCapgoストレージにアップロードし、ダウンロードリンクを表示 |
| —no-output-upload | boolean | ビルド出力 (IPA/APK/AAB) をCapgoストレージにアップロードしない |
| —output-retention | string | 出力リンク TTL: 1時間から7日。例: 1時間、6時間、2日 |
| —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 ビルド認証情報管理
npx @capgo/cli ビルド認証情報管理 —appId com.example.app
npx @capgo/cli ビルド認証情報管理 —appId com.example.app —platform ios
npx @capgo/cli ビルド認証情報管理 —local
オプション:
| パラメーター | タイプ | Description |
|---|---|---|
| 説明 | string | —appId |
| —platform | string | —platform |
| —local | boolean | ローカルの .capgo-credentials.json をみるだけ |
🔹 移行
セクション「 🔹 移行」npx @capgo/cli@latest build credentials migrate古いプロビジョニング プロファイルを新しいマルチターゲット形式に移行する。 BUILD_PROVISION_PROFILE_BASE64 を CAPGO_IOS_PROVISIONING_MAP に変換する。 Xcode プロジェクトから自動的に主なバンドル ID を検出する。 npx @capgo/cli build credentials migrate --platform ios
例:
Example:オプション:
| パラメーター | タイプ | 概要 |
|---|---|---|
| —appId | string | App ID (自動検出から capacitor.config が指定されていない場合) |
| —platform | string | プラットフォーム (iOS のみサポート) |
| —local | boolean | ローカル .capgo-credentials.json からマイグレーションする |
