コンテンツにジャンプ
Capgo - Capacitor アプリをビルド、配信、更新 Capgo

ページ/エリア: Capgo マーケティング ウェブサイト。役割: ウェブサイト コピーの文。見つける場所: component doc/SignupCta.astro, component Hero.astro。

Cloud Buildの設定オプションのすべての完全なリファレンスです。このページを使用して、CLI フラグ、環境変数、またはクレデンシャルキーを検索できます。

設定優先度

設定優先度

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

例: 保存済みの資格情報が SKIP_BUILD_NUMBER_BUMP=true ですが、__CAPGO_KEEP_0__ に --no-skip-build-number-bump Capgo上では、CLI上で指定されたCLIフラグが優先され、ビルド番号は自動で増分されます。

iOS オプション

「iOS Options」

Code サイン

「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—プロビジョニングプロファイルとして path または bundleId=path マッピング。複数のターゲットアプリ (アプリ + 拡張機能) に対して繰り返し可能; プロファイル名は自動抽出される。
--p12-password <password>P12_PASSWORDP12_PASSWORD—資格情報のパスワード .p12 証明書 (パスワードが付いていない証明書の場合省略)

App Store Connect 認証

App Store Connect 認証設定
CLI フラグ環境変数資格情報キーデフォルト説明
--apple-key-id <id>APPLE_KEY_IDAPPLE_KEY_ID—App Store Connect API キー 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 file)
--app-store-connect-team-id <id>APP_STORE_CONNECT_TEAM_IDAPP_STORE_CONNECT_TEAM_ID—推奨されていません
App Store Connect のパスワード認証 (推奨されていません)
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)

iOSビルド設定

セクションのタイトル「iOSビルド設定」
CLI フラグ環境変数資格情報キーデフォルト説明
--ios-scheme <scheme>CAPGO_IOS_SCHEMECAPGO_IOS_SCHEMEAppXcodeスキームでビルド
--ios-target <target>CAPGO_IOS_TARGETCAPGO_IOS_TARGETAppXcodeターゲットでビルド設定を読み取る
--ios-distribution <mode>CAPGO_IOS_DISTRIBUTIONCAPGO_IOS_DISTRIBUTIONapp_store配布モード: app_store または ad_hoc
--xcode-version <version>CAPGO_IOS_XCODE_VERSIONCAPGO_IOS_XCODE_VERSION任意このバージョンのXcodeでビルドします。たとえば 26, 26.0.1 または 27. メジャーバージョンは任意のマイナーバージョンを受け入れます。ビルドが失敗すると、どのバージョンが利用可能かをリストし、どれも一致しない場合は利用可能なバージョンを表示します。

Xcode 27

「Xcode 27」セクション

Xcode 27 (iOS 27 SDK) でビルド --xcode-version 27:

ターミナル画面
npx @capgo/cli@latest build request --platform ios --xcode-version 27

Apps built with the iOS 27 SDK must adopt the UIScene lifecycle: without a UIApplicationSceneManifest in Info.plist iOS 27のアプリ起動時に停止される。 Capgo はビルドを開始する前にこれらのビルドをブロックします (プレースキャン チェック) ios/plist-scene-lifecycle-xcode27構成設定 SceneDelegate と UIApplicationSceneManifest シーンのデリゲートも ios/App/App/Info.plistを --xcode-version 26 コンテキスト: ライブ アップデート製品ページ。役割: 短い UI ラベルまたはナビゲーション アイテム。メッセージキー `live_update_dynamic_label_to` (ライブ アップデート ダイナミック ラベル To)。 シーンライフサイクルガイド.

ココアポッドのサポート終了（2026年12月）

セクション：ココアポッドのサポート終了（2026年12月）

Capgo iOSプロジェクトがCocoaPodsを使用している場合、2026年12月以降はビルドが停止されます。Swift Package Managerにプロジェクトを移行する必要があります。詳細は Capacitor SPMガイドCocoaPodsは現在もビルドを実行し続けます。 CLI は警告を表示し、 Capgo は組織管理者にリマインダーメールを送信します。

Capgo Build

2026年12月以降はココアポッドのビルドは機能しますが、Capgo Buildは警告を表示し、Capgo Buildは組織管理者にメールでリマインダーを送信します。

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キー
--android-track <track>PLAY_STORE_TRACKPLAY_STORE_TRACKinternal または production with --submit-to-store-review))internal, alpha, beta, productionCI環境から/CLIに転送されました。
--android-release-status <status>PLAY_STORE_RELEASE_STATUSPLAY_STORE_RELEASE_STATUSdraft または completed with --submit-to-store-review))draft, completed, inProgress, haltedCI環境から/__CAPGO_KEEP_0__に送信されたビルドランナーに明示的に値を指定すると、 --submit-to-store-review default.

Android ビルド設定

セクション「Android ビルド設定」
CLI フラグデフォルト説明
--android-flavor <flavor>—ビルドする製品のフラバー (例えば production). 必須 プロジェクトが複数のフラバーを定義している場合
--android-track <track>internalGoogle Play アップロード用のトラッキングです。 --submit-to-store-review となくトラッキング設定がされていない場合、Capgoはデフォルトで production.
--android-release-status <status>draftGoogle Play のトラックに応じて __CAPGO_KEEP_0__ が設定されます。 --submit-to-store-review と設定されていない場合、Capgo completed.
--in-app-update-priority <0–5>—ページパス：/ja/docs/builder/configuration/
--no-playstore-upload—保護されたトークン：Live Update、Cloudflare、Capacitor、GitHub、Capgo、code、API、SDK、CLI、npm、bun --output-upload).

アイテム：

テキスト：そしてステータスが設定されていない場合、__CAPGO_KEEP_0__は

テキスト：Google Playのインアプリ更新の優先順位（高いほど急務）

ビルドモード

テキスト：ビルド制御オプション
CLI フラグDefaultテキスト：ビルドモード
--platform <platform>—セクションのタイトル：ビルドモード ios または android
--build-mode <mode>releasedebug または release
--path <path>.プロジェクトディレクトリ
--verbosefalse詳細なビルドログを有効にする
--ai-analyticsfalseビルド失敗時に、Capgo AI にログを送信して診断 — 以下を参照 AI ビルド診断

ビルド番号の制御

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

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

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

出力アップロード --skip-build-number-bump Capgoはプロジェクトファイル（Xcodeプロジェクトまたは）にすでに含まれているバージョンを使用します。 build.gradle).

アップロード出力

「出力アップロード」セクション
CLI フラグ環境変数クレデンシャルキーデフォルト説明
--output-uploadBUILD_OUTPUT_UPLOAD_ENABLEDBUILD_OUTPUT_UPLOAD_ENABLEDfalseビルド出力を Capgo ストレージにアップロードします。環境変数を使用すると BUILD_OUTPUT_UPLOAD_ENABLED=true.
--no-output-uploadBUILD_OUTPUT_UPLOAD_ENABLED——出力アップロードを無効にします。環境変数を使用すると 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 日です。環境変数を介して設定される場合、秒数 (例えば、1 時間) を使用します。 3600 ビルド キャッシュ

「ビルド キャッシュ」のセクション

__CAPGO_KEEP_0__ は、コンパイル済みネイティブアーティファクト (CocoaPods、Gradle、および関連するビルド出力) をアプリごとに保存します

Capgo はコンパイル済みネイティブアーティファクト（CocoaPods、Gradle、および関連するビルド出力）を保存します。 アプリごとに __CAPGO_KEEP_0__ フラグ __CAPGO_KEEP_0__ フィールド ビルド キャッシュの設定

CLI フラグAPI フィールドデフォルト説明
--no-cachecache_enabled: falseキャッシュをオンにしますこのビルドのキャッシュを無効にする: キャッシュの復元をスキップします そして キャッシュを保存しない
--cache-key <value>cache_key(省略)キャッシュを分割します (例えば prod, staging1 つのアプリ用に共有される一般的なキャッシュを省略します

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 Build直接呼び出す場合):

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

省略 cache_key 共有キャッシュ用。セット cache_key 環境を分割してセット "cache_enabled": false 1回のリクエストでキャッシュを無効にする (環境変数と同じ) --no-cache).

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

認証

「認証」セクション
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"
CAPGO_IOS_XCODE_VERSION="27"

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"

資格情報の保存

資格情報の保存

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

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

パスワードやAPIキーなどの資格情報を一度保存しておくと、毎回入力する必要がなくなります。

ターミナル画面
# 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マシン全体に共有されるグローバル
--local.capgo-credentials.json プロジェクトのルートプロジェクトごとにオーバーライド

資格情報はアプリIDで鍵化される アプリ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

Examples

例として

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

混在した設定

セクション「混在した設定」

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