📦 Paket

📦 Verwalten Sie Anwendungs-Dateipakete 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 ein neues Anwendungs-Dateipaket 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 aktuelle Remote-Anwendung) automatisch hochsetzen, wenn Sie __CAPGO_KEEP_0__ nicht übergeben --bundleNützlich in CI, wenn package.json bereits einer Version Capgo entspricht:

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 dem vorherigen __CAPGO_KEEP_2__/Kanal-Delta-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-separierte 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 bei 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 Entscheidungskachel für die Rollout-Dauer in Sekunden
-e	string	Verknüpfe mit einer externen URL anstatt hochladen auf Capgo Cloud
—iv-session-key	string	Setze die IV- und Sitzungschlüssel für die Bundle-URL-extern
—s3-region	string	Region für deinen S3-Container
—s3-apikey	string	API Schlüssel für deinen 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 Signierungschlüssel (v2-System)
—key-data-v2	string	Privates Signaturschlüssel (v2-System)
—bundle-url	boolean	—bundle-url
—bundle-url	boolean	—bundle-url
—no-code-check	boolean	Ignore checking if notifyAppReady() is called in source code and index present in root folder
—bundle-url	boolean	—bundle-url
—bundle-url	string	—bundle-url
-b	string	Automatische Inkrementierung aus dem verknüpften Kanal-Bundle, andernfalls die neueste Remote-Anwendungsversion. Ebene: Major, Minor (Standard), Patch (Alias Fix), Metadaten oder ai (Arbeitnehmer AI ermittelt die Ebene aus lokalen vs. vorheriger Delta-Manifest; fällt auf Patch zurück, wenn keine vorherige Capgo-Version vorhanden ist). Bumpet, bis ein freier Name gefunden wird (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, usw. sein
—min-update-version	string	Minimal erforderliche Version, um auf diese Version zu aktualisieren. Wird nur verwendet, wenn die automatische Aktualisierung auf Metadaten im 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 der Hochladen
—fail-on-incompatible	boolean	Fehler bei der Upload (Exit-Code != 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 wählen; Ablehnung führt zum Scheitern. Kann nicht mit —ignore-metadata-check kombiniert werden.
—ignore-checksum-check	boolean	Überspringt die Prüfung der Prüfsumme bei dem Upload
—force-crc32-checksum	boolean	Zwingt CRC32-Prüfsumme für den Upload (Überprüfung der automatischen 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 des Bundles mit zip zu Capgo Cloud (Legacy)
—tus	boolean	Capgo Cloud hochladen
—tus-chunk-size	string	Größe der Teile in Byte für TUS-Uploads (Standard: Auto)
—partial	boolean	[VERALTET] —delta verwenden. Inkrementelle Updates hochladen
—partial-only	boolean	[VERALTET] —delta-only verwenden. Nur inkrementelle Updates hochladen, Vollbundle überspringen
—delta	boolean	Delta-Updates (nur geänderte Dateien) hochladen, um sofortige, extrem schnelle Updates zu erhalten, anstatt große Zip-Downloads
—delta-only	boolean	Nur Delta-Updates hochladen, ohne Vollbundle, 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 externes Bundle hochgeladen wird.
—Bundle automatisch setzen	boolean	Setze das Bundle in capacitor.config.json
—Trocken-Upload	boolean	Trocken-Upload des Bundle-Prozesses: Füge die Zeile in der Datenbank hinzu, ohne Dateien hochzuladen oder Kanäle zu aktualisieren (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)
—verschlüsselter-Teil	boolean	Verschlüsseln Sie delta-Update-Dateien (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 (komma-getrennte GLOBS, z.B. “.jpg,.png”)
—disable-brotli	boolean	Brotli-Komprimierung vollständig deaktivieren, auch 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 (aktualisieren Sie die 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)
—Ausführlich	boolean	Aktivieren Sie ausführliche Ausgabe mit detaillierten Protokollierungen

🧪 Kompatibilität

npx @capgo/cli@latest bundle compatibility

Die 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, 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 monorepositorien (komma-getrennt)
—node-modules	string	Pfade zu node_modules-Verzeichnissen für monorepositorien (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 einem Kanals neuesten Metadaten.

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	Zum Vergleich ausgewählter Kanal
—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 Selbsthosting)

🗑️ Löschen

Alias: d

npx @capgo/cli@latest bundle delete

Löschen Sie einen bestimmten Bundle aus Capgo Cloud, 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 zu verlinken
—supa-host	string	Benutzerdefinierte Supabase-Host-URL (für Selbsthosting oder Capgo Entwicklung)
—supa-anon	string	Benutzerdefinierte Supabase-Anon-Key (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	Benutzerdefinierter Supabase-Host-URL (für Selbstbetrieb oder Capgo Entwicklung)
—supa-anon	string	Benutzerdefinierter Supabase-Anon-Schlüssel (für Selbstbetrieb)

🧹 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 gelöscht, wenn —ignore-channel verwendet wird.

Beispiel:

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

Optionen:

Param	Typ	Beschreibung
-b	string	Die Versionsnummer des App-Bundles, das gelöscht werden soll
-a	string	API-Schlüssel, um sich mit Ihrem Konto zu verbinden
-k	string	Die Anzahl der zu behaltenden Versionen
-f	boolean	Zwangsvorlage
—ignorierte Kanal	boolean	Bündel auch dann löschen, wenn sie an Kanälen angekettet 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-Bündel für sichere externe Speicherung. Gibt ivSessionKey für Upload/Entschlüsselung zurück. Rufe Checksumme mit ‘bundle zip —json’ auf.

Beispiel:

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

Optionen:

Param	Typ	Beschreibung
—key	string	Benutzerdefinierter Pfad für die private Signierungsdatei
—key-data	string	Private Signierungsdatei
-j	boolean	Ausgabe in JSON
—package.json	string	Pfade zu package.json-Dateien für monorepos (komma-getrennt)

🔓 Entschlüsseln

npx @capgo/cli@latest bundle decrypt

Entschlüsseln Sie ein verschlüsseltes Bundle (hauptsächlich für Tests). Drucken Sie die Base64-Sitzungsschlüssel für die 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 Signierungs-Schlüssel
—Schlüsseldaten	string	Privater Signierungs-Schlüssel
—Prüfsumme	string	Prüfsumme der Bundle, um die Integrität der Bundle 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 einen Prüfsumme zurück, die zum Verschlüsseln verwendet werden kann. 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 zum Namensgeben des Zip-Dateis
-n	string	Name des Zip-Dateis
-j	boolean	Ausgabe in JSON
—no-code-check	boolean	Überprüfung ignorieren, ob notifyAppReady() in der Quelle code und im Index im Root-Ordner aufgerufen wird
—key-v2	boolean	Verschlüsselung v2 verwenden
—package-json	string	Pfade zu package.json-Dateien für monorepos (komma-getrennt)