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, en comparación 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 subas una nueva versión de tu aplicación con la --delta flag, Capgo realiza lo siguiente:

1. Cada archivo de tu compilación se sube individualmente
2. Se generan sumas de verificación para cada archivo
3. Se crea un nuevo manifiesto JSON, que lista todos los archivos y sus sumas de verificación
4. Este manifiesto se sube a la base de datos 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 en función de 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.

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 las 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 de Delta (manifest) automáticamente, y en entornos interactivos te pide confirmación antes de subir. El directUpdate config de legado todavía se detecta. Utiliza --no-delta para forzar una subida de paquete completa.

Hacer cumplir actualizaciones de Delta (Manifest)

Si deseas asegurarte de que todas las subidas sean actualizaciones de Delta (manifest) y evitar cualquier subida accidental de paquetes completos, puedes utilizar la --delta-only flag:

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

Cuando --delta-only si 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.

Puede que desee utilizar --delta-only si:

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

Si necesitas hacer una subida de paquete completo mientras --delta-only está configurado, 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 descargan el paquete JS completo incluso para cambios pequeños), compruebe que:

• Estás utilizando la --delta flag cada vez que subes una nueva versión
• Si estás utilizando --delta-only, asegú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 de Capgo

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

1. Ve a la idioma objetivo: Español
2. tokens protegidos: ["Cloudflare", "Capacitor", "GitHub", "Capgo", "code", "API", "SDK", "CLI", "npm", "bun"]
3. webapp
4. Haz clic en tu aplicación
5. Haz clic en el número de paquetes de la barra de estadísticas. Partial Selecciona el último paquete

If you continue to have trouble, please reach out to Capgo support for further assistance. They can check the server logs to confirm that your Delta (manifest) uploads are being processed correctly and that devices are receiving the updated manifests.

tipo de paquete --delta Si continúas teniendo problemas, por favor, contacta con el soporte de Capgo para obtener asistencia adicional. Pueden verificar los registros del servidor para confirmar que tus subidas de Delta (manifest) se están procesando correctamente y que los dispositivos están recibiendo los manifiestos actualizados.

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

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.