🔹 Aufbau

🏗️ Mit Capgo Cloud native iOS/Android-Builds verwalten.

🚀 Initialisieren

Alias: onboarding

npx @capgo/cli@latest build init

Set up iOS build credentials interactively (creates certificates and profiles automatically). On macOS, it can also create your App Store Connect API key for you, guided.

🔹 Anfrage

npx @capgo/cli@latest build request

An Capgo Cloud eine native Build anfordern. Diese Anweisung wird Ihr Projektverzeichnis komprimieren und es auf Capgo hochladen, um es zu bauen. Die Build wird verarbeitet und direkt an die App-Stores gesendet. 🔒 SICHERHEIT: Keine Anmeldedaten werden auf Capgo Server gespeichert. Sie werden automatisch gelöscht nach Abschluss der Build. Build-Ausgaben können optional hochgeladen werden, um zeitbegrenzte Download-Links zu erhalten. 📋 VORAUSSETZUNG: Speichern Sie die Anmeldedaten zuerst mit: npx @capgo/cli build credentials save --appId <app-id> --platform <ios|android>

Beispiel:

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

Optionen:

Parameter:	Typ	Beschreibung
—Pfad	string	Pfad zum Projektverzeichnis zum Bauen (Standard: aktuelles Verzeichnis)
—Plattform	string	Zielplattform: ios oder android (erforderlich)
—Build-Modus	string	Build-Modus: debug oder release (Standard: release)
—Build-Zertifikat-Base64	string	iOS: Base64-codiertes .p12-Zertifikat
—p12-Sicherheitszertifikat	string	iOS: Zertifikatspassword (optional, wenn Zertifikat kein Passwort hat)
—apple-id	string	iOS: E-Mail-Adresse für Apple-ID zum Hochladen von App-Spezifischen Passwörtern (Alternative zu App Store Connect API Schlüssel)
—apple-app-specific-password	string	iOS: App-Spezifisches Passwort (xxxx-xxxx-xxxx-xxxx) für TestFlight-Hochladen
—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 Schlüssel-ID
—apple-issuer-id	string	iOS: App Store Connect Aussteller-ID
—apple-key-content	string	iOS: Bas64-kodierte App Store Connect API Schlüssel (.p8)
—Team-ID-für-App-Store-Connect	string	iOS: Team-ID für App Store Connect
—Xcode-Schema-für-iOS	string	iOS: Xcode-Schema zum Bauen (Standard: App)
—Xcode-Ziel-für-iOS	string	iOS: Xcode-Ziel für die Lesung von Build-Einstellungen (Standard: gleiche wie Schema)
—Verteilungsmodus-für-iOS	string	iOS: Verteilungsmodus
—Provisioning-Profil-für-iOS	string	iOS: Pfad zum Provisioning-Profil oder bundleId=path-Zuweisung (wiederholbar)
—Datei-für-Android-Keystore	string	Android: Bas64-kodierte Datei für den Keystore
—keystore-key-alias	string	Android: Alias für den Keystore-Schlüssel
—keystore-key-password	string	Android: Passwort für den Keystore-Schlüssel
—keystore-store-password	string	Android: Passwort für den Keystore-Speicher
—play-config-json	string	Android: Bas64-kodierte JSON-Konfiguration für Google Play-Dienste
—android-flavor	string	Android: Produktflavor zum Bauen (z.B. Produktionsumgebung). Erforderlich, wenn Ihr Projekt mehrere Flavors enthält.
—no-playstore-upload	boolean	Play Store-Upload für diese Build auslassen (setzt die gespeicherte Play-Konfiguration auf Null). Erforderlich, wenn —output-upload verwendet wird.
—submit-to-store-review	boolean	Das hochgeladene Release für die Store-Überprüfung einreichen: Android beendet die Play-Veröffentlichung; iOS sendet die bearbeitete TestFlight-Version zur App Store-Überprüfung.
—store-release-name	string	Name/Beschriftung der Store-Veröffentlichung. Android verwendet es als Google Play-Veröffentlichungsnamen; iOS verwendet es als App Store-Version.
—store-release-notes	string	Standardmäßige Store-Veröffentlichungsnotizen. Android verwendet es als Play-Changelog; iOS verwendet es als App Store 'Was Neues'-Text.
—store-release-notes-locale	string	Lokalisierte Store-Veröffentlichungsnotizen, wiederholbar als locale=notes, z.B. —store-release-notes-locale “fr-FR=Corrections”.
—ios-testflight-groups	string	iOS nur: optional, durch Kommata getrennte TestFlight-externer Gruppennamen oder IDs für die Beta-Verteilung.
—ios-automatic-release	boolean	iOS nur: App Store-Version automatisch nach Apple-Zustimmung freigeben. Standard ist manuelle Freigabe.
—no-ios-automatic-release	boolean	iOS nur: Freigabeberechtigte App Store-Version warten, bis manuell freigegeben wird.
—output-upload	boolean	Übernehmen Sie die Ausgabehandhabung für diese Build nur (aktivieren). Vorrang: CLI > Umgebung > gespeicherte Anmeldeinformationen
—no-output-upload	boolean	Übernehmen Sie die Ausgabehandhabung für diese Build nur (deaktivieren). Vorrang: CLI > Umgebung > gespeicherte Anmeldeinformationen
—output-retention	string	Übernehmen Sie die Gültigkeitsdauer der Ausgabeverknüpfung für diese Build nur (1h bis 7t). Beispiele: 1h, 6h, 2t. Vorrang: CLI > Umgebung > gespeicherte Anmeldeinformationen
—skip-build-number-bump	boolean	Automatische Inkrementierung der Buildnummer/Version code überspringen. Verwendet die Version, die bereits in den Projektdateien ist.
—no-skip-build_number_bump	boolean	Überschreiben Sie gespeicherte Anmeldeinformationen, um die automatische Inkrementierung der Buildnummer für diese Build nur einmal zu aktivieren.
-a,	string	API-Schlüssel, um auf Ihr Konto zuzugreifen
—supa-host	string	Benutzerdefinierte Supabase-Host-URL (für Selbsthosting oder Capgo-Entwicklung)
—supa-anon	string	Benutzerdefinierte Supabase-Anon-Schlüssel (für Selbsthosting)
—verbose	boolean	Aktivieren Sie die ausführliche Ausgabe mit detaillierten Protokollierungen

--submit-to-store-review, --store-release-name, --store-release-notes, und --store-release-notes-locale Arbeiten Sie auf beiden Android- und iOS-Geräten. Verwenden Sie --store-release-notes als Ausfalltext, wiederholen Sie dann --store-release-notes-locale "locale=notes" für jede Geschäftsanwendung lokalisiert:

npx @capgo/cli@latest build request com.example.app \
  --platform ios \
  --build-mode release \
  --submit-to-store-review \
  --store-release-name "1.2.3" \
  --store-release-notes "General improvements" \
  --store-release-notes-locale "en-US=General improvements" \
  --store-release-notes-locale "nl-NL=Algemene verbeteringen" \
  --store-release-notes-locale "fr-FR=Ameliorations generales" \
  --no-ios-automatic-release

In der CI können Sie auch die gleichen lokalisierten Hinweise als JSON bereitstellen mit CAPGO_STORE_RELEASE_NOTES_LOCALIZED, zum Beispiel {"en-US":"General improvements","nl-NL":"Algemene verbeteringen"}.

🔹 Anmeldedaten

npx @capgo/cli@latest build credentials

Die lokalen Build-Anmeldedaten auf Ihrem Computer verwalten. 🔒 SICHERHEIT:

• Anmeldedaten in ~/.capgo-anmeldedaten/credentials.json (global) oder .capgo-anmeldedaten.json (lokal) gespeichert
• Bei der Erstellung werden sie an Capgo gesendet, aber NICHT dauerhaft gespeichert
• Gelöscht aus Capgo sofort nach der Erstellung
• Die Ausgaben der Build-Prozesse können optional hochgeladen werden, um zeitbegrenzte Download-Links zu erhalten 📚 DOKUMENTATION: iOS-Einrichtung: https://capgo.app/docs/builder/ios/ Android-Einrichtung: https://capgo.app/docs/builder/android/

Weitermachen von der Build

Wenn Sie " build " zum Planen der CI/CD-Automatisierung verwenden, verbinden Sie es mit " Capgo CI/CD" für den Produktworkflow in "Capgo CI/CD" Capgo Native Builds für den Produktworkflow in Capgo Native Builds Capgo Integrations für den Produktworkflow in Capgo Integrations CI/CD-Integration für die Implementierungsdetails in CI/CD-Integration und GitHub Actions Integration für die Implementierungsdetails in GitHub Actions Integration