Mises à jour Delta

Copiez un prompt de configuration avec les étapes d'installation et la guide markdown complète pour ce plugin.

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.

This is especially beneficial for users on slower or network connections, as it minimizes the amount of data that needs to be downloaded.

Un deuxième avantage est lorsque l'application a des actifs importants 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 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
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 qui ont changé en fonction des sommes de contrôle et des chemins de fichiers.

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

Le système d'exploitation peut la nettoyer à tout moment, mais __CAPGO_KEEP_0__ ne le fait jamais.

To enable Delta (manifest) updates for your Capgo app, simply use the --delta Pour activer les actualisations Delta (manifeste) pour votre application __CAPGO_KEEP_0__, utilisez simplement le

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

Copier dans le presse-papier autoUpdate Si"atInstall", "onLaunch"est défini sur un mode d'application instantané (", ou " "always"en utilisant capacitor.config, le CLI le détecte. Dans les environnements non interactifs, il envoie des mises à jour Delta (manifest) automatiquement, et dans les environnements interactifs, il vous demande de confirmer avant de téléverser. Héritage directUpdate la configuration est toujours détectée. Utilisez --no-delta pour forcer un téléversement de paquet complet.

Forcer les mises à jour Delta (Manifeste)

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

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

est utilisé, __CAPGO_KEEP_0__ ne téléversera que des fichiers individuels et générera un manifeste. Toute appareil qui ne supporte pas 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, vous pouvez simplement exécuter 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.

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 le --delta marquer chaque fois que vous publiez une nouvelle version
Si vous utilisez --delta-only, assurez-vous d'avoir omis par accident 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 upload :

Allez à la application web
Cliquez sur votre application
Cliquez sur le nombre de bundles de la barre des 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 Delta (manifest) sont traités correctement et que les appareils reçoivent les mises à jour de manifestes.

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 de mise à jour Delta (manifest). Si vous omettez la drapeau, Capgo téléchargera l'intégralité du paquet JS sous forme de fichier unique, et les appareils téléchargeront l'ensemble du paquet même si seulement une petite partie a changé.

Continuez avec les mises à jour Delta

Si vous utilisez mises à jour Delta pour planifier la livraison d'actualisations en direct, connectez-le à Capgo Mises à jour en direct pour le flux de travail du produit dans Capgo Mises à jour en direct, Vue d'ensemble pour le détail d'implémentation dans Vue d'ensemble, Fonctionnalités pour le détail d'implémentation dans Fonctionnalités, Comportement de mise à jour pour le détail d'implémentation dans Comportement de mise à jour, et Types de mise à jour pour le détail d'implémentation dans Types de mise à jour.