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 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 Anmeldeinformationen SKIP_BUILD_NUMBER_BUMP=true aber Sie übergeben --no-skip-build-number-bump On dem CLI, gewinnt die CLI-Flag und die Build-Zahlen werden automatisch inkrementiert.

Tip

Für CI/CD-Pipelines sind Umgebungsvariablen am bequemsten. Für lokale Entwicklung sind gespeicherte Anmeldeinformationen (via) build credentials save) vermeiden Sie es, die Flags jede Zeit wiederholen zu müssen.

---

iOS-Optionen

Code-Signierung

CLI-Flag	Umgebungsvariable	Anmeldeinformationsschlüsel	Standard	Beschreibung
--build-certificate-base64 <cert>	BUILD_CERTIFICATE_BASE64	BUILD_CERTIFICATE_BASE64	—	Base64-codiert .p12 Verteilungszertifikat
--ios-provisioning-profile <map>	CAPGO_IOS_PROVISIONING_MAP	CAPGO_IOS_PROVISIONING_MAP	—	Provisionierungsprofil als path oder bundleId=path Entsprechend
--p12-password <password>	P12_PASSWORD	P12_PASSWORD	—	Zuordnung. Wiederholbar für Mehrzielanwendungen (Anwendung + Erweiterungen); der Profilname wird automatisch extrahiert. .p12 Kennwort für das

Zertifikat (Übergehen, wenn das Zertifikat kein Kennwort hat)

CLI Flag	Umgebungsvariable	Zugriffschlüssel	Standard	Beschreibung
--apple-key-id <id>	APPLE_KEY_ID	APPLE_KEY_ID	—	App Store Connect API-Sicherheitszertifikatschlüssel
--apple-issuer-id <id>	APPLE_ISSUER_ID	APPLE_ISSUER_ID	—	App Store Connect-Emittenten-ID (UUID)
--apple-key-content <content>	APPLE_KEY_CONTENT	APPLE_KEY_CONTENT	—	Base64-codiertes App Store Connect API-Sicherheitszertifikat (.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 Anwendungsspezifische Passwortauthentifizierung wird abgeraten und wird nicht empfohlen. It existiert nur als Kompatibilitätsweg für Teams, die von Ionic Appflow migrieren (das sich darauf verließ). Es ist an ein persönliches Apple-Konto mit keinen granularen Berechtigungen gebunden, kann keine App Store Connect-Abfrage durchführen (deshalb fallen Build-Zahlen auf ein Timestamp zurück) und deckt nur die TestFlight-Uploads selbst ab. Statt eines App Store Connect API-Schlüssels (.p8), bevorzugen Sie stattdessen: es ist die empfohlene, leistungsfähigere und sichere Option für CI/CD.

App-spezifische Kennwortauthentifizierung (nicht empfohlen)

CLI-Flag	Umgebungsvariable	Zugriffschlüssel	Standard	Beschreibung
--apple-id <email>	FASTLANE_USER	FASTLANE_USER	—	Apple-ID-E-Mail-Adresse des Kontos, das das App gehört
--apple-app-specific-password <password>	FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD	FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD	—	App-spezifisches Kennwort (xxxx-xxxx-xxxx-xxxx) generiert am appleid.apple.com
--apple-app-id <id>	APPLE_APP_ID	APPLE_APP_ID	—	Numerische App Store Connect-App-ID (z.B. 1234567890)

Vorsicht

Alle drei Felder sind zusammen erforderlich. Die numerische APPLE_APP_ID (in App Store Connect → Ihre App → App-Informationen → Apple-ID) ist erforderlich: Ohne sie fällt fastlane auf den Build-Runner zurück auf eine interaktive 2FA-Anmeldung, die 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

---

Entscheiden Sie sich für eine der folgenden Optionen, um Ihre Anwendung zu erstellen: Sie können auch unsere Appflow- oder Capawesome-Alternative verwenden, um Ihre Anwendung zu erstellen. Wir bieten auch unsere Consulting-Dienste an, um Ihnen bei der Erstellung Ihrer Anwendung zu helfen.

Abschnitt mit dem Titel “Android-Optionen”

CLI Flag	__CAPGO_KEEP_0__-Flag	Umgebungsvariable	Standard	Beschreibung
--android-keystore-file <keystore>	ANDROID_KEYSTORE_FILE	ANDROID_KEYSTORE_FILE	—	Base64-codierter Keystore-Datei (.keystore oder .jks)
--keystore-key-alias <alias>	KEYSTORE_KEY_ALIAS	KEYSTORE_KEY_ALIAS	key0	oder
--keystore-key-password <password>	KEYSTORE_KEY_PASSWORD	KEYSTORE_KEY_PASSWORD	—	Keystore-Schlüssel-Bezeichner
--keystore-store-password <password>	KEYSTORE_STORE_PASSWORD	KEYSTORE_STORE_PASSWORD	—	Keystore-Schlüssel-Passwort (fällt auf Speicher-Passwort zurück, wenn nicht gesetzt)

Keystore-Speicher-Passwort

CLI Flag	__CAPGO_KEEP_0__ Flag	Umgebungsvariable	Standard	Beschreibung
--play-config-json <json>	PLAY_CONFIG_JSON	PLAY_CONFIG_JSON	—	Base64-codiertes JSON-Schlüsseldaten des Google Play-Dienstes
--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, haltedFreigabestatus auf der gewählten Strecke ( --submit-to-store-review )

Einstellungen für Android-Builds

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

---

Baukontrollmöglichkeiten

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

Bauart

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

Build-Nummer-Kontrolle

CLI-Flagge	Umgebungsvariable	Zugriffschlüssel	Standard	Beschreibung
--skip-build-number-bump	SKIP_BUILD_NUMBER_BUMP	SKIP_BUILD_NUMBER_BUMP	false	Automatisches Build-Nummer / Version code-Zählung überspringen
--no-skip-build-number-bump	—	—	—	Automatische Zählung explizit wieder aktivieren (überschreibt gespeicherte Anmeldeinformationen)

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

• iOS: Lädt die neueste Build-Nummer von App Store Connect, erhöht sie um 1
• Android: Lädt die Maximal- versionCode Nummer von Google Play, erhöht sie um 1

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

Abschnitt mit dem Titel „Output Upload“

CLI Flag	Umgebungsvariable	Zugriffschlüssel	Standard	Beschreibung
--output-upload	BUILD_OUTPUT_UPLOAD_ENABLED	BUILD_OUTPUT_UPLOAD_ENABLED	false	Upload von Build-Ergebnissen (IPA/APK/AAB) auf Capgo-Speicher. Wenn über Umgebungsvariable gesetzt, verwenden BUILD_OUTPUT_UPLOAD_ENABLED=true.
--no-output-upload	BUILD_OUTPUT_UPLOAD_ENABLED	—	—	Deaktivieren Sie die Uploads von Build-Ergebnissen. Wenn über Umgebungsvariable gesetzt, verwenden 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 wird ein JSON-Record (Job-ID, Status, Download-URL, QR-code) geschrieben <path> — lesen Sie es zurück mit build last-output.

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

Abschnitt: Build Cache

Capgo saves compiled native artifacts (CocoaPods, Gradle, and related build outputs) so beginnen wiederholte Builds schneller. Build Cache ist standardmäßig aktiviert pro App. __CAPGO_KEEP_0__ Flag

CLI Feld	API field	Default	Beschreibung
--no-cache	cache_enabled: false	Cache aktivieren	Cache für diese Build deaktivieren: Restore vermeiden und speichere keine neue Eintragung
--cache-key <value>	cache_key	(vermeide)	Teile den Cache (z.B. prod, stagingvermeide für eine gemeinsame Cacheinstanz pro App

CLI-Äquivalente: build request akzeptiert --no-cache und --cache-key.

Tip

Verwenden Sie unterschiedliche --cache-key Werte, wenn RC- und Produktionsbuilds denselben App-Id haben, aber nicht voneinander die kompilierte Ausgabe wiederverwenden müssen — zum Beispiel --cache-key=prod und --cache-key=staging.

CLI examples:

# 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 Beispiele: (when your integration calls Capgo Build directly):

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

für den gemeinsamen allgemeinen Cache. Setzen cache_key und cache_key um die Umgebungen zu partitionieren. Setzen Sie "cache_enabled": false um den Cache für eine einzelne Anfrage zu deaktivieren (gleichbedeutend mit --no-cache).

Wenn ein Build erfolgreich aussieht, aber das Artefakt falsch ist – oder ein Android AAB fehlt, nachdem RC gegenüber Produktionsumgebungen gewechselt wurde – versuchen Sie einen dedizierten Cache-Schlüssel oder eine einmalige --no-cache build. Siehe Fehlende Cache-Wiederherstellung: Fehlende Cache-Wiederherstellung.

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

Fertig zum Kopieren in Ihre CI/CD-Pipeline. 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"

---

Zugriffsspeicherung

Sichere Anmeldeinformationen lokal

Stattdessen müssen Sie keine Flags oder Umgebungsvariablen mehr jederzeit angeben, sondern können die Anmeldeinformationen einmalig 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	Anwendungsbereich
Standard	~/.capgo-credentials/credentials.json	Global — auf allen Projekten auf Ihrem Computer gemeinsam
--local	.capgo-credentials.json im Projektroot	Projektbezogen — überschreibt Global, wenn beide existieren

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

Vorsicht

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

Verwalten von gespeerten Anmeldeinformationen

# 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

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

Kombinieren Sie gespeicherte Anmeldeinformationen 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 Signaturregister während CLI Flagge die Ausführung des Buildverhaltens für diese spezifische Ausführung überschreibt.