Saltar al contenido

Página de la aplicación

Primero, vamos a echar un vistazo a la página principal de la aplicación:

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

Captura de pantalla de la página principal

Vamos a echar un vistazo más de cerca 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 las vistas de gestión de la aplicación principales. La captura de pantalla es ilustrativa; la consola actual incluye:

  2. Mostrar estadísticas: Visualiza métricas importantes para el último período de facturación (los datos reflejan el uso desde tu día de facturación, no el 1 de mes):

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

    • Carga de Paquetes (12): Número total de paquetes de aplicaciones cargados.
    • 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 las estadísticas:

    • Diario (15): Ver estadísticas con una frecuencia diaria.
    • Acumulado (16): Ver estadísticas acumuladas a lo largo del tiempo.
    • Periodo de Facturación (17): Ver estadísticas para el período de facturación actual.
    • Rango de Fecha (18): Seleccione un rango de fecha 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.

Página de Información de la Aplicación
Información de la Aplicación

La captura de pantalla es más antigua que la consola actual y no muestra todos los ajustes actuales. Utilice las descripciones de campo a continuación como fuente de verdad.

Un resumen de los campos y acciones disponibles:

  • Icono de la Aplicación (2): Muestra el icono de su aplicación. Puede hacer clic en el botón 'Cambiar' para subir un nuevo icono.
  • ID de la Aplicación (3): Un identificador único para su aplicación dentro de Capgo. Este ID no es editable.
  • Nombre de la Aplicación (4): El nombre de visualización para su aplicación. Puede modificarlo según sea necesario.
  • Canal de Subida Predeterminado (5): Specifica el canal predeterminado a donde se subirán nuevos paquetes. Puede hacer clic en el icono de edición para seleccionar un canal de subida predeterminado diferente.
  • Canal de Descarga Predeterminado (6): Establece el canal predeterminado desde el cual los dispositivos descargarán actualizaciones. Puede hacer clic en el icono de edición para seleccionar un canal predeterminado diferente. Consulte la sección de configuración de canal predeterminado a continuación para obtener información detallada. Configuración del Canal Predeterminado Eliminar automáticamente paquetes no utilizados (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 para deshabilitar la eliminación automática. Esto ayuda a gestionar el almacenamiento y mantener la lista de paquetes limpia. Exponer metadatos de paquete a plugins (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 de 7.35.0 o superior.
  • Bloquear solicitudes de infraestructura de proveedor: Cuando está habilitado, Capacitor rechaza solicitudes de actualización, estadísticas y canal-self de las direcciones IP de centros de datos conocidos de Google y Apple. Deje habilitado para el tráfico de producción normal. Desactive temporalmente solo cuando intencionalmente pruebe desde la infraestructura de proveedor. Las nuevas aplicaciones habilitan esta protección por defecto; las aplicaciones existentes conservan su configuración previamente deshabilitada hasta que la cambie.
  • Transferir la propiedad de la aplicación (9): When enabled, Capgo rejects update, stats, and channel-self requests from known Google and Apple datacenter IP ranges. Leave it enabled for normal production traffic. Disable it temporarily only when you intentionally test from provider infrastructure. New apps enable this protection by default; existing apps retain their previous disabled setting until you change it.
  • Specifies the default channel from which devices will download updates. You can click the edit icon to select a different default channel. See the Default Channel Configuration
  • Botón de Eliminación de Aplicación: Elimina permanentemente tu aplicación de Capgo. Esta acción es irreversible y eliminará todos los datos asociados, conjuntos, canales y dispositivos.
  • Botón de Actualización: Guarda cualquier cambio que hayas realizado en los campos editables de esta página (por ejemplo, Nombre de la Aplicación, Canal de carga predeterminado, configuración de eliminación automática de conjuntos).

El Canal de Descarga Predeterminado es uno de los ajustes más importantes para tu aplicación. Determina qué canal utilizarán los nuevos dispositivos cuando se conecten 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 prioridades (prioridad más alta primero):

  1. Mapeo de dispositivo forzado: Si se fuerza explícitamente el ID de dispositivo a un canal en la configuración del canal, ese canal siempre gana.
  2. Supervisión de Cloud: Si el dispositivo ha sido asignado a un canal mediante setChannel() o manualmente en la consola, se utiliza esa supervisión.
  3. Capacitor config defaultChannel: Si se establece en su capacitor.config.* archivo, se utiliza para compilaciones de prueba/beta.
  4. Canal de descarga por defecto: La configuración configurada aquí—esto es lo que ~99% de sus usuarios de producción utilizarán.

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

  • Quieres realizar actualizaciones en una plataforma antes que en otra
  • Necesitas diferentes estrategias de actualización por plataforma
  • Estás probando una nueva versión en una plataforma mientras mantienes la otra estable

Para configurar los valores por defecto específicos de plataforma:

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

Cuando un dispositivo solicita una actualización:

  • Los dispositivos iOS recibirán actualizaciones del canal de plataforma iOS habilitado
  • Los dispositivos Android recibirán actualizaciones del canal de plataforma Android habilitado
Sección titulada “Canal por Defecto Único (Recomendado para la mayoría de las Aplicaciones)”

Para la mayoría de las aplicaciones, un canal por defecto único que soporta todas las tres plataformas principales es el enfoque más simple:

  1. Crear un canal (por ejemplo, production)
  2. Asegurarse de que las opciones de iOS, Android y Electron estén habilitadas
  3. Marcarlo como el canal por defecto

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

Cuando cambies el canal por defecto:

  • Nuevos dispositivos recibirán actualizaciones inmediatas desde el nuevo canal por defecto
  • Dispositivos existentes que ya tienen una asignación de canal (a través de una sobrescritura o 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
    • Borrar sus entradas de dispositivo (se registrarán 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 Página de la Aplicación para planificar la consola de dashboard y API operaciones, conecte con API Resumen para los detalles de implementación en API Resumen, 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.