Diferencias de actualizaciones

El sistema de Capgo de Live Update puede entregar actualizaciones más rápido y de manera más 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 grandes activos que cambian raramente, como imágenes o videos, comparado con los archivos JS comprimidos, se descargan solo una vez.

Cómo funcionan las actualizaciones delta.

Las actualizaciones delta en Capgo se manejan por el plugin Capgo instalado en tu aplicación. Cuando subes una nueva versión de tu aplicación con la bandera ‘Capgo’ hace lo siguiente: --delta bandera, Capgo realiza lo siguiente:

1. Se generan sumas de comprobación para cada archivo delta.
2. Se generan sumas de comprobación para cada archivo delta
3. La lista de archivos delta, con sus rutas y sumas de comprobación, se almacena en la base de datos Capgo.

When a device running your app checks for an update, the Capgo plugin receives the list of delta files for the new bundle. It compares it to the files it already has, identifying which files have changed based on the checksums and file paths.

El plugin descarga entonces 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 sin cambios que ya tiene.

Cache de archivo delta

Con las actualizaciones Delta, el dispositivo almacena todos los archivos delta descargados en un caché común. Capgo nunca lo limpia, pero el sistema operativo puede hacerlo en cualquier momento.

¿Qué dispositivos obtienen Delta y cuáles obtienen el zip completo?

Un paquete subido con --delta Tiene tanto archivos zip completos como delta. En un canal con la configuración por defecto Zip + delta formato de descarga, cada dispositivo obtiene el paquete mejor que soporta:

• Dispositivos en una versión de plugin con soporte para Delta (5.10.0+, 6.25.0+, 7.0.35+o 8+descarguen solo los archivos delta modificados.
• Los dispositivos con una versión antigua del plugin sin soporte de Delta descargan el zip completo.
• No se subieron bundles con --delta No tienen archivos delta, por lo que cada dispositivo descarga el zip completo.

Espera ver algunos descargas de zip completo después de habilitar Delta. Proceden de dispositivos que aún ejecutan una construcción nativa antigua con una versión antigua del plugin. Desaparecen a medida que los usuarios actualizan la aplicación desde la tienda.

Puedes cambiar esto por canal con el Formato de descarga Configuración.

Actualizaciones delta y uso de ancho de banda

Delta updates also lower your Capgo bandwidth usage. Bandwidth only counts the files a device actually downloads, so with Delta only the changed files count, not the whole bundle. Files or full zips already cached at the edge do not count, and interrupted downloads resume where they stopped without counting the downloaded part twice. See ¿Cómo se cuenta el ancho de banda?.

Habilitar actualizaciones Delta

Para habilitar actualizaciones Delta para tu aplicación Capgo, simplemente utiliza el --delta flag al subir una nueva versión:

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

Usar --delta con modos de aplicación instantánea

Cuando autoUpdate es "atInstall", "onLaunch", o "always", subir con --delta. Estos modos se aplican mientras el usuario espera, por lo que un zip completo ralentiza la experiencia del usuario. También requieren autoSplashscreen: true y @capacitor/splash-screen . Ver launchAutoHide: false. See Comportamiento de Actualización.

If autoUpdate is set to an instant apply mode ("atInstall", "onLaunch") en tu "always") en su capacitor.config, el CLI lo detecta. En entornos no interactivos envía actualizaciones Delta automáticamente, y en entornos interactivos te pide confirmación antes de subir. directUpdate config se sigue detectando. Utilice --no-delta forzar una subida de paquete completa.

Limitaciones de actualizaciones delta

• Archivos vacíos: Los registros de CLI Ignoring empty file... y excluye archivos de cero bytes de los archivos 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 rutas de paquetes delta.
• Espacios en rutas: Las subidas delta fallan antes de subir archivos cuando una ruta de paquete contiene un espacio. Renombre el archivo o directorio para eliminar espacios antes de subir una actualización delta.

Actualizaciones delta obligatorias

Si desea asegurarse de que todas las subidas sean actualizaciones delta y evitar cualquier carga de paquete completo accidental, puede utilizar la --delta-only flag:

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

Cuando --delta-only se utiliza, Capgo solo subirá los archivos delta, sin un zip completo. Cualquier dispositivo en una versión de plugin sin soporte de Delta no podrá descargar la actualización.

Puede que desee utilizar --delta-only si:

• Si siempre deseas utilizar actualizaciones Delta y nunca deseas permitir subidas de paquetes completos
• Si está configurando una pipeline CI/CD y quiere asegurarse de que todas las subidas automatizadas sean Delta
• Su aplicación es grande y la banda ancha está limitada, por lo que necesita minimizar los tamaños de carga/subida.

Si necesita hacer una subida de paquete completo mientras --delta-only está configurado, simplemente ejecute la orden de subida sin --delta-only . Esto sobreescribirá la configuración para esa sola subida, permitiéndole enviar un paquete completo cuando sea necesario.

Troubleshooting

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

• Estás utilizando el --delta flag cada vez que subas una nueva versión
• Si utilizando --delta-onlyAsegúrese de no haber omitido accidentalmente los. --delta flag
• Tu dispositivo está ejecutando una versión de plugin con soporte para Delta (5.10.0+, 6.25.0+, 7.0.35+o 8+)
• El formato de descarga del canal no es Solo zip completo
• Tu dispositivo tiene una conexión de red estable y puede alcanzar los servidores Capgo

Usted también puede utilizar la Capgo aplicación web para verificar los detalles de su última subida:

1. Pase 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 la Delta files fila. Muestra No hay archivos delta cuando el paquete se subió como un archivo zip completo.

Si continúa teniendo problemas, por favor, póngase en contacto con el Capgo soporte para obtener asistencia adicional. Ellos pueden verificar los registros del servidor para confirmar que sus subidas Delta se están procesando correctamente y que los dispositivos están recibiendo los archivos delta.

¡Eso es todo! El --delta La bandera indica a Capgo que suba los archivos delta individuales necesarios para las actualizaciones Delta.

Ten en cuenta que debes utilizar --delta debes utilizar cada vez que subas una nueva versión que deseas que se entregue como una actualización Delta. Si omites la bandera, Capgo subirá el conjunto de JS completo como un archivo único, y los dispositivos descargarán el conjunto completo aunque solo haya cambiado una pequeña parte.

Sigue adelante desde las actualizaciones Delta

Si estás utilizando actualizaciones Delta Para planificar la entrega de live update, conecta con Capgo Live Updates para el flujo de trabajo del producto en Capgo Live Updates, Resumen para el detalle de implementación en Overview, 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.