📦 Paket

📦 Verwalte Anwendungs-Container für die Bereitstellung in Capgo Cloud, einschließlich Hochladen, Kompatibilitätsprüfungen und Verschlüsselung.

⬆️ Hochladen

Alias: u

npx @capgo/cli@latest bundle upload

⬆️ Hochladen eines neuen Anwendungs-Containers in Capgo Cloud für die Verteilung. Die Version muss größer als 0.0.0 und eindeutig sein. Gelöschte Versionen können nicht wieder verwendet werden, um Sicherheitsgründe. Option: Speichere nur eine URL-Verknüpfung (nützlich für Apps >200MB oder Datenschutzanforderungen). Capgo überprüft nie externe Inhalte. Fügen Sie Verschlüsselung hinzu, um vertrauenswürdige Sicherheit zu gewährleisten.

Beispiel:

npx @capgo/cli@latest bundle upload com.example.app --path ./dist --channel production,beta

Automatisch die nächste freie Semver aus dem Kanal (oder die aktuelle Remote-Anwendung) erhöhen, wenn Sie __CAPGO_KEEP_0__ nicht übergeben --bundleNützlich in CI, wenn package.json bereits einer Version Capgo entspricht:

npx @capgo/cli@latest bundle upload --channel=production --auto-bump
npx @capgo/cli@latest bundle upload --auto-bump major
npx @capgo/cli@latest bundle upload --auto-bump minor   # default when the flag has no value
npx @capgo/cli@latest bundle upload --auto-bump patch   # alias: fix
npx @capgo/cli@latest bundle upload --auto-bump metadata
npx @capgo/cli@latest bundle upload --channel=production --auto-bump ai

Mit __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ vergleicht Workers AI lokale Bundle-Dateien mit der vorherigen __CAPGO_KEEP_2__/Kanal-Delta-Manifest, schließt --auto-bump ai, Capgo Cloudflare Workers AI compares local bundle files to the previous Capgo/channel delta manifest, infers major | minor | patch | metadata, and prints a short reason in the CLI log. If no previous Capgo version exists, AI is skipped and the bump defaults to Optionen:.

__CAPGO_KEEP_0__

Parameter	Typ	Beschreibung
-a	string	API-Schlüssel zum Verknüpfen mit Ihrem Konto
-p	string	Pfad des Ordners zum Hochladen, wenn nicht angegeben, wird der Ordner webDir aus capacitor.config verwendet
-c	string	Kanal zum Verknüpfen. Komma-separiert für mehrere Kanäle, z.B. production,beta
—rollout	string	Setze das hochgeladene Bundle als Ziel für den Rollout dieses Kanals mit einem Prozentsatz von 0 bis 100
—stable	boolean	Bei einer rollout-konfigurierten Kanal ersetzen Sie die stabile Fallback-Option anstatt die Zielgruppe für die rollout zu setzen
—rollout-prozent-bps	string	Setzen Sie den hochgeladenen Bundle-Rollout-Prozentsatz in Basispunkten von 0 bis 10000
—rollout-cache-ttl-sekunden	string	Cloudflare rollout-Entscheidung-Cache-TTL in Sekunden
-e	string	Link an eine externe URL anstatt hochzuladen auf Capgo Cloud
—iv-sitzungsschlüssel	string	Setzen Sie den IV- und Sitzungsschlüssel für die Bundle-URL-extern
—s3-region	string	Region für Ihren S3-Bucket
—s3-apikey	string	API Schlüssel für Ihren S3-Endpunkt
—s3-apisecret	string	API Geheimnis für Ihren S3-Endpunkt
—s3-endpunkt	string	URL Ihres S3-Endpunkts
—s3-bucket-name	string	Name für Ihren AWS-S3-Bucket
—s3-port	string	Port für Ihren S3-Endpunkt
—no-s3-ssl	boolean	SSL für S3-Upload deaktivieren
—key-v2	string	Benutzerdefinierter Pfad für den privaten Signierungschlüssel (v2-System)
—key-data-v2	string	Privater Signierungschlüssel (v2-System)
—bundle-URL	boolean	Ausgabe der Bundle-URL in die Konsole
—kein-Schlüssel	boolean	Übergehen des Signierungschlüssels und Senden einer klaren Aktualisierung
—no-code-check	boolean	Ignore checking if notifyAppReady() is called in source code and index present in root folder
—IV-Sitzung-anzeigen	boolean	Anzeige der im Update verwendeten IV- und Sitzungsschlüssel in der Konsole
b	string	Versionnummer des Bundles zum Hochladen
—auto-bump	string	Automatische Inkrementierung von der im Kanal verknüpften Bundle-Version, andernfalls die aktuelle Remote-Anwendungsversion. Stufe: Hauptversion, Minorversion (Standard), Patchversion (Alias für Fix), Metadaten oder ai (Arbeiters AI ermittelt die Stufe aus lokalen vs. vorheriger Delta-Manifest; fällt zurück auf Patch, wenn keine vorherige Capgo-Version vorhanden ist). Bumpet, bis ein freier Name gefunden ist (gelöschte Namen bleiben belegt). Kann nicht kombiniert werden mit —bundle (-b)
—link	string	Verknüpfung zu externer Ressource (z.B. GitHub-Release)
—comment	string	Kommentar zu dieser Version, könnte ein Release-Note, ein Commit-Hash, ein Commit-Mitteilung usw. sein
—min-update-version	string	Minimal erforderliche Version zum Update auf diese Version. Wird nur verwendet, wenn die automatische Aktualisierung auf Metadaten im Kanal gesetzt ist
—auto-min-update-version	boolean	Setze die Min-Aktualisierungs-Version basierend auf native Packages
—ignore-metadata-check	boolean	Ignores die Metadaten (node_modules) bei der Upload-Überprüfung
—fail-on-incompatible	boolean	Führt den Upload (mit einem nicht Nullen-Exit-Status) ab, wenn das Bundle mit den aktuellen native Packages des Kanals nicht kompatibel ist. In einer interaktiven Terminal-Umgebung kannst du immer noch eine native Build auswählen; Ablehnung führt zum Scheitern. Dies kann nicht mit —ignore-metadata-check kombiniert werden.
—ignore-checksum-check	boolean	Ignores die Prüfsummenüberprüfung bei der Upload-Überprüfung
—force-crc32-checksum	boolean	Zwingt CRC32-Prüfsumme für den Upload (überschreibt die automatische Erkennung)
—timeout	string	Zeitüberschreitung für den Upload-Prozess in Sekunden
—multipart	boolean	[VERALTET] Verwende —tus stattdessen. Verwendet das multipart-Protokoll für S3-Uploads
—zip	boolean	Laden Sie das Bundle mit zip in Capgo Cloud (Legacy) hoch
—tus	boolean	Laden Sie das Bundle mit TUS in Capgo Cloud hoch
—tus-chunk-size	string	Größe der Chunk in Byte für TUS-Uploads (Standard: Auto)
—partial	boolean	[VERALTET] Verwenden Sie —delta stattdessen. Hochladen von inkrementellen Updates
—partial-only	boolean	[VERALTET] Verwenden Sie —delta-only stattdessen. Hochladen nur inkrementeller Updates, vollständiges Bundle überspringen
—delta	boolean	Hochladen von Delta-Updates (nur geänderte Dateien) für sofortige, super-schnelle Updates anstatt großer zip-Downloads
—delta-only	boolean	Upload nur Delta-Updates ohne vollständiges Bundle für maximale Geschwindigkeit (nützlich für große Apps)
—no-delta	boolean	Delta-Updates auch bei aktivierter Instant-Update-Funktion deaktivieren
—encrypted-checksum	string	Verschlüsselter Prüfsummenwert (Signatur). Nur bei Upload eines externen Bundles verwendet.
—auto-set-bundle	boolean	Setze das Bundle in capacitor.config.json
—dry-upload	boolean	Trockene Upload-Prozess: Füge die Zeile in der Datenbank hinzu, ohne Dateien hochzuladen oder Kanäle zu aktualisieren (Wird von Capgo für interne Tests verwendet)
—package-json	string	Pfade zu package.json-Dateien für monorepos (getrennt durch Komma)
—node-modules	string	Pfade zu den node_modules-Verzeichnissen für monorepos (komma-getrennt)
—verschlüsseln-teilweise	boolean	Verschlüsseln von Delta-Update-Dateien (automatisch aktiviert für Updater > 6.14.4)
—löschen-verknüpften-bundle-bei-upload	boolean	Lokalisiert das aktuell verknüpfte Bundle im Kanal, in den Sie versuchen, hochzuladen, und löscht es
—keine-brotli-muster	string	Dateien, die von der Brotli-Komprimierung ausgeschlossen werden sollen (komma-getrennte GLOBS, z.B. “.jpg,.png”)
—brotli-deaktivieren	boolean	Brotli-Komprimierung vollständig deaktivieren, auch wenn die Updater-Version sie unterstützt
—version-existiert-ok	boolean	Beenden, wenn die Bundle-Version bereits existiert, nützlich für CI/CD-Workflows mit Monorepos
—self-assign	boolean	Zulassen, dass Geräte sich diesem Kanal (aktualisierungs-Kanal-Einstellung) automatisch anschließen
—qr-preview	boolean	Print a terminal QR code for this bundle preview after upload
—send-update-notification	boolean	Ein natives Update-Check-Notification an Geräte senden, nachdem die verbundenen Kanal-Bundles aktualisiert wurden
—supa-host	string	Custom Supabase host URL (for self-hosting or Capgo development)
—supa-anon	string	Benutzerdefinierte Supabase-Anon-Schlüssel (für Selbsthosting)
—verbose	boolean	Aktivieren Sie die ausführliche Ausgabe mit detaillierten Protokollen

🧪 Kompatibilität

npx @capgo/cli@latest bundle compatibility

🧪 Überprüfen Sie die Kompatibilität eines Pakets mit einem bestimmten Kanal in Capgo Cloud, um sicherzustellen, dass Updates sicher sind.

Beispiel:

npx @capgo/cli@latest bundle compatibility com.example.app --channel production

Optionen:

Parameter	Typ	Beschreibung
-a	string	API Schlüssel, um auf Ihr Konto zu verlinken
-c	string	Kanal, um die Kompatibilität zu überprüfen
—text	boolean	Textausgabe anstelle von Emojis
—package-json	string	Pfade zu package.json-Dateien für monorepositorien (komma-getrennt)
—node-modules	string	Pfade zu node_modules-Verzeichnissen für monorepositorien (komma-getrennt)
—supa-host	string	Benutzerdefinierte Supabase-Host-URL (für Selbsthosting oder Capgo Entwicklung)
—supa-anon	string	Benutzerdefinierte Supabase-Anon-Schlüssel (für Selbsthosting)

🔹 ReleaseTyp

npx @capgo/cli@latest bundle releaseType

🧭 Drucken Sie „native“ oder „OTA“ basierend auf der Kompatibilität mit den neuesten Metadaten eines Kanals.

Beispiel:

npx @capgo/cli@latest bundle releaseType com.example.app --channel production

Optionen:

Parameter	Typ	Beschreibung
–a	string	API key to link to your account
–c	string	Kanal zum Vergleich
–package-json	string	Pfade zu package.json-Dateien für monorepositorien (komma-getrennt)
–node-modules	string	Pfade zu node_modules-Verzeichnissen für monorepositorien (komma-getrennt)
–supa-host	string	Benutzerdefinierte Supabase-Host-URL (für Selbsthosting oder Capgo Entwicklung)
—supa-anon	string	Benutzerdefinierte Supabase-Anon-Schlüssel (für Selbsthosting)

🗑️ Löschen

Alias: d

npx @capgo/cli@latest bundle delete

🗑️ Löschen Sie einen bestimmten Bundle aus Capgo Cloud, optional auf eine einzelne Version zielend.

Beispiel:

npx @capgo/cli@latest bundle delete BUNDLE_ID com.example.app

Optionen:

Param	Typ	Beschreibung
-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)

📋 Liste

Alias: l

npx @capgo/cli@latest bundle list

📋 Alle für eine App hochgeladenen Pakete in Capgo Cloud auflisten.

Beispiel:

npx @capgo/cli@latest bundle list com.example.app

Optionen:

Parameter	Typ	Beschreibung
-a	string	API Schlüssel zum Link auf Ihr Konto
—supa-host	string	Benutzerdefinierter Supabase-Host-URL (für Selbsthosting oder Capgo Entwicklung)
—supa-anon	string	Benutzerdefinierter Supabase-Anon-Schlüssel (für Selbsthosting)

🧹 Säubern

Alias: c

npx @capgo/cli@latest bundle cleanup

🧹 Löschen alter Pakete in Capgo Cloud, wobei die angegebene Anzahl der letzten Versionen beibehalten wird. Pakete, die mit Kanälen verknüpft sind, werden nur dann gelöscht, wenn —ignore-channel verwendet wird.

Beispiel:

npx @capgo/cli@latest bundle cleanup com.example.app --bundle=1.0 --keep=3

Optionen:

Param	Typ	Beschreibung
-b	string	Die Versionsnummer des Anwendungs-Ordners, die gelöscht werden soll
-a	string	API key to link to your account
-k	string	Anzahl der zu behaltenden Versionen
-f	boolean	Zwangsentsorgung
—ignore-channel	boolean	Bündel auch dann löschen, wenn sie mit Kanälen verknüpft sind (WARNUNG: Löscht Kanäle ebenfalls)
—supa-host	string	Benutzerdefinierter Supabase-Host-URL (für Selbsthosting oder Capgo-Entwicklung)
—supa-anon	string	Benutzerdefinierter Supabase-Anon-Key (für Selbsthosting)

🔒 Verschlüsseln

npx @capgo/cli@latest bundle encrypt

Verschlüsseln Sie ein Zip-Paket für sichere externe Speicherung. Rückgabewert: ivSessionKey für Upload/Verschlüsselung. Rufen Sie den Checksummawert mit ‘bundle zip —json’ auf.

Beispiel:

npx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM

Optionen:

Parameter	Typ	Beschreibung
—Schlüssel	string	Benutzerdefinierter Pfad für privaten Signierungsschlüssel
—Schlüsseldaten	string	Privater Signierungsschlüssel
-j	boolean	In JSON ausgeben
—package-json	string	Pfade zu package.json-Dateien für monorepos (getrennt durch Kommas)

🔓 Entschlüsseln

npx @capgo/cli@latest bundle decrypt

Ein verschlüsseltes Bundle entschlüsseln (hauptsächlich für Tests). Druckt die Base64-Sitzungsschlüssel zur Verifizierung aus.

Beispiel:

npx @capgo/cli@latest bundle decrypt ./myapp_encrypted.zip CHECKSUM

Optionen:

Param	Typ	Beschreibung
—Schlüssel	string	Benutzerdefinierter Pfad für privaten Signierungs-Schlüssel
—Schlüsseldaten	string	Privater Signierungs-Schlüssel
—Prüfsumme	string	Prüfsumme des Bundles, um die Integrität des Bundles zu überprüfen
—package-json	string	Pfade zu package.json-Dateien für monorepos (getrennt durch Komma)

🔹 Zip

npx @capgo/cli@latest bundle zip

🗜️ Erstelle ein Zip-Datei-Paket für dein App-Bundle. Gibt den Prüfsumme zur Verschlüsselung zurück. Verwende —json für maschinenlesbare Ausgabe.

Beispiel:

npx @capgo/cli@latest bundle zip com.example.app --path ./dist

Optionen:

Parameter	Typ	Beschreibung
-p	string	Pfad des Ordners zum Hochladen, wenn nicht angegeben, wird der webDir aus capacitor.config verwendet
-b	string	Bundle-Version-Nummer zur Namensgebung des Zip-Dateis
-n	string	Name des Zip-Dateis
-j	boolean	Ausgabe in JSON
—no-code-check	boolean	Überspringen der Überprüfung, ob notifyAppReady() in der Quelldatei von code und dem Index im Root-Ordner aufgerufen wird
—key-v2	boolean	Verschlüsselung v2 verwenden
—package-json	string	Pfade zu package.json-Dateien für monorepos (komma-getrennt)