📦 Bundle

📦 Verwalten Sie App-Bundles 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

⬆️ Ein neues App-Bundle zum Verteilen in Capgo Cloud hochladen. Die Version muss größer als 0.0.0 und eindeutig sein. Gelöschte Versionen dürfen aus Sicherheitsgründen nicht wieder verwendet werden. Option: Nur eine URL-Verknüpfung speichern (nützlich für Apps >200MB oder Datenschutzanforderungen). Capgo überprüft nie externe Inhalte. Fügen Sie Verschlüsselung für vertrauenswürdige Sicherheit hinzu.

Beispiel:

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

Optionen:

Parameter	Typ	Beschreibung
-a,	string	API-Schlüssel, um auf Ihr Konto zuzugreifen
-p,	string	Pfad des Ordners zum Hochladen, wenn nicht angegeben, wird der in capacitor.config gesetzte Wert von webDir verwendet
-c,	string	Kanal, um zuzulinken
-e,	string	Link auf externe URL anstatt Hochladen auf Capgo Cloud
—iv-session-key	string	Sesionschlüssel und IV für den Bundle-URL-externen
—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-endpoint	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	Benutzerdefinierte Pfad für privaten Signierungschlüssel (v2-System)
—key-data-v2	string	Privater Signierungschlüssel (v2-System)
—bundle-url	boolean	Bundle-URL in die Standardausgabe ausgeben
—no-key	boolean	Signierungschlüssel ignorieren und klare Aktualisierung senden
—no-code-check	boolean	Überprüfung, ob notifyAppReady() in der Quelldatei code und im Index im Root-Ordner vorhanden ist, ignorieren
—display-iv-session	boolean	IV- und Sitzungsschlüssel im Konsole anzeigen, die zum Verschlüsseln der Aktualisierung verwendet werden
-b,	string	Bundleversionnummer derBundel zum Hochladen
—link	string	Link zu externerRessource (z.B. GitHub-Release)
—comment	string	Kommentar zu dieserVersion, könnte einRelease-Note, ein Commit-Hash, ein Commit-Mitteilung, usw. sein
—min-update-version	string	MinimalerVersion, die zum Aktualisieren auf dieseVersion erforderlich ist. Wird nur verwendet, wenn die automatische Aktualisierung auf Metadaten in Kanal gesetzt ist
—auto-min-update-version	boolean	Setze die Min-Aktualisierungsversion basierend auf native Packages
—ignore-metadata-check	boolean	Ignores die Metadaten (node_modules)-Überprüfung beim Hochladen
—ignore-checksum-check	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] Verwenden Sie stattdessen —tus. 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)
—teilweise	boolean	[VERALTET] Verwenden Sie —delta stattdessen. Hochladen von inkrementellen Updates
—teilweise nur	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, extrem schnelle Updates anstatt großer Zip-Downloads
—delta-only	boolean	Hochladen nur Delta-Updates ohne vollständiges Bundle für maximale Geschwindigkeit (nützlich für große Apps)
—keine-delta	boolean	Delta-Updates auch bei aktivierter Direkter Update deaktivieren
—verschlüsselter-checksum	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 durchführen, bedeutet, dass die Dateien nicht hochgeladen werden, aber eine Zeile in der Datenbank hinzugefügt wird (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üsselung von Delta-Update-Dateien (automatisch aktiviert für Updater > 6.14.4)
—delete-linked-bundle-on-upload	boolean	Lokalisiert den derzeitigen Bundle-Link in dem Kanal, in den Sie versuchen, hochzuladen, und löscht ihn
__CAPGO_KEEP_0__	string	Dateien, die von der Brotli-Komprimierung ausgeschlossen werden sollen (Komma-getrennte GLOBS, z.B. ".jpg,.png")
__CAPGO_KEEP_0__	boolean	Brotli-Komprimierung vollständig deaktivieren, auch wenn die Updater-Version sie unterstützt
__CAPGO_KEEP_0__	boolean	Erfolgreich beenden, wenn die Bundle-Version bereits existiert, nützlich für CI/CD-Workflows mit Monorepos
__CAPGO_KEEP_0__	boolean	Zulassen, dass Geräte sich automatisch diesem Kanal anschließen (aktualisiert Kanal-Einstellung)
__CAPGO_KEEP_0__	string	Benutzerdefinierte Supabase-Host-URL (für Selbsthosting oder Capgo Entwicklung)
—supa-anon	string	Benutzerdefinierte Supabase-Anon-Schlüssel (für Selbsthosting)
—verbose	boolean	Ermöglichen Sie ausführliche Ausgabe mit detaillierten Protokollen

🧪 Kompatibilität

npx @capgo/cli@latest bundle compatibility

🧪 Check compatibility of a bundle with a specific channel in Capgo Cloud to ensure updates are safe.

Terminal-Fenster

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, um die Kompatibilität zu überprüfen
—text	boolean	Textausgabe anstelle von Emojis
—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	Benutzerdefinierte Supabase-Host-URL (für Selbsthosting oder Capgo Entwicklung)
—supa-anon	string	Benutzerdefinierte Supabase-Anon-Key (für Selbsthosting)

🔹 Veröffentlichungstyp

npx @capgo/cli@latest bundle releaseType

🧭 Ausgabe von “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 zum Vergleichen
—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)
—supa-host	string	Benutzerdefinierte Supabase-Host-URL (für Selbsthosting oder Capgo Entwicklung)
—supa-anon	string	Benutzerdefinierte Supabase-Anon-Key (für Selbsthosting)

🗑️ Löschen

Alias: d

npx @capgo/cli@latest bundle delete

🗑️ Ein bestimmtes Bundle aus Capgo Cloud löschen, optional auf eine einzelne Version abzielen.

Beispiel:

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

Optionen:

Parameter	Typ	Beschreibung
-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	Benutzerdefinierte Supabase-Anon-Key (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	Benutzerdefinierter Supabase-Host-URL (für Selbsthosting oder Capgo Entwicklung)
—supa-anon	string	Benutzerdefinierter Supabase-Anon-Key (für Selbsthosting)

🧹 Säubern

Alias: c

npx @capgo/cli@latest bundle cleanup

🧹 In Capgo Cloud alte Bundel löschen, dabei die letzten Capgo Versionen behalten. Bundel, die mit Kanälen verknüpft sind, werden aufbewahrt, 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	Die Versionsnummer des Bundels, das gelöscht werden soll
-a,	string	API Schlüssel, um auf Ihr Konto zuzugreifen
-k,	string	Anzahl der zu speichernden Versionen
-f,	string	Zwangs-Entfernung
—ignore-channel	boolean	Verpackungen auch dann löschen, wenn sie auf Kanäle verlinkt 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üssle ein Zip-Paket für sichere externe Speicherung. Gibt ivSessionKey für Upload/Verschlüsselung zurück. Lade Checksumme mit ‘bundle zip —json’ herunter.

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,	string	Ausgabe in JSON-Format
—package-json	string	Pfade zu package.json-Dateien für monorepositorien (komma-getrennt)

🔓 Entschlüsseln

npx @capgo/cli@latest bundle decrypt

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

Beispiel:

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

Optionen:

Parameter	Typ	Beschreibung
—key	string	Benutzerdefinierter Pfad für den privaten Signierungschlüssel
—key-data	string	Privater Signierungschlü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 (komma-getrennt)

🔹 Zip

npx @capgo/cli@latest bundle zip

🗜️ Erstelle ein Zip-Datei deines App-Bundles. Gibt Prüfsumme zur Verwendung mit der 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	Verzeichnispfad zum Hochladen, wenn nicht angegeben, wird das in capacitor.config gesetzte webDir verwendet
-b,	string	Bundle-Version-Nummer zur Namensgebung des Zip-Dateis
-n,	string	Name des Zip-Dateis
-j,	string	Ausgabe in JSON
—no-code-prüfung	boolean	Überprüfung ignorieren, wenn notifyAppReady() in der Quelldatei code und der Index im Root-Ordner vorhanden ist
—schlüssel-v2	boolean	Verschlüsselung v2 verwenden
—package-json	string	Pfade zu package.json-Dateien für monorepos (komma-getrennt)

Weitermachen von der Bundle

Wenn Sie " bundle" zur Planung von Sicherheit und Compliance verwenden, verbinden Sie es mit " Verschlüsselung" für die Implementierungsdetails in Verschlüsselung, Kongruenz für die Implementierungsdetails in Kongruenz, Capgo Sicherheits-Scanner für den Produktworkflow in Capgo Sicherheits-Scanner, Capgo Sicherheit für den Produktworkflow in Capgo Sicherheit und Capgo Trust Center für den Produktworkflow in Capgo Trust Center.