[Mises à jour Delta]

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

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.

A un autre bénéfice, lorsque l'application possède de grands éléments qui changent rarement, comme des images ou des vidéos, par rapport aux fichiers JS compressés, il sera téléchargé qu'une seule 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 flag, Capgo effectue les opérations 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 possède actuellement, identifiant les fichiers qui ont changé en fonction des sommes de contrôl’et des chemins de fichiers.

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

Manifeste

Dans le cas d'actualisations Delta (manifeste), l'appareil stocke tous les fichiers téléchargés dans un cache commun. Le Capgo ne le nettoie jamais, mais le système d'exploitation 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 Fenêtre de terminal

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

est défini sur un mode d'application instantanée ( autoUpdate ou"atInstall", "onLaunch") "always"protectedTokens capacitor.configLa CLI détecte cela. Dans les environnements non interactifs, elle envoie des mises à jour Delta (manifest) automatiquement, et dans les environnements interactifs, elle vous invite à confirmer avant de télécharger. Legacy directUpdate Utilisez la commande --no-delta pour forcer une mise à jour de bundle complète.

Limites des mises à jour Delta

• Fichiers vides : La CLI enregistre Ignoring empty file... et exclut les fichiers de zéro octets du manifeste Delta. Elle ne fait pas fail l'upload, donc l'ajout d'un fichier vide peut modifier le bundle résultant sans arrêter votre déploiement. N'incluez pas les fichiers vides dans les chemins de bundle Delta.
• Espaces dans les chemins : Les mises à jour Delta échouent avant de télécharger les fichiers lorsque un chemin de bundle contient un espace. Renommez le fichier ou le répertoire pour supprimer les espaces avant de télécharger une mise à jour Delta.

Mettre en œuvre les mises à jour Delta (Manifeste)

If vous souhaitez vous assurer que toutes les téléchargements sont des mises à jour Delta (manifest) et prévenir tout téléchargement de bundle complet par erreur, vous pouvez utiliser le --delta-only flag:

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

Lorsque --delta-only est utilisé, Capgo ne téléchargera que des fichiers individuels et générera un manifeste. Toute appareil qui ne prend pas en charge les mises à jour Delta (manifest) ne pourra pas télécharger la mise à jour.

Vous pourriez vouloir utiliser --delta-only si:

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

Si vous devez effectuer un téléchargement de bundle complet --delta-only est défini, lancez simplement la commande d'upload sans --delta-only Ceci écrasera la configuration pour cet upload unique, vous permettant de pousser un bundle complet lorsque nécessaire.

Résolution des problèmes

Si les mises à jour Delta (manifeste) 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 la --delta flag à chaque fois que vous uploadez une nouvelle version
• Si vous utilisez --delta-onlyassurez-vous d'avoir bien inclus la --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 à l' 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 Partial champ

Si vous continuez à rencontrer des difficultés, veuillez contacter le support Capgo pour 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 manifestes mis à jour.

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

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

Continuez avec les mises à jour Delta

Si vous utilisez mises à jour Delta context Capgo Live Updates for the product workflow in Capgo Live Updates, __CAPGO_KEEP_0__ Mises à jour en direct context Page/area: Page de produit de mise à jour en direct. Role: Étiquette de navigation ou élément UI court. Voir dans: page live-update.astro. Préservez les termes de produit/marque et les termes de développeur exactement. Message clé `live_update_hero_badge` (Badge de mise à jour en direct Héros). pour les détails d'implémentation dans les fonctionnalités Comportement de mise à jour pour les détails d'implémentation dans le Comportement de mise à jour, et Types de mise à jour pour les détails d'implémentation dans les Types de mise à jour.