📦 Bundle

📦 Verwalte Anwendungsdateien 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 einer neuen Anwendungsdatei 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ßenliegende Option: Speichere nur einen URL-Link (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

Optionen:

Parameter	Typ	Beschreibung
-a,	string	API Schlüssel, um auf Ihr Konto zu verlinken
-p,	string	Pfad des Ordners zum Hochladen, wenn nicht angegeben, wird der in capacitor.config gesetzte Wert von webDir verwendet
-c,	string	Kanal, um zu verlinken
-e,	string	Link anstatt Capgo hochladen
—iv-session-key	string	Setze die IV und Sitzungsschlüssel für die externen Bundle-URL
—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 deinen S3-Endpunkt
—s3-endpoint	string	URL deines S3-Endpunkts
—s3-bucket-name	string	Name für Ihren AWS S3-Bucket
__CAPGO_KEEP_0__	string	S3-Port
__CAPGO_KEEP_0__	boolean	SSL für S3-Upload deaktivieren
__CAPGO_KEEP_0__	string	Benutzerdefinierter Pfad für privaten Signierungskey (v2-System)
__CAPGO_KEEP_0__	string	Privater Signierungskey (v2-System)
__CAPGO_KEEP_0__	boolean	Bundle-URL in stdout ausgeben
__CAPGO_KEEP_0__	boolean	Igriere das Signierungsdatum und sende ein klares Update
—no-code-check	boolean	Igriere die Überprüfung, ob notifyAppReady() in der Quelldatei code und im Index im Root-Ordner aufgerufen wird
—display-iv-session	boolean	Zeige im Konsole die IV- und Sitzungsschlüssel, die zum Verschlüsseln des Updates verwendet werden
-b,	string	Bundle-Version-Nummer des zu hochladenden Bundles
—link	string	Link zu externer Ressource (z.B. GitHub-Release)
—comment	string	Kommentar zu dieser Version, könnte ein Release-Note, ein Commit-Hash, ein Commit-Meldung usw. sein
—min-update-version	string	Minimalversion, die zum Aktualisieren auf diese Version erforderlich ist. Wird nur verwendet, wenn die automatische Aktualisierung auf Metadaten in Kanal gesetzt ist.
—auto-min-update-version	boolean	Setze die Mindestaktualisierungsversion basierend auf native Paketen
—ignore-metadata-check	boolean	Überspringt die Metadaten (node_modules) Überprüfung beim Hochladen
—ignore-checksum-check	boolean	Überspringt die Prüfsummenüberprüfung beim Hochladen
—force-crc32-checksum	boolean	Zwingt CRC32-Prüfsumme für das Hochladen (überschreibt die automatische Erkennung)
—timeout	string	Zeitüberschreitung für den Uploadprozess in Sekunden
—multipart	boolean	[VERALTET] Verwenden Sie stattdessen —tus. Verwendet das multipart-Protokoll für S3-Uploads
—zip	boolean	Laden Sie das Bundle als Zip-Datei zu Capgo Cloud (Legacy) hoch
—tus	boolean	Laden Sie das Bundle als TUS zu Capgo Cloud hoch
—tus-chunk-size	string	Größe der Chunk-Dateien in Byte für TUS-Wiederaufnahmee-Uploads (Standard: Auto)
—partial	boolean	[VERALTET] Verwenden Sie stattdessen —delta. Hochladen von inkrementellen Updates
—partial-only	boolean	[VERALTET] Verwenden Sie stattdessen —delta-only. Hochladen nur inkrementeller Updates, vollständiges Bundle überspringen
—delta	boolean	Delta-Updates hochladen (nur geänderte Dateien) für sofortige, extrem schnelle Updates anstatt großer Zip-Downloads
—delta-only	boolean	Nur Delta-Updates hochladen ohne vollständiges Bundle für maximale Geschwindigkeit (nützlich für große Apps)
—no-delta	boolean	Delta-Updates auch bei aktivierter Direkter Update deaktivieren
—encrypted-checksum	string	Ein verschlüsselter Prüfsummenwert (Signatur). Nur verwendet, wenn ein externes Bundle hochgeladen wird.
—auto-set-bundle	boolean	Die Bundle in capacitor.config.json setzen
—dry-upload	boolean	Das Bundle-Prozess trocken hochladen, bedeutet, es werden die Dateien nicht hochgeladen, aber eine Zeile in der Datenbank hinzugefügt (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 node_modules-Verzeichnissen für monorepos (getrennt durch Komma)
—encrypt-partial	boolean	Delta-Update-Dateien verschlüsseln (automatisch aktiviert für Updater > 6.14.4)
—delete-linked-bundle-on-upload	boolean	Lokalisiert den derzeitigen verknüpften Bundle in dem Kanal, in den Sie versuchen, hochzuladen, und löscht es
—no-brotli-patterns	string	Dateien, die von der Brotli-Komprimierung ausgeschlossen werden sollen (getrennt durch Komma, globale Muster, z.B. ".jpg,.png")
—disable-brotli	boolean	Brotli-Komprimierung vollständig deaktivieren, auch wenn der Updater-versions unterstützt sie
—version-exists-ok	boolean	Mit Erfolg beenden, wenn die Bundle-Version bereits existiert, nützlich für CI/CD-Workflows mit Monorepos
—self-assign	boolean	Zulassen, dass Geräte sich automatisch diesem Kanal anschließen (Aktualisierungs-Kanal-Einstellung)
—supa-host	string	Benutzerdefinierter Supabase-Host-URL (für Selbsthosting oder Capgo Entwicklung)
—supa-anon	string	Benutzerdefinierter Supabase-Anon-Key (für Selbsthosting)
—verbose	boolean	Ausführliche Ausgabe mit detaillierten Protokollen aktivieren

🧪 Kompatibilität

npx @capgo/cli@latest bundle compatibility

💖 Überprüfe 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, um die Kompatibilität zu überprüfen
—text	boolean	Text statt 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	Benutzerdefinierte Supabase-Anon-Key (für Selbstbetrieb)

🔹 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-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	Benutzerdefinierte Supabase-Anonymschlüssel (für Selbstbetrieb)

🗑️ Löschen

Alias: d

npx @capgo/cli@latest bundle delete

🗑️ Ein bestimmtes Bundle aus Capgo Cloud löschen, 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, 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)

📋 Auflistung

Alias: l

npx @capgo/cli@latest bundle list

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

Beispiel:

npx @capgo/cli@latest bundle list 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)

🧹 Reinigung

Alias: c

npx @capgo/cli@latest bundle cleanup

🧹 Löschen Sie in Capgo Cloud alte Pakete, behalten Sie die angegebene Anzahl der letzten Versionen bei. Pakete, die an Kanäle gebunden 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	Version des Apps, die gelöscht werden soll
-a,	string	API-Schlüssel, um sich mit Ihrem Konto zu verbinden
-k,	string	Anzahl der zu behaltenden Versionen
-f,	string	Zwangsvorlage
—ignore-channel	boolean	Bündel auch 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-Schlüssel (für Selbsthosting)

🔒 Verschlüsseln

npx @capgo/cli@latest bundle encrypt

🔒 Verschlüsselt ein Zip-Bündel für sichere externe Speicherung. Gibt ivSessionKey für Upload/Verschlüsselung zurück. Nutze ‘bundle zip —json’ für den Checksummenwert.

Beispiel:

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

Optionen:

Parameter	Typ	Beschreibung
—Schlüssel	string	Benutzerdefinierter Pfad für den privaten Signierungsschlüssel
—Schlüsseldaten	string	Privater Signierungsschlüssel
-j,	string	Ausgabe in JSON
—package-json	string	Pfade zu package.json-Dateien für Monorepos (getrennt durch Komma)

🔓 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
—Schlüssel	string	Benutzerdefinierter Pfad für den privaten Signierungsschlüssel
—Schlüsseldaten	string	Privater Signierungsschlü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

🗜️ Erstelle ein Zip-Datei-Paket deiner App-Bundle. Gibt den Prüfsumme für die 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 in capacitor.config gesetzte Wert von webDir verwendet
-b,	string	Versionnummer der Bundle zum Namen des Zip-Dateis
-n,	string	Name der Zip-Datei
-j,	string	Ausgabe in JSON
—no-code-check	boolean	Überprüfung ignorieren, ob notifyAppReady() in der Quelldatei code und Index im Root-Ordner vorhanden ist
—key-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" zum Planen von Sicherheit und Compliance verwenden, verbinden Sie es mit Encryption für die Implementierungsdetails in Encryption, Compliance für die Implementierungsdetails in Compliance, Capgo Sicherheits-Scanner für den Produktworkflow in Capgo Sicherheits-Scanner, Capgo Sicherheit für den Produktworkflow in Capgo Sicherheit und Capgo Vertrauenszentrum für den Produktworkflow in Capgo Vertrauenszentrum.