Opsi Konfigurasi

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.

Prioritas pengaturan

Setiap opsi pembangunan dapat diatur dalam beberapa cara. Ketika opsi yang sama diatur dalam beberapa tempat, sumber yang lebih tinggi prioritas menang:

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

Contoh: Jika kredit yang disimpan Anda memiliki SKIP_BUILD_NUMBER_BUMP=true tetapi Anda memasukkan --no-skip-build-number-bump pada CLI, flag CLI menang dan nomor pembangunan akan di-otomatiskan.

Tips

Untuk pipeline CI/CD, variabel lingkungan biasanya paling nyaman. Untuk pengembangan lokal, kredit yang disimpan (via build credentials save) menghindari mengulang flag setiap kali.

---

Opsi iOS

Code Signing

CLI Flag	Variabel Lingkungan	Kunci Kredensial	Default	Deskripsi
--build-certificate-base64 <cert>	BUILD_CERTIFICATE_BASE64	BUILD_CERTIFICATE_BASE64	—	Dikodekan dalam Base64 .p12 Sertifikat Distribusi
--build-provision-profile-base64 <profile>	BUILD_PROVISION_PROFILE_BASE64	BUILD_PROVISION_PROFILE_BASE64	—	Dikodekan dalam Base64 .mobileprovision Profil Pengiriman
--build-provision-profile-base64-prod <profile>	BUILD_PROVISION_PROFILE_BASE64_PROD	BUILD_PROVISION_PROFILE_BASE64_PROD	—	Profil distribusi App Store (opsional, untuk distribusi App Store)
--p12-password <password>	P12_PASSWORD	P12_PASSWORD	—	Kata sandi untuk .p12 sertifikat (hilangkan jika sertifikat tidak memiliki kata sandi)

Autentikasi App Store Connect

CLI Flag	Variabel Lingkungan	Kunci Kredensial	Default	Deskripsi
--apple-key-id <id>	APPLE_KEY_ID	APPLE_KEY_ID	—	Kunci ID API App Store Connect
--apple-issuer-id <id>	APPLE_ISSUER_ID	APPLE_ISSUER_ID	—	ID Penerbit App Store Connect (UUID)
--apple-key-content <content>	APPLE_KEY_CONTENT	APPLE_KEY_CONTENT	—	Kunci App Store Connect yang dikodekan dalam Base64 (API) (.p8 Nama profil pengaturan sebagai yang ditampilkan di portal Pengembang Apple
--apple-profile-name <name>	APPLE_PROFILE_NAME	APPLE_PROFILE_NAME	—	ID Tim App Store Connect
--app-store-connect-team-id <id>	APP_STORE_CONNECT_TEAM_ID	APP_STORE_CONNECT_TEAM_ID	—	Catatan

Opsi autentikasi alternatif:

Anda juga dapat menggunakan ID Apple + kata sandi aplikasi spesifik daripada kunci __CAPGO_KEEP_0__. Masukkan You can also use Apple ID + app-specific password instead of API keys. Pass --apple-id <email> (variabel lingkungan: --apple-app-specific-password <password> ). Kunci __CAPGO_KEEP_0__ disarankan untuk CI/CD. APPLE_ID, APPLE_APP_SPECIFIC_PASSWORD). API keys are recommended for CI/CD.

Pengaturan Bangun iOS

CLI Flag	Variabel Lingkungan	Kunci Kredensial	Default	Deskripsi
--ios-scheme <scheme>	CAPGO_IOS_SCHEME	CAPGO_IOS_SCHEME	App	Skema Xcode untuk membangun
--ios-target <target>	CAPGO_IOS_TARGET	CAPGO_IOS_TARGET	App	Target Xcode untuk membaca pengaturan build

---

Pilihan Android

Pengaturan Tanda Tangan Keystore

CLI Flag	Variabel Lingkungan	Kunci Kredensial	Default	Deskripsi
--android-keystore-file <keystore>	ANDROID_KEYSTORE_FILE	ANDROID_KEYSTORE_FILE	—	File keystore yang dikodekan Base64 (.keystore atau .jks)
--keystore-key-alias <alias>	KEYSTORE_KEY_ALIAS	KEYSTORE_KEY_ALIAS	key0	Alias kunci keystore
--keystore-key-password <password>	KEYSTORE_KEY_PASSWORD	KEYSTORE_KEY_PASSWORD	—	Kata sandi kunci keystore (jatuh kembali ke kata sandi penyimpanan jika tidak ditentukan)
--keystore-store-password <password>	KEYSTORE_STORE_PASSWORD	KEYSTORE_STORE_PASSWORD	—	Kata sandi penyimpanan keystore

Konfigurasi Google Play

CLI Flag	Variabel Lingkungan	Kunci Kredensial	Default	Deskripsi
--play-config-json <json>	PLAY_CONFIG_JSON	PLAY_CONFIG_JSON	—	Kunci JSON akun layanan Google Play yang dikodekan Base64

Pengaturan Pembangunan Android

Variabel Lingkungan	Default	Deskripsi
PLAY_STORE_TRACK	internal	Lacak Rilis Google Play (internal, alpha, beta, production)
PLAY_STORE_RELEASE_STATUS	draft	Status Rilis di Google Play (draft, completed)

---

Opsi Pengendalian Bangun

Opsi-opsi ini berlaku untuk bangun iOS dan Android.

Mode Bangun

CLI Flag	Default	Deskripsi
--platform <platform>	—	Diperlukan. ios atau android
--build-mode <mode>	release	debug atau release
--build-config <json>	—	Konfigurasi JSON tambahan untuk pembangunan
--path <path>	.	Direktori proyek
--verbose	false	Aktifkan log pembangunan verbose

Kontrol Nomor Pembangunan

CLI Flag	Variabel Lingkungan	Kunci Kredensial	Default	Deskripsi
--skip-build-number-bump	SKIP_BUILD_NUMBER_BUMP	SKIP_BUILD_NUMBER_BUMP	false	Lepaskan otomatis pembangunan nomor / versi code meningkatkan
--no-skip-build-number-bump	—	—	—	Aktifkan kembali otomatis meningkatkan secara eksplisit (mengatasi kembali kredential yang disimpan)

Dengan default, Capgo secara otomatis meningkatkan nomor build:

• iOS: Mengambil nomor build terbaru dari App Store Connect, meningkatkan oleh 1
• Android: Mengambil maksimum versionCode dari Google Play, meningkatkan oleh 1

Ketika --skip-build-number-bump dipasang, build menggunakan versi yang sudah ada di file-project Anda (Xcode project atau build.gradle).

Bagian Judul “Upload Output”

CLI Flag	Env Variable	Kunci Kredensial	Default	Deskripsi
--output-upload	BUILD_OUTPUT_UPLOAD_ENABLED	BUILD_OUTPUT_UPLOAD_ENABLED	false	Unggah hasil build (IPA/APK/AAB) ke penyimpanan Capgo. BUILD_OUTPUT_UPLOAD_ENABLED=true.
--no-output-upload	BUILD_OUTPUT_UPLOAD_ENABLED	—	—	Ketika diatur melalui variabel lingkungan, gunakan BUILD_OUTPUT_UPLOAD_ENABLED=false.
--output-retention <duration>	BUILD_OUTPUT_RETENTION_SECONDS	BUILD_OUTPUT_RETENTION_SECONDS	1h	Nonaktifkan unggah hasil build.

Ketika diatur melalui variabel lingkungan, gunakan Berapa lama tautan download aktif 1h, 6h, 2d, 7dFormat penyimpanan: 3600 Gunakan durasi yang dapat dibaca manusia seperti

Minimal 1 jam, maksimal 7 hari. Ketika diatur melalui variabel lingkungan, gunakan detik (misalnya

CLI Flag	Variabel Lingkungan	Default	Deskripsi
-a, --apikey <key>	CAPGO_TOKEN	—	Capgo API kunci autentikasi
--supa-host <host>	—	—	Host Supabase yang disesuaikan (hanya untuk penggunaan sendiri)
--supa-anon <key>	—	—	Kunci anon Supabase yang disesuaikan (hanya untuk penggunaan sendiri)

---

Referensi Variabel Lingkungan Cepat

Siapkan salinan untuk pipeline CI/CD Anda. Semua variabel adalah opsional — hanya atur apa yang Anda butuhkan.

iOS

# Code signing (required for iOS builds)
BUILD_CERTIFICATE_BASE64="<base64-encoded .p12>"
BUILD_PROVISION_PROFILE_BASE64="<base64-encoded .mobileprovision>"
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>"
APPLE_PROFILE_NAME="My App Distribution Profile"
APP_STORE_CONNECT_TEAM_ID="TEAM123456"

# 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"

Pengendalian Bangun

# 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"

---

Penyimpanan Kredensial

Simpan Kredensial Lokal

Bandingkan dengan melewati flag atau var lingkungan setiap kali, simpan kredensial sekali:

# Save iOS credentials
bunx @capgo/cli build credentials save \
  --platform ios \
  --certificate ./dist_cert.p12 \
  --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-profile-name "My App Profile" \
  --apple-team-id TEAM123456

# Save Android credentials
bunx @capgo/cli 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

Lokasi Penyimpanan

Flag	Lokasi	Penggunaan
(default)	~/.capgo-credentials/credentials.json	Global — bersamaan di semua proyek di mesin Anda
--local	.capgo-credentials.json di root proyek	Per-proyek — menggantikan global ketika kedua ada

Kredensial dikunci oleh ID aplikasi (misalnya com.example.myapp), sehingga file kredensial tunggal dapat menyimpan pengaturan untuk aplikasi berbeda tanpa konflik. Kredensial setiap aplikasi kemudian dipisahkan oleh platform (ios / android).

Peringatan

Tambahkan .capgo-credentials.json ke .gitignore jika menggunakan kredensial lokal. Jangan pernah komit kredensial ke pengontrol versi.

Kelola Kredensial Tersimpan

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

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

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

---

Contoh

GitHub Aksi

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 build request --platform ios
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
          BUILD_CERTIFICATE_BASE64: ${{ secrets.IOS_CERTIFICATE }}
          BUILD_PROVISION_PROFILE_BASE64: ${{ secrets.IOS_PROFILE }}
          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 }}
          APPLE_PROFILE_NAME: ${{ secrets.APPLE_PROFILE_NAME }}
          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 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 }}

Menggunakan Flag CLI Langsung

# Build iOS with all options inline
bunx @capgo/cli 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 build request \
  --platform android \
  --skip-build-number-bump \
  --no-output-upload \
  --apikey YOUR_API_KEY

Konfigurasi Campuran

Gabungkan kreditensi yang disimpan dengan CLI override:

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

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

Kreditensi yang disimpan menyediakan detail tanda tangan sementara CLI flag mengatur perilaku pembangunan untuk langkah ini.