Mises à jour Delta

Le système d'actualisation en direct de Capgo peut transmettre des mises à jour plus rapidement et de manière plus efficace en envoyant uniquement les fichiers modifiés, plutôt que le bundle JS complet.

Cela est particulièrement bénéfique pour les utilisateurs sur des connexions réseau plus lentes ou facturées, car cela minimise la quantité de données qui doivent être téléchargées.

Un deuxième avantage est lorsque l'application possède de grands éléments qui changent rarement, comme des images ou des vidéos, comparés aux fichiers JS compressés, ils seront téléchargés uniquement une fois.

Comment les mises à jour Delta (Manifeste) fonctionnent

Les mises à jour Delta (manifeste) dans Capgo sont gérées par le plugin Capgo installé dans votre application. Lorsque vous téléchargez une nouvelle version de votre application en utilisant la --delta drapeau, Capgo effectue les étapes suivantes :

1. Chaque fichier de votre build est téléchargé individuellement
2. Des sommes de contrôle sont générées pour chaque fichier
3. Un nouveau manifeste JSON est créé, listant tous les fichiers et leurs sommes de contrôle
4. Ce manifeste est téléchargé dans la base de données Capgo

Lorsqu'un appareil exécutant votre application vérifie une mise à jour, le plugin Capgo reçoit le nouveau manifeste du serveur. Il compare ce manifeste à celui qu'il a actuellement, identifiant les fichiers modifiés en fonction des checksums et des chemins de fichiers.

Le plugin télécharge ensuite uniquement les fichiers modifiés, plutôt que le bundle JS complet. Il reconstruit la nouvelle version de l'application en combinant ces fichiers téléchargés avec les fichiers inchangés qu'il a déjà.

Manifeste

Dans le cas des mises à jour Delta (manifeste), l'appareil stocke tous les fichiers téléchargés dans une cache commune. Le Capgo ne les nettoie jamais, mais l'OS peut le faire à tout moment.

Activer les mises à jour Delta (manifeste)

Pour activer les mises à jour Delta (manifeste) pour votre application Capgo, utilise simplement la --delta flag lors de la téléchargement d'une nouvelle version :

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

Si elle est activée dans votre directUpdate , le __CAPGO_KEEP_0__ la détecte. Dans les environnements non interactifs, il envoie automatiquement les mises à jour Delta (manifeste), et dans les environnements interactifs, il vous invite à confirmer avant de télécharger. capacitor.config, the CLI detects it. In non-interactive environments it sends Delta (manifest) updates automatically, and in interactive environments it prompts you to confirm before uploading. Use --no-delta pour forcer une mise à jour de l'ensemble du bundle.

Mise en œuvre des mises à jour Delta (manifeste)

flag : --delta-only Fenêtre de terminal

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

est utilisé, le __CAPGO_KEEP_0__ n'upload que des fichiers individuels et génère un manifeste. Toute appareil qui ne prend pas en charge les mises à jour Delta (manifeste) ne pourra pas télécharger la mise à jour. --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.

Vous pourriez vouloir utiliser --delta-only si :

• Vous souhaitez toujours utiliser les mises à jour Delta (manifest) et ne voulez jamais autoriser les téléchargements de bundles complets
• Vous configurez une pipeline CI/CD et vous souhaitez vous assurer que toutes les téléchargements automatiques sont des mises à jour Delta (manifest)
• Votre application est importante et la bande passante est limitée, vous devez donc minimiser les tailles de téléchargement/ téléchargement

Si vous avez besoin de faire un téléchargement de bundle complet alors que --delta-only est défini, simplement exécutez la commande de téléchargement sans --delta-only. Cela surpassera la mise en place pour ce seul téléchargement, vous permettant de pousser un bundle complet lorsque nécessaire

Résolution des problèmes

Si les mises à jour Delta (manifest) ne semblent pas fonctionner (c'est-à-dire que les appareils téléchargent toujours le bundle JS complet même pour de petites modifications), vérifiez que :

• Vous utilisez le --delta indiquez chaque fois que vous publiez une nouvelle version
• Si vous utilisez --delta-onlyn'oubliez pas de ne pas avoir omis le --delta flag
• Votre appareil exécute la dernière version du plugin Capgo
• Votre appareil dispose d'une connexion réseau stable et peut atteindre les serveurs Capgo

Vous pouvez également utiliser l'application web Capgo pour vérifier les détails de votre dernier téléchargement :

1. Allez à la application web
2. Cliquez sur votre application
3. Cliquez sur le nombre de bundles de la barre des statistiques.
4. Sélectionnez le dernier bundle
5. Vérifiez le champ Partial le champ

Si vous continuez à rencontrer des difficultés, veuillez contacter le support Capgo pour obtenir une aide supplémentaire. Ils peuvent vérifier les journaux du serveur pour confirmer que vos téléchargements Delta (manifest) sont traités correctement et que les appareils reçoivent les mises à jour de manifeste.

C'est tout ! La --delta drapeau indique à Capgo de procéder aux téléchargements de fichiers individuels et à la génération de manifeste nécessaires aux mises à jour Delta (manifeste).

Notez que vous devez utiliser --delta chaque fois que vous téléchargez une nouvelle version que vous souhaitez être livrée sous forme de mise à jour Delta (manifeste). Si vous omettez le drapeau, Capgo téléchargera l'intégralité du bundle JS sous forme de fichier unique, et les appareils téléchargeront l'ensemble du bundle même si seulement une petite partie a changé.