📢 canal

📢 Gérez les canaux de distribution des mises à jour d’app dans Capgo Cloud et contrôlez leur livraison sur les appareils.

➕ Ajoutez

Alias : a

npx @capgo/cli@latest channel add

➕ Créez un nouveau canal de distribution d’app dans Capgo Cloud pour gérer la livraison des mises à jour.

Exemple :

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

Options :

Paramètre	Type	Description
-d	boolean	Définir le canal par défaut
—self-assign	boolean	Autoriser l’appareil à s’auto-attribuer à ce canal
-a	string	Clé API pour lier votre compte
—supa-host	string	URL d'hôte Supabase personnalisée (pour l'auto-hébergement ou le développement Capgo)
—supa-anon	string	Clé anon Supabase personnalisée (pour l'auto-hébergement)

🗑️ Supprimer

Alias : d

npx @capgo/cli@latest channel delete

🗑️ Supprimer un canal de Capgo Cloud, avec l'option de retirer les bundles associés pour libérer des ressources.

Exemple :

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

Options :

Paramètre	Type	Description
-a	string	Clé API pour lier votre compte
—delete-bundle	boolean	Supprime le bundle associé au canal. Une clé App Preview peut supprimer de façon atomique uniquement son propre canal de preview et le bundle lié non partagé.
—success-if-not-found	boolean	Succès si le canal est introuvable
—supa-host	string	URL d'hôte Supabase personnalisée (pour l'auto-hébergement ou le développement Capgo)
—supa-anon	string	Clé anon Supabase personnalisée (pour l'auto-hébergement)

Attention

Use an organization- and app-bound Aperçu de l'app clé API avec --delete-bundle uniquement pour un canal de préversion de PR non public. La commande utilise une route de nettoyage atomique restreinte : elle ne réussit que pour le canal et le bundle lié et non partagé que cette clé a créés. La clé ne peut pas l'utiliser sur un canal par défaut/main existant, sur le canal d'une autre clé de préversion ni sur le bundle d'une autre clé, et elle ne reçoit toujours pas d'accès général bundle.delete. Voir Clés API for setup.

📋 Liste

Alias : l

npx @capgo/cli@latest channel list

📋 Liste tous les canaux configurés pour une app dans Capgo Cloud afin de vérifier les paramètres de distribution.

Exemple :

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

Options :

Paramètre	Type	Description
-a	string	Clé API pour lier votre compte
—supa-host	string	URL d'hôte Supabase personnalisée (pour l'auto-hébergement ou le développement Capgo)
—supa-anon	string	Clé anon Supabase personnalisée (pour l'auto-hébergement)

📦 CurrentBundle

npx @capgo/cli@latest channel currentBundle

📦 Récupérez le bundle actuel lié à un canal donné dans Capgo Cloud pour le suivi des mises à jour.

Exemple :

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

Options :

Paramètre	Type	Description
-c	string	Canal d'où récupérer le bundle actuel
-a	string	Clé API pour lier votre compte
—quiet	boolean	Affiche uniquement la version du bundle
—supa-host	string	URL d'hôte Supabase personnalisée (pour l'auto-hébergement ou le développement Capgo)
—supa-anon	string	Clé anon Supabase personnalisée (pour l'auto-hébergement)

⚙️ Définissez

Alias : s

npx @capgo/cli@latest channel set

⚙️ Configurez les paramètres d'un canal, par exemple associer un bundle, définir les stratégies de mise à jour (major, minor, metadata, patch, none) ou cibler des appareils (iOS, Android, dev, prod, emulator, device). Un canal doit être défini par défaut.

Exemple :

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

Options :

Paramètre	Type	Description
-a	string	Clé API pour lier votre compte
-b	string	Numéro de version du bundle du fichier à définir
-s	string	Définir l'état du canal : default ou normal
—latest-remote	boolean	Récupérer le dernier bundle envoyé dans le cloud capgo et l'appliquer au canal
—latest	boolean	Récupérer la clé de version la plus récente dans package.json pour l'appliquer au canal
—downgrade	boolean	Allow to downgrade to version under native one
—no-downgrade	boolean	Disable downgrade to version under native one
—ios	boolean	Allow sending update to iOS devices
—no-ios	boolean	Désactiver l’envoi de la mise à jour aux appareils iOS
—android	boolean	Allow sending update to Android devices
—no-android	boolean	Désactiver l’envoi de la mise à jour aux appareils Android
—self-assign	boolean	Autoriser l’appareil à s’auto-attribuer à ce canal
—no-self-assign	boolean	Désactiver l’auto-attribution des appareils à ce canal
—disable-auto-update	string	Bloquer les mises à jour par type : major, minor, metadata, patch ou none (autorise tout)
—update-package	string	Servir zip, delta ou les deux : all, zip, delta, zip_from_builtin ou delta_from_builtin
—rollout-bundle	string	Version du bundle à déployer progressivement sur ce canal
—rollout-percentage	string	Pourcentage de déploiement progressif de 0 à 100
—rollout-percentage-bps	string	Pourcentage de déploiement progressif en points de base, de 0 à 10000
—rollout-enable	boolean	Activer le déploiement progressif configuré
—rollout-disable	boolean	Désactiver le déploiement progressif configuré
—rollout-pause	boolean	Pause rollout exposure without rolling back selected devices
—rollout-resume	boolean	Reprendre un déploiement progressif en pause
—rollout-rollback	boolean	Clear rollout state and return devices to stable
—rollout-promote	boolean	Promote rollout target to stable and clear rollout state
—rollout-cache-ttl-seconds	string	Cloudflare TTL en secondes du cache de décisions de rollout
—auto-pause-enabled	boolean	Activer la politique de pause automatique du déploiement progressif
—auto-pause-disabled	boolean	Disable rollout auto-pause policy
—auto-pause-window-minutes	string	Stats window for rollout auto-pause
—auto-pause-failure-rate-bps	string	Seuil de taux d’échec en points de base
—auto-pause-confidence	string	Niveau de confiance entre 0 et 1
—auto-pause-min-attempts	string	Nombre minimum d’installations et d’échecs avant le déclenchement de la pause automatique
—auto-pause-min-failures	string	Échecs minimum avant déclenchement de la pause automatique
—auto-pause-action	string	Action d’auto-pause : pause, rollback ou notification
—auto-pause-cooldown-minutes	string	Délai avant que l'auto-pause puisse se redéclencher
—dev	boolean	Autoriser l'envoi de mises à jour aux appareils dev
—no-dev	boolean	Désactiver l'envoi de mises à jour aux appareils dev
—prod	boolean	Autoriser l'envoi de mises à jour aux appareils prod
—no-prod	boolean	Désactiver l'envoi de mises à jour aux appareils prod
—emulator	boolean	Autoriser l'envoi de mises à jour aux émulateurs
—no-emulator	boolean	Désactiver l’envoi de la mise à jour aux émulateurs
—device	boolean	Autoriser l’envoi de la mise à jour aux appareils physiques
—no-device	boolean	Désactiver l’envoi de la mise à jour aux appareils physiques
—qr-preview	boolean	Affiche un QR code terminal code pour l’aperçu de ce canal après sa mise à jour
—send-update-notification	boolean	Envoyer une notification native de vérification de mise à jour aux appareils après la mise à jour du bundle du canal lié
—package-json	string	Chemins des fichiers package.json pour les monorepos (séparés par des virgules)
—ignore-metadata-check	boolean	Ignorer la vérification de compatibilité de node_modules si présent dans le bundle
—supa-host	string	URL d'hôte Supabase personnalisée (pour l'auto-hébergement ou le développement Capgo)
—supa-anon	string	Clé anon Supabase personnalisée (pour l'auto-hébergement)