Actualizaciones de Delta

El sistema de actualización en vivo de Capgo puede entregar actualizaciones de manera más rápida y eficiente enviando solo los archivos modificados, en lugar de todo el paquete JS.

Esto es especialmente beneficioso para los usuarios con conexiones de red más lentas o medibles, ya que minimiza la cantidad de datos que deben descargarse.

Un segundo beneficio es cuando la aplicación tiene activos grandes que cambian con poca frecuencia, como imágenes o videos, comparado con los archivos JS comprimidos se descargan solo una vez.

Cómo funcionan las actualizaciones Delta (Manifiesto)

Las actualizaciones Delta (manifiesto) en Capgo se manejan por el plugin Capgo instalado en tu aplicación. Cuando subes una nueva versión de tu aplicación con la --delta bandera, Capgo realiza lo siguiente:

1. Cada archivo en tu compilación se sube individualmente
2. Se generan sumas de verificación para cada archivo
3. Se crea un nuevo manifiesto json, listando todos los archivos y sus sumas de verificación
4. Este manifiesto se sube a la Capgo base de datos

Cuando un dispositivo que ejecuta tu aplicación busca una actualización, el plugin Capgo recibe el nuevo manifiesto desde el servidor. Lo compara con el que tiene actualmente, identificando los archivos que han cambiado basándose en las sumas de verificación y las rutas de archivo.

El plugin descarga solo los archivos modificados, en lugar de todo el paquete JS. Reconstruye la nueva versión de la aplicación combinando estos archivos descargados con los archivos inalterados que ya tiene.

Manifiesto

En caso de actualizaciones Delta (manifiesto), el dispositivo almacena todos los archivos descargados en una caché común. Capgo nunca la limpia, pero el sistema operativo puede hacerlo en cualquier momento.

Habilitar actualizaciones Delta (manifiesto)

Para habilitar actualizaciones Delta (manifiesto) para tu aplicación Capgo, simplemente usa el --delta indicar cuando subas una nueva versión:

npx @capgo/cli@latest bundle upload --delta

Si autoUpdate está configurado en un modo de aplicación instantánea ("atInstall", "onLaunch", o "always") en tu capacitor.config, el CLI lo detecta. En entornos no interactivos envía actualizaciones de Delta (manifest) automáticamente, y en entornos interactivos te pide confirmación antes de subir. Legado directUpdate El config de legado todavía se detecta. Utiliza --no-delta para forzar una subida de paquete completa.

Hacer cumplir actualizaciones de Delta (Manifest)

If deseas asegurarte de que todas las subidas sean actualizaciones Delta (manifest) y evitar cualquier carga completa de paquetes por error, puedes utilizar el --delta-only flag:

npx @capgo/cli@latest bundle upload --delta-only

Cuando --delta-only se utiliza, Capgo solo subirá archivos individuales y generará un manifest. Cualquier dispositivo que no soporte actualizaciones Delta (manifest) no podrá descargar la actualización.

Puede que desees utilizar --delta-only si:

• Si siempre deseas utilizar actualizaciones Delta (manifest) y nunca deseas permitir cargas completas de paquetes
• Estás configurando una pipeline CI/CD y deseas asegurarte de que todas las subidas automatizadas sean Delta (manifest)
• Tu aplicación es grande y la banda ancha está limitada, por lo que necesitas minimizar tamaños de carga/subida

If necesitas hacer una carga completa de paquetes mientras --delta-only está configurado, simplemente ejecuta el comando de carga sin --delta-onlyEsto sobreescribirá la configuración para esa carga única, permitiéndote enviar un paquete completo cuando sea necesario.

Solución de problemas

Si no parecen funcionar las actualizaciones de Delta (manifest), es decir, si los dispositivos siempre están descargando el paquete JS completo incluso para cambios pequeños, revisa que:

• Estás utilizando la --delta bandera cada vez que subes una nueva versión
• Si estás utilizando --delta-only, asegúrate de no haber omitido la --delta bandera
• Tu dispositivo está ejecutando la última versión del plugin Capgo
• Tu dispositivo tiene una conexión de red estable y puede alcanzar los servidores Capgo

Puede utilizar también la aplicación web Capgo para verificar los detalles de su última subida:

1. Vaya a la aplicación web
2. Haga clic en su aplicación
3. Haga clic en el número de conjuntos de la barra de estadísticas.
4. Seleccione el último conjunto
5. Verifique el Partial campo

Si continúa teniendo problemas, por favor, póngase en contacto con el soporte de Capgo para obtener asistencia adicional. Pueden verificar los registros del servidor para confirmar que las subidas de Delta (manifest) se están procesando correctamente y que los dispositivos están recibiendo los manifestos actualizados.

¡Eso es todo! La --delta bandera le dice a Capgo que realice las subidas de archivos individuales y la generación de manifestos necesarios para las actualizaciones de Delta (manifest).

Ten en cuenta que debes utilizar --delta cada vez que subas una nueva versión que deseas que se entregue como una actualización Delta (manifest). Si omites la bandera, Capgo subirá el conjunto de JS completo como un archivo único, y los dispositivos descargarán el conjunto completo incluso si solo se ha cambiado una pequeña parte.

Sigue adelante con actualizaciones Delta

Si estás utilizando actualizaciones Delta para planificar la entrega de actualizaciones en vivo, conecta con Capgo Actualizaciones en vivo para el flujo de trabajo del producto en Capgo Actualizaciones en vivo, Resumen para los detalles de implementación en Resumen, Características para el detalle de implementación en Features, Actualizar Comportamiento para el detalle de implementación en Actualizar Comportamiento, y Tipos de Actualización para el detalle de implementación en Tipos de Actualización.