Saltar al contenido

Página de la aplicación

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

En Capgo, una aplicación representa tu aplicación móvil integrada con el sistema de actualizaciones en vivo de Capgo.

Pantalla de captura de la página principal

Vamos a echar un vistazo más detallado a esto. La página principal de la aplicación se divide en varias áreas clave:

  1. Barra de navegación superior: Proporciona acceso a diferentes secciones de la administración de tu aplicación:

    • Panel de control (1): La vista actual, que muestra métricas y resúmenes clave.
    • Información (2): Muestra los ajustes y detalles básicos de tu aplicación (ver la sección “Información de la aplicación” a continuación).
    • Paquetes (3): Administra las versiones y lanzamientos de tu aplicación.
    • Canales (4): Configura y administra diferentes canales de actualizaciones (por ejemplo, producción, beta).
    • Dispositivos (5): Ver y administrar dispositivos registrados, incluyendo la configuración de sobreescripciones específicas.
    • Registros (6): Acceda a registros detallados y informes de errores para su aplicación.
    • Construcciones (7): Ver y administrar las construcciones de su aplicación.
  2. Estadísticas de visualización: Visualiza métricas importantes para el último período de facturación (los datos reflejan el uso desde su día de facturación, no el 1 de mes):

    • Usuarios activos mensuales (8): Seguimiento del 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.
    • Paquete Activo (11): Muestra la distribución de dispositivos activos a través de diferentes paquetes de aplicaciones.
  3. Tarjetas de Resumen: Ofrece una visión general rápida de los conteos clave:

    • Subidas de Paquetes (12): Número total de paquetes de aplicaciones subidos.
    • Estadísticas de Actualizaciones (13): Número total de actualizaciones realizadas, incluyendo solicitudes, instalaciones y fallos.
    • Estadísticas de Despliegue (14): Número total de despliegues.
  4. Opciones de Visualización (15-18): Controles para filtrar y visualizar estadísticas:

    • Diario (15): Ver estadísticas en un plazo diario.
    • Acumulado (16): Ver estadísticas acumuladas con el tiempo.
    • Periodo de facturación (17): Ver estadísticas para el período de facturación actual.
    • Rango de fechas (18): Seleccione un rango de fechas personalizado (por ejemplo, los últimos 30 días).

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

Información de la Aplicación
Información de la Aplicación

Aquí tienes una descripción de los campos y acciones disponibles:

  • Icono de la Aplicación (2): Muestra el icono de tu aplicación. Puedes hacer clic en el botón "Cambiar" para subir un nuevo icono.
  • ID de la Aplicación (3): Un identificador único para tu aplicación dentro de Capgo. Este ID no es editable.
  • Nombre de la Aplicación (4): El nombre de visualización para tu aplicación. Puedes modificarlo según sea necesario.
  • Canales de Subida Predeterminados (5): Specifica el canal predeterminado a donde se subirán nuevos paquetes. Puedes hacer clic en el icono de edición para seleccionar un canal de subida predeterminado diferente.
  • Canales de Descarga Predeterminados (6): Specifica el canal predeterminado desde el que los dispositivos descargarán actualizaciones. Puedes hacer clic en el icono de edición para seleccionar un canal diferente predeterminado. Consulte la sección "Configuración del Canal Predeterminado" a continuación para obtener información detallada. Configuración del Canal Predeterminado Eliminar Paquetes No Usados (después de x segundos) (7):
  • Esta configuración permite eliminar automáticamente paquetes antiguos que no se han utilizado durante un período de tiempo especificado (en segundos). Establezca en 0 para deshabilitar la eliminación automática. Esto ayuda a gestionar el almacenamiento y mantener la lista de paquetes limpia. Exponer Metadatos del Paquete al Plugin (8): 0 Cuando está habilitado, los campos de enlace y comentario de paquete se enviarán al plugin de Actualizador __CAPGO_KEEP_0__. Esta característica requiere una versión del plugin 7.35.0 o superior.
  • Transferir Propiedad de la Aplicación (9): When enabled, bundle link and comment fields will be sent to the Capacitor Updater plugin. This feature requires plugin version 7.35.0 or higher.
  • Eliminar Aplicación: Elimina permanentemente su aplicación de __CAPGO_KEEP_0__. Esta acción es irreversible y eliminará todos los datos asociados, paquetes, canales y dispositivos.
  • Delete App Button: Permanently deletes your application from Capgo. This action is irreversible and will remove all associated data, bundles, channels, and devices.
  • Actualizar Botón: Guarda cualquier cambio que hayas realizado en los campos editables de esta página (por ejemplo, el nombre de la aplicación, el canal de carga predeterminado, la configuración de eliminación automática de paquetes).

El Canal de Descarga Predeterminado es una de las configuraciones más importantes para tu aplicación. Determina qué canal utilizan los nuevos dispositivos cuando se conectan a Capgo por primera vez.

Cuando un dispositivo solicita una actualización de Capgo, el sistema determina qué canal utilizar basándose en la siguiente jerarquía de prioridad (prioridad más alta primero):

  1. Asignación de dispositivo forzada: Si se fuerza explícitamente el ID del dispositivo a un canal en la configuración de canales, ese canal siempre gana.
  2. Sobreescribir en la nube: Si el dispositivo ha sido asignado a un canal mediante setChannel() o manualmente en la consola, se utiliza esa sobrescripción.
  3. Capacitor config defaultChannel: Si se establece en tu capacitor.config.* archivo, se utiliza para compilaciones de prueba/beta.
  4. Canal de Descarga Predeterminado: La configuración configurada aquí—esto es lo que ~99% de tus usuarios de producción utilizarán.

Canales Predeterminados Específicos de Plataforma

Sección titulada “Canales Predeterminados Específicos de Plataforma”

Puedes configurar canales predeterminados específicos de plataforma—por ejemplo, uno para iOS, uno para Android y uno para Electron. Esto es útil cuando:

  • Quieres lanzar actualizaciones a una plataforma antes que a la otra
  • Necesita diferentes estrategias de actualización por plataforma
  • Está probando una nueva versión en una plataforma mientras mantiene la otra estable

Para configurar valores por defecto específicos de plataforma:

  1. Cree canales separados para cada plataforma (por ejemplo production-ios, production-android, y production-electron)
  2. En la configuración de cada canal, habilite solo la plataforma relevante (iOS, Android o Electron toggle)
  3. Marque ambos canales como “Predeterminado” - Capgo permite esto cuando los canales apuntan a diferentes plataformas

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 del canal predeterminado habilitado para Android
Sección titulada “Canales de Actualización Únicos (Recomendado para la mayoría de las aplicaciones)”

Para la mayoría de las aplicaciones, un canal predeterminado único que soporta todas las tres plataformas principales es la forma más sencilla de abordarla:

  1. Crea un canal (por ejemplo, production)
  2. Asegúrate de que las opciones de iOS, Android y Electron estén habilitadas
  3. Marquelo como el canal predeterminado

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

Cuando cambies el canal predeterminado:

  • Los dispositivos nuevos recibirán actualizaciones inmediatamente desde el nuevo canal predeterminado
  • Los dispositivos existentes que ya tienen una asignación de canal (a través de una sobrescritura o una fuerza) NO cambiarán automáticamente
  • Para mover dispositivos existentes, necesitas hacer una de las siguientes opciones:
    • Usar setChannel() para sobrescribirlos de manera programática
    • Forzarlos al nuevo canal en la consola
    • Eliminar sus registros de dispositivo (se volverán a registrar con el nuevo valor por defecto)

Consejo: Siempre prueba tu nuevo canal por defecto con un pequeño grupo de dispositivos forzados antes de hacerlo el valor por defecto para todos los usuarios.

Si estás utilizando para planificar operaciones de consola y __CAPGO_KEEP_0__ to plan dashboard and API operations, connect it with API Resumen general para los detalles de implementación en API Resumen general, Introducción para los detalles de implementación en Introducción, API Claves para los detalles de implementación en API Claves, Dispositivos para los detalles de implementación en Dispositivos, y Paquetes para los detalles de implementación en Paquetes.