Mises à jour Delta

Copiez un prompt de configuration avec les étapes d'installation et le guide Markdown complet pour ce plugin.

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 zippés, ils seront téléchargés qu'une seule fois.

Comment les mises à jour Delta (Manifest) fonctionnent

Les mises à jour delta (manifest) 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 opérations suivantes :

Chaque fichier de votre build est téléchargé individuellement
Des sommes de contrôle sont générées pour chaque fichier
Un nouveau manifeste JSON est créé, listant tous les fichiers et leurs sommes de contrôle
This manifest is uploaded to the Capgo base de données

Lorsqu'un appareil exécutant votre application vérifie une mise à jour, le plugin Capgo reçoit le nouveau manifest de serveur. Il compare ce manifest à 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à.

Activer les actualisations Delta (manifeste)

Pour activer les actualisations Delta (manifeste) pour votre application Capgo, utilisez simplement la --delta drapeau lors de l'upload d'une nouvelle version :

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

If autoUpdate est défini sur un mode d'application instantané ("atInstall", "onLaunch", ou "always") dans votre capacitor.config, le CLI le détecte. Dans les environnements non interactifs, il envoie des mises à jour Delta (manifeste) automatiquement, et dans les environnements interactifs, il vous invite à confirmer avant de télécharger. La configuration Legacy est toujours détectée. Utilisez directUpdate pour forcer une mise à jour de bundle complet. --no-delta Forcer les mises à jour Delta (Manifeste)

Si vous souhaitez vous assurer que toutes les mises à jour sont des mises à jour Delta (manifeste) et prévenir tout téléchargement de bundle complet accidentel, vous pouvez utiliser la

Fenêtre de terminal --delta-only Enforcing Delta (Manifest) Updates

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 (manifeste) ne pourra pas télécharger la mise à jour.

Vous pourriez vouloir utiliser --delta-only si :

Vous voulez toujours utiliser les mises à jour Delta (manifeste) et ne voulez jamais autoriser les téléchargements de bundles complets
Vous configurez une pipeline CI/CD et voulez vous assurer que toutes les téléchargements automatisés sont des mises à jour Delta (manifeste)
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 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-onlyCela surpassera la mise en œuvre de la mise en œuvre pour cette seule mise à jour, vous permettant de pousser un bundle complet lorsque nécessaire.

Dépannage

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 la --delta flag à chaque fois que vous publiez une nouvelle version
Si vous utilisez --delta-only, assurez-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 dernière mise à jour :

Allez dans l'application web webapp
Appuyez sur votre application
Appuyez sur le nombre de bundles de la barre de statistiques.
Sélectionnez le dernier bundle
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 de 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 de 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 de mise à jour de Delta (manifest). Si vous omettez la drapeau, Capgo téléchargera l'ensemble 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é.

Continuez des mises à jour de Delta

Si vous utilisez Mises à jour Delta pour planifier la livraison d'actualisations en direct, connectez-le avec Capgo Mises à jour en direct pour le flux de travail du produit dans Capgo Mises à jour en direct, Vue d'ensemble pour les détails d'implémentation dans Vue d'ensemble, Caractéristiques pour les détails d'implémentation dans Caractéristiques, Comportement de mise à jour pour les détails d'implémentation dans Comportement de mise à jour, et Mises à jour de type pour le détail d'implémentation dans Mises à jour de type.