Konfigurationsoptionen

Eine umfassende Referenz für jede Cloud Build-Konfigurationsoption. Verwenden Sie diese Seite, um die CLI-Flag, Umgebungsvariable oder Anmeldeinformationsschlüssel für jede Konfigurationsoption zu finden.

Konfigurationsvorrang

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

Tip

Für CI/CD-Pipelines sind Umgebungsvariablen in der Regel die bequemste Lösung. Für lokale Entwicklung sind gespeicherte Anmeldeinformationen (über build credentials save) sinnvoll, um die wiederholte Angabe von Flags zu vermeiden.

---

iOS-Optionen

Code Signierung

CLI Flagge	Umgebungsvariable	Anmeldeinformationsschlüssel	Standard	Beschreibung
--build-certificate-base64 <cert>	BUILD_CERTIFICATE_BASE64	BUILD_CERTIFICATE_BASE64	—	Wert in Base64-Code .p12 Zertifikat für die Verteilung
--ios-provisioning-profile <map>	CAPGO_IOS_PROVISIONING_MAP	CAPGO_IOS_PROVISIONING_MAP	—	Provisioning-Profil als path oder bundleId=path Welche Optionen haben wir?
--p12-password <password>	P12_PASSWORD	P12_PASSWORD	—	Welche Optionen haben wir? .p12 Welche Optionen haben wir?

Welche Optionen haben wir?

CLI Flag	(Übergehen, wenn das Zertifikat kein Passwort hat)	Authentifizierung bei App Store Connect	Standard	Beschreibung
--apple-key-id <id>	APPLE_KEY_ID	APPLE_KEY_ID	—	App Store Connect API-Sicherheitschlüssel
--apple-issuer-id <id>	APPLE_ISSUER_ID	APPLE_ISSUER_ID	—	App Store Connect-Bezeichner-ID (UUID)
--apple-key-content <content>	APPLE_KEY_CONTENT	APPLE_KEY_CONTENT	—	Bas64-codierter App Store Connect API-Sicherheitschlü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-spezifische 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, die keine granularen Berechtigungen hat, 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 empfohlen, einen App Store Connect API-Sicherheitschlüssel zu verwenden: er ist die empfohlene, leistungsfähigere und sichere Option für CI/CD..p8Statt dessen wird empfohlen, einen App Store Connect __CAPGO_KEEP_0__-Sicherheitschlüssel zu verwenden: er ist die empfohlene, leistungsfähigere und sichere Option für CI/CD.

Appspezifische Passwort-Authentifizierung (nicht empfohlen)

CLI Flag	Umgebungsvariable	Zugriffschlü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	—	Appspezifisches Passwort (xxxx-xxxx-xxxx-xxxx) generiert auf appleid.apple.com
--apple-app-id <id>	APPLE_APP_ID	APPLE_APP_ID	—	Numerische App-Store-Connect-App-ID (z.B. 1234567890)

Achtung

Alle drei Felder sind gemeinsam erforderlich. Die numerische APPLE_APP_ID (im App Store Connect → Ihre App → App-Informationen → Apple-ID) ist obligatorisch: Ohne sie 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 eine timestamp-basierte Werte 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 für die Lesung von Build-Einstellungen
--ios-distribution <mode>	CAPGO_IOS_DISTRIBUTION	CAPGO_IOS_DISTRIBUTION	app_store	Verteilungsmodus: app_store oder ad_hoc

---

Alternativen für Live-Updates von Capacitor: Welche Option ist für Sie die beste?

Alternativen für Capawesome: Welche Option ist für Sie die beste?

CLI Flag	Abschnitt: Android-Optionen	Zertifikatsignierung mit Keystore	Abschnitt: Zertifikatsignierung mit Keystore	__CAPGO_KEEP_0__-Flagg
--android-keystore-file <keystore>	ANDROID_KEYSTORE_FILE	ANDROID_KEYSTORE_FILE	—	Wert in Base64 kodierter Keystore-Datei (.keystore oder .jks)
--keystore-key-alias <alias>	KEYSTORE_KEY_ALIAS	KEYSTORE_KEY_ALIAS	key0	Wert in Base64 kodierter Keystore-Datei (
--keystore-key-password <password>	KEYSTORE_KEY_PASSWORD	KEYSTORE_KEY_PASSWORD	—	Keystore-Schlüsselalias
--keystore-store-password <password>	KEYSTORE_STORE_PASSWORD	KEYSTORE_STORE_PASSWORD	—	Keystore-Schlüsselpasswort (fällt auf Speicherpasswort zurück, wenn nicht gesetzt)

Keystore-Speicherpasswort

CLI Flag	__CAPGO_BEWAHREN_0__ Flag	Umgebungsvariable	Zugangsdaten-Schlüssel	Standardmäßig
--play-config-json <json>	PLAY_CONFIG_JSON	PLAY_CONFIG_JSON	—	Base64-codiertes Google Play-Dienstkontokonto-JSON-Schlüssel
--android-track <track>	PLAY_STORE_TRACK	PLAY_STORE_TRACK	internal (oder) production mit --submit-to-store-review)	Google Play-Veröffentlichungsstrecke (internal, alpha, beta, production). Forwarded from CI env / CLI into the build runner.
--android-release-status <status>	PLAY_STORE_RELEASE_STATUS	PLAY_STORE_RELEASE_STATUS	draft Vorwärts von CI-Umgebung / __CAPGO_KEEP_0__ in den Build-Runner. completed (oder) --submit-to-store-review)	mitdraft, completed, inProgress, haltedVeröffentlichungsstatus auf der gewählten Strecke ( --submit-to-store-review )

Deutliche Werte überschreiben die

CLI Flag	Standard	Beschreibung
--android-flavor <flavor>	—	Produktflavor zum Bauen (z.B. production). Obligatorisch Wenn Ihr Projekt mehrere Flavours definiert.
--android-track <track>	internal	Google Play-Track für diese Veröffentlichung. Mit --submit-to-store-review und keinem Track gesetzt, Capgo setzt sich standardmäßig auf production.
--android-release-status <status>	draft	Google Play-Veröffentlichungsstatus. Mit --submit-to-store-review und keinem Status gesetzt, Capgo setzt sich standardmäßig auf completed.
--in-app-update-priority <0–5>	—	Google Play-In-App-Update-Priorität für diese Veröffentlichung (höher = dringender).
--no-playstore-upload	—	Erstellen und signieren, aber die Veröffentlichung im Google Play Store auslassen (erfordert --output-upload).

---

Build Control Optionen

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

Build Modus

CLI Flag	Standard	Beschreibung
--platform <platform>	—	Vorhanden. ios oder android
--build-mode <mode>	release	debug oder release
--path <path>	.	Projektverzeichnis
--verbose	false	Verbesseere die Protokollierung bei der Build-Log-Ausgabe
--ai-analytics	false	Senden Sie bei Build-Fehlern die Protokolle an Capgo AI zur Diagnose — siehe AI-Build-Diagnose

Build-Nummern-Kontrolle

CLI-Flag	Umgebungsvariable	Zugriffschlüssel	Standard	Beschreibung
--skip-build-number-bump	SKIP_BUILD_NUMBER_BUMP	SKIP_BUILD_NUMBER_BUMP	false	Überspringen Sie die automatische Build-Nummer-/Version code-Zahlenerhöhung
--no-skip-build-number-bump	—	—	—	Aktivieren Sie die automatische Zahlenerhöhung explizit (überschreibt gespeicherte Zugriffsdaten)

By default, Capgo Cloud Build automatically increments build numbers:

• iOS: Liest die neueste Buildnummer aus App Store Connect, erhöht sie um 1
• Android: Liest den Maximalwert versionCode aus Google Play, erhöht sie um 1

Wenn --skip-build-number-bump wird gesetzt, verwendet die Build die Version, die bereits in Ihren Projektdateien (Xcode-Projekt oder build.gradle).

Ausgabehochladen

CLI Flag	Umgebungsvariable	Benutzereinstellungen	Standard	Beschreibung
--output-upload	BUILD_OUTPUT_UPLOAD_ENABLED	BUILD_OUTPUT_UPLOAD_ENABLED	false	Hochladen von Buildausgaben (IPA/APK/AAB) in Capgo-Speicher. Wenn über Umgebungsvariable gesetzt, verwenden BUILD_OUTPUT_UPLOAD_ENABLED=true.
--no-output-upload	BUILD_OUTPUT_UPLOAD_ENABLED	—	—	Output-Hochladen deaktivieren. Wenn über Umgebungsvariable gesetzt, verwenden BUILD_OUTPUT_UPLOAD_ENABLED=false.
--output-retention <duration>	BUILD_OUTPUT_RETENTION_SECONDS	BUILD_OUTPUT_RETENTION_SECONDS	1h	wie lange Downloadlinks aktiv bleiben
--output-record <path>	—	—	—	Nach einem erfolgreichen Build eine JSON-Aufzeichnung (Job-ID, Status, Download-URL, QR-code) schreiben <path> — mit lesen build last-output.

Speicherformat: Menschliche Lesbarkeitsdauer wie verwenden 1h, 6h, 2d, 7d. Mindestens 1 Stunde, höchstens 7 Tage. Wenn über Umgebungsvariable gesetzt, verwenden 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

Kopieren und einsetzen für 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>"
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"

---

Zugangsdatenspeicherung

Kredite lokal speichern

Stattdessen Flags oder Umgebungsvariablen jederzeit übergeben, Kredite einmal speichern:

# 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

Speicherorte

Flagge	Ort	Verwendungsfall
(standard)	~/.capgo-credentials/credentials.json	Global — gemeinsam für alle Projekte auf Ihrem Computer
--local	.capgo-credentials.json im Projektroot	Projektbezogen — überschreibt Global, wenn beide existieren

Die Anmeldeinformationen werden durch Anwendungs-ID (z. B. com.example.myapp)ios / android).

Vorsicht

Vorsicht .capgo-credentials.json Hinzufügen an Ihre .gitignore Wenn Sie lokale Anmeldeinformationen verwenden. Stellen Sie sicher, dass Sie keine Anmeldeinformationen in der Versionskontrolle committen.

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

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

Combiniere gespeicherte Anmeldeinformationen mit CLI-Überwriten:

# 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ührung für diese spezifische Ausführung überschreiben.