Zum Inhalt springen

📦 Bundle

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

Alias: u

Terminalfenster
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:

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

Optionen:

ParameterTypBeschreibung
-a,stringAPI-Schlüssel zum Verknüpfen Ihres Kontos
-p,stringPfad des Ordners zum Hochladen, wenn nicht angegeben, wird der webDir im capacitor.config verwendet
-c,stringKanal zum Verknüpfen
-e,stringVerknüpfung zu einer externen URL anstatt zum Hochladen auf Capgo Cloud
—iv-session-keystringIV- und Sitzungsschlüssel für die Bundel-URL extern setzen
—s3-regionstringRegion für Ihren S3-Bucket
—s3-apikeystringAPI Schlüssel für Ihren S3-Endpunkt
—s3-apisecretstringAPI Geheimnis für Ihren S3-Endpunkt
—s3-endpointstringURL Ihres S3-Endpunkts
—s3-bucket-namestringName für Ihren AWS S3-Bucket
—s3-portstringPort für Ihren S3-Endpunkt
—no-s3-sslbooleanSSL für S3-Upload deaktivieren
—Schlüssel-v2stringBenutzerdefinierte Pfad für privaten Signierungs-Schlüssel (v2-System)
—Schlüssel-Daten-v2stringPrivater Signierungs-Schlüssel (v2-System)
—Bündel-URLbooleanBündel-URL in die Konsole ausgeben
—kein-SchlüsselbooleanSignierungs-Schlüssel ignorieren und klare Aktualisierung senden
—kein-code-ÜberprüfungbooleanÜberprüfung ignorieren, ob notifyAppReady() in Quell-code und Index im Root-Ordner vorhanden ist
—Anzeige-IV-SitzungbooleanIV und Sitzungsschlüssel im Konsole anzeigen, der zur Verschlüsselung der Aktualisierung verwendet wird
-b,stringVersionnummer der zu hochladenden Bundle
—linkstringLink zu externer Ressource (z.B. GitHub-Release)
—commentstringKommentar zu dieser Version, könnte ein Release-Note, ein Commit-Hash, ein Commit-Mitteilung etc. sein
—min-update-versionstringMinimal erforderliche Version zum Update auf diese Version. Wird nur verwendet, wenn das automatische Update auf Basis der Channel-Metadaten deaktiviert ist
—auto-min-update-versionbooleanSetzt die Min-Update-Version auf Basis der native Packages
—ignore-metadata-checkbooleanIgnoert die Metadaten-Überprüfung (node_modules) bei der Hochladung
—ignoriere-PrüfsummenprüfungbooleanIgnores die Prüfsummenprüfung bei der Hochladung
—force-crc32-PrüfsummenprüfungbooleanZwingt CRC32-Prüfsummenprüfung für die Hochladung (Überlagerung der automatischen Erkennung)
—ZeitüberschreitungstringZeitüberschreitung für den Hochladevorgang in Sekunden
—Multipartboolean[VERALTET] Verwende —tus stattdessen. Verwendet Multipart-Protokoll für S3-Hochladungen
—ZipbooleanHochlädt das Bundle mit Zip zu Capgo Cloud (Legacy)
—tusbooleanHochlädt das Bundle mit TUS zu Capgo Cloud
—tus-blochendes-TeilmaßstringGröße des Teilstücks in Byte für TUS wiederholbare Uploads (Standard: Auto)
—teilweiseboolean[VERALTET] Verwenden Sie —delta stattdessen. Hochladen inkrementeller Updates
—teilweise-nurboolean[VERALTET] Verwenden Sie —delta-nur stattdessen. Hochladen nur inkrementeller Updates, vollständiges Bundle überspringen
—deltabooleanHochladen von Delta-Updates (nur geänderte Dateien) für sofortige, extrem schnelle Updates anstatt großer Zip-Downloads
—delta-nurbooleanHochladen nur Delta-Updates ohne vollständiges Bundle für maximale Geschwindigkeit (wirksam für große Apps)
—kein-deltabooleanDeaktivieren Sie Delta-Updates auch dann, wenn Direktes Update aktiviert ist
—verschlüsselter-PrüfsummenwertstringEin verschlüsselter Prüfsummenwert (Signatur). Wird nur verwendet, wenn ein externes Bundle hochgeladen wird.
—Bundle automatisch setzenbooleanSetze das Bundle in capacitor.config.json
—Trockenupload des BundlesbooleanTrockenupload 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-JSONstringPfade zu package.json-Dateien für monorepos (getrennt durch Kommas)
—Node-Modul-VerzeichnissestringPfade zu node_modules-Verzeichnissen für monorepos (getrennt durch Kommas)
—Teilweise-VerschlüsselungbooleanVerschlüsselung von Delta-Update-Dateien (automatisch aktiviert für Updater > 6.14.4)
__CAPGO_KEEP_0__booleanLöscht das aktuell verknüpfte Bundle im Zielkanal, bevor es hochgeladen wird
__CAPGO_KEEP_0__stringDateien, die von der Brotli-Komprimierung ausgeschlossen werden sollen (komma-getrennte GLOBS, z.B. .jpg,.png)
__CAPGO_KEEP_0__booleanBrotli-Komprimierung vollständig deaktivieren, auch wenn die Updater-Version sie unterstützt
__CAPGO_KEEP_0__booleanMit Erfolg beenden, wenn die Bundle-Version bereits existiert, nützlich für CI/CD-Workflows mit Monorepos
__CAPGO_KEEP_0__booleanZulassen, dass Geräte sich automatisch diesem Kanal anschließen (aktualisiert Kanal-Einstellung)
—supa-hoststringBenutzerdefinierte Supabase-Host-URL (für Selbsthosting oder Capgo Entwicklung)
—supa-anonstringBenutzerdefinierte Supabase-Anon-Key (für Selbsthosting)
—verbosebooleanErweiterte Ausgabe mit detaillierten Protokollen aktivieren

🧪 Kompatibilität

Fenster des Terminalfensters
Zur Zwischenablage kopieren
npx @capgo/cli@latest bundle compatibility

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

—supa-anon

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

Optionen:

ParamTypBeschreibung
-a,stringAPI-Schlüssel, um auf Ihr Konto zuzugreifen
-c,stringKanal, um die Kompatibilität zu überprüfen
—textbooleanTextausgabe anstelle von Emojis
—package-jsonstringPfade zu package.json-Dateien für monorepos (getrennt durch Komma)
—node-modulesstringPfade zu node_modules-Verzeichnissen für monorepos (getrennt durch Komma)
—supa-hoststringBenutzerdefinierter Supabase-Host-URL (für Selbsthosting oder Capgo Entwicklung)
—supa-anonstringBenutzerdefinierter Supabase-Anon-Key (für Selbsthosting)
Terminalfenster
npx @capgo/cli@latest bundle releaseType

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

Beispiel:

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

Optionen:

ParameterTypBeschreibung
-a,stringAPI-Schlüssel, um auf Ihr Konto zu verlinken
-c,stringKanal zum Vergleich
—package-jsonstringPfade zu package.json-Dateien für monorepos (komma-getrennt)
—node-modulesstringPfade zu node_modules-Verzeichnissen für monorepos (komma-getrennt)
—supa-hoststringBenutzerdefinierter Supabase-Host-URL (für Selbsthosting oder Capgo Entwicklung)
—supa-anonstringBenutzerdefinierter Supabase-Anon-Key (für Selbsthosting)

Alias: d

Terminalfenster
npx @capgo/cli@latest bundle delete

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

Beispiel:

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

Optionen:

ParameterTypBeschreibung
-a,stringAPI Schlüssel, um auf Ihr Konto zuzugreifen
—supa-hoststringEigene Supabase-Host-URL (für Selbstbetrieb oder Capgo Entwicklung)
—supa-anonstringEigene Supabase-Anon-Schlüssel (für Selbstbetrieb)

Alias: l

Terminalfenster
npx @capgo/cli@latest bundle list

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

Beispiel:

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

Optionen:

ParameterTypBeschreibung
-a,stringAPI Schlüssel, um auf Ihr Konto zuzugreifen
—supa-hoststringBenutzerdefinierter Supabase-Host-URL (für Selbsthosting oder Capgo Entwicklung)
—supa-anonstringBenutzerdefinierter Supabase-Anon-Schlüssel (für Selbsthosting)

Alias: c

Terminalfenster
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:

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

Optionen:

ParameterTypBeschreibung
-b,stringVersionnummer der App zum Löschen
-a,stringAPI-Schlüssel zum Verknüpfen mit Ihrem Konto
-k,stringAnzahl der zu haltenden Versionen
-f,stringZwangsentsorgung
—ignore-channelbooleanBundles auch dann löschen, wenn sie mit Kanälen verknüpft sind (WARNUNG: Löscht Kanäle ebenfalls)
—supa-hoststringBenutzerdefinierter Supabase-Host-URL (für Selbsthosting oder Capgo Entwicklung)
—supa-anonstringZuweisung einer benutzerdefinierten Supabase-Anonymschlüssel (für Selbstbetrieb)
Terminalfenster
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:

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

Optionen:

ParameterTypBeschreibung
—SchlüsselstringBenutzerdefinierter Pfad für den privaten Signierungschlüssel
—SchlüsseldatenstringPrivater Signierungschlüssel
-j,stringAusgabe in JSON
—package-jsonstringPfade zu package.json-Dateien für Monorepos (komma-getrennt)
Terminalfenster
npx @capgo/cli@latest bundle decrypt

Verschlüsselte Bundle entschlüsseln (hauptsächlich für Tests). Druckt Base64-Sitzungschlüssel zur Verifizierung.

Beispiel:

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

Optionen:

ParameterTypBeschreibung
—SchlüsselstringBenutzerdefinierter Pfad für privaten Signierungsschlüssel
—SchlüsseldatenstringPrivatschlüssel für die Signierung
—PrüfsummestringPrüfsumme des Bundles, um die Integrität des Bundles zu überprüfen
—package-jsonstringPfade zu package.json-Dateien für Monorepos (komma-getrennt)
Zur Zwischenablage kopieren
npx @capgo/cli@latest bundle zip

Beispiel:

Terminalfenster

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

Optionen:

ParameterTypBeschreibung
-p,stringPfad des Ordners zum Hochladen, wenn nicht angegeben, wird der Ordner webDir aus capacitor.config verwendet
-b,stringVersion des Bundles, um den Namen des Zip-Dateis zu bestimmen
-n,stringName des Zip-Dateis
-j,stringAusgabe in JSON
—no-code-ÜberprüfungbooleanÜberprüfung ignorieren, wenn notifyAppReady() in der Quelldatei code und der Index im Root-Ordner vorhanden ist
—Schlüssel-v2booleanVerschlüsselung v2 verwenden
—package-jsonstringPfade zu package.json-Dateien für monorepos (komma-getrennt)

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.