đč Build
Eine Setup-Anweisung 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-Phase 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 Titel âEin Ausgabeanzeige-URL in CI erfassenâĂbergeben --output-record Um die Download-URL und die QR-Code-code zu speichern und sie dann zu verwenden: build last-output Terminalfenster
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đč Abschnitt mit Titel â Benötigtâ
Terminalfensternpx @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 zum Vergleich. 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 | Benutzerdefinierter Supabase-Host-URL (fĂŒr Selbsthosting oder Capgo-Entwicklung) |
| âsupa-anon | string | Benutzerdefinierter Supabase-Anon-Key (fĂŒr Selbsthosting) |
Alias: onboarding
npx @capgo/cli@latest build initInteraktive Einrichtung von Build-Zugriffscredentials (iOS: Zertifikate + Profile automatisiert; Android: Keystore + Google OAuth bereitstellt GCP-Dienstkontoinvite)
Optionen:
| Parameter | Typ | Beschreibung |
|---|---|---|
| -a | string | API-SchlĂŒssel zum VerknĂŒpfen mit Ihrem Konto |
| -p | string | Plattform zum Einbinden (iOS oder Android). Wenn nicht angegeben, detektiert sie automatisch, wenn nur ein natives Verzeichnis existiert; ansonsten wird ein Hinweis angezeigt. |
| â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
Abschnitt mit dem Titel â Anfrage ânpx @capgo/cli@latest build requestStellen Sie eine native Build-Anfrage an Capgo Cloud an. Diese Anweisung wird Ihr Projektverzeichnis komprimieren und es an Capgo hochladen, um es zu bauen. Die Build-Datei wird direkt an die App-Stores gesendet. Die Anmeldeinformationen werden nie auf Capgo-Servern gespeichert; sie werden nach der Build-AusfĂŒhrung 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:
| Parameter | 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-Modus | string | Build-Modus: debug oder release (Standard: release) |
| âbuild-Zertifikats-Base64 | string | iOS: Base64-kodierte .p12-Zertifizierung |
| âp12-Passwort | string | iOS: Zertifikats-Passwort (optional, wenn das Zertifikat kein Passwort hat) |
| âApple-ID | string | iOS: E-Mail-Adresse fĂŒr die App-spezifische Passwort-Uploads (Alternative zu App Store Connect API-SchlĂŒssel) |
| âapple-app-spezifisches-Passwort | string | iOS: App-spezifisches Passwort (xxxx-xxxx-xxxx-xxxx) fĂŒr TestFlight-Uploads |
| âapple-app-id | string | iOS: Numerische App-Store-Connect-Anwendungs-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-Aussteller-ID |
| âapple-key-content | string | iOS: Base64-encoded App Store Connect API key (.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-kodierte Keystore-Datei |
| âkeystore-key-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: Keystore-Speicherpasswort |
| âplay-config-json | string | Android: Bas64-kodierte Google Play-Dienstkonten-JSON |
| âandroid-flavor | string | Android: Produktflavor zum Bauen (z.B. Produktionsversion). Erforderlich, wenn Ihr Projekt mehrere Flavors enthĂ€lt. |
| âandroid-track | string | Android: Google Play-Track fĂŒr diese Uploads (intern, alpha, beta, Produktionsversion). Standard ohne âsubmit-to-store-review: intern. Mit âsubmit-to-store-review und keinem Track gesetzt: Produktionsversion. 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 (ganze Zahl 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 nullt aus). 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 sendet dies die bearbeitete TestFlight-Build an die App Store-ĂberprĂŒfung. |
| â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-Neuigkeiten-Text. |
| âStore-Veröffentlichungsnotizen-Locale | string | Gelocalisierte Store-Veröffentlichungsnotizen (wiederholbar), zum Beispiel âstore-release-notes-locale en-US=âFehlerbehebungenâ âstore-release-notes-locale fr-FR=âCorrectionsâ. |
| âiOS-Testflight-Gruppen | string | iOS: optional comma-separated TestFlight external group names or IDs for external beta distribution. |
| âios-automatischer-veröffentlichung | boolean | iOS: Die App-Store-Version automatisch nach Apple-Zustimmung veröffentlichen. Standard ist die manuelle Veröffentlichung. |
| âno-ios-automatischer-veröffentlichung | boolean | iOS: Die App-Store-Version nach Apple-Zustimmung manuell veröffentlichen lassen. |
| âoutput-upload | boolean | Ăberschreiben Sie die Ausgabehandlung fĂŒr diese Build nur (aktivieren). Vorrang: CLI > Umgebungsvariablen > gespeicherte Anmeldeinformationen |
| âno-output-upload | boolean | Ăberschreiben Sie die Ausgabehandlung fĂŒr diese Build nur (deaktivieren). Vorrang: CLI > Umgebungsvariablen > gespeicherte Anmeldeinformationen |
| âoutput-retention | string | Ăberschreiben Sie die GĂŒltigkeitsdauer der Ausgabehinweis fĂŒr diese Build nur (1h bis 7t). Beispiele: 1h, 6h, 2t. Vorrang: CLI > Umgebungsvariablen > gespeicherte Anmeldeinformationen |
| â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 code wird auch neben diesem Pfad mit dem .qr.png Lese Felder zurĂŒck mit build last-output. |
| âno-skip-build-number-bump | boolean | Ăberschreibe gespeicherte Anmeldeinformationen, um die automatische ZĂ€hlung der Buildnummer fĂŒr diesen Build nur einmal zu aktivieren. |
| âskip-marketing-version-bump | boolean | Ăberspringe die automatische Marketingversion (CFBundleShortVersionString / versionName) ZĂ€hlung, wenn die App bereits veröffentlicht ist. |
| âsync-ios-version | boolean | iOS: Synchronisiere die Xcode-MARKETING_VERSION aus package.json, bevor Sie das Projekt hochladen. |
| âai-analytics | boolean | Bei Buildfehlern senden Sie Logdateien an Capgo AI fĂŒr Diagnose. In interaktiven Terminals wird diese BestĂ€tigung vorher ĂŒbersprungen; in CI wird automatisch hochgeladen und die Analyse wird auf stderr ausgegeben. |
| âno-prescan | boolean | Ăberspringe die automatische Vorbau-Scannung |
| âprescan-ignore-fatal | boolean | Die Vorschau-Scans durchfĂŒhren, ohne den Build zu blockieren (nur Berichte erstellen) |
| âprescan-skip | string | Spezifische Vorschau-ĂberprĂŒfungen (durch ID) ĂŒberspringen (wiederholbar oder durch Komma getrennt). Andere ĂberprĂŒfungen laufen weiter. |
| âprescan-warn | string | Spezifische Vorschau-ĂberprĂŒfungen (durch ID) auf Warnung herabstufen (wiederholbar oder durch Komma getrennt). ĂberprĂŒfung lĂ€uft weiter. |
| âfail-on-warnings | boolean | Vorschau-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-Eingriff 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, um auf Ihr Konto zuzugreifen |
| âsupa-host | string | Benutzerdefinierter Supabase-Host-URL (fĂŒr Selbsthosting oder Capgo Entwicklung) |
| âsupa-anon | string | Benutzerdefinierter Supabase-Anon-SchlĂŒssel (fĂŒr Selbsthosting) |
| âverbose | boolean | Verbose-Modus aktivieren mit detaillierten Protokollen |
đč Sync-ios-version
Synchronisierung der iOS-Versionnpx @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 synchron ist |
đč Vorabscannen
Abschnitt mit dem Titel â đč Vorabscannenânpx @capgo/cli@latest build prescanScannen Sie Ihr Projekt und Ihre gespeicherten Anmeldeinformationen auf Probleme, die einen Cloud-Build fehlschlagen wĂŒrden â bevor Sie etwas hochladen.
ĂberprĂŒft Anmeldeinformationen (Ablaufdatum, Passwörter, Profilzuordnung), Projektzustand (Cap-Synchronisierung, node_modules-Anordnung) und Plattform-Konfiguration. FĂŒhrt automatisch innerhalb von build requestDieser Befehl fĂŒhrt es eigenstĂ€ndig aus (z.B. in CI).
Siehe Vorabscannen ĂŒberprĂŒft fĂŒr das vollstĂ€ndige Check-Katalog und wie Sie --skip / --warn individuelle Regeln anpassen können.
Optionen:
| Parameter | Typ | Beschreibung |
|---|---|---|
| âplattform | string | Zielplattform: ios oder android (erforderlich) |
| âpfad | string | Pfad zum Projektverzeichnis (Standard: aktuelles Verzeichnis) |
| -a | string | API key to link to your account |
| âandroid-flavor | string | Android: Produktflavor, die der Build verwenden wird |
| âios-dist | string | iOS: Verteilungsmodus zur ĂberprĂŒfung |
| âjson | boolean | Eine maschinell lesbare JSON-Bericht erstellen |
| â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ĂŒfungen (durch ID) ĂŒberspringen (wiederholbar oder durch Komma getrennt) |
| âwarn | string | Spezifische PrĂŒfungen (durch ID) auf Warnung herabstufen (wiederholbar oder durch Komma getrennt) |
| âverbose | boolean | Detaillierte Protokollierung mit ausfĂŒhrlicher Ausgabe aktivieren |
| âsupa-host | string | Eigene Supabase-Host-URL (fĂŒr Selbstbetrieb oder Capgo Entwicklung) |
| âsupa-anon | string | Eigene Supabase-Anon-SchlĂŒssel (fĂŒr Selbstbetrieb) |
đč Zuletzt ausgegebene Ausgabe
Abschnitt mit dem Titel â đč Zuletzt ausgegebene Ausgabeânpx @capgo/cli@latest build last-outputDie Ausgaberecord der letzten Bauphase lesen build request --output-record.
Druckt die vollstĂ€ndige JSON-Datenstruktur standardmĂ€Ăig aus, eine einzelne Feld mit âfield oder die ASCII-QR-Code mit âqr.
code nĂŒtzlich in CI, um die Download-URL oder QR-Code fĂŒr das ZurĂŒcksenden an 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 | Pfad zur JSON-Datei, die von âoutput-record geschrieben wird (erforderlich) |
| âFeld | string | Drucken Sie ein einzelnes Feld (eines von: jobId, appId, platform, buildMode, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt, schemaVersion) |
| âQR | boolean | Drucken Sie den ASCII-QR-Code code (Kurzform fĂŒr âfield qrCodeAscii) |
đč Anmeldedaten
Abschnitt mit dem Titel â đč AnmeldedatenâVerwalten Sie die Build-Anmeldedaten, die lokal auf Ihrem GerĂ€t gespeichert sind. đ SICHERHEIT:
- Anmeldedaten werden 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 können optional fĂŒr zeitbegrenzte Downloadlinks 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 leitenden macOS-Hilfe (nur macOS). Ăffnet ein natives Fenster, das Sie durch Appleâs App Store Connect-UI in einem eingebetteten Browser fĂŒhrt, das Issuer-ID + Key-ID automatisch erfasst, den einmaligen .p8-Code abfĂ€ngt, ihn gegen Apple validiert und ihn in ~/.appstoreconnect/private_keys speichert. Die Fortschrittsstatistiken werden an Capgo-Analytics weitergeleitet (deaktivieren Sie sie mit CAPGO_DISABLE_TELEMETRY). npx @capgo/cli build-Kredentials apple-key âappId com.example.app
Beispiel:
Example:Optionen:
| Param | Typ | Beschreibung |
|---|---|---|
| -a | string | API-SchlĂŒssel, um auf Ihr Konto zuzugreifen |
| âappId | string | Speichern Sie den erfassten SchlĂŒssel in den iOS-Build-Zertifikaten dieser App |
| âlocal | boolean | Speichern Sie ihn stattdessen in der Projekt- .capgo-credentials.json-Datei anstatt in der globalen Datei |
| ---json | boolean | Drucken Sie die gespeicherte SchlĂŒssel-ID / Aussteller-ID / .p8-Pfad als JSON |
đč Speichern
Abschnitt mit dem Titel â Speichern ânpx @capgo/cli@latest build credentials saveSpeichern Sie die Build-Zugangsdaten lokal fĂŒr iOS oder Android. Die Zugangsdaten werden in:
- ~/.capgo-zugangsdaten/zugangsdaten.json (Standard, global)
- capgo-zugangsdaten.json im Projektverzeichnis (mit dem Flag âlocal)
â ïž ZWISCHENBAHRUNGSANLEITUNG: Sie mĂŒssen die Zugangsdaten vor der Anforderung einer Build speichern.
đ Diese Zugangsdaten werden NICHT auf Capgo-Servern dauerhaft gespeichert.
Sie werden sofort nach Abschluss der Build gelöscht.
đ Anleitungen zur Einrichtung:
iOS: https://capgo.app/docs/cli/cloud-build/ios/
Android: https://capgo.app/docs/cli/cloud-build/android/
npm @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 âplatform android
âkeystore ./release.keystore âkeystore-alias âmy-keyâ
âkeystore-key-password âkey-passâ
âplay-config ./service-account.json Lokale Speicherung (projektĂŒbergreif): npx @capgo/cli build credentials save âlocal âplatform ios âŠ
Beispiel:
iOS Example:Optionen:
| Param | Typ | Beschreibung |
|---|---|---|
| âappId | string | Anwendungs-ID (z.B. com.example.app) (erforderlich) |
| âplatform | string | Plattform: ios oder android (erforderlich) |
| âcertificate | string | iOS: Pfad zum .p12-Zertifikat-Datei |
| âios-Zertifizierungsprofil | string | iOS: Pfad zum Zertifizierungsprofil oder bundleId=path (wiederholbar) |
| âp12-Passwort | string | iOS: Zertifizierungsprofil-Passwort (optional, wenn das Zertifikat kein Passwort 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-Aussteller-ID | string | iOS: App Store Connect Aussteller-ID |
| âApple-Team-ID | string | iOS: App Store Connect Team-ID |
| âios-Verteilung | string | iOS: Verteilungsmodus |
| â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-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 (zusammen mit âapple-id und âapple-app-specific-password erforderlich) |
| âkeystore | string | Android: Pfad zum Keystore-Datei (.keystore oder .jks) |
| âkeystore-Alias | string | Android: Alias der Keystore-SchlĂŒssel |
| ---keystore-key-password | string | Android: Keystore-SchlĂŒssel-Passwort |
| ---keystore-store-password | string | Android: Keystore-Speicher-Passwort |
| ---play-config | string | Android: Pfad zur Play Store-Dienstkonten-JSON |
| ---android-flavor | string | Android: Produktflavor zum Bauen (z.B. Produktionsversion). Erforderlich, wenn Ihr Projekt mehrere Flavours 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). Unterlassen Sie dies, um Playâs bestehende Werte unverĂ€ndert zu lassen. |
| ---local | boolean | Speichern Sie es stattdessen in .capgo-credentials.json im Projektroot anstatt global ~/.capgo-credentials/ |
| âoutput-upload | boolean | Upload build outputs (IPA/APK/AAB) to Capgo storage and print download links |
| âno-output-upload | boolean | Do not upload build outputs (IPA/APK/AAB) to Capgo storage |
| âoutput-retention | string | Output-Link-GĂŒltigkeit: 1h bis 7t (Standard: 1h). Beispiele: 1h, 6h, 2t |
| âskip-build-number-bump | boolean | Automatische Baunummer/Version code-ZĂ€hlung auf zukĂŒnftige Builds ĂŒberspringen |
| âno-skip-build-number-bump | boolean | Automatische Baunummer-ZĂ€hlung wieder aktivieren (Standardverhalten) |
| âskip-marketing-version-bump | boolean | Automatische Marketing-Version-ZĂ€hlung auf zukĂŒnftige Builds ĂŒberspringen, wenn die App bereits veröffentlicht ist |
| âno-skip-marketing-version-bump | boolean | Automatische Marketing-Version-Pufferung wieder aktivieren (Standardverhalten) |
đ Liste
Abschnitt mit dem Titel âListeânpx @capgo/cli@latest build credentials listListe aller gespeicherten Build-Zugangsdaten (Passwörter maskiert). Zeigt an, welche Zugangsdaten derzeit gespeichert sind (beide globale und lokale). Beispiele: npx @capgo/cli build credentials list # Alle Anwendungen auflisten npx @capgo/cli build credentials list âappId com.example.app # Spezifische Anwendung auflisten
Optionen:
| Parameter | Typ | Beschreibung |
|---|---|---|
| âappId | string | Anwendungs-ID zum Auflisten (optional, listet alle wenn weggelassen) |
| âlocal | boolean | Liste nur die Anmeldeinformationen aus dem 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:
| Parameter | 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 | Stattdessen aus lokalem .capgo-credentials.json löschen |
đč Update
Abschnitt mit dem Titel â đč Updateânpx @capgo/cli@latest build credentials updateUpdate spezifischer Anmeldeinformationen ohne alle wieder bereitzustellen. Aktualisiere bestehende Anmeldeinformationen, indem Sie nur die Felder bereitstellen, die Sie Ă€ndern möchten. Die Plattform wird automatisch ermittelt, wenn Sie die bereitgestellten Optionen verwenden. 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 (automatisch aus capacitor.config ermittelt, wenn nicht angegeben) |
| âplattform | string | Plattform: ios oder android (automatisch aus Optionen ermittelt) |
| âlokal | boolean | Aktualisiere lokale .capgo-credentials.json anstatt global |
| âzertifikat | string | Pfad zum P12-Zertifikat-Datei |
| âios-zertifikatsprofil | string | Provisionierungsprofil-Pfad oder bundleId=path (wiederholbar, additiv standardmĂ€Ăig) |
| âoverwrite-ios-provisioning-map | boolean | Ersetzen Sie die gesamte Provisionierungskarte anstatt zu mergen (Standard: mergen) |
| âp12-password | string | P12-Zertifikatspasswort |
| âapple-key | string | Pfad zu App Store Connect API SchlĂŒssel (.p8-Datei) |
| âapple-key-id | string | App Store Connect API SchlĂŒssel-ID |
| âapple-issuer-id | string | App Store Connect Aussteller-ID |
| âapple-team-id | string | App Store Connect Team ID |
| â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) |
| âios-distribution | string | iOS: Verteilungsmodus |
| âkeystore | string | Pfad zum Keystore-Datei (.keystore oder .jks) |
| âkeystore-alias | string | Keystore-SchlĂŒssel-Alias |
| __CAPGO_KEEP_0__ | string | Keystore-SchlĂŒsselpasswort |
| __CAPGO_KEEP_0__ | string | Keystore-Speicherpasswort |
| __CAPGO_KEEP_0__ | string | Pfad zum Google Play-Dienstkontokonto-JSON |
| __CAPGO_KEEP_0__ | string | Android: Produktflavor zum Bauen (z.B. Produktionsversion). Erforderlich, wenn Ihr Projekt mehrere Flavors enthÀlt. |
| __CAPGO_KEEP_0__ | string | Android: Google Play-In-App-Update-PrioritĂ€t fĂŒr zukĂŒnftige Versionen (Integer 0â5; höher = dringender). |
| __CAPGO_KEEP_0__ | boolean | Upload-Build-Ergebnisse (IPA/APK/AAB) auf Capgo-Speicher hochladen und Download-Links ausgeben |
| âno-output-upload | boolean | Hochladen von Build-Ergebnissen (IPA/APK/AAB) auf Capgo-Speicher unterlassen |
| âoutput-retention | string | Link-TTL fĂŒr Ausgabedaten: 1h bis 7t. Beispiele: 1h, 6h, 2t |
| âskip-build-number-bump | boolean | Automatische Inkrementierung der Buildnummer/Version auf code zukĂŒnftiger Builds unterlassen |
| âno-skip-build-number-bump | boolean | Automatische Inkrementierung der Buildnummer wieder aktivieren (Standardverhalten) |
| âskip-marketing-version-bump | boolean | Automatische Marketing-VersionssprĂŒnge auf __CAPGO_KEEP_0__ zukĂŒnftigen Builds unterlassen, wenn die App bereits veröffentlicht ist |
| âno-skip-marketing-version-bump | boolean | Automatische Marketing-Versionshöhe wieder aktivieren (Standardverhalten) |
đč Verwalten
Abschnitt mit dem Titel â Verwaltenânpx @capgo/cli@latest build credentials manageInteraktive Verwaltung von gespeicherten Build-Zugriffsberechtigungen.
Durchsuche gespeicherte Zugriffsberechtigungen, zeige an, was konfiguriert ist, exportiere eine CI/CD-fertige .env-Datei,
oder lösche die Zugriffsberechtigungen einer Plattform. 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 nicht angegeben) |
| âplattform | string | Plattform zum Verwalten: ios oder android (optional, fragt nach, wenn nicht angegeben) |
| âlokal | boolean | Nur lokale .capgo-credentials.json durchsuchen |
đč Migrieren
Abschnitt mit dem Titel â Migrateânpx @capgo/cli@latest build credentials migrateMigriere das legale Provisioning-Profile in die neue Multi-Target-Format. Konvertiert BUILD_PROVISION_PROFILE_BASE64 zu CAPGO_IOS_PROVISIONING_MAP. Entdeckt automatisch die Haupt-Bundle-ID aus Ihrem Xcode-Projekt. npx @capgo/cli build credentials migrate âplattform ios
Beispiel:
Example:Optionen:
| Param | Typ | Beschreibung |
|---|---|---|
| âappId | string | App-ID (automatisch aus capacitor.config ermittelt, wenn nicht angegeben) |
| âplatform | string | Plattform (nur ios unterstĂŒtzt) |
| âlocal | boolean | Migriere von lokalen .capgo-credentials.json anstatt global |