Canales

¿Cómo Capgo elige un canal (precedencia)?

Cuando un dispositivo solicita a Capgo una actualización, el canal que se utilizará se decide en el siguiente orden (prioridad más alta primero):

1. Mapeo de dispositivo forzado: Si el ID del dispositivo se fuerza explícitamente a un canal (consulte la lista de dispositivos forzados dentro de las configuraciones de canal), ese canal siempre gana.
2. Sobrescritura de Cloud (creada por setChannel() o acción de Webapp): Llamar a setChannel (o cambiar el canal de un dispositivo en la consola) escribe una sobrescritura persistente en la nube vinculada a ese ID de dispositivo. Esa sobrescritura se consulta después del mapeo forzado pero antes de cualquier valor por defecto. Reinstalar la aplicación no la elimina; eliminar la entrada de dispositivo sí. __CAPGO_KEEP_0__ config
3. Capacitor config defaultChannel (test build default): Para compilaciones internas / beta / de prueba, puede establecer defaultChannel (legacy key channel) en capacitor.config.* para que los dispositivos de prueba comiencen en un canal de pre-lanzamiento (por ejemplo, beta, pr-123). Si falta, el dispositivo proseguirá con el valor por defecto de la nube. Las compilaciones de producción suelen dejar esto sin establecer.
4. Canal por Defecto de la Nube (estrategia principal para ~99% de los usuarios): El canal de producción principal en el que aterriza la mayoría de los usuarios reales. Cualquier nuevo dispositivo sin una fuerza, sin una sobrescritura y sin una configuración defaultChannel utiliza esto. Cambiarlo hace que se despliegue (o se retroceda) para todos en segundos—sin un nuevo binario.

¿Por qué el canal por defecto de la nube es el camino principal:

• Despliegue instantáneo o rollback sin volver a compilar o re-publicar binarios nativos.
• Un lugar para gestionar el comportamiento de iOS, Android y Electron.
• Mas seguro: puede confirmar que los paquetes existen y las configuraciones están correctas antes de cambiar el valor por defecto.
• Cambios auditables (los miembros del equipo pueden ver quién cambió qué en la interfaz de usuario / registros). Principio de diseño: Las capas por encima (fuerza / sobreescribir / configuración) son excepciones

(debug de un usuario, QA que cambia, configuración de build de prueba). Los usuarios normales fluyen a la configuración por defecto de la nube. Cambiar el canal por defecto de la nube affecta nuevos

• dispositivos normales que:
• No ya tengas una sobrescritura de nube
• No tenga un nivel de aplicación defaultChannel definido

Si un paquete de prueba se envía con defaultChannel: 'beta' y más tarde cambies el valor predeterminado de la nube a production, los dispositivos que iniciaron en beta a través de la configuración permanecen allí hasta que: (a) los sobrescribas con setChannel(), (b) los fuerces, o (c) elimines la entrada del dispositivo.

Los dispositivos permanecen en su canal actual a menos que

• Fuerzas a otro canal.
• Llamar setChannel() (creando/reescribiendo la sobrescritura de nube) o cambiarlo manualmente en la consola.
• Elimine / archiva el canal en el que se encuentran (luego caerán nuevamente a través de la precedencia en la próxima verificación).

Si un canal está deshabilitado para una plataforma (consulte los botones de iOS / Android / Electron) y de lo contrario habría sido seleccionado, la selección lo omite y cae en la siguiente regla.

Nota: Establecer defaultChannel significa cambiarlo requiere un nuevo binario; utilícelo intencionalmente para pruebas / QA, no para el control de producción general.

Capacitor ejemplo de configuración

capacitor.config.ts

// Example: a TestFlight or internal QA build defaults to the beta channel.
const config = {
  plugins: {
    Capgo: {
      defaultChannel: 'beta', // Test build default. Omit in production so users attach to cloud default.
      // legacy key: channel
    },
  },
};
export default config;

Si cambia más tarde el valor predeterminado de la consola a productionlos dispositivos que ya están en otro canal (a través de la configuración, la sobrescritura o la fuerza) NO se moverán automáticamente; solo los dispositivos nuevos (o aquellos cuya sobrescritura/fuerza elimine) los captan.

---

Gestión de canales

Primero, vamos a ver la página de canales. Puedes acceder a ella haciendo clic en tu aplicación y luego haciendo clic en la pestaña de canales.

Crear un canal

Como puedes ver, existe un botón de signo más en la esquina inferior derecha. (1 en la imagen) Haciendo clic en él abrirá un modal donde podrás crear un nuevo canal.

Luego, después de hacer clic en Add un nuevo canal debería aparecer en la lista.

¿Qué significa mal configurado?

A veces la configuración de un canal no es válida. En ese caso, obtendrás una gran advertencia y el Misconfigured columna dirá Yes para uno o más de los canales. Puedes aprender más sobre ello aquí

Eliminar un canal

Para eliminar un canal desde la aplicación web, abre la pestaña de Canales para tu aplicación y encuentra la fila del canal. En la Acción haga clic en la columna, en el icono de la papelera, luego haga clic en Eliminar en el diálogo de confirmación.

Si el icono de la papelera no es visible, su cuenta no tiene permiso para ese app. Pida a un administrador de organización o app que le otorgue un rol que pueda eliminar canales, o elimine el canal con una __CAPGO_KEEP_0__ clave que tenga permiso: channel.delete permission for that app. Ask an organization or app admin to grant a role that can delete channels, or delete the channel with an API key that has permission:

npx @capgo/cli@latest channel delete <channel-name> <app-id>

Vista previa de app solo puede eliminar el canal de vista previa no público y empaquetarlo creado con: App Preview channel delete <preview-channel> <app-id> --delete-bundle. No puede cambiar o eliminar un canal predeterminado principal o un canal de otra clave de vista previa, o un paquete de otra clave. API Claves para la configuración de privilegios más baja.

Gestión de un canal

Al hacer clic en el nombre del canal se abrirá una ventana modal donde podrá gestionar los ajustes del canal. (3 Ajustes del canal

Primero el

---

botón de encendido. Cuando está habilitado, este canal se convierte en el predeterminado para nuevos dispositivos. Para una explicación completa de cómo funcionan los canales predeterminados, incluyendo cómo configurar los valores predeterminados específicos de plataforma (uno para iOS, uno para Android y uno para Electron), consulte la Default channel Configuración del Canal Predeterminado Default Channel Configuration sección.

---

Segundo el IOS configuración. Esto es relativamente simple. Si esto es falso, entonces los dispositivos IOS no podrán descargar actualizaciones de este canal.

Tercero es el Android configuración. Esto es similar a IOSSi esto es falso, entonces los dispositivos Android no podrán descargar actualizaciones de este canal.

Cuarto es el Electron configuración. Esto es similar a IOS y AndroidSi esto es falso, entonces las aplicaciones Electron no podrán descargar actualizaciones de este canal.

Quinto es el Disable auto downgrade under native configuración. Si esto es verdadero, entonces será imposible descender a una versión nativa. Esto significa que si has subido una 1.2.0 versión a la tienda de aplicaciones o play store y prueba de establecer la versión del canal a 1.1.0 entonces la actualización (descarga) fallará.

Sexto es el Disable auto update. Esta configuración es bastante compleja, y puedes aprender más sobre ella aquí

En cuanto a Allow development build. Si esto es verdadero, entonces los compilados de desarrollo permitirán descargar actualizaciones de este canal. Si no, entonces cualquier solicitud de actualización que tenga el prod establecido en falso será rechazada. Esto es principalmente útil para fines de prueba.

Séptimo es el Allow Emulators. Si esto es falso, entonces Capgo desaprobará cualquier solicitud de actualización que provenga de un emulador. Esto es principalmente útil para fines de prueba.

Octavo es el Allow devices to self associate. Si esto es verdadero entonces el establecerCanal El método estará disponible. Si se establece en falso y intenta llamar al método con este canal, entonces la llamada fallará. establecerCanal El método con este canal fallará si se establece en falso y se intenta llamar.

Despliegues progresivos

El canal Información La pestaña incluye una sección de despliegue progresivo. Establezca un paquete objetivo, elija el porcentaje y la duración de la caché de decisión, y active el despliegue. Desde la misma sección puede pausar o reanudar la exposición, promover el objetivo a estable, retroceder o configurar una pausa automática, retroceso o notificación cuando los señales de falla crucen un umbral. Controles de despliegue progresivo en un canal __CAPGO_KEEP_0__ Despliegue progresivo

Controles de lanzamiento progresivo aparecen en la parte superior de la pestaña de información del canal.

Leer Rollos progresivos Antes de habilitar uno. Explica cohortes pegajosas, cambios de porcentaje seguros y comportamiento de pausa automática.

Seguir adelante desde Canales

Si está utilizando Canales para planificar la ruta de canal y el lanzamiento en etapas, conecte con Canales para los detalles de implementación en Canales, Canales para los detalles de implementación en Channels, Solución de Pruebas Beta para el flujo de trabajo del producto en Solución de Pruebas Beta, Solución de Enfoque de Versión para el flujo de trabajo del producto en Solución de Enfoque de Versión, y Capgo Mejores Prácticas de Entorno: Etapa con un ID de Aplicación Móvil para el contexto práctico en Capgo Mejores Prácticas de Entorno: Etapa con un ID de Aplicación Móvil.