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 del conjunto completo de JS.

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

Un segundo beneficio es cuando la aplicación tiene activos grandes que cambian raramente, como imágenes o videos, en comparación con archivos JS comprimidos, se descargará solo una vez.

Cómo funcionan las actualizaciones de Delta (Manifiesto)

Las actualizaciones de delta (manifiesto) en Capgo se manejan por el plugin Capgo instalado en su aplicación. Cuando sube una nueva versión de su aplicación utilizando la --delta flag, Capgo realiza lo siguiente:

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

Cuando un dispositivo que ejecuta su aplicación verifica 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 los caminos 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.

Manifesto

En caso de actualizaciones de Delta (manifesto), 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 de Delta (Manifesto)

Para habilitar las actualizaciones de Delta (manifesto) para tu aplicación Capgo, simplemente utiliza la --delta ventana de terminal

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

está habilitado en tu directUpdate , el __CAPGO_KEEP_0__ lo detecta. En entornos no interactivos envía actualizaciones de Delta (manifesto) automáticamente, y en entornos interactivos te pide confirmación antes de subir. capacitor.config, the CLI detects it. In non-interactive environments it sends Delta (manifest) updates automatically, and in interactive environments it prompts you to confirm before uploading. Use --no-delta para forzar una carga de paquetes completa.

Actualización de Delta (Manifiesto)

Si desea asegurarse de que todas las cargas sean actualizaciones de Delta (manifiesto) y evitar cualquier carga de paquetes completa accidental, puede utilizar el --delta-only flag:

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

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

Puede querer utilizar --delta-only si:

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

Si necesitas hacer una subida de paquete completo mientras --delta-only está configurado, simplemente ejecuta el comando de subida sin --delta-only. Esto sobrescribirá la configuración para esa sola subida, permitiéndote enviar un paquete completo cuando sea necesario

Solución de problemas

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

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

También puede utilizar 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 del indicador de estadísticas.
4. Seleccione el último conjunto
5. Verifique el Partial campo

Si continúan teniendo problemas, por favor, contacten 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 indica a Capgo que realice las subidas de archivos individuales y la generación de manifestos necesarios para las actualizaciones de Delta (manifest).

Tenga en cuenta que debe utilizar --delta cada vez que suba una nueva versión que desee ser entregada como una actualización de Delta (manifest). Si omite la bandera, Capgo subirá el conjunto de JS completo como un archivo único, y los dispositivos descargarán el conjunto completo incluso si solo ha cambiado una pequeña parte.