Canales
Copie un prompt de configuración con los pasos de instalación y la guía de markdown completa para este plugin.
¿Cómo Capgo elige un canal (precedencia)?
Sección titulada “¿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):
- Mapeo de dispositivo forzado: Si el ID del dispositivo se fuerza explícitamente a un canal (consulte la lista dentro de los ajustes del canal), ese canal siempre gana. Sobrescritura de Cloud (creado por
- o acción de Webapp)
setChannel(): LlamadaSi el dispositivo ID se fuerza explícitamente a un canal (consulte la lista dentro de los ajustes del canal), ese canal siempre gana.setChannel(o cambiando 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 forzosa pero antes de cualquier valor por defecto. Reinstalar la aplicación no la elimina; eliminar la entrada del dispositivo sí. __CAPGO_KEEP_0__ configuración (versión de prueba por defecto) - Capacitor config
defaultChannel(clave legada) endefaultChannelpara que los dispositivos de prueba comiencen en un canal de pre-lanzamiento (por ejemplo,channel). Si falta, el dispositivo proseguirá con el valor por defecto de la nube. Las ediciones de producción suelen dejar esto sin establecer.capacitor.config.*Canal por defecto de la nube (estrategia principal para ~99% de los usuarios)beta,pr-123: 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. - 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.
defaultChannelusa esto. Cambiarlo despliega (o vuelve a desplegar) para todos en segundos—sin nuevo binario.
¿Por qué el por defecto en la nube es el camino principal:
- Despliegue o reversion instantáneo sin volver a compilar o volver a publicar binarios nativos.
- Un lugar para gestionar el comportamiento de iOS, Android y Electron.
- Seguro: puedes confirmar que los paquetes existen y las configuraciones están correctas antes de cambiar el valor por defecto.
- Cambios auditable (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 usuario único, QA cambiar, construir por defecto de prueba). Los usuarios normales fluyen al valor por defecto en la nube. Cambiar el El canal afecta nuevo dispositivos normales que:
- No están obligados
- No tienen ya un override de nube
- No tienen un nivel de aplicación
defaultChanneldefinido
Si un paquete de prueba se envía con defaultChannel: 'beta' y luego cambias el valor por defecto de la nube a productiondispositivos que comenzaron en beta a través de la configuración se mantienen allí hasta que: (a) los sobreescribas con setChannel()o (b) fuerzas, o (c) elimines la entrada del dispositivo.
Los dispositivos permanecen en su canal actual a menos que usted:
- Forzarlos a otro canal.
- Llamar
setChannel()(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 verificación).
Si un canal está deshabilitado para una plataforma (consulte los botones iOS / Android / Electron) y de lo contrario habría sido seleccionado, la selección lo omite y cae en la siguiente regla.
Nota: Establecer
defaultChannelsignifica cambiarlo requiere un nuevo binario; utilícelo intencionalmente para pruebas/QA, no para el control de producción general.
Ejemplo de configuración Capacitor
Sección titulada “Ejemplo de configuración Capacitor”// 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 más adelante cambias la configuración de la consola predeterminada 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 frescos (o aquellos cuya sobrescritura/fuerza elimines) los capturarán.
Gestión de canales
Sección titulada “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”
Como puedes ver, existe un botón de signo más en la esquina inferior derecha. (Creating a channel1 en el imagen) Haciendo clic en ella 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?
Título de la sección “¿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í
Eliminar un canal
Sección titulada “Eliminar un canal”Eliminar un canal es sencillo. Solo haz clic en el icono de la papelera y confirma la eliminación. (2 en la imagen)
Gestionar un canal
Sección titulada “Gestionar un canal”Haciendo clic en el nombre del canal abrirá una ventana modal 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 nuevos dispositivos. Para una explicación completa de cómo funcionan los canales predeterminados, incluyendo cómo configurar 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 configuración. Esto es relativamente simple. Si esto es falso, entonces los dispositivos IOS no serán permitidos descargar actualizaciones de este canal.
Tercero es el Android configuración. Esto es similar a IOS. Si esto es falso, entonces los dispositivos Android no serán permitidos descargar actualizaciones de este canal.
Cuarto es el Electron configuración. Esto es similar a IOS y Android. Si esto es falso, entonces las aplicaciones Electron no serán permitidas 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 trata 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 establecer canal el método estará disponible. Si se establece en falso y intenta llamar al establecer canal método con este canal, entonces la llamada fallará.
Sigue adelante desde Canales
Sección titulada “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 Enfoque de Versión para el flujo de trabajo del producto en Solución de Enfoque de Versión, y 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.