📦 Paket

📦 Verwalten Sie Anwendungs-Container 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 einen neuen Anwendungs-Container in 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 Sicherheit zu gewährleisten. Außenliegende 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

Die nächste freie Semver aus dem Kanal (oder die neueste Remote-Anwendung) automatisch hochsetzen, wenn Sie keinen Wert übergeben --bundleNützlich in CI wenn package.json bereits eine Version Capgo entspricht, die __CAPGO_KEEP_1__ hat:

npx @capgo/cli@latest bundle upload --channel=production --auto-bump
npx @capgo/cli@latest bundle upload --auto-bump major
npx @capgo/cli@latest bundle upload --auto-bump minor   # default when the flag has no value
npx @capgo/cli@latest bundle upload --auto-bump patch   # alias: fix
npx @capgo/cli@latest bundle upload --auto-bump metadata
npx @capgo/cli@latest bundle upload --channel=production --auto-bump ai

Mit __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ vergleicht Workers AI lokale Bundle-Dateien mit der vorherigen __CAPGO_KEEP_2__-Deltas-Manifest, schließt --auto-bump ai, Capgo Cloudflare Workers AI compares local bundle files to the previous Capgo/channel delta manifest, infers major | minor | patch | metadata, and prints a short reason in the CLI log. If no previous Capgo version exists, AI is skipped and the bump defaults to Optionen:.

__CAPGO_KEEP_0__

Parameter	Typ	Beschreibung
-a	string	API-Schlüssel zum Verknüpfen mit Ihrem Konto
-p	string	Pfad des Ordners zum Hochladen, wenn nicht angegeben, wird der Ordner webDir aus capacitor.config verwendet
-c	string	Kanal zum Verknüpfen. Komma-getrennte Kanäle für mehrere Kanäle, z.B. production,beta
—rollout	string	Setze das hochgeladene Bundle als Ziel für den Rollout dieses Kanals mit einem Prozentsatz von 0 bis 100
—rollout-percentage-bps	string	Setze die hochgeladene Bundle-Rollout-Prozentsatz in Basispunkten von 0 bis 10000
—rollout-cache-ttl-seconds	string	Cloudflare Laufzeit des Entscheidungs-Caches für die Rollout-Entscheidung in Sekunden
-e	string	Link auf externe URL anstatt Hochladen 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 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-endpunkt	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	Benutzerdefinierter Pfad für den privaten Signierungskey (v2-System)
—key-data-v2	string	Privater Signierungskey (v2-System)
—bundle-url	boolean	—bundle-url druckt die Bundle-URL in stdout aus
—no-key	boolean	Übergeht die Signierungskey und sendet ein klares Update
—no-code-check	boolean	—no-code-check ignoriert die Überprüfung, ob notifyAppReady() in der Quelldatei code und im Index im Root-Ordner vorhanden ist
—display-iv-session	boolean	—display-iv-session zeigt im Konsolenfenster die IV- und Sitzungsschlüssel an, die zum Verschlüsseln des Updates verwendet werden
-b	string	Die Versionsnummer der Bundle, die hochgeladen werden soll
—auto-bump	string	Automatische Inkrementierung aus dem verknüpften Kanal-Bundle, andernfalls die neueste Remote-Anwendungsversion. Ebene: Haupt-, Minor- (Standard), Patches (Alias fix), Metadaten oder ai (Arbeitnehmer AI ermittelt die Ebene aus lokalen vs. vorheriger Delta-Manifest; fällt auf Patches zurück, wenn keine vorherige Capgo-Version vorhanden ist). Bumpet, bis ein freier Name gefunden ist (gelöschte Namen bleiben belegt). Kann nicht kombiniert werden mit —bundle (-b)
—link	string	Verknüpfung 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, um auf diese Version zu aktualisieren. 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 Paketen
—ignore-metadata-check	boolean	Ignoert die Metadaten (node_modules)-Überprüfung bei Upload
—fail-on-incompatible	boolean	Fehler bei der Upload (Exitcode != 0) anstatt zu laden, wenn das Bundle mit den aktuellen native Paketen des Kanals nicht kompatibel ist. In einer interaktiven Terminal-Sitzung kannst du immer noch eine native Build auswählen; Ablehnung schlägt fehl. Kann nicht mit —ignore-metadata-check kombiniert werden.
—ignore-checksum-check	boolean	Überspringt die Prüfung der Prüfsumme bei der Upload
—force-crc32-checksum	boolean	Zwingt CRC32-Prüfsumme für Upload (Überschreibt die automatische Erkennung)
—timeout	string	Zeitüberschreitung für den Upload-Prozess in Sekunden
—multipart	boolean	[VERALTET] Verwende —tus stattdessen. Verwendet das multipart-Protokoll für S3-Uploads
—zip	boolean	Upload das Bundle mit Zip zu Capgo Cloud (Legacy)
—tus	boolean	Laden Sie das Bundle mit TUS hoch auf Capgo Cloud
—tus-chunk-size	string	Größe der Teile in Byte für TUS-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	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)
—no-delta	boolean	Delta-Updates deaktivieren, auch wenn Instant-Updates aktiviert sind
—verschlüsselter-Prüfsummenwert	string	Ein verschlüsselter Prüfsummenwert (Signatur). Wird nur verwendet, wenn ein externer Bundle hochgeladen wird.
—Bundle automatisch setzen	boolean	Das Bundle in capacitor.config.json setzen
—Trocken-Upload	boolean	Trocken-Upload des Bundle-Prozesses: Fügen Sie die Zeile in der Datenbank ohne das Hochladen von Dateien oder das Aktualisieren von Kanälen (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)
—verschlüsselter-Teil	boolean	Verschlüsseln Sie delta-Update-Dateien (automatisch aktiviert für Updater > 6.14.4)
—delete-linked-bundle-on-upload	boolean	Lokalisieren Sie das derzeitige verknüpfte Bundle im Kanal, in den Sie versuchen, hochzuladen, und löschen Sie es
—no-brotli-patterns	string	Dateien, die von der Brotli-Komprimierung ausgeschlossen werden sollen (komma-getrennte GLOBS, z.B. ".jpg,.png""
—disable-brotli	boolean	Brotli-Komprimierung vollständig deaktivieren, selbst wenn die Updater-Version es unterstützt
—version-exists-ok	boolean	Erfolgreich beenden, wenn die Bundle-Version bereits existiert, nützlich für CI/CD-Workflows mit monorepos
—self-assign	boolean	Ermöglichen Sie Geräten, sich automatisch diesem Kanal anzuschließen (aktualisierungs-Kanal-Einstellung)
—qr-Vorschau	boolean	Drucken Sie ein Terminal-QR-code für diese Bundle-Vorschau nach dem Hochladen
—Senden-Sie-eine-Update-Benachrichtigung	boolean	Senden Sie eine native Update-Überprüfung-Benachrichtigung an Geräte nach dem Aktualisieren von verknüpften Kanal-Bundles
—Supa-Host	string	Benutzerdefinierte Supabase-Host-URL (für Selbsthosting oder Capgo Entwicklung)
—Supa-Anon	string	Benutzerdefinierte Supabase-Anon-Schlüssel (für Selbsthosting)
—Verbindlich	boolean	Aktivieren Sie ausführliche Ausgabe mit detaillierten Protokollierungen

🧪 Kompatibilität

npx @capgo/cli@latest bundle compatibility

Kompatibilität eines Bundles mit einem bestimmten Kanal in Capgo Cloud überprüfen, 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 zum Link auf Ihr Konto
-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 Kommas)
—node-modules	string	Pfade zu node_modules-Verzeichnissen für monorepos (getrennt durch Kommas)
—supa-host	string	Benutzerdefinierter Supabase-Host-URL (für Selbsthosting oder Capgo Entwicklung)
—supa-anon	string	Benutzerdefinierte Supabase-Anon-Key (für Selbsthosting)

🔹 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	Zielkanal
—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-Anonymous-Schlüssel (für Selbstbetrieb)

🗑️ Löschen

Alias: d

npx @capgo/cli@latest bundle delete

Löschen Sie einen bestimmten Paket aus Capgo Cloud, optional auf eine einzelne Version ausgerichtet.

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 zu verlinken
—supa-host	string	Benutzerdefinierte Supabase-Host-URL (für Selbsthosting oder Capgo Entwicklung)
—supa-anon	string	Benutzerdefinierte Supabase-Anon-Schlüssel (für Selbsthosting)

📋 Auflistung

Alias: l

npx @capgo/cli@latest bundle list

📋 Alle für eine App hochgeladenen Pakete in Capgo Cloud auflisten.

Beispiel:

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

Optionen:

Parameter	Typ	Beschreibung
-a	string	API-Schlüssel zum Verknüpfen mit Ihrem Konto
--supa-host	string	Benutzerdefinierte Supabase-Host-URL (für Selbsthosting oder Capgo Entwicklung)
—supa-anon	string	Benutzerdefinierte Supabase-Anon-Schlüssel (für Selbsthosting)

🧹 Säubern

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. Verknüpfte Kanäle werden nur dann entfernt, wenn —ignore-channel verwendet wird.

Beispiel:

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

Optionen:

Parameter	Typ	Beschreibung
-b	string	Die Versionsnummer des App-Bundles, das gelöscht werden soll
-a	string	API-Schlüssel, um auf Ihr Konto zu verknüpfen
-k	string	Anzahl der zu behaltenden Versionen
-f	boolean	Zwangsvorlage
---ignoriere-Kanal	boolean	Lösche Pakete auch, wenn sie an Kanälen angekettet 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üssle ein Zip-Paket für sichere externe Speicherung. Gibt ivSessionKey für Upload/Verschlüsselung zurück. Hole Prüfsumme mit ‘bundle zip —json’ ab.

Beispiel:

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

Optionen:

Param	Typ	Beschreibung
—key	string	Benutzerdefinierter Pfad für den privaten Signierungskey
—key-data	string	Privater Signierungskey
-j	boolean	Ausgabe in JSON-Format
—package-json	string	Pfade zu package.json-Dateien für monorepos (getrennt durch Kommas)

🔓 Entschlüsseln

npx @capgo/cli@latest bundle decrypt

🔓 Ein verschlüsseltes Bundle entschlüsseln (hauptsächlich für Tests). Druckt die 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 privaten Signierungs-Schlüssel
—Schlüsseldaten	string	Privater Signierungs-Schlü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 einen Zip-Datei 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 Ordner webDir aus capacitor.config verwendet
-b	string	Versionnummer des Bundles zur Namensgebung des Zip-Dateis
-n	string	Name der Zip-Datei
-j	boolean	Ausgabe in JSON-Format
—no-code-check	boolean	Überprüfung ignorieren, ob notifyAppReady() in der Quelldatei code und im Index im Root-Ordner vorhanden ist
—key-v2	boolean	Verschlüsselung v2 verwenden
—package-json	string	Pfade zu package.json-Dateien für monorepos (getrennt durch Komma)