📦 Paket
Einen Einrichtungsprompt mit den Installationsanweisungen und der vollständigen Markdown-Dokumentation für diesen Plugin kopieren.
📦 Verwalten Sie Anwendungsdateien für die Bereitstellung in Capgo Cloud, einschließlich Hochladen, Kompatibilitätsprüfungen und Verschlüsselung.
⬆️ Hochladen
Abschnitt mit dem Titel “ ⬆️ Hochladen”Alias: u
npx @capgo/cli@latest bundle upload⬆️ Hochladen Sie eine neue Anwendungsdatei 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. Externer Option: Speichern Sie nur eine 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:
npx @capgo/cli@latest bundle upload com.example.app --path ./dist --channel productionOptionen:
| Parameter | Typ | Beschreibung |
|---|---|---|
| -a, | string | API-Schlüssel zum Linken auf Ihr Konto |
| -p, | string | Pfad des Ordners zum Hochladen, wenn nicht angegeben, wird der in capacitor.config gesetzte Wert von webDir verwendet |
| -c, | string | Kanal zum Linken |
| -e, | string | Link auf externe URL anstatt Hochladen auf Capgo Cloud |
| —iv-session-key | string | Setzen Sie die IV und Sitzungsschlü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-endpoint | 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 die private Signierungsdatei (v2-System) |
| —key-data-v2 | string | Private Signierungsdatei (v2-System) |
| —bundle-url | boolean | Bundle-URL in die Konsole ausgeben |
| —no-key | boolean | Signierungsdatei ignorieren und klaren Update senden |
| —no-code-check | boolean | Überspringen der Überprüfung, ob notifyAppReady() in der Quelle code und der Index im Root-Ordner vorhanden ist |
| —display-iv-session | boolean | Zeigen Sie im Konsole die IV- und Sitzungsschlüssel an, die zum Verschlüsseln der Aktualisierung verwendet werden |
| -b, | string | Bundle-Version-Nummer des zu hochladenden Bundles |
| —link | string | Link 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 in Kanal gesetzt ist |
| —auto-min-update-version | boolean | Setze die Mindestaktualisierungsversion basierend auf native Packages |
| —ignoriere-Metadaten-Überprüfung | boolean | Ignoert die Metadatenüberprüfung (node_modules) bei der Hochladung |
| —ignoriere-Prüfsummenüberprüfung | boolean | Ignoert die Prüfsummenüberprüfung bei der Hochladung |
| —force-CRC32-Prüfsumme | boolean | Zwingt CRC32-Prüfsumme für die Hochladung (überschreibt die automatische Erkennung) |
| —Zeitlimite | string | Zeitlimite für den Hochladeprozess in Sekunden |
| —Multipart | boolean | [VERALTET] Verwende —tus stattdessen. Verwendet das Multipart-Protokoll für S3-Hochladungen |
| —Zip | boolean | Das Bundle hochladen, indem Sie es als zip-Datei zu Capgo cloud (Legacy) senden |
| —tus | boolean | Das Bundle hochladen, indem Sie es mit TUS zu Capgo cloud senden |
| —tus-chunk-size | string | Größe der Chunk in Byte für TUS-Uploads, die wiederaufgenommen werden können (Standard: Auto) |
| —partial | boolean | [VERALTET] Verwenden Sie stattdessen —delta. Aktualisierungen in kleinen Schritten hochladen |
| —partial-only | boolean | [VERALTET] Verwenden Sie stattdessen —delta-only. Nur Aktualisierungen in kleinen Schritten hochladen, vollständiges Bundle überspringen |
| —delta | boolean | Delta-Aktualisierungen (nur geänderte Dateien) für sofortige, extrem schnelle Aktualisierungen hochladen anstatt großer zip-Downloads |
| —delta-only | boolean | Uploaden Sie nur Delta-Updates ohne volle Bundle für maximale Geschwindigkeit (nützlich für große Apps) |
| —kein-Delta | boolean | Delta-Updates auch dann deaktivieren, wenn Direct Update aktiviert ist |
| —verschlüsselter-Prüfsummenwert | string | Ein verschlüsselter Prüfsummenwert (Signatur). Wird nur verwendet, wenn ein externes Bundle hochgeladen wird. |
| —bundle-automatisch-setzen | boolean | Setzen Sie das Bundle in capacitor.config.json |
| —trockene-Upload-Prozess | boolean | Trockener Upload des Bundle-Prozesses, bedeutet, dass die Dateien nicht hochgeladen werden, aber eine Zeile in der Datenbank hinzugefügt wird (Wird von Capgo für interne Tests verwendet) |
| —package-json-Pfade | string | Pfade zu package.json-Dateien für monorepos (komma-getrennt) |
| —node-modules-Pfade | string | Pfade zu node_modules-Verzeichnissen für Monorepos (getrennt durch Komma) |
| —verschlüsseln-teilweise | boolean | Verschlüsselung von Delta-Update-Dateien (automatisch aktiviert für Updater > 6.14.4) |
| —löschen-verknüpften-bundle-bei-upload | boolean | Ort des derzeit verknüpften Bundles im Kanal, in den Sie versuchen, hochzuladen, und löschen |
| —keine-brotli-muster | string | Dateien, die von der Brotli-Komprimierung ausgeschlossen werden sollen (getrennt durch Komma, z.B. ".jpg,.png") |
| —brotli-aus | boolean | Brotli-Komprimierung vollständig deaktivieren, auch wenn Updater-Version sie unterstützt |
| —version-existiert-ok | boolean | Exit erfolgreich, wenn die Bundle-Version bereits existiert, nützlich für CI/CD-Workflows mit Monorepos |
| —selbstzuweisen | boolean | Ermöglichen Sie Geräten, sich diesem Kanal automatisch anzuschließen (aktualisieren Sie den Kanal-Einstellung) |
| —supa-host | string | Benutzerdefinierte Supabase-Host-URL (für Selbsthosting oder Capgo Entwicklung) |
| —supa-anon | string | Benutzerdefinierte Supabase-Anon-Schlüssel (für Selbsthosting) |
| —verbose | boolean | Aktivieren Sie ausführliche Ausgabe mit detaillierten Protokollierungen |
🧪 Kompatibilität
Abschnitt mit dem Titel “ Kompatibilität”npx @capgo/cli@latest bundle compatibility🧪 Überprüfen Sie die Kompatibilität eines Bundles mit einer bestimmten Kanal in Capgo Cloud, um sicherzustellen, dass Updates sicher sind.
Beispiel:
npx @capgo/cli@latest bundle compatibility com.example.app --channel productionOptionen:
| Parameter | Typ | Beschreibung |
|---|---|---|
| -a, | string | API Schlüssel, um auf Ihr Konto zuzugreifen |
| -c, | string | Kanal zur Überprüfung der Kompatibilität mit |
| —text | boolean | Ausgabe von Text anstelle von Emojis |
| —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-Anon-Key (für Selbsthosting) |
🔹 ReleaseTyp
Abschnitt mit dem Titel “ 🔹 ReleaseType”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 productionOptionen:
| Parameter | Typ | Beschreibung |
|---|---|---|
| -a, | string | API Schlüssel, um auf Ihr Konto zuzugreifen |
| -c, | string | Kanal zum Vergleich |
| —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-Anon-Key (für Selbsthosting) |
🗑️ Löschen
Abschnitt mit dem Titel “ 🗑️ Löschen”Alias: d
npx @capgo/cli@latest bundle delete🗑️ Ein bestimmtes Bundle aus Capgo Cloud löschen, optional auf eine einzelne Version zielend.
Beispiel:
npx @capgo/cli@latest bundle delete BUNDLE_ID com.example.appOptionen:
| Parameter | Typ | Beschreibung |
|---|---|---|
| -a, | string | API-Schlüssel, um auf Ihr Konto zuzugreifen |
| —supa-host | string | Benutzerdefinierter Supabase-Host-URL (für Selbsthosting oder Capgo-Entwicklung) |
| —supa-anon | string | Benutzerdefinierter Supabase-Anon-Schlüssel (für Selbsthosting) |
Alias: l
npx @capgo/cli@latest bundle list📋 Liste aller für eine App hochgeladenen Pakete in Capgo Cloud anzeigen
Beispiel:
npx @capgo/cli@latest bundle list com.example.appOptionen:
| Parameter | Typ | Beschreibung |
|---|---|---|
| -a, | string | API Schlüssel, um auf Ihr Konto zuzugreifen |
| —supa-host | string | Benutzerdefinierte Supabase-Host-URL (für Selbsthosting oder Capgo Entwicklung) |
| —supa-anon | string | Benutzerdefinierte Supabase Anon-Key (für Selbstbetrieb) |
🧹 Reinigung
Abschnitt mit dem Titel “ 🧹 Reinigung”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. Bundles, die mit Kanälen verknüpft sind, werden aufbewahrt, es sei denn, —ignore-channel wird verwendet.
Beispiel:
npx @capgo/cli@latest bundle cleanup com.example.app --bundle=1.0 --keep=3Optionen:
| Parameter: | Typ | Beschreibung |
|---|---|---|
| -b, | string | Bundle-Version-Nummer der App, die gelöscht werden soll |
| -a, | string | API-Schlüssel, um auf Ihr Konto zu verlinken |
| -k, | string | Anzahl der zu behaltenden Versionen |
| -f, | string | Zwangsvorlage |
| —ignore-channel | boolean | Bundles auch dann löschen, wenn sie auf Kanäle verlinkt 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
Abschnitt mit dem Titel “ 🔒 Verschlüsseln”npx @capgo/cli@latest bundle encrypt🔒 Verschlüsselt ein Zip-Paket für sichere externe Speicherung. Gibt ivSessionKey für Upload/Verschlüsselung zurück. Rufe Checksumme mit ‘bundle zip —json’ auf.
Beispiel:
npx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUMOptionen:
| Parameter | Typ | Beschreibung |
|---|---|---|
| —Schlüssel | string | Benutzerdefinierter Pfad für den privaten Signierungs-Schlüssel |
| —Schlüsseldaten | string | Privater Signierungs-Schlüssel |
| -j, | string | Ausgabe in JSON-Format |
| —package-json | string | Pfade zu package.json-Dateien für monorepos (komma-getrennt) |
🔓 Verschlüsselung
Abschnitt mit dem Titel “ 🔓 Verschlüsselung”npx @capgo/cli@latest bundle decryptVerschlüsselung eines verschlüsselten Bundles (hauptsächlich für Tests). Druckt die Base64-Sitzungsschlüssel zur Verifizierung.
Beispiel:
npx @capgo/cli@latest bundle decrypt ./myapp_encrypted.zip CHECKSUMOptionen:
| Parameter | Typ | Beschreibung |
|---|---|---|
| —Schlüssel | string | Benutzerdefinierter Pfad für den privaten Signierungskey |
| —Schlüsseldaten | string | Privater Signierungskey |
| —Prüfsumme | string | Prüfsumme der Bundle, um die Integrität des Bundles zu überprüfen |
| —package-json | string | Pfade zu package.json-Dateien für Monorepos (komma-getrennt) |
npx @capgo/cli@latest bundle zip🗜️ Eine Zip-Datei Ihres App-Bundles erstellen. Gibt den Prüfsummenwert zurück, der zum Verschlüsseln verwendet werden kann. 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 zum Hochladen, wenn nicht angegeben, wird der in capacitor.config gesetzte Wert von webDir verwendet |
| -b, | string | Bundle-Version-Nummer, um den Namen der Zip-Datei zu bestimmen |
| -n, | string | Name des Zip-Dateis |
| -j, | string | 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 (komma-getrennt) |