📦 Bundle
Kopieren Sie einen Einrichtungsbefehl mit den Installationsanweisungen und der vollständigen Markdown-Führungsanleitung für diesen Plugin.
📦 Verwalten Sie Anwendungs-Pakete für die Bereitstellung in Capgo Cloud, einschließlich Hochladen, Kompatibilitätsprüfungen und Verschlüsselung.
⬆️ Hochladen
Abschnitt mit dem Titel “ ⬆️ Hochladen”Alias: u
npx @capgo/cli@latest bundle upload⬆️ Hochladen Sie ein neues App-Paket zu 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ünden. Außenliegende Option: Speichern Sie 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 productionOptionen:
| 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 im capacitor.config verwendet |
| -c, | string | Kanal zum Verknüpfen |
| -e, | string | Verknüpfung zu einer externen URL anstatt zum Hochladen auf Capgo Cloud |
| —iv-session-key | string | IV- und Sitzungsschlüssel für die Bundel-URL extern setzen |
| —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 |
| —Schlüssel-v2 | string | Benutzerdefinierte Pfad für privaten Signierungs-Schlüssel (v2-System) |
| —Schlüssel-Daten-v2 | string | Privater Signierungs-Schlüssel (v2-System) |
| —Bündel-URL | boolean | Bündel-URL in die Konsole ausgeben |
| —kein-Schlüssel | boolean | Signierungs-Schlüssel ignorieren und klare Aktualisierung senden |
| —kein-code-Überprüfung | boolean | Überprüfung ignorieren, ob notifyAppReady() in Quell-code und Index im Root-Ordner vorhanden ist |
| —Anzeige-IV-Sitzung | boolean | IV und Sitzungsschlüssel im Konsole anzeigen, der zur Verschlüsselung der Aktualisierung verwendet wird |
| -b, | string | Versionnummer der zu hochladenden Bundle |
| —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-Mitteilung etc. sein |
| —min-update-version | string | Minimal erforderliche Version zum Update auf diese Version. Wird nur verwendet, wenn das automatische Update auf Basis der Channel-Metadaten deaktiviert ist |
| —auto-min-update-version | boolean | Setzt die Min-Update-Version auf Basis der native Packages |
| —ignore-metadata-check | boolean | Ignoert die Metadaten-Überprüfung (node_modules) bei der Hochladung |
| —ignoriere-Prüfsummenprüfung | boolean | Ignores die Prüfsummenprüfung bei der Hochladung |
| —force-crc32-Prüfsummenprüfung | boolean | Zwingt CRC32-Prüfsummenprüfung für die Hochladung (Überlagerung der automatischen Erkennung) |
| —Zeitüberschreitung | string | Zeitüberschreitung für den Hochladevorgang in Sekunden |
| —Multipart | boolean | [VERALTET] Verwende —tus stattdessen. Verwendet Multipart-Protokoll für S3-Hochladungen |
| —Zip | boolean | Hochlädt das Bundle mit Zip zu Capgo Cloud (Legacy) |
| —tus | boolean | Hochlädt das Bundle mit TUS zu Capgo Cloud |
| —tus-blochendes-Teilmaß | string | Größe des Teilstücks in Byte für TUS wiederholbare Uploads (Standard: Auto) |
| —teilweise | boolean | [VERALTET] Verwenden Sie —delta stattdessen. Hochladen inkrementeller Updates |
| —teilweise-nur | boolean | [VERALTET] Verwenden Sie —delta-nur 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-nur | boolean | Hochladen nur Delta-Updates ohne vollständiges Bundle für maximale Geschwindigkeit (wirksam für große Apps) |
| —kein-delta | boolean | Deaktivieren Sie Delta-Updates auch dann, wenn Direktes Update aktiviert ist |
| —verschlüsselter-Prüfsummenwert | string | Ein verschlüsselter Prüfsummenwert (Signatur). Wird nur verwendet, wenn ein externes Bundle hochgeladen wird. |
| —Bundle automatisch setzen | boolean | Setze das Bundle in capacitor.config.json |
| —Trockenupload des Bundles | boolean | Trockenupload des Bundle-Prozesses, d. h. es werden keine Dateien hochgeladen, aber eine Zeile in der Datenbank hinzugefügt (Wird von Capgo für interne Tests verwendet) |
| —Paket-JSON | string | Pfade zu package.json-Dateien für monorepos (getrennt durch Kommas) |
| —Node-Modul-Verzeichnisse | string | Pfade zu node_modules-Verzeichnissen für monorepos (getrennt durch Kommas) |
| —Teilweise-Verschlüsselung | boolean | Verschlüsselung von Delta-Update-Dateien (automatisch aktiviert für Updater > 6.14.4) |
| __CAPGO_KEEP_0__ | boolean | Löscht das aktuell verknüpfte Bundle im Zielkanal, bevor es hochgeladen wird |
| __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 | Mit Erfolg 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) |
| —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 |
🧪 Kompatibilität
Fenster des Terminalfenstersnpx @capgo/cli@latest bundle compatibility🧪 Check compatibility of a bundle with a specific channel in Capgo Cloud to ensure updates are safe.
—supa-anon
npx @capgo/cli@latest bundle compatibility com.example.app --channel productionOptionen:
| Param | 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 (getrennt durch Komma) |
| —node-modules | string | Pfade zu node_modules-Verzeichnissen für monorepos (getrennt durch Komma) |
| —supa-host | string | Benutzerdefinierter Supabase-Host-URL (für Selbsthosting oder Capgo Entwicklung) |
| —supa-anon | string | Benutzerdefinierter Supabase-Anon-Key (für Selbsthosting) |
🔹 ReleaseTyp
Abschnitt mit dem Titel “ 🔹 ReleaseTyp”npx @capgo/cli@latest bundle releaseTypeDrucken 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 productionOptionen:
| Parameter | Typ | Beschreibung |
|---|---|---|
| -a, | string | API-Schlüssel, um auf Ihr Konto zu verlinken |
| -c, | string | Kanal zum Vergleich |
| —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
Abschnitt mit dem Titel “ 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.appOptionen:
| Parameter | Typ | Beschreibung |
|---|---|---|
| -a, | string | API Schlüssel, um auf Ihr Konto zuzugreifen |
| —supa-host | string | Eigene Supabase-Host-URL (für Selbstbetrieb oder Capgo Entwicklung) |
| —supa-anon | string | Eigene Supabase-Anon-Schlüssel (für Selbstbetrieb) |
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.appOptionen:
| 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) |
🧹 Säubern
Abschnitt mit dem Titel „ 🧹 Säubern“Alias: c
npx @capgo/cli@latest bundle cleanup🧹 Alte Bundles in Capgo Cloud löschen, dabei die letzten Capgo Versionen behalten. Bundles, 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=3Optionen:
| Parameter | Typ | Beschreibung |
|---|---|---|
| -b, | string | Versionnummer der App zum Löschen |
| -a, | string | API-Schlüssel zum Verknüpfen mit Ihrem Konto |
| -k, | string | Anzahl der zu haltenden Versionen |
| -f, | string | Zwangsentsorgung |
| —ignore-channel | boolean | Bundles 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 | Zuweisung einer benutzerdefinierten Supabase-Anonymschlüssel (für Selbstbetrieb) |
🔒 Verschlüsseln
Abschnitt mit dem Titel “ 🔒 Verschlüsseln”npx @capgo/cli@latest bundle encrypt🔒 Verschlüsseln Sie ein Zip-Paket für sichere externe Speicherung. Gibt ivSessionKey für Upload/Verschlüsselung zurück. Rufen Sie den Prüfsummenwert mit ‘bundle zip —json’ auf.
Beispiel:
npx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUMOptionen:
| Parameter | Typ | Beschreibung |
|---|---|---|
| —Schlüssel | string | Benutzerdefinierter Pfad für den privaten Signierungschlüssel |
| —Schlüsseldaten | string | Privater Signierungschlüssel |
| -j, | string | Ausgabe in JSON |
| —package-json | string | Pfade zu package.json-Dateien für Monorepos (komma-getrennt) |
🔓 Entschlüsseln
Abschnitt mit dem Titel “ 🔓 Entschlüsseln”npx @capgo/cli@latest bundle decryptVerschlüsselte Bundle entschlüsseln (hauptsächlich für Tests). Druckt Base64-Sitzungschlüssel zur Verifizierung.
Beispiel:
npx @capgo/cli@latest bundle decrypt ./myapp_encrypted.zip CHECKSUMOptionen:
| Parameter | Typ | Beschreibung |
|---|---|---|
| —Schlüssel | string | Benutzerdefinierter Pfad für privaten Signierungsschlüssel |
| —Schlüsseldaten | string | Privatschlüssel für die Signierung |
| —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
Terminalfensternpx @capgo/cli@latest bundle zipBeispiel:
Terminalfenster
npx @capgo/cli@latest bundle zip com.example.app --path ./distOptionen:
| Parameter | Typ | Beschreibung |
|---|---|---|
| -p, | string | Pfad des Ordners zum Hochladen, wenn nicht angegeben, wird der Ordner webDir aus capacitor.config verwendet |
| -b, | string | Version des Bundles, um den Namen des Zip-Dateis zu bestimmen |
| -n, | string | Name des Zip-Dateis |
| -j, | string | Ausgabe in JSON |
| —no-code-Überprü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) |
Weiter von der Bundle
Abschnitt mit dem Titel “Weiter 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 Vertrauenszentrum für den Produktworkflow in Capgo Vertrauenszentrum.