設定オプション

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 CLI で CLI フラグが優先され、ビルド番号は自動的にインクリメントされます。

ヒント

For CI/CD pipelines, environment variables are usually the most convenient. For local development, saved credentials (via build credentials save毎回フラグを指定する手間を省けます。

---

iOSのオプション

Code 署名

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 認証

CLI フラグ	環境変数	認証情報キー	デフォルト	説明
--apple-key-id <id>	APPLE_KEY_ID	APPLE_KEY_ID	—	App Store Connect API Key ID
--apple-issuer-id <id>	APPLE_ISSUER_ID	APPLE_ISSUER_ID	—	App Store Connect Issuer 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による認証は非推奨であり、使用は控えてください。 これは、Ionic Appflow（同方式に依存）から移行するチーム向けの互換手段としてのみ存在します。個人のApple IDに紐付き、細かい権限設定はできず、App Store Connectへのクエリも行えないため（ビルド番号はタイムスタンプにフォールバック）、TestFlightへのアップロード自体のみをカバーします。代わりにApp Store Connect API キー (.p8) を使用してください。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	—	app-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 → アプリ → App Information → Apple ID に記載) は必ず入力してください。これがないと、fastlane は対話型の 2FA ログインにフォールバックしますが、ビルドランナー上では完了できません。この方法を使用した場合、App Store Connect に最新のビルド番号を問い合わせないため、ビルド番号はタイムスタンプベースの値にフォールバックされます。

iOS ビルド設定

CLI フラグ	環境変数	認証情報キー	デフォルト	説明
--ios-scheme <scheme>	CAPGO_IOS_SCHEME	CAPGO_IOS_SCHEME	App	ビルドする Xcode scheme
--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
--xcode-version <version>	CAPGO_IOS_XCODE_VERSION	CAPGO_IOS_XCODE_VERSION	任意	このXcodeバージョンを使用してビルドします。例： 26, 26.0.1 または 27メジャーバージョンを指定すると、マイナーバージョンは任意となります。一致するバージョンがない場合は、ビルドが即座に失敗し、利用可能なバージョンがリスト表示されます。

Xcode 27

Xcode 27 (iOS 27 SDK) を使用してビルド --xcode-version 27:

npx @capgo/cli@latest build request --platform ios --xcode-version 27

iOS 27 SDK でビルドしたアプリは、UIScene ライフサイクルを採用する必要があります。採用していないと、 UIApplicationSceneManifest における Info.plist と scene delegate がない場合、iOS 27 は起動時にアプリを停止します。Capgo は、ビルド開始前にこれらのビルドをブロックします（プリスキャンチェック ios/plist-scene-lifecycle-xcode27）。 SceneDelegate と UIApplicationSceneManifest まで ios/App/App/Info.plistを追加するか、対応するまで --xcode-version 26 でビルドを続けてください。Apple の scene lifecycle ガイドを参照してください。.

CocoaPods のサポート終了（2026年12月）

Capgo Build は、2026年12月に CocoaPods を使う iOS プロジェクトのビルドを停止します。それまでにプロジェクトを Swift Package Manager に移行してください。詳細は Capacitor SPM ガイド. それまでは CocoaPods によるビルドが継続されます。CLI は警告を表示し、Capgo を通じて組織の管理者にリマインダーをメールで送信します。

---

Androidのオプション

Keystore 署名

CLI フラグ	環境変数	認証情報キー	デフォルト	説明
--android-keystore-file <keystore>	ANDROID_KEYSTORE_FILE	ANDROID_KEYSTORE_FILE	—	Base64 エンコードされた keystore ファイル (.keystore または .jks)
--keystore-key-alias <alias>	KEYSTORE_KEY_ALIAS	KEYSTORE_KEY_ALIAS	key0	Keystoreのキーエイリアス
--keystore-key-password <password>	KEYSTORE_KEY_PASSWORD	KEYSTORE_KEY_PASSWORD	—	Keystoreのキーパスワード（未設定の場合はストアパスワードを使用）
--keystore-store-password <password>	KEYSTORE_STORE_PASSWORD	KEYSTORE_STORE_PASSWORD	—	Keystoreのストアパスワード

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 デフォルト値を上書きします。

Android ビルド設定

CLI フラグ	デフォルト	説明
--android-flavor <flavor>	—	ビルドするプロダクトのflavor（例: production). 必須 プロジェクトで複数のflavorを定義している場合）。
--android-track <track>	internal	Google Play track for this upload. With --submit-to-store-review トラックが設定されていない場合、Capgoは production.
--android-release-status <status>	draft	Google Play release status. With --submit-to-store-review ステータスが設定されていない場合、Capgoは completed.
--in-app-update-priority <0–5>	—	このリリースのGoogle Playアプリ内アップデート優先度（数値が高いほど緊急度が高い）を設定します。
--no-playstore-upload	—	ビルドと署名のみを行い、Play Storeへのアップロードはスキップします（には --output-upload).

---

ビルド制御オプション

これらのオプションはiOSとAndroidの両方のビルドに適用されます。

ビルドモード

CLI フラグ	デフォルト	説明
--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: 最大値を取得 versionCode Google Playから取得し、1を加算します

次の場合: --skip-build-number-bump 設定されている場合、ビルドはプロジェクトファイルに既にあるバージョンをそのまま使用します（Xcodeプロジェクトまたは build.gradle).

出力のアップロード

CLI フラグ	環境変数	認証情報キー	デフォルト	説明
--output-upload	BUILD_OUTPUT_UPLOAD_ENABLED	BUILD_OUTPUT_UPLOAD_ENABLED	false	ビルド成果物 (IPA/APK/AAB) を Capgo ストレージにアップロードします。環境変数で設定する場合は、 BUILD_OUTPUT_UPLOAD_ENABLED=true.
--no-output-upload	BUILD_OUTPUT_UPLOAD_ENABLED	—	—	成果物のアップロードを無効にします。環境変数で設定する場合は、 BUILD_OUTPUT_UPLOAD_ENABLED=false.
--output-retention <duration>	BUILD_OUTPUT_RETENTION_SECONDS	BUILD_OUTPUT_RETENTION_SECONDS	1h	ダウンロードリンクの有効期限
--output-record <path>	—	—	—	ビルド成功後、JSON レコード (job ID、status、download URL、QR code) を以下に書き込みます <path> — 次のコマンドで読み戻します build last-output.

保持期間の形式: 次のような人間が読みやすい期間表記を使用してください 1h, 6h, 2d, 7d. 最小は 1 時間、最大は 7 日間です。環境変数で設定する場合は、秒単位で指定してください (例： 3600 は 1 時間に相当)。

ビルドキャッシュ

Capgo はコンパイル済みのネイティブアーティファクト（CocoaPods、Gradle、関連するビルド出力）を保存します アプリごとに これにより、再ビルドを速く開始できます。 Build cache はデフォルトで有効です 各アプリで。

CLI フラグ	API フィールド	デフォルト	説明
--no-cache	cache_enabled: false	キャッシュオン	このビルドではキャッシュを無効化: リストアをスキップ と 新しいエントリを保存しない
--cache-key <value>	cache_key	(省略)	キャッシュを分割する（例： prod, staging）。アプリごとに1つの共通キャッシュを使用する場合は省略してください

CLI の同等の設定： build request は以下を --no-cache と --cache-key.

ヒント

異なるものを使用してください --cache-key RC版と本番ビルドでアプリIDが同じだが、コンパイル済み出力を共有できない場合 — 例： --cache-key=prod と --cache-key=staging.

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 / webhook ペイロード (統合環境から Capgo Build を直接呼び出す場合):

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

省略 cache_key 共有の共通キャッシュを使用します。 cache_key 環境ごとにパーティション化します。 "cache_enabled": false 単一のリクエストに対してキャッシュを無効にします（ --no-cache).

ビルドは成功したように見えるのにアーティファクトが正しくない場合、または RC と production の切り替え後に Android AAB が見当たらない場合は、専用のキャッシュキーを使用するか、単発の --no-cache build。詳細は トラブルシューティング：キャッシュ復元の誤り.

認証

CLI フラグ	環境変数	デフォルト	説明
-a, --apikey <key>	CAPGO_TOKEN	—	認証用の Capgo API キー
--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"
CAPGO_IOS_XCODE_VERSION="27"

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

ストレージの場所

フラグ	位置情報	ユースケース
(デフォルト)	~/.capgo-credentials/credentials.json	Global — ローカルマシンの全プロジェクトで共有
--local	.capgo-credentials.json プロジェクトのルートディレクトリ内	Per-project — 両方存在する場合、グローバル設定を上書き

認証情報は以下をキーとして管理されます： App ID (例 com.example.myapp), これにより、単一の認証ファイルで複数のアプリの設定を競合なく保存できます。各アプリの認証情報は、さらにプラットフォームごとに分割されます：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 フラグで今回の実行におけるビルド動作を上書きします。