Actualizaciones Delta

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 medibles, ya que minimiza la cantidad de datos que deben descargarse.

A un segundo beneficio es cuando la aplicación tenga grandes activos 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 Delta (Manifiesto)

Las actualizaciones Delta (manifiesto) en Capgo se manejan por el plugin Capgo instalado en tu aplicación. Cuando subas una nueva versión de tu aplicación utilizando la --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, 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 ejecutando 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 según 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.

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á configurado en un modo de aplicación instantánea ( autoUpdate o"atInstall", "onLaunch") en tu "always"Manifesto capacitor.configEn CLI, se detecta. En entornos no interactivos, envía actualizaciones Delta (manifest) automáticamente, y en entornos interactivos, te pide confirmación antes de subir. directUpdate Usa --no-delta para forzar una subida de paquete completa.

Limitaciones de actualización Delta

• Archivos vacíos: El CLI registra Ignoring empty file... y excluye archivos de cero bytes del manifiesto Delta. No falla la subida, por lo que agregar un archivo vacío puede cambiar el paquete resultante sin detener tu despliegue. No incluya archivos de cero bytes en rutas de paquete Delta.
• Espacios en rutas: Las subidas Delta fallan antes de subir archivos cuando una ruta de paquete contiene un espacio. Renombra el archivo o directorio para eliminar espacios antes de subir una actualización Delta.

Actualizaciones Delta (Manifiesto) obligatorias

If you want to ensure that all uploads are Delta (manifest) updates and prevent any accidental full bundle uploads, you can use the --delta-only flag:

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

When --delta-only is used, Capgo will only upload individual files and generate a manifest. Any device that does not support Delta (manifest) updates will not be able to download the update.

You might want to use --delta-only if:

• You always want to use Delta (manifest) updates and never want to allow full bundle uploads
• You’re setting up a CI/CD pipeline and want to ensure all automated uploads are Delta (manifest)
• Su aplicación es grande y la banda ancha está limitada, por lo que necesita minimizar los tamaños de carga/subida

If you need to do a full bundle upload while --delta-only simplemente ejecuta la orden de subida sin --delta-onlyEsto sobreescribirá la configuración para esa sola subida, permitiéndote enviar un paquete completo cuando sea necesario.

Resolución de problemas

Si las actualizaciones de Delta (manifest) 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 la --delta flag
• 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

También puede utilizar la aplicación web Capgo para verificar los detalles de su última carga:

1. Vaya 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, póngase en contacto con el Capgo soporte para obtener asistencia adicional. Pueden verificar los registros del servidor para confirmar que sus cargas 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 cargas de archivos individuales y la generación de manifestos necesarios para las actualizaciones Delta (manifest).

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

Sigue adelante desde actualizaciones Delta

Si estás utilizando Actualizaciones delta conectarla con Capgo Live Updates para el flujo de trabajo del producto en Capgo Actualizaciones en vivo, Resumen Para la implementación en detalle 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.