📦 Bundle
Kopiere einen Setup-Prompt mit den Installationsschritten und dem vollständigen Markdown-Guide für dieses Plugin.
📦 Verwalte App-Bundles für den Deployment in Capgo Cloud, einschließlich Upload, Kompatibilitätsprüfungen und Verschlüsselung.
⬆️ Upload
Abschnitt mit dem Titel „ ⬆️ Upload“Alias: u
npx @capgo/cli@latest bundle upload⬆️ Lade ein neues App-Bundle in Capgo Cloud hoch, um es zu verteilen. Die Version muss > 0.0.0 und eindeutig sein. Gelöschte Versionen können aus Sicherheitsgründen nicht wiederverwendet werden. Externe Option: Speichert nur einen URL-Link (nützlich für Apps >200MB oder Datenschutzanforderungen). Capgo prüft externe Inhalte nie. Füge Verschlüsselung hinzu, um vertrauenslose Sicherheit zu gewährleisten.
Beispiel:
npx @capgo/cli@latest bundle upload com.example.app --path ./dist --channel production,betaErhöhe automatisch die nächste freie semver-Version aus dem Channel (oder der letzten Remote-App-Version), wenn du keine angibst --bundle. Nützlich in CI, wenn package.json entspricht bereits einer Version, die Capgo hat:
npx @capgo/cli@latest bundle upload --channel=production --auto-bumpnpx @capgo/cli@latest bundle upload --auto-bump majornpx @capgo/cli@latest bundle upload --auto-bump minor # default when the flag has no valuenpx @capgo/cli@latest bundle upload --auto-bump patch # alias: fixnpx @capgo/cli@latest bundle upload --auto-bump metadatanpx @capgo/cli@latest bundle upload --channel=production --auto-bump aiMit --auto-bump ai, Capgo Cloudflare Workers AI vergleicht lokale Bundle-Dateien mit dem vorherigen Capgo/Channel-Delta-Manifest und leitet ab major | minor | patch | metadata, und gibt einen kurzen Grund im CLI-Log aus. Wenn keine vorherige Capgo-Version existiert, wird AI übersprungen und der Bump standardmäßig auf Patch.
Optionen:
| Parameter | Typ | Beschreibung |
|---|---|---|
| -a | string | API Key zum Verknüpfen mit deinem Account |
| -p | string | Pfad des Ordners für den Upload; falls nicht angegeben, wird der in capacitor.config festgelegte webDir verwendet |
| -c | string | Channel, mit dem verknüpft werden soll. Mehrere Channels durch Kommas trennen, z. B. production,beta |
| —rollout | string | Das hochgeladene Bundle als Rollout-Ziel dieses Channels mit einem Prozentsatz von 0 bis 100 festlegen |
| —stable | boolean | Auf einem Channel mit Rollout-Konfiguration das stabile Fallback ersetzen, anstatt das Rollout-Ziel zu setzen |
| --rollout-percentage-bps | string | Den Rollout-Prozentsatz des hochgeladenen Bundles in Basispunkten von 0 bis 10000 festlegen |
| —rollout-cache-ttl-seconds | string | Cloudflare Rollout-Entscheidungs-Cache TTL in Sekunden |
| -e | string | Link zu externer URL statt Upload in Capgo Cloud |
| —iv-session-key | string | IV und Session-Key für externe Bundle-URL festlegen |
| —s3-region | string | Region für Ihren S3-Bucket |
| —s3-apikey | string | API-Key für Ihren S3-Endpunkt |
| —s3-apisecret | string | API-Secret für Ihren S3-Endpunkt |
| —s3-endpoint | string | URL des 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 | Eigener Pfad für den privaten Signierungsschlüssel (v2-System) |
| —key-data-v2 | string | Privater Signierungsschlüssel (v2-System) |
| —bundle-url | boolean | Gibt die Bundle-URL in die Standardausgabe aus |
| —no-key | boolean | Signierungsschlüssel ignorieren und klare Update senden |
| —no-code-check | boolean | Ignoriert die Prüfung, ob notifyAppReady() in der Quelle code aufgerufen wird und index im Root-Ordner vorhanden ist |
| —display-iv-session | boolean | IV und Session-Schlüssel anzeigen, die zur Verschlüsselung des Updates verwendet werden |
| -b | string | Versionsnummer des Bundles, das hochgeladen werden soll |
| —auto-bump | string | Automatisch erhöhen vom mit dem Channel verknüpften Bundle, andernfalls von der letzten Remote-App-Version. Level: major, minor (Standard), patch (Alias fix), metadata oder ai (Workers AI leitet das Level aus dem Delta-Manifest lokal vs. vorher ab; fällt auf patch zurück, wenn keine vorherige Capgo-Version existiert). Erhöht, bis ein freier Name gefunden wird (gelöschte Namen bleiben belegt). Kann nicht mit —bundle (-b) kombiniert werden |
| —link | string | Link zu externer Ressource (z. B. GitHub-Release) |
| —comment | string | Kommentar zu dieser Version, z. B. Release Notes, Commit-Hash, Commit-Message usw. |
| —min-update-version | string | Minimale Version, die erforderlich ist, um auf diese Version zu updaten. Wird nur verwendet, wenn im Channel 'disable auto update' auf 'metadata' gesetzt ist. |
| —auto-min-update-version | boolean | Legt die minimale Update-Version anhand der Native Packages fest. |
| —ignore-metadata-check | boolean | Ignoriert den Metadata-Check (node_modules) beim Upload. |
| —fail-on-incompatible | boolean | Lässt den Upload fehlschlagen (Exit-Code ungleich Null), statt ihn durchzuführen, wenn das Bundle nicht mit den aktuellen Native Packages des Channels kompatibel ist. In einem interaktiven Terminal kannst du trotzdem einen Native Build wählen; lehnst du ab, schlägt der Befehl fehl. Nicht mit —ignore-metadata-check kombinierbar. |
| —ignore-checksum-check | boolean | Ignoriert den Checksum-Check beim Upload. |
| —force-crc32-checksum | boolean | CRC32-Prüfsumme für den Upload erzwingen (automatische Erkennung überschreiben) |
| —timeout | string | Timeout für den Upload-Prozess in Sekunden |
| —multipart | boolean | [DEPRECATED] Nutze stattdessen —tus. Nutzt das Multipart-Protokoll für S3-Uploads |
| —zip | boolean | Lädt das Bundle per ZIP in die Capgo Cloud hoch (Legacy) |
| —tus | boolean | Lädt das Bundle via TUS in die Capgo Cloud hoch |
| —tus-chunk-size | string | Chunk-Größe in Bytes für TUS-Resumable-Uploads (Standard: auto) |
| —partial | boolean | [VERALTET] Verwenden Sie stattdessen —delta. Lädt inkrementelle Updates hoch |
| —partial-only | boolean | [VERALTET] Verwenden Sie stattdessen —delta-only. Lädt nur inkrementelle Updates hoch, überspringt das vollständige Bundle |
| —delta | boolean | Lädt Delta-Updates (nur geänderte Dateien) für sofortige, ultraschnelle Updates statt großer Zip-Downloads hoch |
| —delta-only | boolean | Lädt nur Delta-Updates ohne vollständiges Bundle für maximale Geschwindigkeit hoch (nützlich für große Apps) |
| —no-delta | boolean | Deaktiviert Delta-Updates, auch wenn Sofort-Updates aktiviert sind |
| —encrypted-checksum | string | Ein verschlüsselter Prüfsummenwert (Signatur). Wird nur beim Upload eines externen Bundles verwendet. |
| —auto-set-bundle | boolean | Bundle in capacitor.config.json festlegen |
| —dry-upload | boolean | Bundle-Upload simulieren: Zeile in der Datenbank hinzufügen, ohne Dateien hochzuladen oder Channels zu aktualisieren (wird von Capgo für interne Tests verwendet) |
| —package-json | string | Pfade zu package.json-Dateien für Monorepos (kommagetrennt) |
| —node-modules | string | Pfade zu node_modules-Verzeichnissen für Monorepos (kommagetrennt) |
| —encrypt-partial | boolean | Delta-Update-Dateien verschlüsseln (automatisch aktiviert für Updater > 6.14.4) |
| —delete-linked-bundle-on-upload | boolean | Findet das aktuell verknüpfte Bundle im Kanal, in den hochgeladen werden soll, und löscht es |
| —no-brotli-patterns | string | Dateien, die von der Brotli-Komprimierung ausgeschlossen werden sollen (kommagetrennte Globs, z. B. „.jpg,.png“) |
| —disable-brotli | boolean | Brotli-Komprimierung komplett deaktivieren, auch wenn die Updater-Version dies 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 | Geräten erlauben, diesem Channel automatisch beizutreten (aktualisiert die Channel-Einstellung) |
| —qr-preview | boolean | Nach dem Upload einen Terminal-QR code für diese Bundle-Vorschau ausgeben |
| —send-update-notification | boolean | Sendet eine native Update-Check-Benachrichtigung an Geräte, nachdem die Bundles des verknüpften Kanals aktualisiert wurden |
| —supa-host | string | Eigene Supabase-Host-URL (für Self-Hosting oder Capgo-Entwicklung) |
| —supa-anon | string | Eigener Supabase-Anon-Key (für Self-Hosting) |
| —verbose | boolean | Aktiviert ausführliche Ausgabe mit detaillierten Logs |
🧪 Kompatibilität
Abschnitt mit dem Titel „ 🧪 Kompatibilität“npx @capgo/cli@latest bundle compatibility🧪 Prüfe die Kompatibilität eines Bundles mit einem bestimmten Channel in der Capgo Cloud, um sichere Updates zu gewährleisten.
Beispiel:
npx @capgo/cli@latest bundle compatibility com.example.app --channel productionOptionen:
| Parameter | Typ | Beschreibung |
|---|---|---|
| -a | string | API Key zum Verknüpfen mit deinem Account |
| -c | string | Channel, mit dem die Kompatibilität geprüft werden soll |
| —text | boolean | Text-Ausgabe statt Emojis |
| —package-json | string | Pfade zu package.json-Dateien für Monorepos (kommagetrennt) |
| —node-modules | string | Pfade zu node_modules-Verzeichnissen für Monorepos (kommagetrennt) |
| —supa-host | string | Eigene Supabase-Host-URL (für Self-Hosting oder Capgo-Entwicklung) |
| —supa-anon | string | Eigener Supabase-Anon-Key (für Self-Hosting) |
🔹 ReleaseType
Abschnitt mit dem Titel „ 🔹 ReleaseType“npx @capgo/cli@latest bundle releaseType🧭 Gibt „native“ oder „OTA“ basierend auf der Kompatibilität mit den neuesten Metadaten eines Kanals aus.
Beispiel:
npx @capgo/cli@latest bundle releaseType com.example.app --channel productionOptionen:
| Parameter | Typ | Beschreibung |
|---|---|---|
| -a | string | API Key zum Verknüpfen mit deinem Account |
| -c | string | Zu vergleichender Channel |
| —package-json | string | Pfade zu package.json-Dateien für Monorepos (kommagetrennt) |
| —node-modules | string | Pfade zu node_modules-Verzeichnissen für Monorepos (kommagetrennt) |
| —supa-host | string | Eigene Supabase-Host-URL (für Self-Hosting oder Capgo-Entwicklung) |
| —supa-anon | string | Eigener Supabase-Anon-Key (für Self-Hosting) |
🗑️ Löschen
Abschnitt mit dem Titel „ 🗑️ Löschen“Alias: d
npx @capgo/cli@latest bundle delete🗑️ Löscht ein bestimmtes Bundle aus Capgo Cloud, optional für eine einzelne Version.
Beispiel:
npx @capgo/cli@latest bundle delete BUNDLE_ID com.example.appOptionen:
| Parameter | Typ | Beschreibung |
|---|---|---|
| -a | string | API Key zum Verknüpfen mit deinem Account |
| —supa-host | string | Eigene Supabase-Host-URL (für Self-Hosting oder Capgo-Entwicklung) |
| —supa-anon | string | Eigener Supabase-Anon-Key (für Self-Hosting) |
Alias: l
npx @capgo/cli@latest bundle list📋 Alle für eine App in Capgo Cloud hochgeladenen Bundles auflisten.
Beispiel:
npx @capgo/cli@latest bundle list com.example.appOptionen:
| Parameter | Typ | Beschreibung |
|---|---|---|
| -a | string | API Key zum Verknüpfen mit deinem Account |
| —supa-host | string | Eigene Supabase-Host-URL (für Self-Hosting oder Capgo-Entwicklung) |
| —supa-anon | string | Eigener Supabase-Anon-Key (für Self-Hosting) |
🧹 Aufräumen
Abschnitt mit dem Titel „🧹 Cleanup“Alias: c
npx @capgo/cli@latest bundle cleanup🧹 Alte Bundles in Capgo Cloud löschen, dabei die angegebene Anzahl an letzten Versionen beibehalten. An Kanäle verknüpfte Bundles bleiben erhalten, es sei denn, es wird —ignore-channel verwendet.
Beispiel:
npx @capgo/cli@latest bundle cleanup com.example.app --bundle=1.0 --keep=3Optionen:
| Parameter | Typ | Beschreibung |
|---|---|---|
| -b | string | Bundle-Version der App, die gelöscht werden soll |
| -a | string | API Key zum Verknüpfen mit deinem Account |
| -k | string | Anzahl der Versionen, die behalten werden sollen |
| -f | boolean | Erzwungene Löschung |
| —ignore-channel | boolean | Bundles löschen, auch wenn sie mit Channels verknüpft sind (WARNUNG: löscht auch die Channels) |
| —supa-host | string | Eigene Supabase-Host-URL (für Self-Hosting oder Capgo-Entwicklung) |
| —supa-anon | string | Eigener Supabase-Anon-Key (für Self-Hosting) |
🔒 Verschlüsseln
Abschnitt mit dem Titel „ 🔒 Encrypt“npx @capgo/cli@latest bundle encrypt🔒 Verschlüsselt ein zip-Bundle für die sichere externe Speicherung. Gibt ivSessionKey für Upload/Entschlüsselung zurück. Prüfwert mit ‘bundle zip —json’ abrufen.
Beispiel:
npx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUMOptionen:
| Parameter | Typ | Beschreibung |
|---|---|---|
| —key | string | Eigener Pfad für den privaten Signierungsschlüssel |
| —key-data | string | Privater Signing-Key |
| -j | boolean | Ausgabe als JSON |
| —package-json | string | Pfade zu package.json-Dateien für Monorepos (kommagetrennt) |
🔓 Entschlüsseln
Abschnitt mit dem Titel „ 🔓 Entschlüsseln“npx @capgo/cli@latest bundle decrypt🔓 Entschlüsselt ein verschlüsseltes Bundle (hauptsächlich für Tests). Gibt den base64-Session-Key zur Überprüfung aus.
Beispiel:
npx @capgo/cli@latest bundle decrypt ./myapp_encrypted.zip CHECKSUMOptionen:
| Parameter | Typ | Beschreibung |
|---|---|---|
| —key | string | Eigener Pfad für den privaten Signierungsschlüssel |
| —key-data | string | Privater Signing-Key |
| —checksum | string | Prüfsumme des Bundles zur Überprüfung der Integrität des Bundles |
| —package-json | string | Pfade zu package.json-Dateien für Monorepos (kommagetrennt) |
npx @capgo/cli@latest bundle zip🗜️ Erstellen Sie eine Zip-Datei Ihres App-Bundles. Gibt eine Checksumme für die Verwendung mit Verschlüsselung zurück. Verwenden Sie —json für maschinenlesbare Ausgabe.
Beispiel:
npx @capgo/cli@latest bundle zip com.example.app --path ./distOptionen:
| Parameter | Typ | Beschreibung |
|---|---|---|
| -p | string | Pfad des Ordners für den Upload; falls nicht angegeben, wird der in capacitor.config festgelegte webDir verwendet |
| -b | string | Bundle-Versionsnummer für den Namen der Zip-Datei |
| -n | string | Name der Zip-Datei |
| -j | boolean | Ausgabe als JSON |
| —no-code-check | boolean | Ignoriert die Prüfung, ob notifyAppReady() in der Quelle code aufgerufen wird 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 (kommagetrennt) |