De la version V3 à la version V4

Pourquoi cette mise à niveau

Après de nombreuses discussions dans la communauté Discord avec vous. J'ai découvert que le mode manuel était trop manuel et pas sûr à utiliser, par exemple, la réversion automatique n'était pas possible, donc si vous avez échoué à mettre à jour en mode manuel, l'utilisateur devait supprimer l'application et l'installer à nouveau, ce qui est un terrible UX.

Je me suis aperçu que c'était une occasion de vous donner plus de liberté et de supprimer tous les mauvais code que j'ai faits.

Installation

npm i @capgo/capacitor-updater@4

Mise à jour automatique cloud

Si vous utilisez l'exemple de base dans votre application, vous êtes en sécurité pour migrer vers la nouvelle version, profitez-en !

Mise à jour automatique auto-hébergée

Pour vous, toujours simple, les changements sont :

• Le nom de la mise en forme de la configuration à partir de autoUpdateUrl en updateUrl
• La méthode de point de terminaison a changé de GET à POST

Utilisateurs manuels

Pour vous, c'est le changement le plus significatif, mais pour le meilleur ! Vous obtenez des améliorations à profusion, Lisez attentivement.

Changements

• autoUpdateUrl devient updateUrl Depuis que cette configuration peut être utilisée en mode manuel également.
• Suppression de cancelDelay et delayUpdate en faveur de setDelay
• Pas plus versionName en ensemble
• Mettre à jour version clé qui a été renvoyée dans la plupart des fonctions vers un objet BundleInfo

interface BundleInfo {
  id: string;
  version: string;
  downloaded: string;
  status: 'success' | 'error' | 'pending' | 'downloading'
}

• Les anciens noms trompeurs ont été renommés (même si l'explication ne peut pas être claire, mais à l'utilisation, le nouveau est facile à comprendre :
  • ce qui était appelé un version fait maintenant référence à un bundle
  • id faisait référence à l'ancien version qui était une chaîne aléatoire de 10 caractères, cela id est la seule façon fiable et unique d'accéder à vos ensembles, par exemple 7Dfcd2RedN.
  • version fait maintenant référence à versionName que vous avez choisi pour un ensemble, par exemple 1.0.0
• updateUrl passer de get à postpuisqu'en-têtes personnalisés étaient un problème pour certains d'entre vous et post est plus logique, tous les en-têtes précédents vont dans le corps et le préfixe cap_ disparaît.
• versionName méthode est supprimée, au profit de getId
• liste retourne maintenant une liste de BundleInfo
• Renommer getId dans getDeviceId
• autoUpdate devient vrai par défaut, si vous utilisez le mode Manuel, définissez-le sur faux.

Actualités

• Méthode getLatest, cette méthode vous permet d'obtenir de votre serveur configuré avec updateUrl la dernière version disponible.
• Méthode setDelay qui prennent {genre: “arrière-plan” | “tuer” | “version native” | “date”, valeur? : chaîne} en tant qu'argument pour définir le délai dans différentes modes.
• Méthode next, pour définir la version dans le prochain arrière-plan, à l'opposé de set qui le fait instantanément.
• Méthode isAutoUpdateEnabled, pour vous informer si vous êtes dans le contexte de mise à jour automatique
• Événement downloadComplete lorsque le téléchargement atteint 100%
• Champ obligatoire ajouté version dans la méthode de téléchargement
• notifyAppReady devient obligatoire également en mode manuel, si ce n'est pas appelé après 10 sec l'application revient à la version précédente.

Contributeurs

@lincolnthree Merci beaucoup de lancer ce travail, cela aurait été impossible de faire cette mise à jour fonctionner sans vous.

Continuez de partir de V3 vers V4

Si vous utilisez V3 vers V4 pour planifier la livraison d'actualisations en direct, connectez-l’avec Capgo Mises à jour en direct for the product workflow in Capgo Live Updates, pour le flux de travail du produit dans __CAPGO_KEEP_0__ Mises à jour en direct, » : « Présentation pour les détails d'implémentation dans L'aperçu Fonctionnalités 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 Modifier la page