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

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

Funcionamiento de las actualizaciones Delta (Manifiesto)

Las actualizaciones Delta (manifest) en Capgo se manejan mediante el plugin Capgo instalado en tu aplicación. Cuando subes una nueva versión de tu aplicación utilizando el --delta flag, Capgo realiza lo siguiente:

1. Cada archivo de tu build 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 ejecutando tu aplicación busca una actualización, el plugin Capgo recibe el nuevo manifiesto desde el servidor. Lo compara con el que actualmente tiene, identificando los archivos que han cambiado basándose en las sumas de verificación y 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 (manifest), 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 utiliza la --delta flag al subir 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 Delta (manifiesto) automáticamente, y en entornos interactivos te solicita confirmación antes de subir. Configuración legado sigue siendo detectada. Utiliza directUpdate Habilitar actualizaciones Delta (Manifiesto) --no-delta para forzar una carga de paquete completa.

Limitaciones de actualización Delta

• Archivos vacíos: Los registros CLI Ignoring empty file... y excluye archivos de cero bytes del manifiesto Delta. No falla la carga, por lo que agregar un archivo vacío puede cambiar el paquete resultante sin detener su despliegue. No incluya archivos de cero bytes en las rutas del paquete Delta.
• Espacios en rutas: Las cargas Delta fallan antes de cargar archivos cuando una ruta de paquete contiene un espacio. Renombre el archivo o directorio para eliminar espacios antes de cargar una actualización Delta.

Implicar actualizaciones Delta (Manifiesto)

Si desea asegurarse de que todas las cargas sean actualizaciones Delta (manifiesto) y prevenir cualquier carga accidental de paquete completo, puede utilizar la --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 Delta (manifiesto) no podrá descargar la actualización.

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

• Siempre quiere utilizar actualizaciones Delta (manifiesto) y nunca quiere permitir subidas de paquetes completos
• Está configurando una pipeline CI/CD y quiere asegurarse de que todas las subidas automatizadas sean 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 hacer una subida de paquete completo mientras --delta-only está configurado, simplemente ejecute la orden de subida sin --delta-only. Esto sobrescribirá la configuración para esa sola subida, permitiéndole enviar un paquete completo cuando sea necesario.

Resolució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, compruebe 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

También puedes utilizar la aplicación web Capgo para verificar los detalles de tu última subida:

1. Ve a webapp
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 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 necesita usar --delta cada vez que suba una nueva versión que desee que se entregue como una actualización de Delta (manifest). Si omite la bandera, Capgo subirá el conjunto de archivos JS completo como un archivo único, y los dispositivos descargarán el conjunto de archivos completo incluso si solo ha cambiado una pequeña parte.

Sigue adelante desde actualizaciones de Delta

Si estás utilizando Actualizaciones de 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 el detalle 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 Update Behavior, y Tipos de Actualización para el detalle de implementación en Tipos de Actualización.