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 (la Dispositivos tab on the channel page), that channel always wins. Forced mappings are console/API overrides. Capgo removes them 90 days after the last override write. See Consola y API overrides expiran.
2. Sobreescribir de la nube (Panel de control o Público API): Cambiar el canal de un dispositivo en el panel de control o a través del Público API escribe una sobrescripción vinculada a ese ID de dispositivo. Reinstalar la aplicación no la elimina; eliminar la sobrescripción sí. La misma retención de 90 días se aplica. Plugin (local)
3. : En versiones actuales de plugins, setChannel() almacena el canal en el dispositivo después de la validación del servidor. No es una sobrescripción del panel de control. Reinstalar la aplicación la elimina; la aplicación debe llamarde nuevo si todavía deseas ese canal. setChannel() __CAPGO_KEEP_0__ config setChannel() (configuración de construcción de prueba)
4. Capacitor config defaultChannel __CAPGO_KEEP_0__(configuración de construcción de prueba) defaultChannel (clave legado) channelin capacitor.config.* para que los dispositivos de prueba comiencen en un canal de pre-lanzamiento (por ejemplo, beta, pr-123. Si falta, el dispositivo procederá a la configuración por defecto de la nube. Los builds de producción suelen dejar esto sin configurar.
5. 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, sin una configuración local setChannel()y sin una configuración defaultChannel utiliza esto. Cambiarlo hace que se despliegue (o se revierta) para todos en segundos, sin un nuevo binario.

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

• Despliegue o retroceso instantáneo sin tener que reconstruir o volver a publicar binarios nativos.
• Un lugar para gestionar el comportamiento de iOS, Android y Electron.
• Más seguro: puede confirmar que los paquetes existen y los ajustes están correctos 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 (depurar a un usuario individual, QA que cambia, configuración de prueba por defecto). El flujo normal de usuarios va a la configuración por defecto de la nube.

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

• No están obligados
• No tienen ya una sobrescritura de la nube
• No tenga una aplicación definida defaultChannel definido

Si un paquete de prueba se envía con defaultChannel: 'beta' y más tarde cambie el valor por defecto de la nube a productiondispositivos que se iniciaron en beta a través de la configuración permanecen allí hasta que se aplique una asignación de mayor prioridad, o hasta que envíe un binario sin defaultChannel. Eliminar una fuerza, una sobrescritura de la nube o una asignación local no elimina el valor de la configuración; ese fallback permanece hasta el nuevo binario. setChannel() Los dispositivos permanecen en su canal actual a menos que usted:

Los fuerce a otro canal (consola o Public __CAPGO_KEEP_0__).

• Cambie la sobrescritura de la nube en la consola o Public API.
• Change the cloud override in the dashboard or Public API.
• contexto: texto de fragmento de HTML de una cadena de Capgo UI más larga (clave de padre `appflow_migration_step2`). Página/área: Comparación y migración de Appflow / marketing de copia. Rol: Copia de sitio web. Visto en: página ionic-appflow.astro. Preservar términos de producto/marca y términos de desarrollador de Capgo exactamente. Clave de mensaje `appflow_migration_step2` (Paso 2 de la migración de Appflow). setChannel() (asignación local en versiones actuales del plugin).
• 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).
• Esperar hasta que una consola/API se vaya a expirar después de 90 días.
• Reinstalar la aplicación, que elimina una asignación local pero no una configuración de consola/__CAPGO_KEEP_0__. setChannel() assignment but not a console/API override.

Nota: Establecer

significa cambiarlo requiere un nuevo binario; utilícelo intencionalmente para pruebas/QA, no para control de producción general. defaultChannel Ejemplo de configuración de __CAPGO_KEEP_0__

Sección titulada “Ejemplo de configuración de Capacitor”

capacitor.config.ts

// Example: a TestFlight or internal QA build defaults to the beta channel.
const config = {
  plugins: {
    CapacitorUpdater: {
      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 productionNo se moverán automáticamente los dispositivos que ya están en otro canal (a través de la configuración, la sobrescritura o la fuerza); solo los dispositivos nuevos (o aquellos cuya sobrescritura o fuerza elimines) 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.

Sección titulada “Crear un canal”

protectedTokens1 haga clic en ella (en la imagen) para abrir un modal donde puede crear un nuevo canal.

Luego, después de hacer clic en Add debería 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á una gran advertencia y el Misconfigured columna dirá Yes para uno o más de los canales. Puede aprender más sobre ello aquí

Eliminar 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 soluciones 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 acción de columna mostrando el icono de la papelera para eliminar 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>

Una clave organización- y aplicación-vinculada Vista de la aplicación Una clave de la 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 una clave de otra clave, o un paquete de otra clave. Consulte API Claves para la configuración de privilegios mínimo.

Administrar un canal

Haga clic en el nombre del canal para abrir la página del canal. Es una página completa con pestañas, no un diálogo.

Pestañas del canal

• Panel de controlAdopción del paquete actual y estadísticas de instalación para este canal.
• InformaciónConfiguración del canal listada a continuación, más lanzamiento progresivo y Actualización de prueba API.
• DispositivosMapeos forzados creados desde la consola o Public API solo. No muestra todos los dispositivos actualmente en el canal, y no muestra dispositivos que usaron setChannel()Ver Sobrescrituras de la consola y API caducan.
• HistorialCambios de configuración y paquetes para este canal.
• Vista previa: Vista previa en el navegador y nativa del paquete vinculado. Habilita la vista previa del paquete en Información de la aplicación primero.

Configuración de información

Mantente en la pantalla de información pantalla. Los ajustes aparecen en este orden:

Primero, El canal de descarga predeterminado es una etiqueta de estado, no un interruptor. Activo Segundo, significa que este canal es el por defecto de la nube para dispositivos nuevos. Haga clic Administrar en ajustes de la aplicación para cambiar el valor por defecto en Información de la aplicación. Para valores por defecto específicos de plataforma (uno para iOS, uno para Android y uno para Electron), consulte la misma sección.

Segundo el IOS configuración. Si esto es falso, entonces los dispositivos iOS no serán permitidos para descargar actualizaciones de este canal.

Tercero es el Android configuración. Si esto es falso, entonces los dispositivos Android no serán permitidos para descargar actualizaciones de este canal.

Cuarto es el Electron configuración. Si esto es falso, entonces las aplicaciones Electron no serán permitidas para descargar actualizaciones de este canal.

Quinto es el Disable auto downgrade under native Configuración. Si esto es cierto, entonces no será posible descender a una versión nativa. Esto significa que si ha subido una versión a la tienda de aplicaciones o a la tienda de Google Play y trata de establecer la versión del canal a __CAPGO_KEEP_0__, la actualización (descarga) fallará. 1.2.0 Octava es la 1.1.0 Configuración. Esta configuración es bastante compleja, y puede aprender más sobre ella

aquí Disable auto updateNovena es la Configuración. Elige si los dispositivos descargarán un archivo zip completo, una delta de archivos modificados o ambos. Consulte

Pakete de actualización Update package Décima es Si esto es cierto, entonces los builds de desarrollo permitirán descargar actualizaciones de este canal. Si no, cualquier solicitud de actualización que tenga.

establecido en falso será rechazada. Esto es principalmente útil para fines de prueba. Allow development buildUndécima es la prod Configuración. Si esto es cierto, entonces los builds de desarrollo permitirán descargar actualizaciones de este canal. Si no, cualquier solicitud de actualización que tenga

Noveno es Allow production build. Si esto es falso, entonces las compilaciones de producción (almacenamiento) no recibirán actualizaciones de este canal. Deja esto encendido para los canales que sirven a usuarios reales.

Décimo 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.

Décimo primero es Allow physical devices. Si esto es falso, entonces Capgo rechazará solicitudes de actualización de teléfonos y tabletas reales. Deja esto encendido para los canales de producción.

Décimo segundo es Allow devices to self dissociate/associate. Si esto es verdadero, entonces el setChannel método estará disponible. Si esto está configurado en falso y intentas llamar a setChannel con este canal, entonces la llamada fallará.

Actualización de prueba API

En la parte inferior de la Información expandir Actualización de prueba API. Capgo muestra un comando curl contra /updates para un dispositivo de muestra en este canal.

Los cambios pueden tardar hasta 60 segundos en aparecer en el API debido a la caché. Si el canal no se puede probar, el consola te advierte: el canal necesita al menos una plataforma (iOS o Android), compilaciones de producción, dispositivos físicos y, o ser el canal de descarga predeterminado o permitir la asignación de dispositivos por parte del usuario.

Notificar actualización

Después de cambiar el paquete vinculado, el consola puede preguntar a Enviar notificación de actualizaciónQueuing una notificación silenciosa para que los dispositivos en el canal revisen el nuevo paquete ahora. Configure las credenciales de notificación de Android e iOS en la pestaña de Notificaciones de la aplicación primero.

Console y API sobrescriben expiran

Las asignaciones forzadas y los sobrescriben de canal Dashboard/Public API se eliminan 90 días después de la última escritura de sobrescriben. La última verificación de dispositivo no reinicia ese reloj. Para una asignación que sobreviva a esa limpieza, establezca defaultChannel en su configuración de Capacitor (sobrevive a la reinstalación, necesita un nuevo binario para cambiar) o llame setChannel() desde la aplicación (evita la limpieza de 90 días, pero la reinstalación la elimina, por lo que la aplicación debe llamar setChannel() de nuevo).

La retención de sobrescriben en la pestaña de dispositivos del canal. El mismo aviso aparece cuando fuerza un ID de dispositivo al canal.

Esto está separado de retención de inventario de dispositivos. La inventario elimina dispositivos que no se han conectado a Capgo durante 90 días. La limpieza de override elimina la asignación incluso si el dispositivo sigue activo. Detalles completos: Console y API overrides caducan después de 90 días.

Paquete de actualización

Abra un canal y permanezca en la pantalla de información . El paquete de actualización está en la lista de configuración, bajo Deshabilitar la actualización automática.

Actualice el paquete en la pestaña de información del canal. Los nuevos canales por defecto se establecen en Zip y delta.

Esta configuración elige qué Capgo envía cuando un dispositivo en este canal busca una actualización. Deje Zip y delta a menos que necesite forzar un tipo.

Etiqueta en la consola	CLI / API valor	¿Qué dispositivos descargan?
Zip y delta	all	Un archivo zip completo y un delta cuando ambos existen. Este es el valor predeterminado.
Solo Zip	zip	Solo el archivo zip completo.
Solo delta	delta	Sólo los archivos modificados. Los plugins que no pueden aplicar un delta aún reciben un zip.
Sólo zip desde builtin	zip_from_builtin	Sólo zip mientras el dispositivo aún está en la versión binaria del store. Después del primer actualización en vivo, Capgo sirve zip y delta nuevamente.
Sólo delta desde builtin	delta_from_builtin	Sólo delta mientras el dispositivo aún está en la versión binaria del store. Después del primer actualización en vivo, Capgo sirve zip y delta nuevamente.

builtin es las activos web embarcados dentro de la App Store o Play Store binaria, antes de cualquier Capgo actualización. Utilice un from builtin modo cuando la primera actualización desde la construcción del store debería ser zip-sólo o delta-sólo, y las actualizaciones posteriores pueden utilizar ambos.

Capgo no pairá un canal zip-sólo con un paquete delta-sólo, o viceversa. La consola, CLI, y Los canales API se niegan a guardar y le dicen que suba el paquete faltante o cambie el modo.

También puede establecer el mismo valor desde el CLI. El canal ya debe existir:

npx @capgo/cli@latest channel set production com.example.app --update-package zip

Valores válidos: all, zip, delta, zip_from_builtin, delta_from_builtin.

Despliegues progresivos

El canal Información La pestaña incluye un Despliegue progresivo sección con Objetivo de despliegue y el contexto es: Página/área: Sitio web de marketing de Capgo. Rol: Etiqueta de IU corta o elemento de navegación. Visto en: página trust.astro. Mensaje clave `and` (Y). Control de fallback estable, Cambiar objetivo de lanzamiento, Aplicar porcentajey acciones Completa el lanzamiento, Revertir lanzamiento, Habilitar lanzamiento, Deshabilitar lanzamiento, Pausar lanzamientoy Reanudar lanzamiento.

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

Leer Despliegues progresivos Antes de habilitar uno. Ese guía cubre la ruta de carga (Auto (recomendado) / Objetivo de despliegue / Sustituir estable; CLI --stable / API target: "stable" para superar), el Este canal utiliza despliegue progresivo dialogo de enlace de paquete, y un flujo de trabajo seguro con Observa y Log de Inspección.

Sigue adelante desde Canales

Si estás utilizando Canales para planificar la ruta de los canales y la implementación 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 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.