Mises à jour Delta

Copier 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 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 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 (Manifest) 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 à l'aide du --delta flag, Capgo fait les choses 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é sur 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 complet. 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à.

Activer les actualisations Delta (Manifeste)

Pour activer les mises à jour Delta (manifeste) pour votre application Capgo, utilisez simplement le --delta flag lors de l'upload d'une nouvelle version :

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

Si 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 automatiquement les mises à jour Delta (manifeste), et dans les environnements interactifs, il vous demande de confirmer avant de l'uploader. La configuration Legacy est toujours détectée. Utilisez directUpdate pour forcer un upload complet du paquet. --no-delta Mettre en œuvre les mises à jour Delta (Manifeste)

Environnement

Si vous souhaitez vous assurer que toutes les mises à jour sont des mises à jour Delta (manifeste) et empêcher 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 (manifeste) ne pourra pas télécharger la mise à jour.

Vous pourriez vouloir utiliser --delta-only si :

Vous voulez toujours utiliser des mises à jour Delta (manifeste) et ne voulez jamais autoriser des téléchargements de bundle complets
Vous configurez une pipeline CI/CD et vous voulez vous assurer que toutes les mises à jour automatiques sont des mises à jour Delta (manifeste)
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 devez effectuer une mise à jour complète du bundle tout en ayant activé la fonctionnalité Delta, vous pouvez simplement exécuter la commande de mise à jour sans le paramètre. --delta-only Cette commande remplacera la configuration pour cette seule mise à jour, vous permettant de pousser un bundle complet lorsque nécessaire. --delta-onlyRésolution des problèmes

Section intitulée “Résolution des problèmes”

Vous utilisez la

flag à chaque fois que vous mettez à jour une nouvelle version --delta Si vous utilisez
, assurez-vous d'avoir bien inclus la --delta-onlyflag --delta Votre appareil exécute la dernière version du plugin __CAPGO_KEEP_0__
Your device is running the latest version of the Capgo plugin
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 :

Allez à l' application web
Cliquez sur votre application
Cliquez 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 obtenir de l'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 ! Le --delta le drapeau indique à Capgo de procéder aux téléchargements de fichiers individuels et à la génération du 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é.

Continuez des mises à jour Delta

Si vous utilisez les 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, Résumé pour les détails d'implémentation dans Résumé, 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.