Entendiendo las actualizaciones en vivo en Capgo

Las actualizaciones en vivo son una de las características más poderosas en las aplicaciones de Capacitor, permitiendo actualizaciones en tiempo real sin necesidad de presentarlas en las tiendas de aplicaciones. Vamos a profundizar en cómo Capgo implementa esta funcionalidad.

Conceptos Fundamentales

Una aplicación de Capacitor consta de dos capas principales:

Nivel Web: Contiene archivos HTML, CSS y JavaScript cargados en el WebView
Nivel Nativo: Contiene código de plataforma específico de code (Java/Kotlin para Android, Swift para iOS)

El sistema de actualizaciones en vivo de Capgo funciona reemplazando el nivel web en tiempo de ejecución, ya que estos archivos no se compilan en el binario de la aplicación.

Implementación Técnica

Rutas del Servidor en Capacitor

Capgo gestiona dos rutas críticas:

Ruta del Servidor Actual: Se refiere a archivos cargados actualmente en WebView
Ruta del Servidor Siguiente: Se refiere a archivos que se cargarán en la próxima reiniciación de la aplicación

Implementación de Android

En Android, Capgo gestiona rutas a través de:

// Store next server path
private void setNextCapacitorServerPath(String path) {
    SharedPreferences prefs = context.getSharedPreferences("CapWebViewSettings", Activity.MODE_PRIVATE);
    SharedPreferences.Editor editor = prefs.edit();
    editor.putString("serverBasePath", path);
    editor.apply();
}

// Update current path and reload
private void setCurrentCapacitorServerPath(String path) {
    bridge.setServerBasePath(path);
    bridge.reload();
}

Implementación de iOS

En iOS, las rutas se gestionan a través de:

// Store next server path
private func setNextCapacitorServerPath(path: String) {
    KeyValueStore.standard["serverBasePath"] = path
}

// Update current path
private func setCurrentCapacitorServerPath(path: String) {
    bridge.viewController.setServerBasePath(path: path)
}

Medidas de Seguridad

Capgo implementa medidas de seguridad de grado militar a través de cifrado de extremo a extremo, asegurando que las actualizaciones de la aplicación permanezcan completamente seguras desde el desarrollo hasta la implementación. Nuestro sistema de cifrado va más allá del cifrado tradicional de code de firma para proporcionar seguridad cero conocimiento verdadera.

Arquitectura de cifrado de extremo a extremo

Cifrado de extremo a extremo (E2EE): Cada paquete de actualización se cifra utilizando el cifrado AES-256-GCM antes de salir de su entorno de desarrollo. Este cifrado de grado militar garantiza que las actualizaciones de su aplicación permanezcan completamente privadas y seguras durante todo el proceso de entrega.
Arquitectura de conocimiento cero: A diferencia de otras soluciones de actualización OTA que solo firman actualizaciones, Capgo emplea cifrado de conocimiento cero verdadero. Esto significa:
- El contenido de las actualizaciones se cifra antes de subir
- Los servidores de Capgo solo almacenan datos cifrados
- La desifrado solo ocurre en dispositivos de usuarios finales
- No hay intermediario que pueda acceder al contenido de su actualización
Gestión de claves seguras:
- Las claves de cifrado se generan y se almacenan de manera segura en su entorno de CI/CD
- Las claves privadas nunca tocan los servidores de Capgo
- Cada versión de la aplicación puede utilizar claves de cifrado únicas
- Soporte para rotación de claves para una mayor seguridad

Aprende más sobre nuestro sistema de cifrado en nuestra guía detallada: Cifrado de Fin a Fin en Capgo Actualizaciones en Vivo

Proceso de Actualización de Seguridad

Cifrado Pre-Subida:
- Las actualizaciones se cifran en tu pipeline de CI/CD
- Cada archivo se cifra individualmente
- El metadatos también se cifra para una privacidad completa
Almacenamiento Seguro:
- Los paquetes cifrados se almacenan en el CDN global de Capgo
- No hay datos de texto plano que toquen nuestros servidores
- Even in caso de robo del servidor, los datos permanecen seguros
Entrega Segura:
- Las actualizaciones se entregan a través de canales cifrados
- Cada instancia de la aplicación valida la integridad de la cifrado
- Mecanismos de reintento automático para la desifrado fallida
Seguridad en el lado del cliente:
- Las actualizaciones se verifican antes de la instalación
- La desifrado fallida desencadena un rollback automático
- Almacenamiento de claves seguro en el almacenamiento protegido de la aplicación

Esta seguridad integral garantiza que las actualizaciones de su aplicación permanezcan protegidas contra:

Ataques de hombre en el medio
Robos del lado del servidor
Modificaciones no autorizadas
Ataques de replay
Manipulación de contenido

Ciclo de actualización

El proceso de actualización de Capgo está diseñado para ser automático por defecto. Aquí's cómo funciona el proceso automático:

1. Verificación de actualizaciones automáticas

El plugin verifica automáticamente las actualizaciones en las siguientes situaciones:

Cuando se inicia la aplicación

Este comportamiento se controla mediante la autoUpdate configuración:

// capacitor.config.json
{
  "plugins": {
    "CapacitorUpdater": {
      "autoUpdate": true // Enable automatic updates
    }
  }
}

También puedes verificar manualmente con getLatest()

2. Descarga automática

When se detecta una nueva versión, si autoUpdate está habilitado:

Comienza el descarga automáticamente
El progreso se sigue internamente
Las descargas fallidas se reintentan automáticamente al abrir la aplicación
Las descargas exitosas se almacenan en el almacenamiento de la aplicación

Puedes monitorear este proceso a través de eventos:

CapacitorUpdater.addListener('download', (info: DownloadEvent) => {
  console.log('Auto-download progress:', info.percent);
});

CapacitorUpdater.addListener('downloadComplete', (info: DownloadCompleteEvent) => {
  console.log('Auto-download complete:', info.bundle);
});

3. Instalación automática

El tiempo de instalación depende de tu configuración:

// capacitor.config.json
{
  "plugins": {
    "CapacitorUpdater": {
      "autoUpdate": true,
      "directUpdate": false // install update on app backgrounding
      "resetWhenUpdate": true, // reset live updates on native update (true by default)
      "autoDeleteFailed": true, // Auto cleanup failed updates (true by default)
      "autoDeletePrevious": true // Auto cleanup old versions (true by default)
    }
  }
}

La instalación ocurre:

Inmediatamente si directUpdate __CAPGO_KEEP_0__
En la próxima app de fondo si directUpdate es falso
Auto-rollback si falla la instalación

El plugin también gestiona automáticamente el almacenamiento:

Elimina actualizaciones fallidas si autoDeleteFailed es verdadero
Elimina versiones antiguas si autoDeletePrevious es verdadero

Retrasar actualizaciones

Puedes controlar cuándo se instalan las actualizaciones utilizando condiciones de retraso:

// Delay until app goes to background
await CapacitorUpdater.setDelay({
  kind: 'background'
});

// Delay until specific date
await CapacitorUpdater.setDelay({
  kind: 'date',
  value: '2024-03-20T10:00:00.000Z'
});

// Delay until next native version
await CapacitorUpdater.setDelay({
  kind: 'nativeVersion'
});

// Multiple conditions
await CapacitorUpdater.setMultiDelay({
  delayConditions: [
    {
      kind: 'background'
    },
    {
      kind: 'date',
      value: '2024-03-20T10:00:00.000Z'
    }
  ]
});

Condiciones de retraso disponibles:

fondo: Instale cuando la aplicación se ponga en segundo plano
: Fecha: Instale después de una fecha/hora específica
: Versión nativa: Instale después de la próxima actualización nativa
: Eliminar: Instale después de que la aplicación se elimine

Esto es útil para:

Programar actualizaciones durante horas de baja demanda
Coordinar actualizaciones con la actividad del usuario
Asegurar una experiencia de actualización suave
Prevenir interrupciones durante tareas críticas

Actualizar Estados

Durante el proceso automático, los paquetes pasan por estos estados:

descargando: Descargando en progreso
pendiente: Descarga completa, esperando a la instalación
éxito: Actualización instalada y activa
error: Actualización fallida (desencadena el auto-rollback)

Cumplimiento de la Tienda

Tienda de Aplicaciones de Apple

Actualizaciones en vivo están plenamente conformes con las políticas del App Store de Apple. Como se establece en el Acuerdo de Licencia del Programa de Desarrolladores de Apple:

“La interpretación de code puede descargarse a una aplicación, pero solo durante tanto tiempo como tal code: (a) no cambie el propósito principal de la aplicación proporcionando características o funcionalidad que sean inconsistentes con el propósito y la publicidad previstos de la aplicación tal como se presentó en el App Store, (b) no cree un almacén o tienda para otras code o aplicaciones, y (c) no evite la firma, el sandbox o otras características de seguridad del sistema operativo.”

Las actualizaciones de Capgo solo modifican la capa web mientras respeta todas las fronteras de seguridad de la plataforma.

✅ Tienda de Juegos de Google

Las actualizaciones en vivo cumplen con las políticas de Google Play. La política de abuso de dispositivos y redes especifica:

“Esta restricción no se aplica a code que se ejecuta en una máquina virtual o un intérprete donde se proporciona acceso indirecto a las API de Android (como JavaScript en una vista de navegador o navegador).”

Desde que Capgo solo actualiza el contenido de la vista de navegador, se ajusta a estas directrices permitidas.

Prácticas recomendadas

Despliegue en fases: Despliegue actualizaciones gradualmente
Control de versiones: Registre todas las versiones desplegadas
Soporte de Reversión: Recuperación rápida de problemas
Actualizaciones Delta: Solo descargar archivos modificados

Cuándo Usar Actualizaciones en Vivo

Ideal para:

: Reparaciones de errores
Mejoras de interfaz de usuario
Actualizaciones de contenido
Trazas de características

No apto para:

: Cambios nativos code
Actualizaciones de versión mayor
Patch de seguridad que requiere cambios nativos

Sigue adelante desde Cómo funcionan las Actualizaciones en vivo en Capgo

Si estás utilizando Cómo funcionan las Actualizaciones en vivo en Capgo para planificar el trabajo de plugin nativo, conecta con Capgo Directorio de Plugins para el flujo de trabajo del producto en Capgo Directorio de Plugins, Capacitor Plugins por Capgo para el detalle de implementación en Capacitor Plugins por Capgo, Agregar o Actualizar Plugins para el detalle de implementación en Agregar o Actualizar Plugins, Alternativas de Plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas de Plugins de Ionic Enterprise, y Capgo Construcción Nativa para el flujo de trabajo del producto en Capgo Construcción Nativa.

¿Cómo funcionan las actualizaciones en vivo en Capgo