📢 canal

📢 Gestiona los canales de distribución para las actualizaciones de tu app en Capgo Cloud, controlando cómo se entregan a los dispositivos.

➕ Añadir

Alias: a

npx @capgo/cli@latest channel add

➕ Crea un nuevo canal de distribución en Capgo Cloud para gestionar la entrega de actualizaciones.

Ejemplo:

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

Opciones:

Parámetro	Tipo	Descripción
-d	boolean	Establecer el canal como predeterminado
—self-assign	boolean	Permitir que el dispositivo se asigne a este canal
-a	string	clave API para vincular a tu cuenta
—supa-host	string	URL del host de Supabase personalizada (para self-hosting o desarrollo con Capgo)
—supa-anon	string	Clave anon personalizada de Supabase (para self-hosting)

🗑️ Eliminar

Alias: d

npx @capgo/cli@latest channel delete

🗑️ Elimina un canal de Capgo Cloud, con la opción de borrar los bundles asociados para liberar recursos.

Ejemplo:

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

Opciones:

Parámetro	Tipo	Descripción
-a	string	clave API para vincular a tu cuenta
—delete-bundle	boolean	Elimina el bundle asociado al canal. Una App Preview key solo puede borrar de forma atómica su propio canal de preview y su bundle vinculado no compartido.
—success-if-not-found	boolean	Devuelve éxito si el canal no se encuentra
—supa-host	string	URL del host de Supabase personalizada (para self-hosting o desarrollo con Capgo)
—supa-anon	string	Clave anon personalizada de Supabase (para self-hosting)

Precaución

Usa uno vinculado a la organización y la app Preview de app API; úsala solo --delete-bundle para un canal de preview de PR no público. El comando usa una ruta de limpieza atómica y acotada: solo funciona para el canal y el bundle vinculado y no compartido que creó esa clave. La clave no puede usarlo en un canal default/main existente, en el canal de otra clave de preview ni en el bundle de otra clave, y sigue sin tener acceso general bundle.delete. Claves de API for setup.

📋 Listar

Alias: l

npx @capgo/cli@latest channel list

📋 Lista todos los canales configurados para una app en Capgo Cloud para revisar la configuración de distribución.

Ejemplo:

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

Opciones:

Parámetro	Tipo	Descripción
-a	string	clave API para vincular a tu cuenta
—supa-host	string	URL del host de Supabase personalizada (para self-hosting o desarrollo con Capgo)
—supa-anon	string	Clave anon personalizada de Supabase (para self-hosting)

📦 CurrentBundle

npx @capgo/cli@latest channel currentBundle

📦 Obtén el bundle actual vinculado a un canal específico en Capgo Cloud para el seguimiento de actualizaciones.

Ejemplo:

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

Opciones:

Parámetro	Tipo	Descripción
-c	string	Canal para obtener el bundle actual
-a	string	clave API para vincular a tu cuenta
—quiet	boolean	Solo imprime la versión del bundle
—supa-host	string	URL del host de Supabase personalizada (para self-hosting o desarrollo con Capgo)
—supa-anon	string	Clave anon personalizada de Supabase (para self-hosting)

⚙️ Configurar

Alias: s

npx @capgo/cli@latest channel set

⚙️ Configura los ajustes de un channel, como vincular un bundle, definir estrategias de update (major, minor, metadata, patch, none) o el targeting de dispositivos (iOS, Android, dev, prod, emulator, device). Un channel debe ser el default.

Ejemplo:

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

Opciones:

Parámetro	Tipo	Descripción
-a	string	clave API para vincular a tu cuenta
-b	string	Número de versión del bundle a establecer
-s	string	Establece el estado del channel, default o normal
—latest-remote	boolean	Obtiene el último bundle subido a la nube de capgo y lo asigna al channel
—latest	boolean	Obtén la última clave de versión en el package.json para establecerla en el channel
—downgrade	boolean	Permite hacer downgrade a una versión inferior a la nativa
—no-downgrade	boolean	Desactiva el downgrade a una versión inferior a la nativa
—ios	boolean	Permite enviar actualizaciones a dispositivos iOS
—no-ios	boolean	Desactiva el envío de updates a dispositivos iOS
—android	boolean	Permite enviar actualizaciones a dispositivos Android
—no-android	boolean	Desactiva el envío de actualizaciones a dispositivos Android
—self-assign	boolean	Permite que el dispositivo se asigne a este canal
—no-self-assign	boolean	Impide que los dispositivos se asignen a este canal
—disable-auto-update	string	Bloquea actualizaciones por tipo: major, minor, metadata, patch, o none (permite todas)
—update-package	string	Sirve zip, delta, o ambos: all, zip, delta, zip_from_builtin, o delta_from_builtin
—rollout-bundle	string	Versión del bundle para el despliegue gradual en este canal
—rollout-percentage	string	Porcentaje de rollout de 0 a 100
—rollout-percentage-bps	string	Porcentaje de rollout en puntos básicos de 0 a 10000
—rollout-enable	boolean	Habilitar el rollout configurado
—rollout-disable	boolean	Deshabilitar el rollout configurado
—rollout-pause	boolean	Pausar la exposición del rollout sin revertir los dispositivos seleccionados
—rollout-resume	boolean	Reanuda un rollout pausado
—rollout-rollback	boolean	Limpia el estado del rollout y vuelve a stable
—rollout-promote	boolean	Promociona el target del rollout a stable y limpia su estado
—rollout-cache-ttl-seconds	string	TTL de la caché de decisiones de Cloudflare en segundos
—auto-pause-enabled	boolean	Activa la política de auto-pause del rollout
—auto-pause-disabled	boolean	Desactiva la política de auto-pause del rollout
—auto-pause-window-minutes	string	Ventana de stats para la auto-pausa del rollout
—auto-pause-failure-rate-bps	string	Umbral de tasa de fallos en puntos básicos
—auto-pause-confidence	string	Nivel de confianza entre 0 y 1
—auto-pause-min-attempts	string	Mínimo de intentos de instalación y fallo antes de activar la auto-pausa
—auto-pause-min-failures	string	Mínimo de fallos antes de activar la auto-pausa
—auto-pause-action	string	Acción de auto-pausa: pause, rollback o notify
—auto-pause-cooldown-minutes	string	Cooldown antes de que el auto-pause se active de nuevo
—dev	boolean	Permitir enviar actualizaciones a dispositivos de desarrollo
—no-dev	boolean	Desactivar el envío de actualizaciones a dispositivos de desarrollo
—prod	boolean	Permitir enviar actualizaciones a dispositivos de producción
—no-prod	boolean	Disable sending update to production devices
—emulator	boolean	Permitir enviar actualizaciones a dispositivos emulados
—no-emulator	boolean	Desactiva el envío de actualizaciones a emuladores
—device	boolean	Permite enviar actualizaciones a dispositivos físicos
—no-device	boolean	Desactiva el envío de actualizaciones a dispositivos físicos
—qr-preview	boolean	Muestra un QR de terminal code para la vista previa de este canal tras actualizarlo
—send-update-notification	boolean	Envía una notificación nativa de comprobación de actualización tras actualizar el bundle del canal vinculado
—package-json	string	Rutas a los archivos package.json para monorepos (separadas por comas)
—ignore-metadata-check	boolean	Ignora la comprobación de compatibilidad de node_modules si está en el bundle
—supa-host	string	URL del host de Supabase personalizada (para self-hosting o desarrollo con Capgo)
—supa-anon	string	Clave anon personalizada de Supabase (para self-hosting)