Canales

How 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. Mapa de dispositivos forzados: Si el ID del dispositivo se fuerza explícitamente a un canal (consulte la Lista de dispositivos forzados sección 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 de la mapeación forzada pero antes de cualquier valor por defecto. Reinstalar la aplicación no not borrar el dispositivo; eliminar la entrada del dispositivo hace.
3. Capacitor config defaultChannel (prueba de construcción predeterminada): Para ediciones internas / beta / de prueba, puede establecer defaultChannel (clave de legado 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 ediciones de producción suelen dejar esto sin configurar.
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 usa este. Cambiarlo hace que se despliegue (o se retroceda) para todos en segundos—sin un nuevo binario.

¿Por qué por defecto en la nube es la ruta principal:

• Implementación instantánea o retroceso sin volver a compilar ni volver a publicar binarios nativos.
• Un lugar para gestionar el comportamiento de iOS, Android y Electron.
• Seguro: Puede confirmar que los paquetes existen y que 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 / sobrescritura / configuración) son excepciones (debug de un usuario, QA de cambio, configuración de valores por defecto de compilación de prueba). Los usuarios normales fluyen a la nube por defecto.

Cambiar el por defecto en la nube canal afecta nuevos dispositivos normales que:

• No están obligados
• No tienen una sobrescritura de nube predeterminada
• No tienen un nivel de aplicación defaultChannel definido

Si un paquete de prueba se envía con defaultChannel: 'beta' y luego cambias la nube predeterminada a production, dispositivos que comenzaron en beta por medio de la configuración se quedan ahí hasta que: (a) los sobreescribas con setChannel(), (b) los fuerces, o (c) elimines la entrada del dispositivo.

Los dispositivos se quedan en su canal actual a menos que:

• Los fuerces a otro canal.
• Llamar setChannel() (Crear/Reemplazar la configuración de nube) o cambiarlo manualmente en la consola.
• Eliminar / archivar el canal en el que se encuentran (luego caerán nuevamente a través de la precedencia nuevamente 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 ignora 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.

Ejemplo de configuración Capacitor

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 cambias más tarde la configuración predeterminada de la consola a production, los 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 frescos (o aquellos cuya sobrescritura/fuerza elimines) lo captan.

---

Administrando 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 se abrirá un modal donde podrás crear un nuevo canal.

Después de hacer clic en Add debe aparecer un nuevo canal 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 por uno o más de los canales. Puedes aprender más sobre ello aquí

Borrar un canal

Para borrar un canal desde la aplicación web, abre el Canales pulsa la pestaña para tu aplicación y encuentra la fila del canal. En la columna de acción, haz clic en el icono de la papelera, luego haz clic en Borrar en el diálogo de confirmación. Fila de acción del canal mostrando el icono de la papelera

Ventana de terminal 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>

If the trash icon is not visible, your account does not have the permission for that app. Ask an organization or app admin to grant a role that can delete channels, or delete the channel with an __CAPGO_KEEP_0__ key that has permission:

Haciendo clic en el nombre del canal abrirá una ventana emergente donde podrás gestionar las configuraciones del canal. (3 en la imagen)

La página de configuraciones del canal contiene todas las opciones de configuración para tu canal. Vamos a pasar por cada configuración.

---

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

---

Segundo el IOS parámetro. Esto es relativamente simple. Si esto es falso, los dispositivos de iOS no podrán descargar actualizaciones desde este canal.

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

Cuarto es el Electron configuración. Este es similar a IOS y Android. Si esto es falso, entonces las aplicaciones de 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 bajar de versión desde una versión nativa. Esto significa que si has subido una 1.2.0 versión a la tienda de aplicaciones o a Google Play y tratas de establecer la versión del canal a 1.1.0 entonces la actualización (descendiente) fallará.

Sexto es el Disable auto update. Esta configuración es bastante compleja, y puedes aprender más sobre ella en targetLanguage":"Spanish","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"texts":["aquí","En cuanto a",". Si esto es cierto, entonces los compilados de desarrollo permitirán descargar actualizaciones de este canal. Si no, cualquier solicitud de actualización que tenga el","establecido en falso" será rechazada. Esto es principalmente útil para fines de prueba.","Séptimo es el",". Si esto es falso entonces __CAPGO_KEEP_0__ desaprobará cualquier solicitud de actualización que provenga de un emulador. Esto es principalmente útil para fines de prueba.","Octavo es el",". Si esto es cierto entonces el","setChannel","método estará disponible. Si se establece en falso y intenta llamar al","setChannel","método con este canal entonces la llamada fallará."]}

translations Allow development buildtranslations prod translations

translations Allow Emulators. If this is false then Capgo will disallow any update request that comes from an emulator. This is mostly useful for testing purposes.

translations Allow devices to self associatetranslations translations translations translations translations

Sigue adelante desde Canales

Si estás utilizando Canales para planificar la ruta de canales y el despliegue en etapas, conecta con Canales para los detalles de implementación en Canales Canales para los detalles de implementación en Canales Solución de Pruebas Beta para el flujo de trabajo del producto en Solución de Pruebas Beta Solución de Alcance de Versión para el flujo de producto en la Solución de Versionado de Objetivos Capgo Prácticas de Entorno: Etapa con un ID de Aplicación Móvil para el contexto práctico en Capgo Prácticas de Entorno: Etapa con un ID de Aplicación Móvil.