📢 Channel

📢 Verwalte die Verteilungskanäle für App-Updates in Capgo Cloud und steuere, wie Updates auf Geräte ausgeliefert werden.

➕ Füge

Alias: a

npx @capgo/cli@latest channel add

➕ Erstellen Sie einen neuen Channel für die App-Verteilung in Capgo Cloud, um die Update-Auslieferung zu verwalten.

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äten erlauben, sich diesem Channel zuzuordnen
-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)

🗑️ Löschen

Alias: d

npx @capgo/cli@latest channel delete

🗑️ Lösche einen Channel aus der Capgo Cloud und entferne 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 zum Verknüpfen mit deinem Account
—delete-bundle	boolean	Löscht das Bundle, das mit dem Channel verknüpft ist. Ein App-Preview-Key kann nur seinen eigenen Preview-Channel und das zugehörige, nicht geteilte Bundle atomar löschen.
—success-if-not-found	boolean	Erfolg, wenn 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

Verwendung eines an Organisation und App gebundenen App-Vorschau API-Key mit --delete-bundle nur für einen nicht öffentlichen PR-Preview-Channel. Der Befehl nutzt eine eng gefasste 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 sie nicht für einen bestehenden Default-/Main-Channel, den Channel eines anderen Preview-Keys oder das Bundle eines anderen Keys verwenden und erhält weiterhin keine allgemeinen bundle.delete. Siehe API Schlüssel für das Setup.

📋 Liste

Alias: l

npx @capgo/cli@latest channel list

📋 Alle für eine App in Capgo Cloud konfigurierten Channels auflisten, um die Verteilungseinstellungen zu überprüfen.

Beispiel:

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

Optionen:

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)

📦 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, von dem das aktuelle Bundle geholt wird
-a	string	API Key zum Verknüpfen 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)

⚙️ Setzen Sie

Alias: s

npx @capgo/cli@latest channel set

⚙️ Konfiguriere 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 zum Verknüpfen 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 in der package.json abrufen und dem Channel zuweisen
—downgrade	boolean	Ermöglicht das Downgraden auf eine Version unter der nativen Version
—no-downgrade	boolean	Downgrade auf eine Version unter der nativen Version deaktivieren
—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	Erlaubt das Senden von Updates an Android-Geräte
—no-android	boolean	Deaktiviert das Senden von Updates an Android-Geräte
—self-assign	boolean	Erlaubt Geräten, sich diesem Channel zuzuordnen
—no-self-assign	boolean	Deaktiviert die Selbstzuordnung von Geräten zu diesem Channel
—disable-auto-update	string	Blockiert Updates nach Typ: 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 ausgerollt 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 löschen und Geräte auf stable zurücksetzen
—rollout-promote	boolean	Rollout-Target auf stable promoten und Rollout-Status löschen
—rollout-cache-ttl-seconds	string	Cloudflare Rollout-Entscheidungs-Cache TTL 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	Fehlerraten-Schwellenwert in Basispunkten
—auto-pause-confidence	string	Konfidenzniveau zwischen 0 und 1
—auto-pause-min-attempts	string	Mindestanzahl an Installations- und Fehlversuchen, bevor Auto-Pause ausgelöst werden kann
—auto-pause-min-failures	string	Mindestanzahl an Fehlern, bevor Auto-Pause ausgelöst werden kann
—auto-pause-action	string	Auto-Pause-Aktion: pause, rollback oder notify
—auto-pause-cooldown-minutes	string	Cooldown, bevor Auto-Pause erneut ausgelöst werden kann
—dev	boolean	Update an Dev-Geräte senden erlauben
—no-dev	boolean	Update an Dev-Geräte senden deaktivieren
—prod	boolean	Update an Prod-Geräte senden erlauben
—no-prod	boolean	Update an Prod-Geräte senden deaktivieren
—emulator	boolean	Update an Emulator-Geräte senden erlauben
—no-emulator	boolean	Senden von Updates an Emulator-Geräte deaktivieren
—device	boolean	Senden von Updates an physische Geräte erlauben
—no-device	boolean	Senden von Updates an physische Geräte deaktivieren
—qr-preview	boolean	Terminal-QR code für diese Channel-Vorschau nach deren Aktualisierung ausgeben
—send-update-notification	boolean	Native Update-Check-Benachrichtigung an Geräte senden, nachdem das verknüpfte Channel-Bundle aktualisiert wurde
—package-json	string	Pfade zu package.json-Dateien für Monorepos (kommagetrennt)
—ignore-metadata-check	boolean	Kompatibilitätsprüfung von node_modules 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)