Konfigurationsoptionen

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

Konfigurationsvorrang

Jede Buildoption kann auf mehrere Weise gesetzt werden. Wenn dieselbe Option auf mehrere Weise 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 Zertifikate SKIP_BUILD_NUMBER_BUMP=true aber Sie übergeben --no-skip-build-number-bump auf der CLI, gewinnt die CLI-Flagge und die Buildnummern werden automatisch inkrementiert.

Tip

Für CI/CD-Pipelines sind Umgebungsvariablen normalerweise die bequemsten. Für lokale Entwicklung sind gespeicherte Zertifikate (via build credentials saveVermeide die Wiederholung von Flags.

---

IOS-Optionen

Code Signierung

CLI Flag	Umgebungsvariable	Zugriffschlüssel	Standard	Beschreibung
--build-certificate-base64 <cert>	BUILD_CERTIFICATE_BASE64	BUILD_CERTIFICATE_BASE64	—	Base64-codiert .p12 Distributionsszertifikat
--ios-provisioning-profile <map>	CAPGO_IOS_PROVISIONING_MAP	CAPGO_IOS_PROVISIONING_MAP	—	Provisionierungsprofil als path oder bundleId=path Mapping. Wiederholbar für Mehrziel-Apps (App + Erweiterungen); der Profilname wird automatisch extrahiert.
--p12-password <password>	P12_PASSWORD	P12_PASSWORD	—	Zugangsdaten für das .p12 Zertifikat (überspringen, wenn das Zertifikat kein Passwort hat)

App Store Connect Authentifizierung

CLI Flag	Umgebungsvariable	Kredentialschlü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 Aussteller-ID (UUID)
--apple-key-content <content>	APPLE_KEY_CONTENT	APPLE_KEY_CONTENT	—	Base64-codierte App Store Connect API-Schlüssel (.p8 Datei)
--app-store-connect-team-id <id>	APP_STORE_CONNECT_TEAM_ID	APP_STORE_CONNECT_TEAM_ID	—	App Store Connect Team-ID

Nicht empfohlen

Die App-basierte Passwortauthentifizierung wird abgeraten und ihr Einsatz wird abgeraten. Es existiert nur als Kompatibilitätsweg für Teams, die von Ionic Appflow migrieren (das sich auf sie verließ). Es ist an eine persönliche Apple-ID gebunden, mit keiner granularen Berechtigung, kann App Store Connect nicht abfragen (so fallen Build-Zahlen auf ein Timestamp zurück), und deckt nur die TestFlight-Uploads selbst ab. Statt dessen wird eine App Store Connect API-Schlüssel (.p8) empfohlen: Sie ist die empfohlene, fähigere und sichere Option für CI/CD.

App-basierte Passwortauthentifizierung (nicht empfohlen)

CLI Flag	Umgebungsvariable	Zugriffsschlüssel	Standard	Beschreibung
--apple-id <email>	FASTLANE_USER	FASTLANE_USER	—	E-Mail-Adresse des Apple-Kontos, das das App gehört
--apple-app-specific-password <password>	FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD	FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD	—	Zur App spezifische Passwort (xxxx-xxxx-xxxx-xxxx) generiert auf numerische App-Store-Connect-App-ID (z.B.
--apple-app-id <id>	APPLE_APP_ID	APPLE_APP_ID	—	Vorsicht 1234567890)

Vorsicht

All drei Felder sind gemeinsam erforderlich. Das numerische APPLE_APP_ID (in App Store Connect → Ihre App → App-Informationen → Apple-ID) ist erforderlich: Ohne es fällt fastlane auf einen interaktiven 2FA-Login zurück, der auf dem Build-Runner nicht abgeschlossen werden kann. Wenn diese Methode verwendet wird, fällt die Build-Nummer auf ein timestamp-basiertes Wert zurück, weil App Store Connect nicht für die neueste Build-Nummer abgefragt wird.

iOS-Build-Einstellungen

CLI-Flag	Umgebungsvariable	Zugriffschlüssel	Standard	Beschreibung
--ios-scheme <scheme>	CAPGO_IOS_SCHEME	CAPGO_IOS_SCHEME	App	Xcode-Scheme zum Bauen
--ios-target <target>	CAPGO_IOS_TARGET	CAPGO_IOS_TARGET	App	Xcode-Ziel zum Lesen von Build-Einstellungen
--ios-distribution <mode>	CAPGO_IOS_DISTRIBUTION	CAPGO_IOS_DISTRIBUTION	app_store	Verteilungsmodus: app_store oder ad_hoc

---

Android-Optionen

Keystore-Zertifizierung

CLI Flag	Umgebungsvariable	Benutzerkennungsschlüssel	Standard	Beschreibung
--android-keystore-file <keystore>	ANDROID_KEYSTORE_FILE	ANDROID_KEYSTORE_FILE	—	Bas64-codierte Keystore-Datei (.keystore oder .jks)
--keystore-key-alias <alias>	KEYSTORE_KEY_ALIAS	KEYSTORE_KEY_ALIAS	key0	Sicherheitsdatenbank-Schlüsselalias
--keystore-key-password <password>	KEYSTORE_KEY_PASSWORD	KEYSTORE_KEY_PASSWORD	—	Sicherheitsdatenbank-Schlüsselpasswort (falls nicht gesetzt, fällt zurück auf Speicherpasswort)
--keystore-store-password <password>	KEYSTORE_STORE_PASSWORD	KEYSTORE_STORE_PASSWORD	—	Sicherheitsdatenbank-Speicherpasswort

Google Play-Konfiguration

CLI Flag	Umgebungsvariable	Benutzerkennwort	Standard	Beschreibung
--play-config-json <json>	PLAY_CONFIG_JSON	PLAY_CONFIG_JSON	—	Bas64-codiertes Google Play-Dienstkontokennwort
(nur Umgebungsvariable)	PLAY_STORE_TRACK	—	internal	Google Play Release-Spur (internal, alpha, beta, production)
(umgebungsspezifisch nur)	PLAY_STORE_RELEASE_STATUS	—	draft	Freigabe-Status auf der gewählten Spur (draft, completed, inProgress, halted)

Android Build-Einstellungen

CLI-Flag	Standard	Beschreibung
--android-flavor <flavor>	—	Produktflavor zum Bauen (z.B. production). Pflichtfeld wenn Ihr Projekt mehrere Flavours definiert.
--in-app-update-priority <0–5>	—	Google Play in-app-Update-Priorität für diese Freigabe (höher = dringender).
--no-playstore-upload	—	Bauen und signieren, aber die Play Store-Uploads auslassen (erfordert --output-upload).

---

Build Control Options

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

Build Mode

CLI Flag	Standard	Beschreibung
--platform <platform>	—	Erforderlich. ios oder android
--build-mode <mode>	release	debug oder release
--path <path>	.	Projektordner
--verbose	false	Erweiterter Build-Protokoll-Loggen aktivieren
--ai-analytics	false	Bei Build-Fehlern werden Protokolle an Capgo AI zur Diagnose gesendet — siehe AI-Build-Diagnose

Build-Nummer-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-Zählung ü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 Maximalwert von Google Play, erhöht ihn um 1 versionCode Wenn

die Build die Version verwendet, 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	Lade die Build-Ausgänge (IPA/APK/AAB) in Capgo-Speicher hoch. Wenn über Umgebungsvariable gesetzt, verwenden Sie BUILD_OUTPUT_UPLOAD_ENABLED=true.
--no-output-upload	BUILD_OUTPUT_UPLOAD_ENABLED	—	—	Deaktivieren Sie die Ausgabenhochladung. 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 bleiben Download-Links aktiv
--output-record <path>	—	—	—	Nach erfolgreichem Build schreiben Sie ein JSON-Protokoll (Job-ID, Status, Download-URL, QR-Code code) <path> — lesen Sie es wieder mit build last-output.

Speicherformat: Verwenden Sie menschenlesbare Dauerangaben wie 1h, 6h, 2d, 7dMindestens 1 Stunde, höchstens 7 Tage. Wenn über Umgebungsvariable gesetzt, verwenden Sie Sekunden (z.B. 3600 für 1 Stunde).

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-Key (nur Selbsthosting)

---

Umgebungsvariable-Quick-Reference

Für Ihre CI/CD-Pipeline einfach kopieren. Alle Variablen sind optional — setzen Sie nur, was Sie benötigen.

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

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

---

Kreditwesen-Speicherung

Lokale Kreditwerte speichern

Stattdessen Flags oder Umgebungsvariablen jederzeit übergeben, speichern Sie Kreditwerte einmal:

# 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

Speicherorten

Flagge	Speicherort	Verwendungsfall
(Standard)	~/.capgo-credentials/credentials.json	Global — auf allen Projekten auf Ihrem Computer gemeinsam verwendet
--local	.capgo-credentials.json im Projektroot	Projektbezogen — überschreibt das globale, wenn beide existieren

Daten sind durch Anwendungs-ID (z.B. com.example.myapp), so kann ein einzelner Datenordner Einstellungen für mehrere Anwendungen ohne Konflikte speichern. Jede Anwendung wird weiterhin durch Plattform (ios / android).

Vorsicht

Hinzufügen .capgo-credentials.json zu Ihrem .gitignore wenn Sie lokale Anmeldeinformationen verwenden. Nie commiten Sie Anmeldeinformationen in die Versionskontrolle.

Gespeicherte Anmeldeinformationen verwalten

# 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

---

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

Mit CLI Flags direkt verwenden

# 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

Mischkonfiguration

Gespeicherte Anmeldeinformationen kombinieren mit CLI-Überschreibungen:

# 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

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