Actualizaciones de Delta

El sistema de actualizaciones 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 medidoras, ya que minimiza la cantidad de datos que deben descargarse.

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

Cómo funcionan las actualizaciones de delta (manifest)

Las actualizaciones de delta (manifest) en Capgo se manejan por el plugin Capgo instalado en tu aplicación. Cuando subas una nueva versión de tu aplicación utilizando el --delta flag, 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 base de datos de Capgo

Cuando un dispositivo que ejecuta tu aplicación busca una actualización, el plugin Capgo recibe el nuevo manifiesto desde el servidor. Compara este manifiesto 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 que han cambiado, en lugar de todo el paquete JS. Reconstruye la nueva versión de la aplicación combinando estos archivos descargados con los archivos que ya tiene que no han cambiado.

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 de Delta (manifesto) para tu aplicación Capgo, simplemente utiliza la --delta bandera 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 (manifesto) automáticamente, y en entornos interactivos, te pide que confirmes antes de subir. La configuración de legado todavía se detecta. Utiliza directUpdate para forzar una subida de paquetes completa. --no-delta Impone actualizaciones de Delta (Manifiesto)

Impone actualizaciones de Delta (Manifiesto)

Si desea asegurarse de que todas las subidas sean actualizaciones de Delta (manifiesto) y evitar cualquier subida accidental de paquetes completos, puede 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 manifiesto. Cualquier dispositivo que no admita actualizaciones de Delta (manifiesto) no podrá descargar la actualización.

Quizás desee utilizar --delta-only if:

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

Si necesita realizar un subir paquete completo mientras --delta-only está configurado, simplemente ejecute el comando de subir sin --delta-onlyEsto sobrescribirá la configuración para ese solo subir, permitiéndole empujar un paquete completo cuando sea necesario.

Solución de problemas

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

• Está utilizando la --delta bandera cada vez que sube una nueva versión
• Si está utilizando --delta-onlyasegúrese de no haber omitido accidentalmente la --delta bandera
• Su dispositivo está ejecutando la versión más reciente 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 carga:

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

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

¡Eso es todo! --delta El flag Capgo indica a Capgo que realice las subidas de archivos individuales y la generación de manifiesto necesarios para las actualizaciones Delta (manifiesto).

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

Sigue adelante con las actualizaciones Delta

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