đč build
Eine Setup-Anfrage mit den Installations-Schritten und der vollstĂ€ndigen Markdown-Dokumentation fĂŒr diesen Plugin kopieren.
đïž Native iOS/Android-Builds ĂŒber Capgo Cloud verwalten.
Zugriff und Ausgabe
Abschnitt 'Zugriff und Ausgabe'Native Cloud-Build-Anfragen befinden sich derzeit in einer begrenzten Beta und der Zugriff ist eingeschrĂ€nkt. Die Build-Zugangsdaten werden nie auf den Capgo-Servern gespeichert: sie werden nur fĂŒr die AusfĂŒhrung verwendet und dann gelöscht. Die Ausgabedaten können optional mit zeitbegrenzten Download-Links hochgeladen werden.
Speichern Sie die Zugangsdaten zuerst
Abschnitt 'Speichern 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 Ausgabeadresse in CI erfassen
Abschnitt 'Ein Ausgabeadresse in CI erfassen'Ăbergeben --output-record Um den Download-Link und die QR-Code code zu speichern, verwenden Sie dann 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 auf Ihr Konto zuzugreifen |
| -c | string | Kanal zum Vergleichen. StandardmĂ€Ăig CapacitorUpdater.defaultChannel oder der öffentliche Standardkanal |
| âpackage-json | string | Pfade zu package.json-Dateien fĂŒr monorepos (komma-getrennt) |
| ânode-modules | string | Pfade zu node_modules-Verzeichnissen fĂŒr monorepos (komma-getrennt) |
| âverbose | boolean | Verwenden Sie ausfĂŒhrliche Ausgaben mit detaillierten Protokollen |
| âsupa-host | string | Benutzerdefinierte Supabase-Host-URL (fĂŒr Selbsthosting oder Capgo Entwicklung) |
| âsupa-anon | string | Benutzerdefinierte Supabase-Anon-SchlĂŒssel (fĂŒr Selbsthosting) |
đ Init
Alias:Terminalfenster onboarding
npx @capgo/cli@latest build initOptionen:
âsupa-alias
| Parameter | Typ | Beschreibung |
|---|---|---|
| -a | string | API SchlĂŒssel, um auf Ihr Konto zuzugreifen |
| -p | string | Plattform zum Anmelden (ios oder android). Wenn nicht angegeben, wird automatisch ermittelt, wenn nur eine native Ordner existiert; ansonsten wird gefragt. |
| âsupa-host | string | Benutzerdefinierter Supabase-Host-URL (fĂŒr Selbsthosting oder Capgo Entwicklung) |
| âno-analytics | boolean | Deaktivieren Sie die Build-Onboarding-Analytik und die Terminal-Wiedergabe fĂŒr diese AusfĂŒhrung |
đč Anfrage
Abschnitt mit dem Titel â đč Anfrageânpx @capgo/cli@latest build requestEine native Anwendung von Capgo Cloud anfordern. Diese Anweisung wird Ihr Projektverzeichnis komprimieren und auf Capgo hochladen, um es zu bauen. Die Anwendung wird bearbeitet und direkt in die App-Stores gesendet. Die Anmeldedaten werden nie auf den Capgo Servern gespeichert; sie werden nach der Anwendungsbereitstellung gelöscht. Speichern Sie sie vor der Anwendungsbereitstellung:
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, um zu 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-zertifikat-base64 | string | iOS: Base64-kodierte .p12-Zertifikatsdatei |
| âp12-sicherheitszugang | string | iOS: Zertifikatspasswort (optional, wenn das Zertifikat kein Passwort hat) |
| âapple-id | string | iOS: E-Mail-Adresse fĂŒr das Apple-ID-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: Numerisches 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: Base64-codiertes App Store Connect API-Sicherheitszertifikat (.p8) |
| âapp-store-connect-team-id | string | iOS: App Store Connect-Team-ID |
| âios-scheme | string | iOS: Xcode-Baukette zum Bauen (Standard: App) |
| âios-target | string | iOS: Xcode-Ziel fĂŒr die Lesung von Build-Einstellungen (Standard: dasselbe wie Baukette) |
| âios-distribution | string | iOS: Verteilungsmodus |
| âios-provisioning-profile | string | iOS: Pfad zum Bereitstellungsprofil oder bundleId=path-Zuweisung (wiederholbar) |
| âandroid-keystore-file | string | Android: Base64-gekodierte Keystore-Datei |
| __CAPGO_KEEP_0__ | string | Android: Alias fĂŒr die Keystore-SchlĂŒssel |
| __CAPGO_KEEP_0__ | string | Android: Passwort fĂŒr die Keystore-SchlĂŒssel |
| __CAPGO_KEEP_0__ | string | Android: Passwort fĂŒr die Keystore-Speicherung |
| __CAPGO_KEEP_0__ | string | Android: Bas64-kodierte JSON-Datei fĂŒr Google Play-Dienst |
| __CAPGO_KEEP_0__ | string | Android: Produktflavor zum Bauen (z.B. Produktionsumgebung). Erforderlich, wenn Ihr Projekt mehrere Flavors enthÀlt. |
| __CAPGO_KEEP_0__ | string | Android: Google Play in-app-Update-PrioritĂ€t fĂŒr diese Version (Ganzzahl 0â5; höher = dringender). Siehe https://developer.android.com/guide/playcore/in-app-updates. Vorrang: CLI > Umgebung > gespeicherte Anmeldeinformationen |
| âkein-Playstore-Upload | boolean | Play Store-Upload fĂŒr diese Build ausfĂŒhren (Nulliert die gespeicherte Play-Konfiguration aus). Erfordert âoutput-upload. |
| âzur-ĂberprĂŒfung-in-den-App-Store-Submit | boolean | Nach dem Upload die Store-Veröffentlichung fĂŒr die ĂberprĂŒfung anstatt als Entwurf/Inaktives Build zu lassen. Android markiert die Play-Veröffentlichung als abgeschlossen; iOS sendet die bearbeitete TestFlight-Build zur App-Store-ĂberprĂŒfung. |
| âstore-release-name | string | Bezeichnung/Label fĂŒr die Store-Veröffentlichung/Seriennummer. Android sendet dies als Google Play-Version_Namen; iOS verwendet es als App-Store-Version bei der Erstellung oder Wiederherstellung der editierbaren Version. |
| âstore-release-notes | string | Standard-Store-Veröffentlichungs-Hinweise. Android verwendet dies als Play-Ănderungsprotokoll; iOS verwendet es als App-Store-Neuigkeiten-Text. |
| âstore-release-notes-locale | string | Lokalisierte App-Store-Bereitstellungsnotizen (wiederholbar), z.B. âstore-release-notes-locale en-US=âFehlerkorrekturenâ âstore-release-notes-locale fr-FR=âKorrekturenâ. |
| âios-testflight-gruppen | string | iOS: optional, durch Kommata getrennte TestFlight-externer Gruppennamen oder IDs fĂŒr externe Beta-Verteilung. |
| âios-automatische-veröffentlichung | boolean | iOS: Veröffentlichen Sie die App-Store-Version automatisch nach Apple-Zustimmung. Standard ist die manuelle Veröffentlichung. |
| âkeine-ios-automatische-veröffentlichung | boolean | iOS: Halten Sie die App-Store-Version auf Warteschleife fĂŒr manuelle Veröffentlichung nach Apple-Zustimmung. |
| âausgabe-hochladen | boolean | Ăberschreiben Sie die Ausgabehochladeverhalten fĂŒr diese Build nur (aktivieren). Vorrang: CLI > Umgebungsvariablen > gespeicherte Anmeldeinformationen |
| âkeine-ausgabe-hochladen | boolean | Ăberschreiben Sie die Ausgabehochladeverhalten fĂŒr diese Build nur (deaktivieren). Vorrang: CLI > Umgebungsvariablen > gespeicherte Anmeldeinformationen |
| âausgabe-beihalten | string | Ăberschreiben Sie die TTL fĂŒr den Ausgabeverweis fĂŒr diese Build nur (1h bis 7t). Beispiele: 1h, 6h, 2t. Vorrang: CLI > Umgebung > gespeicherte Anmeldeinformationen |
| âoutput-record | string | Nach erfolgreichem Build schreiben Sie ein JSON-Record (jobId, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt) in einen Pfad. Ein PNG-QR-code wird auch neben diesem Pfad mit dem .qr.png suffix geschrieben. Lesen Sie Felder zurĂŒck mit build last-output. |
| âno-skip-build-number-bump | boolean | Ăberschreiben Sie gespeicherte Anmeldeinformationen, um die automatische Erhöhung der Buildnummer fĂŒr diese Build nur zu aktivieren. |
| âskip-marketing-version-bump | boolean | Ăberspringen Sie die automatische Erhöhung der Marketingversion (CFBundleShortVersionString / versionName) wenn die App bereits veröffentlicht ist. |
| âsync-ios-version | boolean | iOS: Synchronisieren Sie die MARKETING_VERSION von Xcode aus package.json vor dem Hochladen des Projekts. |
| âai-analytics | boolean | Bei Buildfehlern senden Sie Logfiles an Capgo AI zur Diagnose. In interaktiven Terminals wird diese BestĂ€tigung vorher ĂŒbersprungen; in CI wird die Analyse automatisch hochgeladen und auf stderr ausgegeben. |
| âkeine-Vorabscans | boolean | Automatische Vorabscans ĂŒberspringen |
| âvorabscans-ignorieren-fatal | boolean | Vorabscans durchfĂŒhren, aber nie den Build blockieren (nur Meldungen) |
| âwarnungen-fatal | boolean | Vorabscans-Warnungen als fatal behandeln |
| âsupport-logs-senden | boolean | Bei einem CI/CD-Build-Fehler werden die Build-Logs automatisch an Capgo-Support hochgeladen (kein E-Mail-Eingabe erforderlich). Capgo-Support wird benachrichtigt und wird per E-Mail folgen. |
| âlogs-senden | boolean | Veralteter Alias fĂŒr âsend-logs-to-support |
| -a | string | API-SchlĂŒssel zum Link zu Ihrem 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 | Erweiterte Ausgabe mit detaillierten Protokollen aktivieren |
đč 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:
| Param | Typ | Beschreibung |
|---|---|---|
| âpath | string | Pfad zum Projektverzeichnis (Standard: aktuelles Verzeichnis) |
| âcheck | boolean | Nur ĂŒberprĂŒfen; mit nicht Nullen verlassen, wenn MARKETING_VERSION nicht synchron ist |
đč Vorabscannen
Abschnitt mit dem Titel â đč Vorabscannenânpx @capgo/cli@latest build prescanĂberprĂŒfe dein Projekt und gespeicherte Anmeldeinformationen auf Probleme, die einen Cloud-Build fehlschlagen wĂŒrden â bevor du etwas hochlĂ€dst.
ĂberprĂŒft Anmeldeinformationen (GĂŒltigkeit, Passwörter, Profilzuordnung), Projektzustand (Cap Sync, node_modules-Anordnung) und Plattform-Konfiguration. FĂŒhrt automatisch innerhalb von build requestDieser Befehl fĂŒhrt es eigenstĂ€ndig aus (z.B. in CI).
Optionen:
| Parameter | Typ | Beschreibung |
|---|---|---|
| âplattform | string | Zielplattform: ios oder android (erforderlich) |
| âpfad | string | Pfad zum Projektverzeichnis (Standard: aktuelles Verzeichnis) |
| -a | string | API SchlĂŒssel, um auf Ihr Konto zuzugreifen |
| âandroid-flavor | string | Android: Produktflavor, die das Build verwenden wird |
| âios-dist | string | iOS: Verteilungsmodus zur ĂberprĂŒfung gegen |
| âjson | boolean | Eine maschinelle lesbare JSON-Bericht ausgeben |
| âfail-on-warnings | boolean | Bei Warnungen nicht Null ausgeben (CI) |
| âignore-fatal | boolean | Diagnosemodus: Berichte alles, aber immer 0 ausgeben |
| âverbose | boolean | Erhöhte Ausgabe mit detaillierten Protokollen aktivieren |
| âsupa-host | string | Benutzerdefinierte Supabase-Host-URL (fĂŒr Selbsthosting oder Capgo Entwicklung) |
| âsupa-anon | string | Benutzerdefinierte Supabase-Anon-SchlĂŒssel (fĂŒr Selbsthosting) |
đč Letzter Ausgabe
Abschnitt mit dem Titel â đč Letzter Ausgabeânpx @capgo/cli@latest build last-outputDie Ausgaberecord der letzten Bauzeit lesen build request --output-record.
Prints the full JSON by default, a single field with âfield, or the ASCII QR
code with âqr. Useful in CI to grab the download URL or QR for posting back
to a PR or issue.
Examples:
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 zum JSON-Dokument, das von âoutput-record geschrieben wird (erforderlich) |
| âfeld | string | Drucken Sie ein einzelnes Feld (eines der folgenden: jobId, appId, platform, buildMode, status, outputUrl, qrCodeAscii, qrCodePngPath, finishedAt, schemaVersion) |
| âqr | boolean | Print the rendered ASCII QR code (shortcut for âfield qrCodeAscii) |
đč Anmeldedaten
Abschnitt mit dem Titel â đč AnmeldedatenâDeine lokalen Maschinenkredenziale verwalten. đ SICHERHEIT:
- Kredenziale werden in ~/.capgo-credentials/credentials.json (global) oder .capgo-credentials.json (lokal) gespeichert.
- WĂ€hrend des Builds werden sie an Capgo gesendet, aber NICHT dauerhaft gespeichert.
- Gespeicherte Daten werden sofort nach dem Build aus Capgo gelöscht.
- Die Build-Ausgaben 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 gefĂŒhrten macOS-Hilfe (nur macOS). Ăffnet ein natives Fenster, das Sie durch die Apple-App Store Connect-BenutzeroberflĂ€che 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-Analyse (deaktivieren mit CAPGO_DISABLE_TELEMETRY) weitergeleitet. npx @capgo/cli erstellt Apple-Zertifikate âappId com.example.app
Beispiel:
Example:Einstellungen:
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| -a | string | API-SchlĂŒssel zum VerknĂŒpfen Ihres Kontos |
| âappId | string | Speichern Sie die aufgefangene Taste in diesem iOS-Build-Zugriffskonto |
| âlocal | boolean | Save into the per-project .capgo-credentials.json instead of the global file |
| âjson | boolean | Als JSON die aufgefangene SchlĂŒssel-ID / Aussteller-ID / .p8-Pfad ausgeben |
đč Speichern
Abschnitt mit dem Titel â đč Speichernânpx @capgo/cli@latest build credentials saveSpeichern Sie die Build-Zugriffskonten lokal fĂŒr iOS oder Android. Die Zugriffskonten werden in:
- ~/.capgo-credentials/credentials.json (Standard, global)
- .capgo-credentials.json im Projektroot (mit âlocal-Flag)
â ïž ZUR VERFĂGBARKEIT VOR DEM BUILDEN: Sie mĂŒssen die Zugriffskonten vor dem Abrufen eines Builds speichern.
đ Diese Zugriffskonten werden NICHT auf Capgo-Servern dauerhaft gespeichert.
Sie werden sofort nach Abschluss des Builds gelöscht.
đ Anleitungen zur Einrichtung:
iOS: https://capgo.app/docs/cli/cloud-build/deutsch/ios/
Android: https://capgo.app/docs/cli/cloud-build/deutsch/android/
npx @capgo/cli build credentials speichern âplattform ios
âzertifikat ./cert.p12 âp12-schlĂŒsselwort âpasswordâ
âios-Verteilungsprofil ./profile.mobileprovision
âapple-SchlĂŒssel ./AuthKey.p8 âapple-SchlĂŒssel-ID âKEY123â
âapple-Issuer-ID âissuer-uuidâ âapple-Team-ID âteam-idâ Beispiel fĂŒr mehrere Ziele (Anwendung + Widget-Erweiterung): npx @capgo/cli build credentials speichern âplattform ios
âios-Verteilungsprofil ./App.mobileprovision
âios-Verteilungsprofil com.example.widget=./Widget.mobileprovision
⊠npx @capgo/cli build credentials speichern âplattform android
âkeystore ./release.keystore âkeystore-Alias âmy-keyâ
âkeystore-key-password âkey-passâ
âplay-config ./service-account.json Speicherung in der lokalen Datenbank (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) |
| âplatform | string | Plattform: ios oder android (erforderlich) |
| âZertifikat | string | iOS: Pfad zum .p12-Zertifikatsdatei |
| âiOS-Provisioning-Profil | string | iOS: Pfad zum Provisioning-Profil oder bundleId=path (wiederholbar) |
| âP12-Passwort | string | iOS: Zertifikatspasswort (optional, wenn Zertifikat kein Passwort hat) |
| âApple-SchlĂŒssel | string | iOS: Pfad zur .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 Zertifizierungs-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-Spezifikationspasswörtern (Alternative zur App Store Connect API-SchlĂŒssel) |
| âapple-app-specific-password | string | iOS: App-Spezifikationspasswort (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 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-Speicherung |
| âplay-config | string | Android: Pfad zum Play Store-Dienstkonten-JSON |
| âandroid-flavor | string | Android: Produktflavor zum Bauen (z.B. Produktionsumgebung). 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 Versionen (ganzzahliger Wert 0â5; höher = dringender). Omit, um Playâs bestehende Werte unverĂ€ndert zu lassen. |
| âlokal | boolean | Speichern Sie 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 | Hochladen von Build-Ergebnissen (IPA/APK/AAB) in Capgo-Speicher unterlassen |
| âoutput-retention | string | Output-Link-TTL: 1h bis 7t (Standard: 1h). Beispiele: 1h, 6h, 2t |
| âskip-build-number-bump | boolean | Automatisches Inkrementieren der Buildnummer/Version code auf zukĂŒnftige Builds unterlassen |
| âno-skip-build-number-bump | boolean | Automatische Versionsnummerierung wiederherstellen (Standardverhalten) |
| âskip-marketing-version-bump | boolean | Bei zukĂŒnftigen Builds die automatische Marketing-Versionserhöhung aufgrund einer bereits veröffentlichten App ĂŒberspringen |
| âno-skip-marketing-version-bump | boolean | Automatische Marketing-Versionserhöhung wiederherstellen (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 | App-ID zum Auflisten (optional, listet alle wenn weggelassen) |
| âlocal | boolean | Liste nur lokale Anmeldeinformationen aus der Datei .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 weggelassen) |
| âplatform | string | Plattform zum Löschen: ios oder android (optional, löscht alle Plattformen wenn weggelassen) |
| âlocal | boolean | Löscht aus lokalem .capgo-credentials.json anstatt global |
đč Aktualisieren
Abschnitt mit dem Titel â Aktualisierenânpx @capgo/cli@latest build credentials updateUpdate spezifische Anmeldeinformationen, ohne alle wieder zu liefern. 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 | App-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-Zertifizierungsprofil | string | Pfad zum Zertifizierungsprofil oder bundleId=path (wiederholbar, additiv standardmĂ€Ăig) |
| âios-Zertifizierungsprofil-ĂŒberschreiben | boolean | Ersetzen Sie die gesamte Zertifizierungsmappe anstatt zu mergen (Standard: mergen) |
| âP12-Zertifikatspasswort | string | P12-Zertifikatspasswort |
| âApple-SchlĂŒssel | string | Pfad zum App Store Connect API-SchlĂŒssel (.p8-Datei) |
| âApple-SchlĂŒssel-ID | string | App Store Connect API-SchlĂŒssel-ID |
| âapple-issuer-id | string | App Store Connect Herausgeber-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-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: Verteilungsmodus |
| âSicherheitsdatei | string | Pfad zur Sicherheitsdateifile (.keystore oder .jks) |
| âSicherheitsdatei-Alias | string | Sicherheitsdatei-SchlĂŒssel-Alias |
| âSicherheitsdatei-SchlĂŒsselpasswort | string | Sicherheitsdatei-SchlĂŒsselpasswort |
| âSicherheitsdatei-Speicherpasswort | string | Sicherheitsdatei-Speicherpasswort |
| âPlay-Konfiguration | string | Pfad zur Google Play-Dienstkontokonfiguration (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 Versionen (ganzzahliger Wert 0â5; höher = dringender). |
| âoutput-upload | boolean | Uploaden Sie Build-Ausgaben (IPA/APK/AAB) auf Capgo-Speicher und drucken Sie Download-Links |
| âno-output-upload | boolean | Uploaden Sie keine Build-Ausgaben (IPA/APK/AAB) auf Capgo-Speicher |
| âoutput-retention | string | Output-Link-TTL: 1h bis 7t. Beispiele: 1h, 6h, 2t |
| âskip-build-number-bump | boolean | Automatisches Inkrementieren der Buildnummer/Version code auf zukĂŒnftigen Builds ĂŒberspringen |
| âno-skip-build-number-bump | boolean | Automatisches Inkrementieren der Buildnummer (Standardverhalten) wieder aktivieren |
| âZu-schaltmarkierte-Marketing-Versionssprung | boolean | Automatische Marketing-Versionssprung bei zukĂŒnftigen Builds ausfĂŒhren, wenn die App bereits veröffentlicht ist |
| âKeinen-Zu-schaltmarkierten-Marketing-Versionssprung | boolean | Automatische Marketing-Versionssprung wieder aktivieren (Standardverhalten) |
đč Verwalten
Abschnitt mit dem Titel â đč Verwaltenânpx @capgo/cli@latest build credentials manageInteraktiv die gespeicherten Build-Zugriffsberechtigungen verwalten.
Durchsuche gespeicherte Zugriffsberechtigungen, betrachte, was konfiguriert ist, exportiere eine CI/CD-fertige .env-Datei,
oder lösche die Zugriffsberechtigungen einer Plattform. Wiederholt den gleichen 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) |
| âplatform | string | Plattform zum Verwalten: ios oder android (optional, fragt nach, wenn nicht angegeben) |
| âlocal | boolean | Nur lokale .capgo-credentials.json durchsuchen |
đč Migrieren
Abschnitt mit dem Titel â Migrierenânpx @capgo/cli@latest build credentials migrateMigriere das legale Provisionierungsprofil in die neue Mehrziel-Format. Konvertiert BUILD_PROVISION_PROFILE_BASE64 zu 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 | App-ID (wird automatisch aus capacitor.config ermittelt, wenn nicht angegeben) |
| âplatform | string | Plattform (nur ios wird unterstĂŒtzt) |
| âlokal | boolean | Migriere von lokalen .capgo-Anmeldeinformationen anstatt globalen |