đč bauen
Ein Setup-Vorlage mit den Installationsanweisungen und der vollstĂ€ndigen Markdown-Dokumentation fĂŒr diesen Plugin kopieren
đïž Native iOS/Android-Builds ĂŒber Capgo Cloud verwalten.
Zugriff auf und Ausgabe von Build
Abschnitt mit dem Titel âZugriff auf und Ausgabe von BuildâNative Cloud-Build-Anfragen befinden sich derzeit in einer begrenzten Beta und der Zugriff ist eingeschrĂ€nkt. Die Build-Zugangsdaten werden nie auf Capgo-Servern gespeichert: Sie werden nur fĂŒr den Build verwendet und dann gelöscht. Die Build-Ausgaben können optional mit zeitbegrenzten Download-Links hochgeladen werden.
Sparen Sie die Zugangsdaten zuerst
Abschnitt mit dem Titel âSparen Sie die Zugangsdaten zuerstânpx @capgo/cli build credentials save --appId YOUR_APP_ID --platform iosnpx @capgo/cli build credentials save --appId YOUR_APP_ID --platform androidEin Ausgabeanzeige-URL in CI erfassen
Abschnitt mit dem Titel âEin Ausgabeanzeige-URL in CI erfassenâĂbergeben --output-record Um die Download-URL und die QR-Code-code zu speichern und dann zu verwenden: build last-output Um es zu lesen:
npx @capgo/cli build request APP_ID --platform android --output-upload --output-record /tmp/build.jsonnpx @capgo/cli build last-output --path /tmp/build.json --field outputUrlđč Benötigt
Abschnitt mit dem Titel â Benötigtânpx @capgo/cli@latest build neededđ§ Drucken Sie "ja" und beenden Sie mit code 1, wenn ein natives Build erforderlich ist; andernfalls drucken Sie "nein" und beenden Sie mit code 0. Beim Auftreten von Command-Fehlern wird mit code 2 beendet.
Beispiel:
npx @capgo/cli@latest build needed com.example.app --channel production --verboseOptionen:
| Parameter | Typ | Beschreibung |
|---|---|---|
| -a | string | API-SchlĂŒssel, um sich mit Ihrem Konto zu verbinden |
| -c | string | Kanal, gegen den verglichen werden soll. StandardmĂ€Ăig ist es CapacitorUpdater.defaultChannel oder der öffentliche Standardkanal |
| âpackage-json | string | Pfade zu package.json-Dateien fĂŒr monorepos (getrennt durch Kommas) |
| ânode-modules | string | Pfade zu node_modules-Verzeichnissen fĂŒr monorepos (getrennt durch Kommas) |
| âverbose | boolean | Aktiviert ausfĂŒhrliche Ausgabe mit detaillierten Protokollen |
| âsupa-host | string | Custom Supabase host URL (for self-hosting or Capgo development) |
| âsupa-anon | string | Benutzerdefinierter Supabase-Anon-Key (fĂŒr Selbsthosting) |
Alias: onboarding
npx @capgo/cli@latest build initInteraktive Einrichtung von Build-Zugangsdaten (iOS: Zertifikate + Profile automatisiert; Android: Keystore + Google OAuth stellt GCP-Dienstkonten und Play-Console-Einladung ein)
Optionen:
| Parameter | Typ | Beschreibung |
|---|---|---|
| -a | string | API-SchlĂŒssel, um auf Ihr Konto zuzugreifen |
| -p | string | Plattform zum Einbinden (iOS oder Android). Wenn nicht angegeben, wird automatisch ermittelt, wenn nur ein natives Verzeichnis existiert; ansonsten wird gefragt. |
| âsupa-host | string | Custom Supabase host URL (for self-hosting or Capgo development) |
| âno-analytics | boolean | Deaktivieren Sie die Build-Einbindungsanalytik und die Terminal-Wiedergabe fĂŒr diese AusfĂŒhrung |
đč Anfrage
Sektion mit dem Titel â Anfrageânpx @capgo/cli@latest build requestStellen Sie eine native Build-Anfrage an Capgo Cloud. Diese Anweisung wird Ihr Projektverzeichnis komprimieren und es an Capgo hochladen, um es zu bauen. Die Build wird bearbeitet und direkt an die App-Stores gesendet. Die Anmeldeinformationen werden nie auf Capgo-Servern gespeichert; sie werden nach der Build gelöscht. Speichern Sie sie vor der Anfrage einer Build:
npx @capgo/cli build credentials save --appId APP_ID --platform iosBeispiel:
npx @capgo/cli@latest build request com.example.app --platform ios --path .Optionen:
| Param | Typ | Beschreibung |
|---|---|---|
| âpfad | string | Pfad zum Projektverzeichnis zum Bauen (Standard: aktuelles Verzeichnis) |
| ânode-modules | string | Pfade zu node_modules-Verzeichnissen fĂŒr monorepos (getrennt durch Komma) |
| âplattform | string | Zielplattform: ios oder android (erforderlich) |
| âbuild-mode | string | Build-Modus: debug oder release (Standard: release) |
| âbuild-certificate-base64 | string | iOS: Base64-codierte .p12-Zertifikatsdatei |
| âp12-password | string | iOS: Zertifikatspasswort (optional, wenn das Zertifikat kein Passwort hat) |
| âapple-id | string | iOS: E-Mail-Adresse fĂŒr das Apple-Konto zum Hochladen von App-Spezifizierungs-Passwörtern (Alternative zur App Store Connect API-SchlĂŒssel) |
| âapple-app-specific-password | string | iOS: App-Spezifizierungs-Passwort (xxxx-xxxx-xxxx-xxxx) fĂŒr TestFlight-Hochladen |
| âapple-app-id | string | iOS: Zahlen-App-Store-Connect-Anwendungs-ID (erforderlich zusammen mit âapple-id und âapple-app-spezifische-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-codierter App-Store-Connect API-SchlĂŒssel (.p8) |
| âapp-store-connect-team-id | string | iOS: App-Store-Connect-Team-ID |
| âios-scheme | string | iOS: Xcode-Baukette (Standard: App) |
| âios-target | string | iOS: Ziel fĂŒr Xcode zum Lesen von Build-Einstellungen (Standard: gleich wie Scheme) |
| âios-distribution | string | iOS: Verteilungsmodus |
| âios-provisioning-profile | string | iOS: Pfad zum Provisioning-Profile oder bundleId=Path-Zuweisung (wiederholbar) |
| âandroid-keystore-file | string | Android: Bas64-codiertes Keystore-Datei |
| âkeystore-key-alias | string | Android: Alias fĂŒr Keystore-SchlĂŒssel |
| âkeystore-key-password | string | Android: Passwort fĂŒr Keystore-SchlĂŒssel |
| âkeystore-store-password | string | Android: Keystore Speicherpasswort |
| âplay-config-json | string | Android: Bas64-codierter Google Play-Dienstkonten-JSON |
| âandroid-flavor | string | Android: Produktflavor zum Bauen (z.B. Produktionsumgebung). Erforderlich, wenn Ihr Projekt mehrere Flavors enthĂ€lt. |
| âandroid-track | string | Android: Google Play-Track fĂŒr diese Hochladen (intern, alpha, beta, Produktionsumgebung). Standard ohne âsubmit-to-store-review: intern. Mit âsubmit-to-store-review und keinem Track gesetzt: Produktionsumgebung. Vorrang: CLI > Umgebungsvariable > gespeicherte Anmeldeinformationen |
| âandroid-release-status | string | Android: Google Play-Veröffentlichungsstatus (Entwurf, abgeschlossen, inBearbeitung, gestoppt). Standard ohne âsubmit-to-store-review: Entwurf. Mit âsubmit-to-store-review und keinem Status gesetzt: abgeschlossen. Vorrang: CLI > Umgebungsvariable > gespeicherte Anmeldeinformationen |
| âin-app-update-priority | string | Android: Google Play-In-App-Update-PrioritĂ€t fĂŒr diese Veröffentlichung (Ganzzahl 0â5; höher = dringender). Siehe https://developer.android.com/guide/playcore/in-app-updates. Vorrang: CLI > Umgebung > gespeicherte Anmeldeinformationen |
| âkeine-Playstore-Upload | boolean | Play Store-Upload fĂŒr diese Build ausfĂŒhren (gespeicherte Play-Konfiguration wird null gesetzt). Erfordert âoutput-upload. |
| âzur-ĂberprĂŒfung-in-den-App-Store-Submit | boolean | Nach dem Upload die Store-Veröffentlichung zur ĂberprĂŒfung einreichen anstatt sie als Entwurf/Inaktive Build zu lassen. Auf Android setzt sich dies standardmĂ€Ăig auf die Produktionsstrecke mit Release_Status abgeschlossen (ĂŒberschreiben Sie dies mit âandroid-track / PLAY_STORE_TRACK und âandroid-release-status / PLAY_STORE_RELEASE_STATUS). Auf iOS wird die verarbeitete TestFlight-Build an die App Store-ĂberprĂŒfung eingereicht. |
| âStore-Veröffentlichungsname | string | Store-Veröffentlichungsname/Beschreibung. Android sendet dies als Google Play-Version; iOS verwendet es als App Store-Version bei der Erstellung oder Wiederherstellung der editierbaren Version. |
| âStore-Veröffentlichungsnotizen | string | Standard-Store-Veröffentlichungsnotizen. Android verwendet dies als Play-Changelog; iOS verwendet es als App Store-âWas ist Neuesâ-Text. |
| âStore-Veröffentlichungsnotizen-Locale | string | Gelocalisierte Store-Veröffentlichungsnotizen (wiederholbar), z. B. âstore-release-notes-locale en-US=âFehlerbehebungenâ âstore-release-notes-locale fr-FR=âKorrekturenâ. |
| âiOS-Testflight-Gruppen | string | iOS: optional comma-separated TestFlight external group names or IDs for external beta distribution. |
| âios-automatic-release | boolean | iOS: die App Store-Version automatisch nach Apple-Zustimmung freigeben. Standard ist die manuelle Freigabe. |
| âno-ios-automatic-release | boolean | iOS: Halten Sie die App Store-Version nach Apple-Zustimmung auf Warteschleife fĂŒr manuelle Freigabe. |
| âoutput-upload | boolean | Ăberschreiben Sie die Ausgabehandlung fĂŒr diese Build nur (aktivieren). Vorrang: CLI > Umgebungsvariable > gespeicherte Anmelddaten |
| âno-output-upload | boolean | Ăberschreiben Sie die Ausgabehandlung fĂŒr diese Build nur (deaktivieren). Vorrang: CLI > Umgebungsvariable > gespeicherte Anmelddaten |
| âoutput-retention | string | Ăberschreiben Sie die GĂŒltigkeitsdauer der Ausgabelink fĂŒr diese Build nur (1h bis 7t). Beispiele: 1h, 6h, 2t. Vorrang: CLI > Umgebungsvariable > gespeicherte Anmelddaten |
| âoutput-record | string | Nach einem erfolgreichen Build, wird ein JSON-Record (jobId, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt) an einen Pfad geschrieben. Ein PNG QR code wird auch neben diesem Pfad mit dem .qr.png Lese Felder zurĂŒck mit build last-output. |
| âno-cache | boolean | Cache fĂŒr Build ĂŒberspringen und speichere keine neue Cache-EintrĂ€ge fĂŒr diesen Build. Der Build-Cache ist standardmĂ€Ăig pro App aktiviert. |
| âcache-key | string | Teile den Build-Cache nach Umgebung, Branch oder Android-Flavor (z.B. prod, staging). Omit fĂŒr einen gemeinsamen Standard-Cache pro App. |
| âno-skip-build-number-bump | boolean | Ăberschreibe gespeicherte Anmeldeinformationen, um automatische Build-Nummer-Inkrementierung fĂŒr diesen Build wieder zu aktivieren. |
| âskip-marketing-version-bump | boolean | Automatisches Marketingversion (CFBundleShortVersionString / versionName) Hochstufen, wenn die App bereits veröffentlicht ist. |
| âsync-ios-version | boolean | iOS: Synchronisiere Xcode MARKETING_VERSION aus package.json, bevor Sie das Projekt hochladen. |
| âai-analytics | boolean | Bei Buildfehlern senden Sie die Protokolle an Capgo AI zur Diagnose. In interaktiven Terminals wird die vorherige BestĂ€tigung ĂŒbersprungen; in CI wird automatisch hochgeladen und die Analyse wird auf stderr ausgegeben. |
| âno-prescan | boolean | Die automatische Vorbau-ĂberprĂŒfung ĂŒberspringen |
| âprescan-ignore-fatal | boolean | Die Vorbau-ĂberprĂŒfung durchfĂŒhren, aber nie den Build blockieren (nur Meldungen) |
| âprescan-skip | string | Spezifische Vorbau-ĂberprĂŒfungen (wiederholbar oder durch Komma getrennt) ĂŒberspringen (ID). Andere ĂberprĂŒfungen werden weiterhin durchgefĂŒhrt. |
| âprescan-warn | string | Herunterstufen bestimmter PrĂ€skan-ĂberprĂŒfungen auf Warnung durch ID (wiederholbar oder durch Komma getrennt). Die ĂberprĂŒfung lĂ€uft weiterhin. |
| âfail-on-warnings | boolean | PrĂ€skan-Warnungen als fatal behandeln |
| âsend-logs-to-support | boolean | Bei einem CI/CD-Build-Fehler werden die Build-Protokolle automatisch auf Capgo-Support hochgeladen (kein E-Mail-Eintrag erforderlich). Capgo-Support wird benachrichtigt und wird per E-Mail folgen. |
| âsend-logs | boolean | Veralteter Alias fĂŒr âsend-logs-to-support |
| -a | string | API-SchlĂŒssel zum Linken auf Ihr Konto |
| âsupa-host | string | Benutzerdefinierte Supabase-Host-URL (fĂŒr Selbsthosting oder Capgo-Entwicklung) |
| âsupa-anon | string | Benutzerdefinierte Supabase-Anon-Key (fĂŒr Selbsthosting) |
| âverbose | boolean | Aktiviere ausfĂŒhrliche Ausgabe mit detaillierten Protokollen |
Build-Cache: Capgo restauriert und speichert kompilierte native Artefakte (CocoaPods, Gradle und verwandte Ausgaben) pro App standardmĂ€Ăig. Verwende --cache-key um die RC- und Produktionscaches getrennt zu halten; verwende --no-cache fĂŒr einen einmaligen Clean-Build. API-Integrations können cache_key oder cache_enabled: false fĂŒr eine einmalige Clean-Build. __CAPGO_KEEP_0__-Integrations können oder fĂŒr eine einmalige Clean-Build. __CAPGO_KEEP_0__-Integrations können oder.
đč iOS-Synchronisierung
Abschnitt: â iOS-Synchronisierungânpx @capgo/cli@latest build sync-ios-versionSynchronisiere die lokale iOS Xcode MARKETING_VERSION aus package.json.
Beispiel:
npx @capgo/cli@latest build sync-ios-version --path .Optionen:
| Parameter | Typ | Beschreibung |
|---|---|---|
| âpfad | string | Pfad zum Projektverzeichnis (Standard: aktuelles Verzeichnis) |
| âprĂŒfen | boolean | Nur prĂŒfen; beende mit nicht-Null-Ausgabe, wenn MARKETING_VERSION nicht in Einklang ist |
đč Vorabscannen
Abschnitt mit dem Titel â đč Vorabscannenânpx @capgo/cli@latest build prescanScannen Sie Ihr Projekt und die gespeicherten Anmeldeinformationen auf Probleme, die einen Cloud-Build fehlschlagen wĂŒrden â bevor Sie etwas hochladen.
ĂberprĂŒft Anmeldeinformationen (GĂŒltigkeitsdatum, Passwörter, Profilzuordnung), Projektzustand (cap Sync, node_modules-Anordnung) und Plattform-Konfiguration. FĂŒhrt automatisch innerhalb build request; diese Anweisung fĂŒhrt es eigenstĂ€ndig aus (z.B. in CI).
Siehe Vorabscannen prĂŒft fĂŒr die vollstĂ€ndige PrĂŒfzettelkatalog und wie man --skip / --warn Einzelnregeln.
Optionen:
| Param | Typ | Beschreibung |
|---|---|---|
| âplattform | string | Zielplattform: ios oder android (erforderlich) |
| âpfad | string | Pfad zum Projektverzeichnis (Standard: aktuelles Verzeichnis) |
| __CAPGO_BEHALTER_0__ SchlĂŒssel zum VerknĂŒpfen mit Ihrem Konto | string | API key to link to your account |
| âandroid-flavor | string | Android: Produktflavor, das die zu erstellende Build verwendet |
| âios-dist | string | iOS: Verteilungsmodus zur ĂberprĂŒfung |
| âjson | boolean | Eine maschinelle lesbare JSON-Bericht ausgeben |
| âfail-on-warnings | boolean | Bei Warnungen nicht Null ausgeben (CI) |
| âignore-fatal | boolean | Diagnose-Modus: Meldet alles, aber immer mit Ausgabe 0 |
| âskip | string | Spezifische PrĂŒfung(s) mit ID ĂŒberspringen (wiederholbar oder durch Komma getrennt) |
| âwarn | string | Herunterstufen bestimmter PrĂŒfungen auf Warnung durch ID (wiederholbar oder durch Komma getrennt) |
| âverbose | boolean | âverbose |
| Aktivieren Sie die ausfĂŒhrliche Ausgabe mit detaillierten Protokollen | string | Custom Supabase host URL (for self-hosting or Capgo development) |
| Benutzerdefinierte Supabase-Host-URL (fĂŒr Selbsthosting oder __CAPGO_KEEP_0__-Entwicklung) | string | âsupa-anon |
đč Benutzerdefinierte Supabase-Anon-Key (fĂŒr Selbsthosting)
Letzter-Ausgabenpx @capgo/cli@latest build last-outputZur Zwischenablage kopieren build request --output-record.
Druckt die vollstĂ€ndige JSON-Datei standardmĂ€Ăig, eine einzelne Feld mit âfield oder die ASCII QR
code mit âqr. NĂŒtzlich in CI, um die Download-URL oder QR fĂŒr das Einpflegen in einen PR oder Issue zu erhalten.
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 |
|---|---|---|
| âPfad | string | Datei Pfad zur JSON-Datei, die von âoutput-record geschrieben wird (erforderlich) |
| âFeld | string | Druckt ein einzelnes Feld (eines von: jobId, appId, platform, buildMode, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt, schemaVersion) |
| âQR | boolean | Druckt die ASCII QR-Code code (Kurzform fĂŒr âfield qrCodeAscii) |
đč Anmeldeinformationen
Abschnitt mit dem Titel â đč AnmeldeinformationenâVerwalten Sie die Anmeldeinformationen, die lokal auf Ihrem GerĂ€t gespeichert sind. Sicherheit:
- Die Anmeldeinformationen werden in ~/.capgo-anmeldeinformationen/credentials.json (global) oder .capgo-anmeldeinformationen.json (lokal) gespeichert
- WĂ€hrend des Build-Prozesses werden die Anmeldeinformationen an Capgo gesendet, aber nie dauerhaft gespeichert
- Die Anmeldeinformationen werden sofort nach dem Build von Capgo gelöscht
- Die Build-Ergebnisse können optional fĂŒr zeitbegrenzte Download-Links hochgeladen werden Dokumentation: iOS-Einrichtung: https://capgo.app/docs/cli/cloud-build/ios/ Android-Einrichtung: https://capgo.app/docs/cli/cloud-build/android/
đč Apple-SchlĂŒssel
Abschnitt mit dem Titel â đč Apple-SchlĂŒsselâAlias: asc-key
npx @capgo/cli@latest build credentials apple-keyErstelle einen App Store Connect-Team-SchlĂŒssel API mit einer geleiteten macOS-Hilfe (nur macOS). Ăffnet ein natives Fenster, das Sie durch Appleâs App Store Connect-UI in einem eingebetteten Browser fĂŒhrt, fĂ€ngt die Issuer-ID + Key-ID automatisch ein, fĂ€ngt den einmaligen .p8 ein, ĂŒberprĂŒft ihn gegen Apple und speichert ihn in ~/.appstoreconnect/private_keys. Fortschrittsstatistiken werden an Capgo-Analytik (deaktivieren mit CAPGO_DISABLE_TELEMETRY) weitergeleitet. npx @capgo/cli build-Kredentials apple-key âappId com.example.app
Beispiel:
Example:Optionen:
| Parameter | Typ | Beschreibung |
|---|---|---|
| -a | string | API-SchlĂŒssel, um Ihren Account zu verknĂŒpfen |
| âappId | string | Speichern Sie die erfasste SchlĂŒssel in diesem iOS-Build-Zertifikat |
| âlocal | boolean | Speichern Sie in der Projekt-Datei .capgo-credentials.json anstatt in der globalen Datei |
| âjson | boolean | Drucken Sie die erfasste SchlĂŒssel-ID / Aussteller-ID / .p8-Pfad als JSON |
đč Speichern
Sparennpx @capgo/cli@latest build credentials saveSpeichern Sie die Build-Zertifikate lokal fĂŒr iOS oder Android. Die Zertifikate werden in:
- ~/.capgo-credentials/credentials.json (Standard, global)
- capgo-Daten.json in Projektroot (mit âlocal Flag)
â ïž ERFORDERLICH BEVOR DEM BUILDEN: Sie mĂŒssen die Daten vor dem Anfordern eines Builds speichern.
đ Diese Daten werden NICHT auf Capgo-Servern dauerhaft gespeichert.
Sie werden sofort nach Abschluss des Builds gelöscht.
đ Setup-Anleitungen:
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
âZertifikat ./cert.p12 âp12-Passwort âpasswordâ
âiOS-Provisioning-Profile ./profile.mobileprovision
âApple-SchlĂŒssel ./AuthKey.p8 âApple-SchlĂŒssel-ID âKEY123â
âApple-Issuer-ID âissuer-uuidâ âApple-Team-ID âteam-idâ Multi-target Beispiel (app + Widget-Erweiterung): 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 âplatform android
âkeystore ./release.keystore âkeystore-alias âmein-SchlĂŒsselâ
âkeystore-key-password âSchlĂŒssel-Passwortâ
âplay-config ./service-account.json Lokale Speicherung (projektbezogen): npx @capgo/cli build credentials save âlocal âplatform ios âŠ
Beispiel:
iOS Example:Optionen:
| Parameter | Typ | Beschreibung |
|---|---|---|
| âappId | string | Anwendungs-ID (z.B. com.example.app) (erforderlich) |
| âplattform | string | Plattform: ios oder android (erforderlich) |
| âzertifikat | string | iOS: Pfad zum .p12-Zertifikatsdatei |
| âios-zertifikatsprofil | string | iOS: Pfad zum Zertifikatsprofil oder bundleId=path (wiederholbar) |
| âp12-schlĂŒssel | string | iOS: ZertifikatschlĂŒssel (optional, wenn Zertifikat keinen SchlĂŒssel hat) |
| âapple-schlĂŒssel | string | iOS: Pfad zum .p8 App Store Connect API-SchlĂŒssel |
| âapple-schlĂŒssel-id | string | iOS: App Store Connect API-SchlĂŒssel-ID |
| âapple-issuer-id | string | iOS: App Store Connect Aussteller-ID |
| âapple-team-id | string | iOS: App Store Connect Team-ID |
| âios-distribution | string | iOS: Verteilungsmodus |
| âapple-id | string | iOS: E-Mail-Adresse fĂŒr Apple-ID zum Hochladen von App-Spezifischen Passwörtern (Alternative zur 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) |
| âkeystore | string | Android: Pfad zum Keystore-Datei (.keystore oder .jks) |
| âkeystore-alias | string | Android: Alias fĂŒr die Keystore-SchlĂŒssel |
| âkeystore-key-password | string | Android: Passwort fĂŒr die Keystore-SchlĂŒssel |
| âkeystore-store-password | string | Android: Passwort fĂŒr die Keystore-Speicher |
| âplay-config | string | Android: Pfad zum Play Store-Dienstkontokonto-JSON |
| âandroid-flavor | string | Android: Produktflavor zum Bauen (z.B. Produktionsversion). Erforderlich, wenn Ihr Projekt mehrere Flavors enthĂ€lt. |
| âin-app-Update-PrioritĂ€t | string | Android: Google Play in-app-Update-PrioritĂ€t fĂŒr zukĂŒnftige Versionen (Integer 0â5; höher = dringender). Omit, um Playâs bestehende Werte unverĂ€ndert zu lassen. |
| âlokale | boolean | Save to .capgo-credentials.json in project root instead of global ~/.capgo-credentials/ |
| âAusgabehost | boolean | Hochladen Sie die Ausgabedateien (IPA/APK/AAB) auf Capgo-Speicher und drucken Sie die Downloadlinks aus |
| âkeine Ausgabehost | boolean | Hochladen Sie die Ausgabedateien (IPA/APK/AAB) nicht auf Capgo-Speicher |
| âAusgabehaltbarkeit | string | Ausgabelink-TTL: 1h bis 7t (Standard: 1h). Beispiele: 1h, 6h, 2t |
| âZu-Bau-Nummer-Ăberspringen | boolean | Automatische Zunahme der Bau-Nummer/Versionsnummer code auf zukĂŒnftige Builds ĂŒberspringen |
| âno-skip-build-number-bump | boolean | Automatische Build-Nummer erhöhen wieder aktivieren (Standardverhalten) |
| âskip-marketing-version-bump | boolean | Automatische Marketing-Version erhöhen bei zukĂŒnftigen Builds ausblenden, wenn die App bereits veröffentlicht ist |
| âno-skip-marketing-version-bump | boolean | Automatische Marketing-Version erhöhen wieder aktivieren (Standardverhalten) |
đ Liste
Abschnitt mit dem Titel âđ Listeânpx @capgo/cli@latest build credentials listListe der gespeicherten Build-Zugangsdaten (Passwörter maskiert). Zeigt an, welche Zugangsdaten derzeit gespeichert sind (globale und lokale). 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 | Anwendungs-ID, die aufgelistet werden soll (optional, listet alle, wenn weggelassen) |
| âlocal | boolean | Liste nur die Anmeldeinformationen aus der lokalen .capgo-credentials.json |
đč Löschen
Abschnitt mit dem Titel â Löschenânpx @capgo/cli@latest build credentials clearClear saved build credentials. Remove credentials from storage. Use âappId and âplatform to target specific credentials. Examples: npx @capgo/cli build credentials clear # Clear all apps (global) npx @capgo/cli build credentials clear âlocal # Clear local credentials npx @capgo/cli build credentials clear âappId com.example.app âplatform ios
Optionen:
| Param | Typ | Beschreibung |
|---|---|---|
| âappId | string | App-ID zum Löschen (optional, löscht alle Apps, wenn nicht angegeben) |
| âplatform | string | Plattform zum Löschen: ios oder android (optional, löscht alle Plattformen, wenn nicht angegeben) |
| âlocal | boolean | Löscht stattdessen aus der lokalen .capgo-credentials.json anstatt der globalen |
đč Aktualisierung
Abschnitt mit dem Titel â Aktualisierung ânpx @capgo/cli@latest build credentials updateUpdate spezifischer Anmeldeinformationen ohne alle wiederzugeben. Aktualisieren Sie bestehende Anmeldeinformationen, indem Sie nur die Felder bereitstellen, die Sie Ă€ndern möchten. Die Plattform wird automatisch aus den bereitgestellten Optionen ermittelt. 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 | Anwendungs-ID (automatisch aus capacitor.config ermittelt, wenn nicht angegeben) |
| âplatform | string | Plattform: ios oder android (automatisch aus den Optionen ermittelt) |
| âlocal | boolean | Update lokale .capgo-credentials.json anstatt global |
| âZertifikat | string | Pfad zum P12-Zertifikatsdatei |
| âios-Provisioning-Profil | string | Pflichtprofilpfad oder bundleId=path (wiederholbar, additiv standardmĂ€Ăig) |
| âios-Provisioning-Karte ĂŒberschreiben | boolean | Ersetzen Sie die gesamte Provisionierungskarte anstatt Merging (Standard: Merging) |
| âP12-Zertifikatspasswort | string | P12-Zertifikatspasswort |
| âApple-Key | string | Pfad zum App Store Connect API-SicherheitsschlĂŒssel (.p8-Datei) |
| âApple-Key-ID | string | App Store Connect API SchlĂŒssel-ID |
| âapple-issuer-id | string | App Store Connect Zertifizierungs-ID |
| âapple-team-id | string | App Store Connect Team-ID |
| âapple-id | string | iOS: E-Mail-Adresse fĂŒr die Apple-ID zum Hochladen von App-Spezifikapasswörtern (Alternative zur App Store Connect API-SchlĂŒssel) |
| âapple-app-spezifisches-passwort | 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-spezifisches-passwort) |
| âios-distribution | string | iOS: Verteilungsmodus |
| âkeystore | string | Pfad zum Keystore-Datei (.keystore oder .jks) |
| âkeystore-alias | string | Keystore-SchlĂŒsselalias |
| âkeystore-key-password | string | Keystore-SchlĂŒsselpasswort |
| âkeystore-store-password | string | Keystore-Lagerraum-Passwort |
| âplay-config | string | Pfad zum Google Play-Dienstkontokonto-JSON |
| âandroid-flavor | string | Android: Produktflavor zum Bauen (z.B. Produktionsversion). Erforderlich, wenn Ihr Projekt mehrere Flavors enthĂ€lt. |
| âin-app-update-priority | string | Android: Google Play in-app-Update-PrioritĂ€t fĂŒr zukĂŒnftige Releases (Integer 0â5; höher = dringender). |
| âoutput-upload | boolean | Upload-Build-Ergebnisse (IPA/APK/AAB) auf Capgo-Speicher und drucken Download-Links |
| âno-output-upload | boolean | Upload-Build-Ergebnisse (IPA/APK/AAB) auf Capgo-Speicher nicht hochladen |
| âoutput-retention | string | Output-Link-TTL: 1h bis 7t. Beispiele: 1h, 6h, 2t |
| âskip-build-number-bump | boolean | Automatische Build-Nummer-/Version-code-ZĂ€hlung auf zukĂŒnftigen Builds ĂŒberspringen |
| âno-skip-build-number-bump | boolean | Automatisches Inkrementieren der Buildnummer wiederherstellen (Standardverhalten) |
| âskip-marketing-version-bump | boolean | Verpassen Sie die automatische Marketingversionserhöhung bei zukĂŒnftigen Builds, wenn die App bereits veröffentlicht wurde |
| âno-skip-marketing-version-bump | boolean | Automatisches Marketingversionserhöhen wiederherstellen (Standardverhalten) |
đč Verwalten
Sektion mit dem Titel â Verwaltenânpx @capgo/cli@latest build credentials manageInteraktiv die gespeicherten Buildanmeldeinformationen verwalten.
Durchsuchen Sie die gespeicherten Anmeldeinformationen, sehen Sie, was konfiguriert ist, exportieren Sie eine CI/CD-fertige .env-Datei,
oder löschen Sie die Anmeldeinformationen eines Plattforms. Wiederholt die gleiche 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 | App-ID zum Verwalten (optional, fragt nach, wenn weggelassen) |
| âplattform | string | Plattform zum Verwalten: ios oder android (optional, fragt nach, wenn weggelassen) |
| âlokal | boolean | Nur lokale .capgo-credentials.json durchsuchen |
đč Migrieren
Abschnitt mit dem Titel â Migrieren ânpx @capgo/cli@latest build credentials migrateMigriere das legale Provisionierungsprofil in das neue Mehrziel-Format. Konvertiert BUILD_PROVISION_PROFILE_BASE64 in CAPGO_IOS_PROVISIONING_MAP. Entdeckt die Hauptbundle-ID automatisch aus Ihrem Xcode-Projekt. npx @capgo/cli build credentials migrate âplatform ios
Beispiel:
Example:Optionen:
| Parameter | Typ | Beschreibung |
|---|---|---|
| âappId | string | Anwendungs-ID (automatisch aus capacitor.config ermittelt, wenn nicht angegeben) |
| âplatform | string | Plattform (nur ios wird unterstĂŒtzt) |
| âlokal | boolean | Migrieren Sie von lokalen .capgo-credentials.json anstatt global |