🔹 build

🏗️ Verwalte native iOS/Android Builds über die Capgo Cloud.

Build-Zugriff und Output

Native Cloud Builds sind in jedem Capgo Plan verfügbar. Build-Credentials werden niemals auf Capgo Servern gespeichert: Sie werden nur für den Build verwendet und danach gelöscht. Build-Outputs können optional mit zeitlich begrenzten Download-Links hochgeladen werden.

Credentials zuerst speichern

npx @capgo/cli build credentials save --appId YOUR_APP_ID --platform ios
npx @capgo/cli build credentials save --appId YOUR_APP_ID --platform android

Output-URL in der CI erfassen

Übergeben --output-record um die Download-URL und den QR code zu speichern, verwende dann build last-output um sie zu lesen:

npx @capgo/cli build request APP_ID --platform android --output-upload --output-record /tmp/build.json
npx @capgo/cli build last-output --path /tmp/build.json --field outputUrl

🔹 Erforderlich

npx @capgo/cli@latest build needed

🧭 Gibt „yes“ aus und beendet mit code 1, falls ein Native Build benötigt wird; andernfalls wird „no“ ausgegeben und mit code 0 beendet. Fehler führen zu code 2.

Beispiel:

npx @capgo/cli@latest build needed com.example.app --channel production --verbose

Optionen:

Parameter	Typ	Beschreibung
-a	string	API Key zum Verknüpfen mit deinem Account
-c	string	Channel, mit dem verglichen wird. Standardmäßig CapacitorUpdater.defaultChannel oder der öffentliche Default-Channel
—package-json	string	Pfade zu package.json-Dateien für Monorepos (kommagetrennt)
—node-modules	string	Pfade zu node_modules-Verzeichnissen für Monorepos (kommagetrennt)
—verbose	boolean	Aktiviert ausführliche Ausgabe mit detaillierten Logs
—supa-host	string	Eigene Supabase-Host-URL (für Self-Hosting oder Capgo-Entwicklung)
—supa-anon	string	Eigener Supabase-Anon-Key (für Self-Hosting)

🚀 Init

Alias: onboarding

npx @capgo/cli@latest build init

Build-Credentials interaktiv einrichten (iOS: Zertifikate + Profile automatisiert; Android: Keystore + Google OAuth bereiten GCP-Service-Account und Play Console Invite vor)

Optionen:

Parameter	Typ	Beschreibung
-a	string	API Key zum Verknüpfen mit deinem Account
-p	string	Platform to onboard (ios or android). If omitted, auto-detects when only one native folder exists; prompts otherwise.
—supa-host	string	Eigene Supabase-Host-URL (für Self-Hosting oder Capgo-Entwicklung)
—no-analytics	boolean	Deaktiviert Build-Onboarding-Analytics und Terminal-Replay für diesen Durchlauf

🔹 Anfrage

npx @capgo/cli@latest build request

Fordere einen Native Build bei Capgo Cloud an. Dieser Befehl zippt dein Projektverzeichnis und lädt es für den Build zu Capgo hoch. Der Build wird verarbeitet und direkt an die App Stores gesendet. Credentials werden nie auf den Servern von Capgo gespeichert; sie werden nach dem Build gelöscht. Speichere sie, bevor du einen Build anforderst:

npx @capgo/cli build credentials save --appId APP_ID --platform ios

Beispiel:

npx @capgo/cli@latest build request com.example.app --platform ios --path .

Optionen:

Parameter	Typ	Beschreibung
—path	string	Pfad zum Projektverzeichnis für den Build (Standard: aktuelles Verzeichnis)
—node-modules	string	Pfade zu node_modules-Verzeichnissen für Monorepos (kommagetrennt)
—platform	string	Zielplattform: ios oder android (erforderlich)
—build-mode	string	Build-Modus: debug oder release (Standard: release)
—build-certificate-base64	string	iOS: Base64-kodiertes .p12-Zertifikat
—p12-password	string	iOS: Zertifikatspasswort (optional, falls kein Passwort gesetzt ist)
—apple-id	string	iOS: Apple-ID-E-Mail für app-spezifische Passwort-Uploads (Alternative zum App Store Connect API Key)
—apple-app-specific-password	string	iOS: App-spezifisches Passwort (xxxx-xxxx-xxxx-xxxx) für TestFlight-Uploads
—apple-app-id	string	iOS: Numerische App Store Connect App-ID (erforderlich zusammen mit —apple-id und —apple-app-specific-password)
—apple-key-id	string	iOS: App Store Connect API Key ID
—apple-issuer-id	string	iOS: App Store Connect Issuer ID
—apple-key-content	string	iOS: Base64-kodierter App Store Connect API Key (.p8)
—app-store-connect-team-id	string	iOS: App Store Connect Team ID
—ios-scheme	string	iOS: Xcode-Scheme für den Build (Standard: App)
—ios-target	string	iOS: Xcode-Target zum Auslesen der Build-Settings (Standard: wie Scheme)
—xcode-version	string	iOS: Build auf einer Maschine mit dieser Xcode-Version (z. B. 26, 26.0.1, 27). Eine Major-Version akzeptiert jede Minor-Version. Standard: jede Maschine. Priorität: CLI > env (CAPGO_IOS_XCODE_VERSION) > gespeicherte Credentials
—ios-distribution	string	iOS: Distribution-Modus
—ios-provisioning-profile	string	iOS: Pfad zum Provisioning-Profile oder bundleId=Pfad-Mapping (wiederholbar)
—android-keystore-file	string	Android: Base64-kodierte Keystore-Datei
—keystore-key-alias	string	Android: Keystore-Key-Alias
—keystore-key-password	string	Android: Keystore-Key-Passwort
—keystore-store-password	string	Android: Keystore-Store-Passwort
—play-config-json	string	Android: Base64-kodierte Google Play Service-Account-JSON
—android-flavor	string	Android: Zu bauender Product Flavor (z. B. production). Erforderlich, wenn dein Projekt mehrere Flavors nutzt.
—android-track	string	Android: Google Play Track für diesen Upload (internal, alpha, beta, production). Standard ohne —submit-to-store-review: internal. Mit —submit-to-store-review und ohne gesetzten Track: production. Priorität: CLI > env > gespeicherte Credentials
—android-release-status	string	Android: Google Play Release-Status (draft, completed, inProgress, halted). Standard ohne —submit-to-store-review: draft. Mit —submit-to-store-review und ohne gesetzten Status: completed. Priorität: CLI > env > gespeicherte Credentials
—in-app-update-priority	string	Android: Google Play In-App-Update-Priorität für dieses Release (Integer 0–5; höher = dringender). Siehe https://developer.android.com/guide/playcore/in-app-updates. Priorität: CLI > env > gespeicherte Credentials
—no-playstore-upload	boolean	Play Store Upload für diesen Build überspringen (setzt gespeicherte Play-Config auf null). Erfordert —output-upload.
—submit-to-store-review	boolean	Nach dem Upload wird die Store-Release zur Prüfung eingereicht, anstatt sie als Entwurf/inaktiven Build zu lassen. Bei Android ist dies standardmäßig der Production-Track mit dem Status release_status completed (überschreibbar mit —android-track / PLAY_STORE_TRACK und —android-release-status / PLAY_STORE_RELEASE_STATUS). Bei iOS wird der verarbeitete TestFlight-Build zur App Store Review eingereicht.
—store-release-name	string	Name/Versionsbezeichnung der Store-Release. Android sendet dies als Google Play version_name; iOS verwendet es als App Store Version beim Erstellen oder Wiederverwenden der editierbaren Version.
—store-release-notes	string	Standardmäßige Release Notes für den Store. Android nutzt dies als Play Changelog; iOS verwendet es als Fallback-Text für „Was gibt’s Neues“ im App Store.
—store-release-notes-locale	string	Lokalisierte Release Notes (wiederholbar), z. B. —store-release-notes-locale en-US=“Bug fixes” —store-release-notes-locale de-DE=“Fehlerbehebungen”.
—ios-testflight-groups	string	iOS: optionale, durch Kommas getrennte TestFlight-Gruppennamen oder IDs für die externe Beta-Distribution.
—ios-automatic-release	boolean	iOS: Die App Store Version wird nach der Apple-Freigabe automatisch veröffentlicht. Standardmäßig erfolgt die Veröffentlichung manuell.
—no-ios-automatic-release	boolean	iOS: Die App Store-Version nach der Apple-Freigabe für ein manuelles Release zurückhalten.
—output-upload	boolean	Überschreibt das Upload-Verhalten nur für diesen Build (aktivieren). Priorität: CLI > env > gespeicherte Credentials
—no-output-upload	boolean	Überschreibt das Upload-Verhalten nur für diesen Build (deaktivieren). Priorität: CLI > env > gespeicherte Credentials
—output-retention	string	Überschreibt die TTL des Output-Links nur für diesen Build (1h bis 7d). Beispiele: 1h, 6h, 2d. Priorität: CLI > env > gespeicherte Credentials
—output-record	string	Schreibt nach einem erfolgreichen Build einen JSON-Record (jobId, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt) an einen Pfad. Ein PNG-QR-code wird ebenfalls neben diesem Pfad mit dem .qr.png Suffix geschrieben. Felder lassen sich wieder auslesen mit build last-output.
—no-cache	boolean	Build-Cache-Wiederherstellung überspringen und Es wird kein neuer Cache-Eintrag für diesen Build gespeichert. Der Build-Cache ist pro App standardmäßig aktiviert.
—cache-key	string	Partitioniert den Build-Cache nach Umgebung, Branch oder Android-Flavor (z. B. prod, staging). Weglassen für einen gemeinsamen Standard-Cache pro App.
—no-skip-build-number-bump	boolean	Überschreibt gespeicherte Credentials, um die automatische Erhöhung der Build-Nummer nur für diesen Build wieder zu aktivieren.
—skip-marketing-version-bump	boolean	Überspringt das automatische Bump der Marketing-Version (CFBundleShortVersionString / versionName), wenn die App bereits veröffentlicht ist.
—sync-ios-version	boolean	iOS: Synchronisiert die Xcode MARKETING_VERSION aus der package.json vor dem Hochladen des Projekts.
—ai-analytics	boolean	Bei einem Build-Fehler werden die Logs zur Diagnose an Capgo AI gesendet. In interaktiven Terminals entfällt die vorherige Bestätigung; in CI wird automatisch hochgeladen und die Analyse an stderr ausgegeben.
—no-prescan	boolean	Den automatischen Pre-Build-Scan überspringen
—prescan-ignore-fatal	boolean	Den Pre-Build-Scan ausführen, aber den Build nie blockieren (nur Bericht)
—prescan-skip	string	Bestimmte Prescan-Checks per ID überspringen (wiederholbar oder kommagetrennt). Andere Checks laufen weiterhin.
—prescan-warn	string	Bestimmte Prescan-Checks per ID zur Warnung herabstufen (wiederholbar oder kommagetrennt). Der Check läuft trotzdem weiter.
—fail-on-warnings	boolean	Prescan-Warnungen als fatal behandeln
—send-logs-to-support	boolean	Bei einem CI/CD-Build-Fehler werden die Build-Logs automatisch an den Support von Capgo hochgeladen (keine E-Mail erforderlich). Der Support von Capgo wird benachrichtigt und meldet sich per E-Mail. Ergänzend zu —ai-analytics.
—send-logs	boolean	Veralteter Alias für —send-logs-to-support
-a	string	API Key zum Verknüpfen mit deinem Account
—supa-host	string	Eigene Supabase-Host-URL (für Self-Hosting oder Capgo-Entwicklung)
—supa-anon	string	Eigener Supabase-Anon-Key (für Self-Hosting)
—verbose	boolean	Aktiviert ausführliche Ausgabe mit detaillierten Logs

Build-Cache: Standardmäßig stellt Capgo kompilierte native Artefakte (CocoaPods, Gradle und zugehörige Outputs) pro App wieder her und speichert sie. Nutze --cache-key um RC- und Production-Caches getrennt zu halten; nutze --no-cache für einen einmaligen Clean Build. API-Integrationen können cache_key oder cache_enabled: false im Build-Request-Payload übergeben. Siehe Build-Cache und Troubleshooting: Fehler beim Cache-Restore.

🔹 Sync-ios-version

npx @capgo/cli@latest build sync-ios-version

Synchronisiert die lokale iOS Xcode MARKETING_VERSION aus der package.json.

Beispiel:

npx @capgo/cli@latest build sync-ios-version --path .

Optionen:

Parameter	Typ	Beschreibung
—path	string	Pfad zum Projektverzeichnis (Standard: aktuelles Verzeichnis)
—check	boolean	Nur Prüfung; Exit-Code ungleich Null, wenn MARKETING_VERSION nicht synchron ist

🔹 Prescan

npx @capgo/cli@latest build prescan

Scannt dein Projekt und gespeicherte Credentials auf Probleme, die einen Cloud-Build verhindern würden – noch bevor etwas hochgeladen wird. Prüft Credentials (Ablauf, Passwörter, Profil-Pairing), den Projektstatus (cap sync, node_modules Layout) und die Plattform-Konfiguration. Läuft automatisch innerhalb von build request; dieser Befehl führt ihn eigenständig aus (z. B. in der CI). Siehe Prescan-Checks für die vollständige Liste der Checks und wie man --skip / --warn einzelne Regeln anpasst.

Optionen:

Parameter	Typ	Beschreibung
—platform	string	Zielplattform: ios oder android (erforderlich)
—path	string	Pfad zum Projektverzeichnis (Standard: aktuelles Verzeichnis)
-a	string	API Key zum Verknüpfen mit deinem Account
—android-flavor	string	Android: Product Flavor, der für den Build verwendet wird
—ios-dist	string	iOS: Distribution-Modus zur Validierung
—json	boolean	Gibt einen maschinenlesbaren JSON-Report aus
—fail-on-warnings	boolean	Beendet mit Fehlercode, wenn Warnungen gefunden werden (CI)
—ignore-fatal	boolean	Diagnosemodus: Meldet alles, beendet aber immer mit Exit 0
—skip	string	Bestimmte Checks per ID überspringen (wiederholbar oder kommagetrennt)
—warn	string	Bestimmte Checks per ID zu Warnungen herabstufen (wiederholbar oder kommagetrennt)
—verbose	boolean	Aktiviert ausführliche Ausgabe mit detaillierten Logs
—supa-host	string	Eigene Supabase-Host-URL (für Self-Hosting oder Capgo-Entwicklung)
—supa-anon	string	Eigener Supabase-Anon-Key (für Self-Hosting)

🔹 Letzter Output

npx @capgo/cli@latest build last-output

Liest den Build-Output-Datensatz eines vorherigen Builds build request --output-record. Gibt standardmäßig das komplette JSON aus, mit —field ein einzelnes Feld oder mit —qr den ASCII-QR-code. Praktisch in der CI, um die Download-URL oder den QR-Code zu holen und in einen PR oder ein Issue zu posten. Beispiele: npx @capgo/cli build last-output —path /tmp/build.json npx @capgo/cli build last-output —path /tmp/build.json —field outputUrl npx @capgo/cli build last-output —path /tmp/build.json —qr

Optionen:

Parameter	Typ	Beschreibung
—path	string	Pfad zur JSON-Datei, die von —output-record erstellt wurde (erforderlich)
—field	string	Gibt ein einzelnes Feld aus (eines von: jobId, appId, platform, buildMode, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt, schemaVersion)
—qr	boolean	Gibt den gerenderten ASCII QR code aus (Shortcut für —field qrCodeAscii)

🔹 Credentials

Verwalte lokal auf deinem Rechner gespeicherte Build-Credentials. 🔒 SICHERHEIT:

• Credentials gespeichert unter ~/.capgo-credentials/credentials.json (global) oder .capgo-credentials.json (lokal)
• Wird beim Build an Capgo gesendet, aber NIEMALS dauerhaft gespeichert
• Wird nach dem Build sofort aus Capgo gelöscht
• Build-Outputs können optional für zeitlich begrenzte Download-Links hochgeladen werden 📚 DOKUMENTATION: iOS Setup: https://capgo.app/docs/cli/cloud-build/ios/ Android Setup: https://capgo.app/docs/cli/cloud-build/android/

🔹 Apple-Key

Alias: asc-key

npx @capgo/cli@latest build credentials apple-key

Erstelle einen App Store Connect Team-API-Key mit einem geführten macOS-Helper (nur macOS). Er öffnet ein natives Fenster, das dich durch Apples App Store Connect UI in einem eingebetteten Browser führt, Issuer ID + Key ID automatisch erfasst, die einmalige .p8-Datei abfängt, sie bei Apple validiert und unter ~/.appstoreconnect/private_keys speichert. Fortschrittsstatistiken werden an Capgo Analytics weitergeleitet (deaktivierbar mit CAPGO_DISABLE_TELEMETRY). npx @capgo/cli build credentials apple-key —appId com.example.app

Beispiel:

Example:

Optionen:

Parameter	Typ	Beschreibung
-a	string	API Key zum Verknüpfen mit deinem Account
—appId	string	Speichert den erfassten Key in den iOS Build-Credentials dieser App
—local	boolean	Speichert die Daten in der projektbezogenen .capgo-credentials.json statt in der globalen Datei
—json	boolean	Gibt die erfasste Key ID / Issuer ID / .p8-Pfad als JSON aus

🔹 Speichern

npx @capgo/cli@latest build credentials save

Speichert Build-Credentials lokal für iOS oder Android. Die Credentials werden hier gespeichert:

• ~/.capgo-credentials/credentials.json (Standard, global)
• .capgo-credentials.json im Projekt-Root (mit —local Flag) ⚠️ VOR DEM BUILD ERFORDERLICH: Du musst die Credentials speichern, bevor du einen Build anforderst. 🔒 Diese Credentials werden NIEMALS dauerhaft auf Capgo-Servern gespeichert. Sie werden sofort nach Abschluss des Builds gelöscht. 📚 Setup-Guides: iOS: https://capgo.app/docs/cli/cloud-build/ios/ Android: https://capgo.app/docs/cli/cloud-build/android/ npx @capgo/cli build credentials save —platform ios
  —certificate ./cert.p12 —p12-password „password“
  —ios-provisioning-profile ./profile.mobileprovision
  —apple-key ./AuthKey.p8 —apple-key-id „KEY123“
  —apple-issuer-id „issuer-uuid“ —apple-team-id „team-id“ Multi-Target Beispiel (App + Widget Extension): npx @capgo/cli build credentials save —platform ios
  —ios-provisioning-profile ./App.mobileprovision
  —ios-provisioning-profile com.example.widget=./Widget.mobileprovision
  … npx @capgo/cli build credentials save —Plattform Android
  —keystore ./release.keystore —keystore-alias „my-key“
  —keystore-key-password „key-pass“
  —play-config ./service-account.json Lokaler Speicher (pro Projekt): npx @capgo/cli build credentials save —local —platform ios …

Beispiel:

iOS Example:

Optionen:

Parameter	Typ	Beschreibung
—appId	string	App-ID (z. B. com.example.app) (erforderlich)
—platform	string	Plattform: ios oder android (erforderlich)
—certificate	string	iOS: Pfad zur .p12-Zertifikatsdatei
—ios-provisioning-profile	string	iOS: Provisioning-Profile-Pfad oder bundleId=Pfad (wiederholbar)
—p12-password	string	iOS: Zertifikatspasswort (optional, falls kein Passwort gesetzt)
—apple-key	string	iOS: Pfad zum .p8 App Store Connect API Key
—apple-key-id	string	iOS: App Store Connect API Key ID
—apple-issuer-id	string	iOS: App Store Connect Issuer ID
—apple-team-id	string	iOS: App Store Connect Team ID
—ios-distribution	string	iOS: Distribution-Modus
—apple-id	string	iOS: Apple-ID-E-Mail für app-spezifische Passwort-Uploads (Alternative zum App Store Connect API Key)
—apple-app-specific-password	string	iOS: App-spezifisches Passwort (xxxx-xxxx-xxxx-xxxx) für TestFlight-Uploads
—apple-app-id	string	iOS: Numerische App Store Connect App-ID (erforderlich zusammen mit —apple-id und —apple-app-specific-password)
—keystore	string	Android: Pfad zur Keystore-Datei (.keystore oder .jks)
—keystore-alias	string	Android: Keystore-Key-Alias
—keystore-key-password	string	Android: Keystore-Key-Passwort
—keystore-store-password	string	Android: Keystore-Store-Passwort
—play-config	string	Android: Pfad zur JSON-Datei des Play Store Service Account
—android-flavor	string	Android: Zu bauender Product Flavor (z. B. production). Erforderlich, wenn dein Projekt mehrere Flavors nutzt.
—in-app-update-priority	string	Android: Google Play In-App-Update-Priorität für zukünftige Releases (Integer 0–5; höher = dringender). Weglassen, um den bestehenden Wert von Play unverändert zu lassen.
—local	boolean	Speichert in .capgo-credentials.json im Projektverzeichnis statt global in ~/.capgo-credentials/
—output-upload	boolean	Build-Outputs (IPA/APK/AAB) in Capgo Storage hochladen und Download-Links ausgeben
—no-output-upload	boolean	Build-Outputs (IPA/APK/AAB) nicht in Capgo Storage hochladen
—output-retention	string	TTL für den Output-Link: 1h bis 7d (Standard: 1h). Beispiele: 1h, 6h, 2d
—skip-build-number-bump	boolean	Automatisches Erhöhen von Build-Nummer/Version-code bei zukünftigen Builds überspringen
—no-skip-build-number-bump	boolean	Automatisches Erhöhen der Build-Nummer wieder aktivieren (Standard)
—skip-marketing-version-bump	boolean	Automatisches Erhöhen der Marketing-Version bei zukünftigen Builds überspringen, wenn die App bereits veröffentlicht ist
—no-skip-marketing-version-bump	boolean	Automatisches Marketing-Version-Bump wieder aktivieren (Standard)

📋 Liste

npx @capgo/cli@latest build credentials list

Gespeicherte Build-Credentials auflisten (Passwörter maskiert). Zeigt die aktuell gespeicherten Credentials (global und lokal). Beispiele: npx @capgo/cli build credentials list # Alle Apps auflisten npx @capgo/cli build credentials list —appId com.example.app # Spezifische App auflisten

Optionen:

Parameter	Typ	Beschreibung
—appId	string	App ID zum Auflisten (optional, sonst alle)
—local	boolean	Nur Credentials aus der lokalen .capgo-credentials.json auflisten

🔹 Löschen

npx @capgo/cli@latest build credentials clear

Gespeicherte Build-Credentials löschen. Credentials aus dem Storage entfernen. Nutze —appId und —platform, um bestimmte Credentials anzusprechen. Beispiele: npx @capgo/cli build credentials clear # Alle Apps löschen (global) npx @capgo/cli build credentials clear —local # Lokale Credentials löschen npx @capgo/cli build credentials clear —appId com.example.app —platform ios

Optionen:

Parameter	Typ	Beschreibung
—appId	string	App ID zum Löschen (optional, löscht alle Apps, wenn weggelassen)
—platform	string	Plattform zum Löschen: ios oder android (optional, löscht alle Plattformen, wenn weggelassen)
—local	boolean	Aus der lokalen .capgo-credentials.json statt der globalen löschen

🔹 Update

npx @capgo/cli@latest build credentials update

Spezifische Credentials aktualisieren, ohne alle erneut angeben zu müssen. Bestehende Credentials aktualisieren, indem Sie nur die zu ändernden Felder angeben. Die Plattform wird automatisch anhand der angegebenen Optionen erkannt. Beispiele: npx @capgo/cli build credentials update —ios-provisioning-profile ./new-profile.mobileprovision npx @capgo/cli build credentials update —local —keystore ./new-keystore.jks

Optionen:

Parameter	Typ	Beschreibung
—appId	string	App ID (wird automatisch aus capacitor.config erkannt, falls nicht angegeben)
—platform	string	Plattform: ios oder android (wird automatisch aus den Optionen erkannt)
—local	boolean	Lokale .capgo-credentials.json statt der globalen aktualisieren
—certificate	string	Pfad zur P12-Zertifikatsdatei
—ios-provisioning-profile	string	Pfad zum Provisioning Profile oder bundleId=path (wiederholbar, standardmäßig additiv)
—overwrite-ios-provisioning-map	boolean	Ersetzt die gesamte Provisioning Map anstatt sie zu mergen (Standard: merge)
—p12-password	string	Passwort für das P12-Zertifikat
—apple-key	string	Pfad zum App Store Connect API Key (.p8 Datei)
—apple-key-id	string	App Store Connect API Key ID
—apple-issuer-id	string	App Store Connect Issuer ID
—apple-team-id	string	App Store Connect Team ID
—apple-id	string	iOS: Apple-ID-E-Mail für app-spezifische Passwort-Uploads (Alternative zum App Store Connect API Key)
—apple-app-specific-password	string	iOS: App-spezifisches Passwort (xxxx-xxxx-xxxx-xxxx) für TestFlight-Uploads
—apple-app-id	string	iOS: Numerische App Store Connect App-ID (erforderlich zusammen mit —apple-id und —apple-app-specific-password)
—ios-distribution	string	iOS: Distribution-Modus
—keystore	string	Pfad zur Keystore-Datei (.keystore oder .jks)
—keystore-alias	string	Keystore-Key-Alias
—keystore-key-password	string	Keystore-Key-Passwort
—keystore-store-password	string	Keystore-Store-Passwort
—play-config	string	Pfad zur Google Play Service Account JSON
—android-flavor	string	Android: Zu bauender Product Flavor (z. B. production). Erforderlich, wenn dein Projekt mehrere Flavors nutzt.
—in-app-update-priority	string	Android: Google Play In-App-Update-Priorität für kommende Releases (Integer 0–5; höher = dringender).
—output-upload	boolean	Build-Outputs (IPA/APK/AAB) in Capgo Storage hochladen und Download-Links ausgeben
—no-output-upload	boolean	Build-Outputs (IPA/APK/AAB) nicht in Capgo Storage hochladen
—output-retention	string	TTL für Output-Links: 1h bis 7d. Beispiele: 1h, 6h, 2d
—skip-build-number-bump	boolean	Automatisches Erhöhen von Build-Nummer/Version-code bei zukünftigen Builds überspringen
—no-skip-build-number-bump	boolean	Automatisches Erhöhen der Build-Nummer wieder aktivieren (Standard)
—skip-marketing-version-bump	boolean	Automatisches Erhöhen der Marketing-Version bei zukünftigen Builds überspringen, wenn die App bereits veröffentlicht ist
—no-skip-marketing-version-bump	boolean	Automatisches Marketing-Version-Bump wieder aktivieren (Standard)

🔹 Verwalten

npx @capgo/cli@latest build credentials manage

Verwalte gespeicherte Build-Credentials interaktiv. Durchsuche gespeicherte Credentials, sieh dir Konfigurationen an, exportiere eine CI/CD-fähige .env-Datei oder lösche die Credentials einer Plattform. Nutzt dieselbe TUI wie capgo init. Beispiele: npx @capgo/cli build credentials manage npx @capgo/cli build credentials manage —appId com.example.app npx @capgo/cli build credentials manage —appId com.example.app —platform ios npx @capgo/cli build credentials manage —local

Optionen:

Parameter	Typ	Beschreibung
—appId	string	Die zu verwaltende App ID (optional, wird abgefragt, falls weggelassen)
—platform	string	Zu verwaltende Plattform: ios oder android (optional, wird abgefragt, falls weggelassen)
—local	boolean	Nur lokale .capgo-credentials.json durchsuchen

🔹 Migrate

npx @capgo/cli@latest build credentials migrate

Migriert alte Provisioning Profiles in das neue Multi-Target-Format. Konvertiert BUILD_PROVISION_PROFILE_BASE64 zu CAPGO_IOS_PROVISIONING_MAP. Findet die primäre Bundle ID automatisch aus deinem Xcode-Projekt. npx @capgo/cli build credentials migrate —platform ios

Beispiel:

Example:

Optionen:

Parameter	Typ	Beschreibung
—appId	string	App ID (wird automatisch aus capacitor.config erkannt, falls nicht angegeben)
—platform	string	Plattform (nur iOS wird unterstützt)
—local	boolean	Von lokaler .capgo-credentials.json statt global migrieren