Entendiendo las actualizaciones en vivo en Capgo

Live updates are one of the most powerful features in Capacitor apps, allowing real-time updates without app store submissions. Let’s dive deep into how Capgo implements this functionality.

Vamos a sumergirnos en cómo __CAPGO_KEEP_1__ implementa esta funcionalidad.

A Capacitor app consists of two main layers:

Una aplicación de __CAPGO_KEEP_0__ consta de dos capas principales:Nivel Web
: Contiene archivos HTML, CSS y JavaScript cargados en el WebView: Contains platform-specific code (Java/Kotlin for Android, Swift for iOS)

: Contiene código de plataforma específico de Capgo (Java/Kotlin para Android, Swift para iOS)

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

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 code de firma para proporcionar seguridad de 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 descifrado solo ocurre en dispositivos de usuarios finales
- Ningún intermediario puede 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 extremo a extremo en Capgo Actualizaciones en vivo

Proceso de actualización de seguridad

Cifrado previo a la carga:
- Las actualizaciones se cifran en tu pipeline de CI/CD
- Cada archivo se cifra individualmente
- También se cifra la información de metadatos para una privacidad completa
Almacenamiento seguro:
- Los conjuntos cifrados se almacenan en el CDN global de Capgo
- No se toca nunca nuestro servidor con datos en texto plano
- A pesar de una brecha en el 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 descriptografía fallida
Seguridad en el lado del cliente:
- Las actualizaciones se verifican antes de la instalación
- La descriptografía 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 tu aplicación permanezcan protegidas contra:

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

Ciclo de Actualización

Capgo’s proceso de actualización 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 el 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 la memoria 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 siguiente 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 sea eliminada

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 Convenio de Licencia del Programa de Desarrolladores de Apple:

“La interpretación de code puede descargarse a una aplicación, pero solo mientras 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 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 entorno de pruebas o otras características de seguridad del sistema operativo.”

Capgo actualiza solo la capa web mientras respeta todos los límites 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: Registra todas las versiones desplegadas
Soporte de RebobinadoRecuperación rápida de problemas
Actualizaciones DeltaDescargar solo archivos modificados

Cuándo Usar Actualizaciones en Vivo

Ideal para:

Correcciones de errores
Mejoras de interfaz de usuario
Actualizaciones de contenido
Tiradas de características

No apto para:

Cambios nativos code
Actualizaciones de versión mayor
Parches de seguridad que requieren 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 plugins nativos, 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 Compilaciones Nativas para el flujo de trabajo del producto en Capgo Compilaciones Nativas.

¿Cómo funcionan las actualizaciones en vivo en Capgo