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 releases.
   • Canales: Canales de actualización y controles de despliegue progresivo.
   • Dispositivos: Dispositivos registrados y overrides.
   • Logs: Análisis de logs y logs en bruto.
   • Builds: Gestión de builds nativos.

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

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

3. Tarjetas de resumen: Ofrece una vista rápida de las cifras clave:

   • Subidas de bundle (12): Número total de bundles de la app subidos.
   • Estadísticas de actualizaciones (13): Número total de actualizaciones realizadas, incluidas solicitudes, instalaciones y fallos.
   • Estadísticas de despliegues (14): Número total de despliegues.

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

   • Diario (15): Ver estadísticas por día.
   • Acumulado (16): Ver estadísticas acumuladas a lo largo del tiempo.
   • Período 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.
• App ID (3): Un identificador único para tu aplicación dentro de Capgo. Este ID no es editable.
• Nombre de la app (4): El nombre de visualización de tu aplicación. Puedes modificarlo según sea necesario.
• Canal de upload predeterminado (5): Especifica el canal predeterminado al que se subirán los nuevos bundles. Puedes hacer clic en el icono de edición para seleccionar un canal predeterminado diferente.
• Canal de download predeterminado (6): Especifica el canal predeterminado desde el que los dispositivos descargarán las actualizaciones. Puedes hacer clic en el icono de edición para seleccionar un canal predeterminado diferente. La página del canal muestra si un canal es el predeterminado, pero lo cambias aquí, no con un interruptor en el canal. Abre un canal y haz clic Gestionar en Ajustes de la app para ir a este campo. Consulta la Configuración del canal predeterminado sección inferior para obtener información detallada.
• Eliminación automática de bundles no usados (después de x segundos) (7): Esta configuración permite eliminar automáticamente los bundles antiguos que no se hayan usado durante un tiempo especificado (en segundos). Establece 0 para desactivar la eliminación automática. Esto ayuda a gestionar el almacenamiento y mantener la lista de bundles ordenada.
• Exponer metadatos del bundle al plugin (8): Cuando está habilitado, los campos de enlace y comentario del bundle se enviarán al plugin Capacitor Updater. Esta función requiere la versión 7.35.0 o superior del plugin.
• Bloquear solicitudes de infraestructura del proveedor: Cuando está habilitado, Capgo rechaza las solicitudes de actualización, estadísticas y canal propio desde rangos de IP de centros de datos conocidos de Google y Apple. Déjalo habilitado para el tráfico de producción normal. Desactívalo temporalmente solo si pruebas intencionalmente desde la infraestructura del proveedor. Las nuevas aplicaciones activan esta protección de forma predeterminada; las aplicaciones existentes conservan su configuración anterior deshabilitada hasta que la cambies.
• Transferir propiedad de la aplicación (9): Esta sección ofrece una opción para iniciar la transferencia de tu aplicación a otra organización de la que seas miembro.
• Botón para eliminar la aplicación: Elimina permanentemente tu aplicación de Capgo. Esta acción es irreversible y eliminará todos los datos, bundles, canales y dispositivos asociados.
• Botón de actualización: 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 desde la API pública, se usa ese override.
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 uno 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 canal predeterminado de inmediato
• Dispositivos existentes que ya tienen una asignación de canal (vía override o force) NO cambiarán automáticamente
• Para mover dispositivos existentes, debes:
  • Usa setChannel() (o unsetChannel()) desde la app. Eliminar el registro del dispositivo en el backend no borra la asignación local setChannel() de canal.
  • Forzarlos al nuevo canal en el dashboard (console/API override; expira después de 90 días)
  • Elimina su override de consola/API para que caiga en la precedencia. Los dispositivos con solo el predeterminado en la nube adoptarán el nuevo valor predeterminado.

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.