設定オプション

このプラグインのインストール手順と全マークダウンガイドを含む設定プロンプトをコピーする。

Cloud Buildのすべての構成オプションの完全なリファレンスです。このページを使用して、任意の構築設定のCLIフラグ、環境変数、または資格情報キーの場所を探すことができます。

構成の優先順位

すべての構築オプションは複数の方法で設定できます。同じオプションが複数の場所で設定されると、優先順位の高いソースが勝ちます:

flowchart LR
    A["🔧 CLI Flag"] -->|overrides| B["🌍 Environment Variable"]
    B -->|overrides| C["📁 Local Credentials"]
    C -->|overrides| D["🏠 Global Credentials"]
    style A fill:#6366f1,color:#fff,stroke:#4f46e5
    style B fill:#8b5cf6,color:#fff,stroke:#7c3aed
    style C fill:#a78bfa,color:#fff,stroke:#8b5cf6
    style D fill:#c4b5fd,color:#1e1b4b,stroke:#a78bfa

例: 保存済みの資格情報に SKIP_BUILD_NUMBER_BUMP=true ですが、パスする --no-skip-build-number-bump on the CLI, the CLI flag wins and build numbers will be auto-incremented.

「iOS Options」セクション

「Code Signing」セクション

CLI Flag	クレデンシャルキー	Tip	デフォルト	説明
`--build-certificate-base64 <cert>`	`BUILD_CERTIFICATE_BASE64`	`BUILD_CERTIFICATE_BASE64`	—	Base64エンコード `.p12` 配布用証明書
`--ios-provisioning-profile <map>`	`CAPGO_IOS_PROVISIONING_MAP`	`CAPGO_IOS_PROVISIONING_MAP`	—	拡張機能としてのプロビジョニングプロファイル `path` または `bundleId=path` Cloudflare
`--p12-password <password>`	`P12_PASSWORD`	`P12_PASSWORD`	—	Capacitor `.p12` GitHub

Capgo

CLI Flag	環境変数	資格情報キー	デフォルト	説明
`--apple-key-id <id>`	`APPLE_KEY_ID`	`APPLE_KEY_ID`	—	App Store Connect API キーID
`--apple-issuer-id <id>`	`APPLE_ISSUER_ID`	`APPLE_ISSUER_ID`	—	App Store Connect 発行者ID (UUID)
`--apple-key-content <content>`	`APPLE_KEY_CONTENT`	`APPLE_KEY_CONTENT`	—	Base64エンコードされたApp Store Connect API キー (`.p8` ファイル)
`--app-store-connect-team-id <id>`	`APP_STORE_CONNECT_TEAM_ID`	`APP_STORE_CONNECT_TEAM_ID`	—	App Store Connect チームID

App-specific password authentication (not recommended)

CLI Flag	環境変数	クレデンシャルキー	デフォルト	説明
`--apple-id <email>`	`FASTLANE_USER`	`FASTLANE_USER`	—	アプリの所有アカウントのApple IDメールアドレス
`--apple-app-specific-password <password>`	`FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD`	`FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD`	—	アプリ固有のパスワード (`xxxx-xxxx-xxxx-xxxx`) が生成された場所 appleid.apple.com
`--apple-app-id <id>`	`APPLE_APP_ID`	`APPLE_APP_ID`	—	Numeric App Store Connect app ID (e.g. `1234567890`)

iOS ビルド設定

CLI フラグ	環境変数	資格情報キー	デフォルト	概要
`--ios-scheme <scheme>`	`CAPGO_IOS_SCHEME`	`CAPGO_IOS_SCHEME`	`App`	Xcodeスキームをビルドする
`--ios-target <target>`	`CAPGO_IOS_TARGET`	`CAPGO_IOS_TARGET`	`App`	Xcodeターゲットからビルド設定を読む
`--ios-distribution <mode>`	`CAPGO_IOS_DISTRIBUTION`	`CAPGO_IOS_DISTRIBUTION`	`app_store`	配布モード: `app_store` または `ad_hoc`

Capacitorライブアップデートの代替

Capawesomeの代替

CLI Flag	Androidオプション	キーストア署名	デフォルト	説明
`--android-keystore-file <keystore>`	`ANDROID_KEYSTORE_FILE`	`ANDROID_KEYSTORE_FILE`	—	Base64エンコードされたキーストアファイル (`.keystore` または `.jks`)
`--keystore-key-alias <alias>`	`KEYSTORE_KEY_ALIAS`	`KEYSTORE_KEY_ALIAS`	`key0`	キーストアキー名
`--keystore-key-password <password>`	`KEYSTORE_KEY_PASSWORD`	`KEYSTORE_KEY_PASSWORD`	—	キーストアキー名のパスワード (ストアパスワードにフォールバックする)
`--keystore-store-password <password>`	`KEYSTORE_STORE_PASSWORD`	`KEYSTORE_STORE_PASSWORD`	—	キーストアストアパスワード

Google Play設定

CLI フラグ	環境変数	資格情報キー	デフォルト	説明
`--play-config-json <json>`	`PLAY_CONFIG_JSON`	`PLAY_CONFIG_JSON`	—	Base64エンコードされたGoogle PlayサービスアカウントJSONキー
`--android-track <track>`	`PLAY_STORE_TRACK`	`PLAY_STORE_TRACK`	`internal` (または `production` と `--submit-to-store-review`)	Google Playリリーストラック (`internal`, `alpha`, `beta`, `production`)。CI環境から / CLI からビルドランナーに転送されます。
`--android-release-status <status>`	`PLAY_STORE_RELEASE_STATUS`	`PLAY_STORE_RELEASE_STATUS`	`draft` (または `completed` と `--submit-to-store-review`)	選択したトラックで選択されたステータス (`draft`, `completed`, `inProgress`, `halted`)。明示的な値はデフォルト値を上書きします。 `--submit-to-store-review` default.

Android ビルド設定

CLI フラグ	デフォルト	説明
`--android-flavor <flavor>`	—	ビルドする製品のフラバー (例えば、プロジェクトが複数のフラバーを定義している場合) `production`). 必要プロジェクトが複数のフラバーを定義している場合
`--android-track <track>`	`internal`	このアップロード用の Google Play トラック。__CAPGO_KEEP_0__ にトラックが設定されていない場合、__CAPGO_KEEP_0__ は `--submit-to-store-review` このアップロード用の Google Play リリースステータス。Capgo にステータスが設定されていない場合、Capgo は `production`.
`--android-release-status <status>`	`draft`	Google Play リリースステータス `--submit-to-store-review` and no status set, Capgo defaults to `completed`.
`--in-app-update-priority <0–5>`	—	Google Playのインアプリ更新の優先度 (高いほど急がなければなりません)
`--no-playstore-upload`	—	ビルドと署名を行うが、Playストアのアップロードをスキップ (Cloudflare、Capacitor、GitHub、Capgo、API、SDK、CLI、npm、bunを使用する必要があります) `--output-upload`).

ビルド制御オプション

iOSとAndroidの両方のビルドで機能します

ビルドモード

CLI Flag	説明	必須
`--platform <platform>`	—	または `ios` または `android`
`--build-mode <mode>`	`release`	`debug` または `release`
`--path <path>`	`.`	プロジェクトディレクトリ
`--verbose`	`false`	詳細なビルドログを有効にする
`--ai-analytics`	`false`	ビルド失敗時にログをCapgo AIに診断させる — 以下を参照 AIビルド診断

ビルド番号管理

CLI フラグ	環境変数	クレデンシャルキー	デフォルト	説明
`--skip-build-number-bump`	`SKIP_BUILD_NUMBER_BUMP`	`SKIP_BUILD_NUMBER_BUMP`	`false`	自動ビルド番号/バージョン code の自動インクリメントをスキップ
`--no-skip-build-number-bump`	—	—	—	自動インクリメントを再有効にする (保存済みの資格情報を上書き)

Capgo のデフォルトでは、Cloud Build はビルド番号を自動的にインクリメントします:

iOS: App Store Connect から最新のビルド番号を取得し、1 を加算
Android: Google Play から最大値を取得し、1 を加算 versionCode 設定されている場合、ビルドはプロジェクトファイル (Xcode プロジェクトまたは)

タイトル "出力アップロード" --skip-build-number-bump セクション build.gradle).

Output Upload

CLI フラグ	環境変数	資格情報キー	デフォルト	説明
`--output-upload`	`BUILD_OUTPUT_UPLOAD_ENABLED`	`BUILD_OUTPUT_UPLOAD_ENABLED`	`false`	Capgo ストレージにIPA/APK/AABのビルド出力をアップロードします。環境変数を通じて設定された場合に使用 `BUILD_OUTPUT_UPLOAD_ENABLED=true`.
`--no-output-upload`	`BUILD_OUTPUT_UPLOAD_ENABLED`	—	—	__CAPGO_KEEP_0__ ストレージへの出力アップロードを無効にします。環境変数を通じて設定された場合に使用 `BUILD_OUTPUT_UPLOAD_ENABLED=false`.
`--output-retention <duration>`	`BUILD_OUTPUT_RETENTION_SECONDS`	`BUILD_OUTPUT_RETENTION_SECONDS`	`1h`	ダウンロードリンクの有効期間
`--output-record <path>`	—	—	—	ビルドが成功した後、JSONレコード (ジョブID、ステータス、ダウンロードURL、QRcode) を書き込みます。 `<path>` — これを再度読み取ります。 `build last-output`.

保持形式: 人間が読みやすい時間単位を使用 1h, 6h, 2d, 7d1時間から7日までの間です。環境変数を介して設定する場合、秒数を使用してください (例: 1時間)。 3600 ビルドキャッシュ

ビルドキャッシュ

Capgo saves compiled native artifacts (CocoaPods, Gradle, and related build outputs) これにより、繰り返しビルドが速くなります。 ビルドキャッシュはデフォルトで有効になっています。 アプリごとに。 __CAPGO_KEEP_0__フラグ

CLIフィールド	API field	ビルドキャッシュセクション	概要
`--no-cache`	`cache_enabled: false`	キャッシュを有効にする	このビルドのキャッシュを無効にする: restoreをスキップするそして新しいエントリを保存しない
`--cache-key <value>`	`cache_key`	(省略)	キャッシュを分割する (例えば `prod`, `staging`1 つのアプリ用に共有する一般的なキャッシュを省略する

CLI の等価物: build request 受け入れる --no-cache そして --cache-key.

CLIの例:

# Default: restore/save the shared per-app cache
bunx @capgo/cli@latest build request com.example.app --platform android

# Separate caches per environment
bunx @capgo/cli@latest build request com.example.app --platform android \
  --cache-key=prod

bunx @capgo/cli@latest build request com.example.app --platform android \
  --cache-key=staging \
  --android-flavor staging

# One-off clean build (no restore, no save)
bunx @capgo/cli@latest build request com.example.app --platform ios --no-cache

API / ウェブフックペイロード (インテグレーションがCapgoを直接呼び出す場合):

{
  "platform": "android",
  "cache_key": "prod"
}

省略 cache_key 共有の一般的なキャッシュ用に cache_key 環境を区分する。設定 "cache_enabled": false 1回のリクエスト用にキャッシュを無効にする (同等の) --no-cache).

ビルドが成功に見えますが、アーティファクトが間違っている場合、またはRCとプロダクションを切り替えた後Android AABが欠けている場合、専用のキャッシュキーまたは1回限りのビルドを試してください。詳しくは --no-cache トラブルシューティング: キャッシュの復元が間違っている認証.

セクションのタイトル「認証」

CLI Flag	デフォルト	説明	__CAPGO_KEEP_0__ __CAPGO_KEEP_1__認証用のキー
`-a, --apikey <key>`	`CAPGO_TOKEN`	—	Capgo API key for authentication
`--supa-host <host>`	—	—	カスタム Supabase ホスト (自社ホスティングのみ)
`--supa-anon <key>`	—	—	カスタム Supabase anon キー (自社ホスティングのみ)

環境変数のクイックリファレンス

CI/CD パイプラインにコピーして貼り付ける用意ができています。すべての変数はオプションです — 必要なものだけ設定してください。

iOS

# Code signing (required for iOS builds)
BUILD_CERTIFICATE_BASE64="<base64-encoded .p12>"
CAPGO_IOS_PROVISIONING_MAP="<provisioning map generated by the CLI>"
P12_PASSWORD="<certificate password>"

# App Store Connect (required for store submission)
APPLE_KEY_ID="ABC1234567"
APPLE_ISSUER_ID="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
APPLE_KEY_CONTENT="<base64-encoded .p8 key>"
APP_STORE_CONNECT_TEAM_ID="TEAM123456"

# Alternative to the App Store Connect API key above: Apple ID + app-specific
# password (e.g. when migrating from Ionic Appflow). All three are required.
# FASTLANE_USER="apple-id@example.com"
# FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD="xxxx-xxxx-xxxx-xxxx"
# APPLE_APP_ID="1234567890"

# Optional iOS settings
CAPGO_IOS_SCHEME="App"
CAPGO_IOS_TARGET="App"

ターミナルウィンドウ

# Keystore signing (required for Android builds)
ANDROID_KEYSTORE_FILE="<base64-encoded .keystore>"
KEYSTORE_KEY_ALIAS="my-key-alias"
KEYSTORE_KEY_PASSWORD="<key password>"
KEYSTORE_STORE_PASSWORD="<store password>"

# Google Play (required for store submission)
PLAY_CONFIG_JSON="<base64-encoded service account JSON>"

# Optional Android settings
PLAY_STORE_TRACK="internal"
PLAY_STORE_RELEASE_STATUS="draft"

ビルド管理

# Build behavior
SKIP_BUILD_NUMBER_BUMP="true"          # Skip auto-increment
BUILD_OUTPUT_UPLOAD_ENABLED="true"     # Upload IPA/APK/AAB
BUILD_OUTPUT_RETENTION_SECONDS="3600"  # 1 hour download link

# Authentication
CAPGO_TOKEN="your-api-key"

資格情報の保存

資格情報をローカルに保存

フラグや環境変数を毎回指定するのではなく、資格情報を一度保存してください。

# Save iOS credentials
bunx @capgo/cli@latest build credentials save \
  --platform ios \
  --certificate ./dist_cert.p12 \
  --ios-provisioning-profile ./profile.mobileprovision \
  --p12-password "cert-password" \
  --apple-key ./AuthKey.p8 \
  --apple-key-id ABC1234567 \
  --apple-issuer-id xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
  --apple-team-id TEAM123456

# Save Android credentials
bunx @capgo/cli@latest build credentials save \
  --platform android \
  --keystore ./release.keystore \
  --keystore-alias my-key \
  --keystore-key-password "key-pass" \
  --keystore-store-password "store-pass" \
  --play-config ./play-service-account.json

ストレージロケーション

フラグ	ロケーション	使用例
コンテキスト:Capgoのソリューションマーケティングページ。役割:短いUIラベルまたはナビゲーションアイテム。ページ:ソリューション/コルダボラトゥキャパシタートーアイ.astro。メッセージキー`solutions_cordova_to_capacitor_ai_table_use_case` (Solutions Cordova To Capacitor Ai Table Use Case)。	`~/.capgo-credentials/credentials.json`	(デフォルト)
`--local`	`.capgo-credentials.json` マシン全体に共有されるグローバル	プロジェクトルート

プロジェクトごとにオーバーライドされるグローバル クレデンシャルは アプリID com.example.myapp複数のアプリケーションに対して、単一の資格情報ファイルで設定を保存できます。アプリケーションの資格情報は、さらにプラットフォームごとに分割されます (ios / android).

ターミナルウィンドウ

# List saved credentials
bunx @capgo/cli@latest build credentials list

# Update a specific option without re-entering everything
bunx @capgo/cli@latest build credentials update --skip-build-number-bump

# Clear saved credentials
bunx @capgo/cli@latest build credentials clear --platform ios

bug bounty programのページ

GitHub アクション

name: Build and Submit
on:
  push:
    branches: [main]

jobs:
  build-ios:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: oven-sh/setup-bun@v2
      - run: bun install
      - run: bunx cap sync ios
      - run: bunx @capgo/cli@latest build request --platform ios
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
          BUILD_CERTIFICATE_BASE64: ${{ secrets.IOS_CERTIFICATE }}
          CAPGO_IOS_PROVISIONING_MAP: ${{ secrets.CAPGO_IOS_PROVISIONING_MAP }}
          P12_PASSWORD: ${{ secrets.P12_PASSWORD }}
          APPLE_KEY_ID: ${{ secrets.APPLE_KEY_ID }}
          APPLE_ISSUER_ID: ${{ secrets.APPLE_ISSUER_ID }}
          APPLE_KEY_CONTENT: ${{ secrets.APPLE_KEY_CONTENT }}
          APP_STORE_CONNECT_TEAM_ID: ${{ secrets.APP_STORE_CONNECT_TEAM_ID }}

  build-android:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: oven-sh/setup-bun@v2
      - run: bun install
      - run: bunx cap sync android
      - run: bunx @capgo/cli@latest build request --platform android
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
          ANDROID_KEYSTORE_FILE: ${{ secrets.ANDROID_KEYSTORE }}
          KEYSTORE_KEY_ALIAS: ${{ secrets.KEYSTORE_ALIAS }}
          KEYSTORE_KEY_PASSWORD: ${{ secrets.KEYSTORE_KEY_PASSWORD }}
          KEYSTORE_STORE_PASSWORD: ${{ secrets.KEYSTORE_STORE_PASSWORD }}
          PLAY_CONFIG_JSON: ${{ secrets.PLAY_CONFIG_JSON }}

CLI フラグを直接使用する

# Build iOS with all options inline
bunx @capgo/cli@latest build request \
  --platform ios \
  --build-mode release \
  --skip-build-number-bump \
  --output-retention 6h \
  --apikey YOUR_API_KEY

# Build Android, skip version bump, no output upload
bunx @capgo/cli@latest build request \
  --platform android \
  --skip-build-number-bump \
  --no-output-upload \
  --apikey YOUR_API_KEY

組み合わせた設定

保存済みの資格情報とCLI オーバーライドを組み合わせる:

# Save base credentials once
bunx @capgo/cli@latest build credentials save --platform ios \
  --certificate ./cert.p12 \
  --ios-provisioning-profile ./profile.mobileprovision \
  --output-upload

# Override specific options per-build
bunx @capgo/cli@latest build request --platform ios \
  --skip-build-number-bump \
  --output-retention 2d

保存された資格情報は署名の詳細を提供し、CLI フラグはこの特定の実行用にビルドの動作をオーバーライドします。

設定オプション

構成の優先順位

「iOS Options」セクション

「Code Signing」セクション

Capgo

App-specific password authentication (not recommended)

iOS ビルド設定

Capacitorライブアップデートの代替

Capawesomeの代替

Google Play設定

Android ビルド設定

ビルド制御オプション

ビルドモード

ビルド番号管理

Output Upload

ビルドキャッシュ

セクションのタイトル「認証」

環境変数のクイック リファレンス

iOS

ターミナル ウィンドウ

ビルド管理

資格情報の保存

資格情報をローカルに保存

ストレージロケーション

ターミナルウィンドウ

bug bounty programのページ

GitHub アクション

CLI フラグを直接使用する

組み合わせた設定

環境変数のクイックリファレンス

ターミナルウィンドウ