De V3 à 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 non sécurisé à utiliser, par exemple, la réversion automatique n'était pas possible, donc si vous aviez é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 !

Auto-mise à jour auto-hébergée

Pour vous, toujours simple, les changements sont :

• Le nom de la configuration de autoUpdateUrl en updateUrl
• La méthode d'endpoint 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 à la pelle, Lisez attentivement.

Changements

• autoUpdateUrl devient updateUrl puisque cette configuration peut désormais être utilisée en mode manuel également
• Suppression de cancelDelay et delayUpdate au profit de setDelay
• Plus de versionName dans la configuration
• Modification version clé, qui était renvoyée dans la plupart des fonctions à l'objet BundleInfo

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

• Renommage des noms trompeurs maintenant (même si l'explication ne peut pas être claire, mais à l'utilisation, c'est facile à comprendre le nouveau) :
  • 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 à postpuisquels 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 getLatestCette 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 les différents 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 est devenu obligatoire également en mode manuel, si ce n'est pas appelé après 10 sec l'application revient à la version précédente.

Membres de la communauté

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

Continuez de la section suivante : De V3 à V4

Si vous utilisez De V3 à V4 pour planifier la livraison de mises à jour 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, » : : Aperçu pour les détails d'implémentation dans L'aperçu 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 Types de mise à jour pour les détails d'implémentation dans Types de mise à jour.