コンテンツにジャンプ
Capgo - Capacitor アプリのライブアップデート Capgo

設定オプション

Cloud Build のすべての構成オプションの完全なリファレンスを参照してください。このページを使用して、任意のビルド設定の CLI フラグ、環境変数、または資格情報キーを検索します。

構成の優先順位

構成の優先順位

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

例: 保存済みの資格情報が 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.

iOS オプション

「iOS オプション」

Code Signing

「Code Signing」
CLI フラグ環境変数クレデンシャル キーデフォルト説明
--build-certificate-base64 <cert>BUILD_CERTIFICATE_BASE64BUILD_CERTIFICATE_BASE64—Base64 でエンコードされた .p12 配布用証明書
--ios-provisioning-profile <map>CAPGO_IOS_PROVISIONING_MAPCAPGO_IOS_PROVISIONING_MAP—Provisioning profile as a path or bundleId=path mapping. Repeatable for multi-target apps (app + extensions); the profile name is auto-extracted.
--p12-password <password>P12_PASSWORDP12_PASSWORD—Password for the .p12 certificate (omit if certificate has no password)

App Store Connect Authentication

__CAPGO_KEEP_0__
CLI FlagEnv VariableCredential KeyDefaultDescription
--apple-key-id <id>APPLE_KEY_IDAPPLE_KEY_ID—App Store Connect API Key ID
--apple-issuer-id <id>APPLE_ISSUER_IDAPPLE_ISSUER_ID—App Store Connect の発行者 ID (UUID)
--apple-key-content <content>APPLE_KEY_CONTENTAPPLE_KEY_CONTENT—Base64 でエンコードされた App Store Connect API キー (.p8 ファイル)
--app-store-connect-team-id <id>APP_STORE_CONNECT_TEAM_IDAPP_STORE_CONNECT_TEAM_ID—App Store Connect チーム ID
App Store Connect キーを使用することをお勧めします。App Store Connect キーは、CI/CD の推奨される、機能のある、そして安全なオプションです。
CLI フラグ環境変数資格情報キーデフォルト説明
--apple-id <email>FASTLANE_USERFASTLANE_USER—アプリの所有者が所有するアカウントのApple IDメールアドレス
--apple-app-specific-password <password>FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORDFASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD—アプリ固有のパスワード（xxxx-xxxx-xxxx-xxxx）が生成された appleid.apple.com
--apple-app-id <id>APPLE_APP_IDAPPLE_APP_ID—数字のApp Store ConnectアプリID（例えば 1234567890)

App Store Connect → アプリ → アプリ情報 → Apple ID で見つけることができます。 これがなければ、fastlane はインタラクティブな 2 つの 2FA ログインにフォールバックし、ビルドランナーで完了できません。 この方法を使用すると、ビルド番号はタイムスタンプベースの値にフォールバックします。 App Store Connect から最新のビルド番号を取得することはできません。

iOS ビルド設定
CLI Flag__CAPGO_KEEP_0__ フラグ環境変数資格情報キーデフォルト
--ios-scheme <scheme>CAPGO_IOS_SCHEMECAPGO_IOS_SCHEMEApp説明
--ios-target <target>CAPGO_IOS_TARGETCAPGO_IOS_TARGETAppXcode スキームをビルド
--ios-distribution <mode>CAPGO_IOS_DISTRIBUTIONCAPGO_IOS_DISTRIBUTIONapp_storeXcode ターゲットでビルド設定を読み取るものです。 app_store または ad_hoc

Android オプション

セクション「Android オプション」

キーストア署名

セクション「キーストア署名」
CLI フラグ環境変数クレデンシャル キーデフォルト説明
--android-keystore-file <keystore>ANDROID_KEYSTORE_FILEANDROID_KEYSTORE_FILE—Base64 でエンコードされたキーストア ファイル (.keystore または .jks)
--keystore-key-alias <alias>KEYSTORE_KEY_ALIASKEYSTORE_KEY_ALIASkey0キーストアキー名
--keystore-key-password <password>KEYSTORE_KEY_PASSWORDKEYSTORE_KEY_PASSWORD—キーストアキー用パスワード（設定されていない場合はストアパスワードにフォールバック）
--keystore-store-password <password>KEYSTORE_STORE_PASSWORDKEYSTORE_STORE_PASSWORD—キーストアストア用パスワード

Google Play設定

「Google Play設定」のセクション
CLI フラグ環境変数クレデンシャルキーデフォルト説明
--play-config-json <json>PLAY_CONFIG_JSONPLAY_CONFIG_JSON—Base64エンコードされたGoogle PlayサービスアカウントJSONキー
(環境変数のみ)PLAY_STORE_TRACK—internalGoogle Play リリース トラック (internal, alpha, beta, production)
(env のみ)PLAY_STORE_RELEASE_STATUS—draft選択したトラックでのリリース状態 (draft, completed, inProgress, halted)

Android ビルド設定

「Android ビルド設定」セクション
CLI フラグデフォルト説明
--android-flavor <flavor>—ビルドする製品フラバー (例えば、 production). 必須 プロジェクトが複数のフラバーを定義している場合。
--in-app-update-priority <0–5>—Google Play 内アプリ更新の優先度 (高いほど急いで更新する)。
--no-playstore-upload—Build and sign, but skip the Play Store upload (requires --output-upload).

ビルド制御オプション

ビルド制御オプション

iOSおよびAndroidの両方のビルドに使用できます。

ビルドモード

ビルドモード
CLI フラグデフォルト説明
--platform <platform>—必要です。 ios または android
--build-mode <mode>releasedebug または release
--path <path>.プロジェクトディレクトリ
--verbosefalse詳細なビルドログを有効にする
--ai-analyticsfalseビルド失敗時にログをCapgo AIに診断に送信 — ご参照 AIビルド診断

ビルド番号管理

「ビルド番号管理」セクション
CLI フラグ環境変数資格情報キーデフォルト自動ビルド番号/バージョン__CAPGO_KEEP_0__インクリメントをスキップする
--skip-build-number-bumpSKIP_BUILD_NUMBER_BUMPSKIP_BUILD_NUMBER_BUMPfalseSkip automatic build number / version code incrementing
--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).

__CAPGO_KEEP_0__ フラグ

__CAPGO_KEEP_0__ Flag
CLI Flag環境変数資格情報キーデフォルト説明
--output-uploadBUILD_OUTPUT_UPLOAD_ENABLEDBUILD_OUTPUT_UPLOAD_ENABLEDfalseCapgo へのIPA/APK/AABのビルド出力をアップロードします。環境変数を通じて設定された場合に使用 BUILD_OUTPUT_UPLOAD_ENABLED=true.
--no-output-uploadBUILD_OUTPUT_UPLOAD_ENABLED——__CAPGO_KEEP_0__ への出力のアップロードを無効にします。環境変数を通じて設定された場合に使用 BUILD_OUTPUT_UPLOAD_ENABLED=false.
--output-retention <duration>BUILD_OUTPUT_RETENTION_SECONDSBUILD_OUTPUT_RETENTION_SECONDS1hダウンロードリンクが有効な時間
--output-record <path>———ビルドが成功した後、JSONレコード (ジョブID、ステータス、ダウンロードURL、QR code) を <path> — これを読み戻す build last-output.

保持形式: 人間が読みやすい時間の単位を使用 1h, 6h, 2d, 7d秒で指定する場合、最小は 1 時間、最大は 7 日です。環境変数を通じて設定された場合に使用 (例えば、 3600 1時間で実行されます。

認証

「認証」
CLI フラグ環境変数デフォルト説明
-a, --apikey <key>CAPGO_TOKEN—Capgo API 認証用のキー
--supa-host <host>——自主ホスト用のカスタム Supabase ホスト
--supa-anon <key>——自主ホスト用のカスタム Supabase anon キー

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

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

CI/CD パイプライン用にコピー・ペースト可能です。すべての変数はオプションです — 必要なものだけを設定してください。

iOS

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

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 プロジェクトルートプロジェクトごと — グローバルと両方存在する場合に上書き

__CAPGO_KEEP_0__はキーとして使用されます。 アプリ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

例

セクション：例

GitHub アクション

セクション：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 フラグを直接使用する方法

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

組み合わせた設定

__CAPGO_KEEP_0__ フラグを直接使用する方法

保存済みの資格情報と 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 フラグが保存済みの資格情報の署名情報を提供します。