📦 Paket

📦 Verwalten Sie App-Pakete 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 Sie ein neues App-Paket in Capgo Cloud für die Verteilung. Die Version muss größer als 0.0.0 und einzigartig sein. Gelöschte Versionen können nicht wieder verwendet werden, um Sicherheit zu gewährleisten. Außerhalb der Option: Speichern Sie 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

Optionen:

Parameter	Typ	Beschreibung
-a	string	API-Schlüssel zum Verknüpfen Ihres Kontos
-p	string	Pfad des Ordners zum Hochladen, wenn nicht angegeben, wird der webDir aus capacitor.config verwendet
-c	string	Kanal zum Verknüpfen. Komma-getrennte Kanäle verwenden, z.B. production,beta
—rollout	string	Setze das hochgeladene Bundle als Ziel für den Rollout dieses Kanals bei einem Prozentsatz von 0 bis 100
—rollout-percentage-bps	string	Setze die Upload-Bundle-Rollout-Prozentsatz in Basispunkten von 0 bis 10000
—rollout-cache-ttl-seconds	string	Cloudflare Entscheidungskache-TTL in Sekunden für die Rollout-Entscheidung
-e	string	Link auf externe URL anstatt Upload auf Capgo Cloud
—iv-session-key	string	Setze die IV und Sitzungs-Schlüssel für die Bundle-URL-extern
—s3-region	string	Region für deinen S3-Bucket
—s3-apikey	string	API Schlüssel für deinen S3-Endpunkt
—s3-apisecret	string	API Geheimnis für Ihren S3-Endpunkt
—s3-endpoint	string	URL Ihres S3-Endpunkts
—s3-bucket-name	string	Name Ihres AWS-S3-Buckets
—s3-port	string	Port Ihres S3-Endpunkts
—no-s3-ssl	boolean	SSL für S3-Upload deaktivieren
—key-v2	string	Benutzerdefinierte Pfad für privaten Signierungschlüssel (v2-System)
—key-data-v2	string	Privater Signierungskey (v2-System)
__CAPGO_KEEP_0__-bundle-url	boolean	Bundle-URL in die Konsole ausgeben
__CAPGO_KEEP_0__-no-key	boolean	Signierungskey ignorieren und klare Update senden
code-no-code-check	boolean	Überprüfung, ob notifyAppReady() in Quell-code und Index im Root-Ordner vorhanden ist, ignorieren
__CAPGO_KEEP_0__-display-iv-session	boolean	IV- und Sitzungsschlüssel zum Verschlüsseln des Updates in der Konsole anzeigen
-b	string	Bundle-Version-Nummer des zu uploadenden Bundles
__CAPGO_KEEP_0__-link	string	Link zu externer Ressource (z.B. GitHub-Release)
—Kommentar	string	Kommentar zu dieser Version, könnte eine Release-Note, ein Commit-Hash, ein Commit-Mitteilung etc. sein
—Mindestversion für Update	string	Minimal erforderliche Version zum Update auf diese Version. Wird nur verwendet, wenn das automatische Update in der Kanal-Einstellung auf Metadaten gesetzt ist
—Automatische Mindestversion für Update	boolean	Setze die Mindestupdateversion basierend auf native Packages
—Überprüfung von Metadaten ignorieren	boolean	Ignores die Metadaten (node_modules) Überprüfung bei Upload
—Fehler bei inkompatibler Version	boolean	Fehlermeldung bei Upload (Exitcode nicht Null) anstelle von Upload, wenn das Bundle inkompatibel mit den aktuellen native Packages des Kanals ist. In einer interaktiven Terminal-Umgebung kann man immer noch eine native Build wählen; Ablehnen führt zu einem Fehler. Kann nicht kombiniert werden mit —Überprüfung von Metadaten ignorieren
—Überprüfung von Checksummen ignorieren	boolean	Ignores die Prüfsummenprüfung bei der Hochladung
—force-crc32-checksum	boolean	CRC32-Prüfsumme für die Hochladung zwingend (Überlagerung der automatischen Erkennung)
—timeout	string	Zeitüberschreitung für den Hochladevorgang in Sekunden
—multipart	boolean	[VERALTET] Verwende —tus stattdessen. Verwendet das multipart-Protokoll für S3-Hochladungen
—zip	boolean	Hochladet das Bundle mit Zip zu Capgo Cloud (Legacy)
—tus	boolean	Hochladet das Bundle mit TUS zu Capgo Cloud
—tus-chunk-size	string	Bündelgröße in Byte für TUS-Uploads (Standard: Auto)
__CAPGO_KEEP_0__	boolean	[VERALTET] Verwenden Sie stattdessen —delta. Hochladen inkrementeller Updates
__CAPGO_KEEP_0__	boolean	[VERALTET] Verwenden Sie stattdessen —delta-only. Hochladen nur inkrementeller Updates, vollständiges Bundle überspringen
__CAPGO_KEEP_0__	boolean	Hochladen von Delta-Updates (nur geänderte Dateien) für sofortige, extrem schnelle Updates anstatt großer Zip-Downloads
__CAPGO_KEEP_0__	boolean	Hochladen nur Delta-Updates ohne vollständiges Bundle für maximale Geschwindigkeit (nützlich für große Apps)
__CAPGO_KEEP_0__	boolean	Delta-Updates deaktivieren, auch wenn sofortige Updates aktiviert sind
__CAPGO_KEEP_0__	string	Ein verschlüsselter Prüfsummenwert (Signatur). Wird nur verwendet, wenn ein externes Bundle hochgeladen wird.
—auto-set-bundle	boolean	Setze das Bundle in capacitor.config.json
—dry-upload	boolean	Trockene Upload-Prozess: Füge die Zeile in der Datenbank ohne das Hochladen von Dateien oder das Aktualisieren von Kanälen ein (Wird von Capgo für interne Tests verwendet)
—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)
—encrypt-partial	boolean	Verschlüssle delta-Update-Dateien (automatisch aktiviert für Updater > 6.14.4)
—delete-linked-bundle-on-upload	boolean	Lokalisiert die derzeitige Verknüpfung im Kanal, in den Sie versuchen, zu laden, und löscht sie
—no-brotli-Muster	string	Dateien, die von der Brotli-Komprimierung ausgeschlossen werden sollen (komma-getrennte globale Muster, z.B. .jpg,.png)
—Brotli deaktivieren	boolean	Brotli-Komprimierung vollständig deaktivieren, auch wenn die Updater-Version sie unterstützt
—Version existiert, ist okay	boolean	Mit Erfolg beenden, wenn die Bundle-Version bereits existiert, nützlich für CI/CD-Workflows mit monorepos
—Selbstzuweisung	boolean	Zulassen, dass Geräte sich automatisch diesem Kanal (aktualisieren Sie den Kanal-Einstellung) anschließen
—QR-Vorschau	boolean	Drucken Sie ein Terminal-QR code für diese Bundle-Vorschau nach Upload
—send-update-notification	boolean	Senden Sie eine native Update-Prüfnachricht an Geräte nach dem Aktualisieren von verknüpften Kanal-Ordner
—supa-host	string	Benutzerdefinierte Supabase-Host-URL (für Selbsthosting oder Capgo Entwicklung)
—supa-anon	string	Benutzerdefinierte Supabase-Anon-Schlüssel (für Selbsthosting)
—verbose	boolean	Aktivieren Sie ausführliche Ausgabe mit detaillierten Protokollen

🧪 Kompatibilität

npx @capgo/cli@latest bundle compatibility

🧪 Überprüfen Sie die Kompatibilität eines Bundles mit einer 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 zuzugreifen
-c	string	Kanal zum Überprüfen der Kompatibilität mit
__CAPGO_KEEP_0__	boolean	Text anstelle von Emojis ausgeben
—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)
—supa-host	string	Benutzerdefinierter Supabase-Host-URL (für Selbsthosting oder Capgo Entwicklung)
—supa-anon	string	Benutzerdefinierter Supabase-Anon-Key (für Selbsthosting)

🔹 Veröffentlichungstyp

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 Schlüssel, um auf Ihr Konto zuzugreifen
-c	string	Kanal, gegen den verglichen werden soll
—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)
—supa-host	string	Benutzerdefinierter Supabase-Host-URL (für Selbsthosting oder Capgo Entwicklung)
—supa-anon	string	Benutzerdefinierter Supabase-Anon-Key (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:

Parameter	Typ	Beschreibung
-a	string	API-Schlüssel zum Verknüpfen Ihres Kontos
—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

📋 Liste aller für eine App hochgeladenen Pakete in Capgo Cloud.

Beispiel:

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

Optionen:

Parameter	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-Key (für Selbsthosting)

🧹 Reinigung

Alias: c

npx @capgo/cli@latest bundle cleanup

🧹 Löschen Sie alte Bundles in Capgo Cloud, wobei die angegebene Anzahl der letzten Versionen beibehalten wird. Bundles, die mit Kanälen verknüpft sind, werden beibehalten, es sei denn, —ignore-channel wird verwendet.

Beispiel:

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

Optionen:

Parameter:	Typ	Beschreibung
-b	string	Bundle-Version-Nummer der App, die gelöscht werden soll
-a	string	API-Schlüssel, um auf Ihr Konto zu verlinken
-k	string	Anzahl der zu behaltenden Versionen
-f	boolean	Zwangsvorlage
—ignore-channel	boolean	Bundles auch dann löschen, wenn sie auf Kanäle verlinkt sind (WARNUNG: Löscht Kanäle ebenfalls)
—supa-host	string	Benutzerdefinierte Supabase-Host-URL (für Selbsthosting oder Capgo-Entwicklung)
—supa-anon	string	Benutzerdefinierte Supabase-Anon-Key (für Selbsthosting)

🔒 Verschlüsseln

npx @capgo/cli@latest bundle encrypt

🔒 Verschlüsselt ein Zip-Paket für sichere externe Speicherung. Gibt ivSessionKey für Upload/Verschlüsselung zurück. Rufe Checksumme 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 den privaten Signierungs-Schlüssel
—Schlüsseldaten	string	Privater Signierungs-Schlüssel
-j	boolean	Ausgabe in JSON-Format
—package-json	string	Pfade zu package.json-Dateien für monorepos (komma-getrennt)

🔓 Verschlüsselung

npx @capgo/cli@latest bundle decrypt

Verschlüsselung eines verschlüsselten Bundles (hauptsächlich für Tests). Druckt Base64-Sitzungsschlüssel zur Verifizierung.

Beispiel:

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

Optionen:

Parameter	Typ	Beschreibung
—Schlüssel	string	Benutzerdefinierter Pfad für den privaten Signierungs-Schlüssel
—Schlüsseldaten	string	Privater Signierungs-Schlüssel
—Prüfsumme	string	Prüfsumme der Verpackung, um die Integrität der Verpackung zu überprüfen
—package-json	string	Pfade zu package.json-Dateien für Monorepos (komma-getrennt)

🔹 Zip

npx @capgo/cli@latest bundle zip

🗜️ Eine Zip-Datei Ihres App-Bundles erstellen. Gibt den Prüfsummenwert zurück, der zur Verschlüsselung verwendet werden kann. Verwenden Sie —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 in capacitor.config gesetzte Wert von webDir verwendet
-b	string	Bundle-Version-Nummer, um den Namen der Zip-Datei zu bestimmen
-n	string	Name des Zip-Dateis
-j	boolean	Ausgabe in JSON
—no-code-check	boolean	Überprüfung ignorieren, ob notifyAppReady() in der Quelldatei code und im 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)