📢 Channel

📢 Verwalte Distribution Channels für App-Updates in der Capgo Cloud und steuere, wie Updates auf Geräte ausgeliefert werden.

➕ Füge

Alias: a

npx @capgo/cli@latest channel add

➕ Erstelle einen neuen Channel für die App-Distribution in der Capgo Cloud, um die Update-Auslieferung zu steuern.

Beispiel:

npx @capgo/cli@latest channel add production com.example.app --default

Optionen:

Parameter	Typ	Beschreibung
-d	boolean	Channel als Standard festlegen
—self-assign	boolean	Gerät darf sich selbst diesem Channel zuweisen
-a	string	API Key zur Verknüpfung 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)

🗑️ Löschen

Alias: d

npx @capgo/cli@latest channel delete

🗑️ Löscht einen Channel aus der Capgo Cloud und entfernt optional zugehörige Bundles, um Ressourcen freizugeben.

Beispiel:

npx @capgo/cli@latest channel delete production com.example.app

Optionen:

Parameter	Typ	Beschreibung
-a	string	API Key zur Verknüpfung mit deinem Account
—delete-bundle	boolean	Löscht das mit dem Channel verknüpfte Bundle. Ein App Preview Key kann atomar nur seinen eigenen Preview-Channel und das verknüpfte, nicht geteilte Bundle löschen.
—success-if-not-found	boolean	Erfolg, falls der Channel nicht gefunden wird
—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)

Achtung

Verwenden Sie eine organisations- und app-gebundene App-Vorschau API Key mit --delete-bundle nur für einen nicht öffentlichen PR-Preview-Channel. Der Befehl nutzt eine strikte atomare Cleanup-Route: Er ist nur für den Channel und das verknüpfte, nicht geteilte Bundle erfolgreich, das dieser Key erstellt hat. Der Key kann ihn nicht für einen bestehenden Default/Main-Channel, den Channel eines anderen Preview-Keys oder das Bundle eines anderen Keys nutzen und erhält auch keinen allgemeinen bundle.delete. Siehe API Keys für das Setup.

📋 Liste

Alias: l

npx @capgo/cli@latest channel list

📋 Listet alle für eine App in der Capgo Cloud konfigurierten Channels auf, um die Distribution-Einstellungen zu prüfen.

Beispiel:

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

Optionen:

Parameter	Typ	Beschreibung
-a	string	API Key zur Verknüpfung 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)

📦 CurrentBundle

npx @capgo/cli@latest channel currentBundle

📦 Rufe das aktuelle Bundle ab, das mit einem bestimmten Channel in der Capgo Cloud verknüpft ist, um Updates zu tracken.

Beispiel:

npx @capgo/cli@latest channel currentBundle production com.example.app

Optionen:

Parameter	Typ	Beschreibung
-c	string	Channel, um das aktuelle Bundle abzurufen
-a	string	API Key zur Verknüpfung mit deinem Account
—quiet	boolean	Nur die Bundle-Version ausgeben
—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)

⚙️ Setze

Alias: s

npx @capgo/cli@latest channel set

⚙️ Konfiguriert Einstellungen für einen Channel, wie z. B. das Verknüpfen eines Bundles, das Festlegen von Update-Strategien (major, minor, metadata, patch, none) oder das Device-Targeting (iOS, Android, dev, prod, emulator, device). Ein Channel muss als Default gesetzt sein.

Beispiel:

npx @capgo/cli@latest channel set production com.example.app --bundle 1.0.0 --state default

Optionen:

Parameter	Typ	Beschreibung
-a	string	API Key zur Verknüpfung mit deinem Account
-b	string	Bundle-Versionsnummer der Datei, die gesetzt werden soll
-s	string	Status des Channels festlegen (default oder normal)
—latest-remote	boolean	Das neueste in der capgo Cloud hochgeladene Bundle abrufen und dem Channel zuweisen
—latest	boolean	Den neuesten Version-Key aus der package.json abrufen und dem Channel zuweisen
—downgrade	boolean	Allow to downgrade to version under native one
—no-downgrade	boolean	Disable downgrade to version under native one
—ios	boolean	Ermöglicht das Senden von Updates an iOS-Geräte
—no-ios	boolean	Deaktiviert das Senden von Updates an iOS-Geräte
—android	boolean	Erlauben, Updates an Android-Geräte zu senden
—no-android	boolean	Senden von Updates an Android-Geräte deaktivieren
—self-assign	boolean	Geräten erlauben, sich selbst diesem Channel zuzuweisen
—no-self-assign	boolean	Selbstzuweisung von Geräten zu diesem Channel deaktivieren
—disable-auto-update	string	Updates nach Typ blockieren: major, minor, metadata, patch oder none (erlaubt alle)
—update-package	string	zip, delta oder beides bereitstellen: all, zip, delta, zip_from_builtin oder delta_from_builtin
—rollout-bundle	string	Bundle-Version, die auf diesem Channel schrittweise veröffentlicht wird
—rollout-percentage	string	Rollout-Prozentsatz von 0 bis 100
—rollout-percentage-bps	string	Rollout-Prozentsatz in Basispunkten von 0 bis 10000
—rollout-enable	boolean	Konfigurierten Rollout aktivieren
—rollout-disable	boolean	Konfigurierten Rollout deaktivieren
—rollout-pause	boolean	Rollout pausieren, ohne ausgewählte Geräte zurückzurollen
—rollout-resume	boolean	Pausierten Rollout fortsetzen
—rollout-rollback	boolean	Rollout-Status zurücksetzen und Geräte auf stable setzen
—rollout-promote	boolean	Rollout-Target auf stable befördern und Status zurücksetzen
—rollout-cache-ttl-seconds	string	TTL für den Cloudflare Rollout-Entscheidungs-Cache in Sekunden
—auto-pause-enabled	boolean	Rollout Auto-Pause Policy aktivieren
—auto-pause-disabled	boolean	Rollout Auto-Pause Policy deaktivieren
—auto-pause-window-minutes	string	Stats-Fenster für Rollout Auto-Pause
—auto-pause-failure-rate-bps	string	Fehlerrate-Schwellenwert in Basispunkten
—auto-pause-confidence	string	Konfidenzniveau zwischen 0 und 1
—auto-pause-min-attempts	string	Minimale Installationen plus Fehlversuche vor Auto-Pause
—auto-pause-min-failures	string	Maximale Fehlversuche vor Auto-Pause
—auto-pause-action	string	Auto-Pause Aktion: pause, rollback oder notify
—auto-pause-cooldown-minutes	string	Cooldown vor erneutem Auto-Pause
—dev	boolean	Updates an Entwicklungsgeräte senden erlauben
—no-dev	boolean	Updates an Dev-Geräte deaktivieren
—prod	boolean	Updates an Prod-Geräte erlauben
—no-prod	boolean	Updates an Prod-Geräte deaktivieren
—emulator	boolean	Updates an Emulatoren erlauben
—no-emulator	boolean	Updates an Emulator-Geräte nicht senden
—device	boolean	Updates an physische Geräte senden
—no-device	boolean	Updates an physische Geräte nicht senden
—qr-preview	boolean	Nach dem Update wird ein Terminal-QR-Code code für die Channel-Vorschau ausgegeben
—send-update-notification	boolean	Nach dem Update des verknüpften Channel-Bundles eine native Benachrichtigung zur Update-Prüfung senden
—package-json	string	Pfade zu package.json-Dateien für Monorepos (kommagetrennt)
—ignore-metadata-check	boolean	Prüfung der node_modules-Kompatibilität ignorieren, falls im Bundle vorhanden
—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)