Konfigurationsoptionen

Vollständige Referenz für jede Cloud Build-Konfigurationsoption. Verwenden Sie diese Seite, um die CLI Flagge, Umgebungsvariable oder Zugriffsschlüssel für jede Build-Einstellung zu finden.

Konfigurationsvorzug

Jede Buildoption kann auf mehrere Weise gesetzt werden. Wenn die gleiche Option an mehreren Stellen gesetzt wird, gewinnen höherprioritäre Quellen:

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

Beispiel: Wenn Ihre gespeicherten Anmeldeinformationen haben SKIP_BUILD_NUMBER_BUMP=true aber Sie übergeben --no-skip-build-number-bump auf dem CLI, gewinnt die CLI-Flag und die Buildnummern werden automatisch inkrementiert.

Tip

Für CI/CD-Pipelines sind Umgebungsvariablen normalerweise die bequemste Wahl. Für lokale Entwicklung vermeiden Sie es, Anmeldeinformationen (via build credentials savezu wiederholen, um nicht jede Zeit wieder Flags einzugeben.

---

iOS Optionen

Code Signierung

CLI Flagge	Umgebungsvariable	Zugriffschlüssel	Standard	Beschreibung
--build-certificate-base64 <cert>	BUILD_CERTIFICATE_BASE64	BUILD_CERTIFICATE_BASE64	—	Base64-codiert .p12 Verteilungszertifikat
--build-provision-profile-base64 <profile>	BUILD_PROVISION_PROFILE_BASE64	BUILD_PROVISION_PROFILE_BASE64	—	Base64-codiert .mobileprovision __CAPGO_KEEP_0__ Provisionierungsprofil
--build-provision-profile-base64-prod <profile>	BUILD_PROVISION_PROFILE_BASE64_PROD	BUILD_PROVISION_PROFILE_BASE64_PROD	—	Produktionsprovisionierungsprofil (optional, für die Verteilung im App Store)
--p12-password <password>	P12_PASSWORD	P12_PASSWORD	—	Passwort für das .p12 Zertifikat (lösen Sie das Passwort, wenn das Zertifikat kein Passwort hat)

App Store Connect-Anmeldung

CLI Flag	Umgebungsvariable	Zugriffsschlüssel	Standard	Beschreibung
--apple-key-id <id>	APPLE_KEY_ID	APPLE_KEY_ID	—	App Store Connect API Schlüssel-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-codierter App Store Connect API-Schlüssel (.p8 Datei)
--apple-profile-name <name>	APPLE_PROFILE_NAME	APPLE_PROFILE_NAME	—	Zertifikatsprofilname wie im Apple Developer-Portal angezeigt
--app-store-connect-team-id <id>	APP_STORE_CONNECT_TEAM_ID	APP_STORE_CONNECT_TEAM_ID	—	App Store Connect Team-ID

Hinweis

Alternative Authentifizierung: Sie können auch eine Apple-ID + Anwendungs-Spezifisches-Passwort anstelle von API-Schlüsseln verwenden. Pass --apple-id <email> und --apple-app-specific-password <password> (Umgebungsvariablen: APPLE_ID, APPLE_APP_SPECIFIC_PASSWORD). API-Schlüssel werden für CI/CD empfohlen.

iOS Build Einstellungen

CLI Flag	Umgebungsvariable	Zugriffschlüssel	Standard	Beschreibung
--ios-scheme <scheme>	CAPGO_IOS_SCHEME	CAPGO_IOS_SCHEME	App	Xcode-Skript zum Bauen
--ios-target <target>	CAPGO_IOS_TARGET	CAPGO_IOS_TARGET	App	Xcode-Ziel zum Lesen von Build-Einstellungen

---

Android-Optionen

Keystore-Zertifizierung

CLI Flag	Umgebungsvariable	Zugangsdaten-Schlüssel	Standard	Beschreibung
--android-keystore-file <keystore>	ANDROID_KEYSTORE_FILE	ANDROID_KEYSTORE_FILE	—	Base64-kodierte Sicherheitsdatei-Datei (.keystore oder .jks)
--keystore-key-alias <alias>	KEYSTORE_KEY_ALIAS	KEYSTORE_KEY_ALIAS	key0	Zertifizierungsdaten-Schlüssel
--keystore-key-password <password>	KEYSTORE_KEY_PASSWORD	KEYSTORE_KEY_PASSWORD	—	Zertifizierungsdaten-Schlüsselpasswort (falls nicht gesetzt, fällt es auf das Speicherpasswort zurück)
--keystore-store-password <password>	KEYSTORE_STORE_PASSWORD	KEYSTORE_STORE_PASSWORD	—	Zertifizierungsdaten-Speicherpasswort

Google Play-Konfiguration

CLI Flag	Umgebungsvariable	Zugriffsschlüssel	Standard	Beschreibung
--play-config-json <json>	PLAY_CONFIG_JSON	PLAY_CONFIG_JSON	—	Base64-codierter JSON-Schlüssel für die Google Play-Dienste

Einstellungen für die Android-Buildumgebung

Umgebungsvariable	Standard	Beschreibung
PLAY_STORE_TRACK	internal	Google Play Veröffentlichungsstrecke (internal, alpha, beta, production)
PLAY_STORE_RELEASE_STATUS	draft	Veröffentlichungsstatus auf Google Play (draft, completed)

---

Build Steuerungsoptionen

Diese Optionen funktionieren für beide iOS- und Android-Builds.

Build Modus

CLI Flag	Beschreibung	Erforderlich.
--platform <platform>	—	oder ios oder android
--build-mode <mode>	release	debug oder release
--build-config <json>	—	Zusätzliche JSON-Build-Konfiguration
--path <path>	.	Projektverzeichnis
--verbose	false	Verbose Build-Logging aktivieren

Build-Nummern-Kontrolle

CLI Flag	Umgebungsvariable	Zugriffschlüssel	Standard	Beschreibung
--skip-build-number-bump	SKIP_BUILD_NUMBER_BUMP	SKIP_BUILD_NUMBER_BUMP	false	Automatische Build-Nummer / Version code-Erhöhung überspringen
--no-skip-build-number-bump	—	—	—	Explicitly re-enable auto-increment (overrides saved credentials)

Standardmäßig erhöht Capgo Cloud Build automatisch die Buildnummern:

• iOS: Liest die neueste Buildnummer aus App Store Connect, erhöht sie um 1
• Android: Liest den maximalen Wert von Google Play, erhöht ihn um 1 versionCode Wenn

wird verwendet, verwendet das Build-Tool die Version, die bereits in Ihren Projektdateien (Xcode-Projekt oder --skip-build-number-bump Ausgabeanhänge build.gradle).

Abschnitt mit dem Titel “Ausgabeanhänge”

CLI Flag	Umgebungsvariable	Zugriffschlüssel	Standard	Beschreibung
--output-upload	BUILD_OUTPUT_UPLOAD_ENABLED	BUILD_OUTPUT_UPLOAD_ENABLED	false	Upload Buildausgaben (IPA/APK/AAB) an Capgo-Speicher. Wenn über Umgebungsvariable gesetzt, verwenden Sie BUILD_OUTPUT_UPLOAD_ENABLED=true.
--no-output-upload	BUILD_OUTPUT_UPLOAD_ENABLED	—	—	Ausgabeupload deaktivieren. Wenn über Umgebungsvariable gesetzt, verwenden Sie BUILD_OUTPUT_UPLOAD_ENABLED=false.
--output-retention <duration>	BUILD_OUTPUT_RETENTION_SECONDS	BUILD_OUTPUT_RETENTION_SECONDS	1h	Wie lange Downloadlinks aktiv bleiben

Aufbewahrungsformat: Menschliche Lesbarkeit verwenden wie 1h, 6h, 2d, 7d. Mindestens 1 Stunde, höchstens 7 Tage. Wenn über Umgebungsvariable gesetzt, verwenden Sie Sekunden (z.B., 3600 Authentifizierung

Authentifizierung

CLI Flag	Umgebungsvariable	Standard	Beschreibung
-a, --apikey <key>	CAPGO_TOKEN	—	Capgo API Schlüssel für die Authentifizierung
--supa-host <host>	—	—	Benutzerdefinierter Supabase-Host (nur Selbsthosting)
--supa-anon <key>	—	—	Benutzerdefinierter Supabase-Anon-Schlüssel (nur Selbsthosting)

---

Übersicht über Umgebungsvariablen

Fertig zum Kopieren und Einsetzen in Ihre CI/CD-Pipeline. Alle Variablen sind optional – setzen Sie nur das, was Sie benötigen.

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"

Build Control

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

---

Zugriffsdaten Speicherung

Lokal anlegen

Stattdessen Flags oder Umgebungsvariablen jederzeit übergeben, legen Sie die Zugriffsdaten einmal ab:

# 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

Speicherorte

Flagge	Speicherort	Verwendungsfall
(Standard)	~/.capgo-credentials/credentials.json	Globale — gemeinsam für alle Projekte auf Ihrem Computer
--local	.capgo-credentials.json im Projekt-Ordner	Projekt-spezifisch — überschreibt die globale Konfiguration, wenn beide existieren

Die Anmeldeinformationen werden durch den Anwendungs-ID (z.B. com.example.myapp), wodurch ein einzelnes Anmeldeinformationen-File Einstellungen für mehrere Apps ohne Konflikte speichern kann. Jede App-Anmeldeinformationen werden weiterhin durch die Plattform (ios / android).

Vorsicht

Hinzufügen .capgo-credentials.json zu Ihrem .gitignore Wenn Sie lokale Anmeldeinformationen verwenden. Anmeldeinformationen niemals in die Versionskontrolle einchecken.

Gespeicherte Anmeldeinformationen verwalten

# 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

---

Beispiele

GitHub Aktionen

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 }}

Mit CLI Flags direkt verwenden

# 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

Mischkonfiguration

Gespeicherte Anmeldeinformationen kombinieren mit CLI-Überschreibungen:

# 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

Die gespeicherten Anmeldeinformationen liefern Signaturdetails, während CLI-Flaggen die Buildverhalten für diese spezifische Ausführung überschreiben.