Página de la app

¿Qué muestra la página de la app?

Primero, echemos un vistazo a la página principal de la app:

En Capgo, una app representa tu aplicación móvil integrada con el sistema live update de Capgo. Te permite gestionar actualizaciones, canales y dispositivos sin fricciones.

Analicémoslo en detalle. La página principal de la app se divide en varias áreas clave:

1. Barra de navegación superior: Ofrece acceso a las vistas principales de gestión de la app. La captura es ilustrativa; la consola actual incluye:

   • Dashboard: Métricas y resúmenes de la app.
   • Observe (beta): Señales de Native Build, WebView, errores y salud de los lanzamientos.
   • Información: Configuración y detalles principales de la app (ver Información de la app).
   • Bundles: Versiones y lanzamientos.
   • Canales: Canales de actualización y control de rollout progresivo.
   • Dispositivos: Dispositivos registrados y overrides.
   • Logs: Análisis de logs y logs en bruto.
   • Builds: Gestión de Native Build.

2. Visualización de estadísticas: Visualiza métricas clave del último periodo de facturación (los datos reflejan el uso desde tu día de facturación, no desde el día 1):

   • Usuarios activos mensuales (8): Rastrea el número de usuarios activos únicos a lo largo del tiempo.
   • Almacenamiento (9): Muestra el consumo de almacenamiento actual.
   • Ancho de banda (10): Muestra el uso de ancho de banda.
   • Bundle activo (11): Muestra la distribución de dispositivos activos entre los distintos app bundles.

3. Tarjetas de resumen: Ofrece una vista rápida de los conteos clave:

   • Subidas de bundles (12): Número total de app bundles subidos.
   • Estadísticas de Updates (13): Total de updates realizadas, incluyendo peticiones, instalaciones y fallos.
   • Estadísticas de Deployment (14): Número total de deployments.

4. Opciones de visualización (15-18): Controles para filtrar y ver las estadísticas:

   • Diario (15): Ver estadísticas de forma diaria.
   • Acumulado (16): Ver estadísticas acumuladas en el tiempo.
   • Periodo de facturación (17): Ver estadísticas del periodo de facturación actual.
   • Rango de fechas (18): Selecciona un rango de fechas personalizado (ej. últimos 30 días).

Información de la app

Esta sección corresponde a la pestaña “Information” (1) en la barra de navegación superior. Aquí puedes ver y gestionar detalles y ajustes cruciales de tu aplicación.

Página de App Information

La captura es anterior a la versión actual de la consola y no muestra todos los ajustes actuales. Usa las descripciones de los campos de abajo como fuente de verdad.

Aquí tienes un desglose de los campos y acciones disponibles:

• Icono de la app (2): Muestra el icono de tu aplicación. Puedes hacer clic en el botón “Change” para subir un nuevo icono.
• ID de la app (3): Un identificador único para tu aplicación en Capgo. Este ID no se puede editar.
• Nombre de la app (4): El nombre de visualización de tu aplicación. Puedes modificarlo cuando quieras.
• Canal de upload predeterminado (5): Especifica el canal por defecto donde se subirán los nuevos bundles. Puedes usar el icono de editar para elegir otro canal.
• Canal de descarga predeterminado (6): Especifica el canal por defecto desde el cual los dispositivos descargarán las actualizaciones. Puedes usar el icono de editar para elegir otro canal. La página del canal indica si es el predeterminado, pero el cambio se hace aquí, no con un toggle en el canal. Abre un canal y haz clic en Gestionar en Ajustes de la app para ir directamente a este campo. Consulta la Configuración del canal predeterminado sección de abajo para más información.
• Eliminar bundles no usados automáticamente (tras x segundos) (7): Esta opción permite borrar automáticamente bundles antiguos que no se hayan usado durante un tiempo determinado (en segundos). Configúralo en 0 para desactivar el borrado automático. Esto ayuda a gestionar el almacenamiento y mantener limpia tu lista de bundles.
• Exponer metadatos del bundle al plugin (8): Al activarlo, los campos de enlace y comentario del bundle se enviarán al plugin Capacitor Updater. Requiere la versión 7.35.0 o superior.
• Bloquear peticiones de infraestructura de proveedores: Al activarlo, Capgo rechaza peticiones de update, stats y channel-self desde rangos de IP conocidos de Google y Apple. Déjalo activo para tráfico de producción normal. Desactívalo temporalmente solo si testeas desde infraestructura de proveedores. Las apps nuevas tienen esta protección por defecto; las existentes mantienen su configuración previa.
• Transferir propiedad de la app (9): Esta sección ofrece la opción de iniciar la transferencia de tu aplicación a otra organización de la que formes parte.
• Botón de eliminar app: Elimina permanentemente tu aplicación de Capgo. Esta acción es irreversible y borrará todos los datos, bundles, canales y dispositivos asociados.
• Botón de actualizar: Guarda los cambios realizados en los campos editables de esta página (p. ej., Nombre de la app, Canal de subida predeterminado, Eliminación automática de bundles).

Configuración del canal predeterminado

El Canal de descarga predeterminado es uno de los ajustes más importantes de tu app. Determina de qué canal recibirán actualizaciones los nuevos dispositivos al conectarse por primera vez a Capgo.

Cómo funcionan los canales predeterminados

Cuando un dispositivo solicita una actualización a Capgo, el sistema determina qué canal usar siguiendo este orden de prioridad (de mayor a menor):

1. Mapeo forzado de dispositivos: Si el ID del dispositivo está forzado a un canal en la configuración de canales, ese canal siempre tiene prioridad.
2. Anulación desde la nube: Si el dispositivo se ha asignado a un canal desde el dashboard o API Público, se usará esa prioridad.
3. Plugin setChannel(): En las versiones actuales del plugin, esto es una asignación local, no un override del dashboard. Ver Cómo un dispositivo elige un canal.
4. la config de Capacitor defaultChannel: Si se define en tu capacitor.config.* archivo, se usará para builds de test/beta.
5. Canal de descarga predeterminado: El ajuste configurado aquí. Esto es lo que usará el ~99% de tus usuarios en producción.

Canales por defecto por plataforma

Puedes configurar canales por defecto específicos para cada plataforma; por ejemplo, uno para iOS, otro para Android y otro para Electron. Esto es útil cuando:

• Quieres lanzar actualizaciones en una plataforma antes que en otra
• Necesitas distintas estrategias de actualización por plataforma
• Estás probando una nueva versión en una plataforma manteniendo la otra estable

Para configurar valores predeterminados por plataforma:

1. Crea canales separados para cada plataforma (por ejemplo production-ios, production-android, y production-electron)
2. En los ajustes de cada canal, activa solo la plataforma correspondiente (toggle de iOS, Android o Electron)
3. En Información de la app, establece cada uno de esos canales como el canal de descarga predeterminado de su plataforma. Capgo permite más de un canal predeterminado cuando los canales apuntan a plataformas distintas.

Cuando un dispositivo solicita una actualización:

• Los dispositivos iOS recibirán actualizaciones del canal predeterminado habilitado para iOS
• Los dispositivos Android recibirán actualizaciones desde el canal por defecto habilitado para Android

Canal único por defecto (Recomendado para la mayoría de las apps)

Para la mayoría de las aplicaciones, lo más sencillo es usar un único canal predeterminado que soporte las tres plataformas principales:

1. Crea un canal (ej., production)
2. Asegúrate de que los interruptores de iOS, Android y Electron estén activados
3. Configúralo como el canal de descarga por defecto en Información de la app

Esto garantiza un comportamiento consistente en todas las plataformas y simplifica tu flujo de release.

Cambiar el canal por defecto

Cuando cambias el canal por defecto:

• Nuevos dispositivos empezarán a recibir actualizaciones del nuevo valor por defecto de inmediato
• Dispositivos existentes que ya tengan un canal asignado (vía override o force) NO cambiarán automáticamente
• Para mover dispositivos existentes, debes:
  • Usa setChannel() (o unsetChannel()) desde la app. Borrar el registro del dispositivo en el backend no limpia una setChannel() asignación local.
  • Forzarlos al nuevo canal desde el dashboard (console/API override; expira tras 90 días)
  • Borrar su console/API override para que sigan la precedencia. Los dispositivos con solo el default de la nube tomarán el nuevo default.

Consejo: Prueba siempre tu nuevo canal predeterminado con un grupo pequeño de dispositivos forzados antes de convertirlo en el predeterminado para todos los usuarios.

Continuar desde App Page

Si estás usando Página de la app para planificar las operaciones del dashboard y de API, conéctalo con Resumen de API para los detalles de implementación en API Overview, Introducción para los detalles de implementación en la Introducción, Claves de API para el detalle de implementación en API Keys, Dispositivos para el detalle de implementación en Devices, y Bundles para el detalle de implementación en Bundles.