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. Mapa de dispositivos forzados: Si el ID del dispositivo se fuerza explícitamente a un canal (consulte la lista dentro de las configuraciones del canal), ese canal siempre gana. Sobrescritura de Cloud (creada por
2. o acción de Webapp) setChannel() OVERRIDE DE CLOUD (CREADA POR O ACCIÓN DE WEBAPP): Llamada 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 asignación forzada pero antes de cualquier valor por defecto. Reinstalar la aplicación no la elimina; eliminar la entrada de dispositivo sí. no no
3. Capacitor config defaultChannel (versión de prueba por defecto): Para versiones internas / beta / de prueba, puedes establecer defaultChannel (clave legada) 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 versiones de producción suelen dejar esto sin establecer.
4. Canal por Defecto de la Nube (estrategia principal para ~99% de los usuarios)La principal canalización de producción a la que llegan virtualmente todos los usuarios reales. Cualquier nuevo dispositivo sin una fuerza, sin una sobrescritura y sin una configuración defaultChannel Utiliza esto. Cambiarlo despliega (o vuelve a desplegar) para todos en segundos—sin un nuevo binario.

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

• Despliegue o rollback instantáneo sin volver a compilar o 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 auditable (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 único, QA que cambia, configuración de pruebas por defecto). Los usuarios normales fluyen hacia el valor por defecto de la nube. dispositivos por defecto de la nube el canal afecta nuevo dispositivos normales que:

• No están obligados
• No tienen ya un override de la nube
• No tienen un override de nivel de aplicación defaultChannel definido

Si un paquete de prueba se envía con defaultChannel: 'beta' y luego cambias el valor por defecto de la nube a productiondispositivos que iniciaron en beta por medio de la configuración se quedan ahí hasta que: (a) los sobreescribas con setChannel()o (b) forzarlos, o (c) eliminar la entrada del dispositivo.

Los dispositivos permanecen en su canal actual a menos que:

• Forzarlos a otro canal.
• Llamar setChannel() contexto: texto de fragmento HTML de una cadena de Capgo UI más larga (clave de página clave `appflow_migration_step2`). Página/área: Comparación y migración de Appflow / marketing de copia. Papel: oración de copia de sitio web. Visto en: página ionic-appflow.astro. Preservar términos de producto/marca y términos de desarrollador exactamente. Clave de mensaje `appflow_migration_step2` (Paso 2 de la migración de Appflow).
• (creando/reescribiendo la sobrescritura en la nube) o cambiarlo manualmente en la consola.

Eliminar / archivar el canal en el que se encuentran (entonces caerán nuevamente a través de la precedencia nuevamente en la próxima comprobación).

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 posteriormente cambias la configuración de la consola predeterminada a production, los dispositivos que ya estaban 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 o fuerza hayas eliminado) los capturarán.

---

Gestión de canales

Primero, vamos a echar un vistazo a 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 lista de canales.

Título de la sección “Crear un canal”

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

Luego, 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 indicará Yes por uno o más de los canales. Puedes aprender más sobre ello aquí

Eliminando un canal

Para eliminar un canal desde la aplicación web, abre la Canales contexto: nombre de característica de canales de Capgo. Página/área: página de marketing de soluciones de Capgo. Rol: etiqueta de IU corta o elemento de navegación. Visto en: página solutions/white-label.astro. Clave de mensaje `solutions_white_label_visual_cell2_value` (Valor de celda visual de Solutions White Label). pestaña para tu aplicación y encuentra la fila del canal. En la Acción columna, haz clic en el icono de la papelera, luego haz clic en Eliminar

Fila de canal de la columna de acción mostrando el icono de la papelera channel.delete Si el icono de la papelera no es visible, tu cuenta no tiene la autorización para ese aplicación. Pide a un administrador de organización o aplicación que otorgue un rol que pueda eliminar canales, o elimina el canal con una clave API que tenga autorización:

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

vinculado a una organización y una aplicación Vista previa de la aplicación una clave de organización y aplicación puede eliminar de manera atómica solo el canal de previsualización no público y empaquetarlo creado con channel delete <preview-channel> <app-id> --delete-bundleno puede cambiar o eliminar un canal predeterminado principal, otro canal de previsualización de clave o empaquete de otra clave. Consulte API Claves para la configuración de privilegios mínimo.

Administración de un canal

Haciendo clic en el nombre del canal se abrirá una ventana modal donde se puede administrar los ajustes del canal. (3 en la imagen)

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

---

Primero el Default channel toggle. 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 de canal predeterminado sección.

---

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

Tercero es el Android ajuste. Esto es similar a IOSSi esto es falso, 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.

quinta es la Disable auto downgrade under native configuración. Si esto es verdadero, entonces no será posible descender a una versión nativa. Esto significa que si ha subido una 1.2.0 versión a la tienda de aplicaciones o a la tienda de Google Play y trata de establecer la versión del canal en 1.1.0 entonces la actualización (descendiente) fallará.

sexta es la Disable auto update. Esta configuración es bastante compleja, y puede aprender más sobre ella aquí

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

Octavo es el Allow Emulators. Si esto es falso entonces Capgo no permitirá ninguna solicitud de actualización que provenga de un emulador. Esto es principalmente útil para fines de prueba.

Noveno es el Allow devices to self associate. Si esto es verdadero entonces el setChannel método estará disponible. Si esto se establece en false y intenta llamar al setChannel método con este canal entonces la llamada fallará.

Despliegues progresivos

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

Los controles de despliegue progresivo aparecen en la parte superior de la pestaña Información del canal.

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

Siga adelante desde Canales

Si está utilizando Canales para planificar la ruta de canal y la implementación de lanzamientos etapados, conecte 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 Versionado para el flujo de trabajo del producto en Solución de Versionado, y Capgo Prácticas recomendadas para el entorno: Etapa con un ID de aplicación móvil para el contexto práctico en Capgo Prácticas recomendadas para el entorno: Etapa con un ID de aplicación móvil