Zum Inhalt springen

📦 Bundle

📦 Verwalte App-Bundles für den Deployment in Capgo Cloud, einschließlich Upload, Kompatibilitätsprüfungen und Verschlüsselung.

Alias: u

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

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

Erhö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:

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

ParameterTypBeschreibung
-astringAPI Key zum Verknüpfen mit deinem Account
-pstringPfad des Ordners für den Upload; falls nicht angegeben, wird der in capacitor.config festgelegte webDir verwendet
-cstringChannel, mit dem verknüpft werden soll. Mehrere Channels durch Kommas trennen, z. B. production,beta
—rolloutstringDas hochgeladene Bundle als Rollout-Ziel dieses Channels mit einem Prozentsatz von 0 bis 100 festlegen
—stablebooleanAuf einem Channel mit Rollout-Konfiguration das stabile Fallback ersetzen, anstatt das Rollout-Ziel zu setzen
--rollout-percentage-bpsstringDen Rollout-Prozentsatz des hochgeladenen Bundles in Basispunkten von 0 bis 10000 festlegen
—rollout-cache-ttl-secondsstringCloudflare Rollout-Entscheidungs-Cache TTL in Sekunden
-estringLink zu externer URL statt Upload in Capgo Cloud
—iv-session-keystringIV und Session-Key für externe Bundle-URL festlegen
—s3-regionstringRegion für Ihren S3-Bucket
—s3-apikeystringAPI-Key für Ihren S3-Endpunkt
—s3-apisecretstringAPI-Secret für Ihren S3-Endpunkt
—s3-endpointstringURL des 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
—key-v2stringEigener Pfad für den privaten Signierungsschlüssel (v2-System)
—key-data-v2stringPrivater Signierungsschlüssel (v2-System)
—bundle-urlbooleanGibt die Bundle-URL in die Standardausgabe aus
—no-keybooleanSignierungsschlüssel ignorieren und klare Update senden
—no-code-checkbooleanIgnoriert die Prüfung, ob notifyAppReady() in der Quelle code aufgerufen wird und index im Root-Ordner vorhanden ist
—display-iv-sessionbooleanIV und Session-Schlüssel anzeigen, die zur Verschlüsselung des Updates verwendet werden
-bstringVersionsnummer des Bundles, das hochgeladen werden soll
—auto-bumpstringAutomatisch 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
—linkstringLink zu externer Ressource (z. B. GitHub-Release)
—commentstringKommentar zu dieser Version, z. B. Release Notes, Commit-Hash, Commit-Message usw.
—min-update-versionstringMinimale 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-versionbooleanLegt die minimale Update-Version anhand der Native Packages fest.
—ignore-metadata-checkbooleanIgnoriert den Metadata-Check (node_modules) beim Upload.
—fail-on-incompatiblebooleanLä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-checkbooleanIgnoriert den Checksum-Check beim Upload.
—force-crc32-checksumbooleanCRC32-Prüfsumme für den Upload erzwingen (automatische Erkennung überschreiben)
—timeoutstringTimeout für den Upload-Prozess in Sekunden
—multipartboolean[DEPRECATED] Nutze stattdessen —tus. Nutzt das Multipart-Protokoll für S3-Uploads
—zipbooleanLädt das Bundle per ZIP in die Capgo Cloud hoch (Legacy)
—tusbooleanLädt das Bundle via TUS in die Capgo Cloud hoch
—tus-chunk-sizestringChunk-Größe in Bytes für TUS-Resumable-Uploads (Standard: auto)
—partialboolean[VERALTET] Verwenden Sie stattdessen —delta. Lädt inkrementelle Updates hoch
—partial-onlyboolean[VERALTET] Verwenden Sie stattdessen —delta-only. Lädt nur inkrementelle Updates hoch, überspringt das vollständige Bundle
—deltabooleanLädt Delta-Updates (nur geänderte Dateien) für sofortige, ultraschnelle Updates statt großer Zip-Downloads hoch
—delta-onlybooleanLädt nur Delta-Updates ohne vollständiges Bundle für maximale Geschwindigkeit hoch (nützlich für große Apps)
—no-deltabooleanDeaktiviert Delta-Updates, auch wenn Sofort-Updates aktiviert sind
—encrypted-checksumstringEin verschlüsselter Prüfsummenwert (Signatur). Wird nur beim Upload eines externen Bundles verwendet.
—auto-set-bundlebooleanBundle in capacitor.config.json festlegen
—dry-uploadbooleanBundle-Upload simulieren: Zeile in der Datenbank hinzufügen, ohne Dateien hochzuladen oder Channels zu aktualisieren (wird von Capgo für interne Tests verwendet)
—package-jsonstringPfade zu package.json-Dateien für Monorepos (kommagetrennt)
—node-modulesstringPfade zu node_modules-Verzeichnissen für Monorepos (kommagetrennt)
—encrypt-partialbooleanDelta-Update-Dateien verschlüsseln (automatisch aktiviert für Updater > 6.14.4)
—delete-linked-bundle-on-uploadbooleanFindet das aktuell verknüpfte Bundle im Kanal, in den hochgeladen werden soll, und löscht es
—no-brotli-patternsstringDateien, die von der Brotli-Komprimierung ausgeschlossen werden sollen (kommagetrennte Globs, z. B. „.jpg,.png“)
—disable-brotlibooleanBrotli-Komprimierung komplett deaktivieren, auch wenn die Updater-Version dies unterstützt
—version-exists-okbooleanErfolgreich beenden, wenn die Bundle-Version bereits existiert; nützlich für CI/CD-Workflows mit Monorepos
—self-assignbooleanGeräten erlauben, diesem Channel automatisch beizutreten (aktualisiert die Channel-Einstellung)
—qr-previewbooleanNach dem Upload einen Terminal-QR code für diese Bundle-Vorschau ausgeben
—send-update-notificationbooleanSendet eine native Update-Check-Benachrichtigung an Geräte, nachdem die Bundles des verknüpften Kanals aktualisiert wurden
—supa-hoststringEigene Supabase-Host-URL (für Self-Hosting oder Capgo-Entwicklung)
—supa-anonstringEigener Supabase-Anon-Key (für Self-Hosting)
—verbosebooleanAktiviert ausführliche Ausgabe mit detaillierten Logs
Terminalfenster
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:

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

Optionen:

ParameterTypBeschreibung
-astringAPI Key zum Verknüpfen mit deinem Account
-cstringChannel, mit dem die Kompatibilität geprüft werden soll
—textbooleanText-Ausgabe statt Emojis
—package-jsonstringPfade zu package.json-Dateien für Monorepos (kommagetrennt)
—node-modulesstringPfade zu node_modules-Verzeichnissen für Monorepos (kommagetrennt)
—supa-hoststringEigene Supabase-Host-URL (für Self-Hosting oder Capgo-Entwicklung)
—supa-anonstringEigener Supabase-Anon-Key (für Self-Hosting)
Terminalfenster
npx @capgo/cli@latest bundle releaseType

🧭 Gibt „native“ oder „OTA“ basierend auf der Kompatibilität mit den neuesten Metadaten eines Kanals aus.

Beispiel:

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

Optionen:

ParameterTypBeschreibung
-astringAPI Key zum Verknüpfen mit deinem Account
-cstringZu vergleichender Channel
—package-jsonstringPfade zu package.json-Dateien für Monorepos (kommagetrennt)
—node-modulesstringPfade zu node_modules-Verzeichnissen für Monorepos (kommagetrennt)
—supa-hoststringEigene Supabase-Host-URL (für Self-Hosting oder Capgo-Entwicklung)
—supa-anonstringEigener Supabase-Anon-Key (für Self-Hosting)

Alias: d

Terminalfenster
npx @capgo/cli@latest bundle delete

🗑️ Löscht ein bestimmtes Bundle aus Capgo Cloud, optional für eine einzelne Version.

Beispiel:

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

Optionen:

ParameterTypBeschreibung
-astringAPI Key zum Verknüpfen mit deinem Account
—supa-hoststringEigene Supabase-Host-URL (für Self-Hosting oder Capgo-Entwicklung)
—supa-anonstringEigener Supabase-Anon-Key (für Self-Hosting)

Alias: l

Terminalfenster
npx @capgo/cli@latest bundle list

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

Beispiel:

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

Optionen:

ParameterTypBeschreibung
-astringAPI Key zum Verknüpfen mit deinem Account
—supa-hoststringEigene Supabase-Host-URL (für Self-Hosting oder Capgo-Entwicklung)
—supa-anonstringEigener Supabase-Anon-Key (für Self-Hosting)

Alias: c

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

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

Optionen:

ParameterTypBeschreibung
-bstringBundle-Version der App, die gelöscht werden soll
-astringAPI Key zum Verknüpfen mit deinem Account
-kstringAnzahl der Versionen, die behalten werden sollen
-fbooleanErzwungene Löschung
—ignore-channelbooleanBundles löschen, auch wenn sie mit Channels verknüpft sind (WARNUNG: löscht auch die Channels)
—supa-hoststringEigene Supabase-Host-URL (für Self-Hosting oder Capgo-Entwicklung)
—supa-anonstringEigener Supabase-Anon-Key (für Self-Hosting)
Terminalfenster
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:

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

Optionen:

ParameterTypBeschreibung
—keystringEigener Pfad für den privaten Signierungsschlüssel
—key-datastringPrivater Signing-Key
-jbooleanAusgabe als JSON
—package-jsonstringPfade zu package.json-Dateien für Monorepos (kommagetrennt)
Terminalfenster
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:

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

Optionen:

ParameterTypBeschreibung
—keystringEigener Pfad für den privaten Signierungsschlüssel
—key-datastringPrivater Signing-Key
—checksumstringPrüfsumme des Bundles zur Überprüfung der Integrität des Bundles
—package-jsonstringPfade zu package.json-Dateien für Monorepos (kommagetrennt)
Terminalfenster
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:

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

Optionen:

ParameterTypBeschreibung
-pstringPfad des Ordners für den Upload; falls nicht angegeben, wird der in capacitor.config festgelegte webDir verwendet
-bstringBundle-Versionsnummer für den Namen der Zip-Datei
-nstringName der Zip-Datei
-jbooleanAusgabe als JSON
—no-code-checkbooleanIgnoriert die Prüfung, ob notifyAppReady() in der Quelle code aufgerufen wird und index im Root-Ordner vorhanden ist
—key-v2booleanVerschlüsselung v2 verwenden
—package-jsonstringPfade zu package.json-Dateien für Monorepos (kommagetrennt)