設定オプション

Complete reference for every Cloud Build configuration option. Use this page to find the CLI flag, environment variable, or credential key for any build setting.

構成の優先順位

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

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 ですが、__CAPGO_KEEP_0__ --no-skip-build-number-bump on the CLI, the CLI flag wins and build numbers will be auto-incremented.

ヒント

CI/CD Pipelinesの場合、環境変数は通常最も便利です。ローカル開発の場合、保存されたクレデンシャル (via) build credentials saveを使用すると、フラグを毎回繰り返す必要がなくなります。

---

iOSオプション

Code Signing

CLI フラグ	環境変数	クレデンシャルキー	デフォルト	説明
--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 配布用証明書のパスワード
--p12-password <password>	P12_PASSWORD	P12_PASSWORD	—	配布用証明書 (証明書にパスワードがない場合は省略) .p12 App Store Connectの認証

App Store Connectの認証

CLI Flag	資格情報キー	App Store Connectの認証	デフォルト	説明
--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 Store Connect キーを使用したアプリ固有のパスワード認証は、推奨されていません。使用を勧められていません。 It exists only as a compatibility path for teams migrating from Ionic Appflow (which relied on it). It is tied to a personal Apple ID with no granular permissions, cannot query App Store Connect (so build numbers fall back to a timestamp), and only covers the TestFlight upload itself. Prefer an App Store Connect API key (.p8App Store Connect __CAPGO_KEEP_0__ キーを使用するのではなく、CI/CD に推奨される、より強力で安全なオプションを使用することをお勧めします。

アプリ固有のパスワード認証 (推奨されません)

CLI フラグ	環境変数	クレデンシャルキー	デフォルト	説明
--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	—	数値のApp Store ConnectアプリID（例えば 1234567890)

注意

すべての3つのフィールドが必要です。数字 APPLE_APP_ID App Store Connect → アプリ → アプリ情報 → Apple ID にある (App Store Connect → your app → App Information → Apple ID) には必須です: これを欠くと、fastlane は build runner 上で完了できないインタラクティブ 2FA ログインにフォールバックします。 この方法を使用すると、build number は timestamp-based 値にフォールバックします。なぜなら、App Store Connect は最新の build number を取得することができないからです。

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ライブアップデートの代替

Androidオプション

CLI Flag	__CAPGO_KEEP_0__フラグ	環境変数	クレデンシャルキー	デフォルト値
--android-keystore-file <keystore>	ANDROID_KEYSTORE_FILE	ANDROID_KEYSTORE_FILE	—	Base64-encoded keystore file (.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	—	キーストアのパスワード (ストアのパスワードにフォールバックする)

キーストアのストア パスワード

CLI Flag	__CAPGO_KEEP_0__ フラグ	環境変数	資格情報のキー	デフォルト値
--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 Androidビルド設定

セクションのタイトルは「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	—	Google Playのリリースステータス --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	—	—	—	自動インクリメントを明示的に再有効にする (保存済み資格情報を上書き)

By default, Capgo Cloud Build automatically increments build numbers:

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

タイトル「出力アップロード」 --skip-build-number-bump Capgoフラグ build.gradle).

環境変数

CLI Flag	Capgo Cloud Buildは自動的にビルド番号をインクリメントします	資格情報キー	デフォルト	説明
--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 1時間

認証

CLI フラグ	環境変数	デフォルト	__CAPGO_KEEP_0__ __CAPGO_KEEP_1__ キーによる認証
-a, --apikey <key>	CAPGO_TOKEN	—	Capgo API key for authentication
--supa-host <host>	—	—	自ホスト用のカスタム Supabase anon キー
--supa-anon <key>	—	—	環境変数のクイック リファレンス

---

セクション「環境変数のクイック リファレンス」

セクション「環境変数のクイック リファレンス」

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"

Android

# 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

保存場所

フラグ	場所	使用例
(default)	~/.capgo-credentials/credentials.json	全体 — すべてのプロジェクトに共有されるマシン上の
--local	.capgo-credentials.json プロジェクトルート内	プロジェクトごとに — グローバルを上書きする

資格情報は アプリID (例えば com.example.myapp), 1 つの資格情報ファイルで複数のアプリの設定を保存することができるため、競合が発生することはない。各アプリの資格情報はさらにプラットフォームによって分割されるios / android).

注意

に追加する .capgo-credentials.json 資格情報ファイルをプロジェクトルートに追加する .gitignore ローカル認証情報を使用している場合。バージョン管理に認証情報をコミットすることは絶対にしないでください。

保存済みの認証情報を管理する

# 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

---

例

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