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 non sécurisé à 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 l'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 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 être utilisée en mode manuel maintenant également
• Suppression de cancelDelay et delayUpdate au profit de setDelay
• Plus de versionName dans la mise en place
• Changer 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'
}

• Renommé des noms trompeurs maintenant (même si on ne peut pas expliquer clairement, 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 à postpuisque les en-têtes personnalisés étaient un problème pour certains d'entre vous et il 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 en 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 de récupérer 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 de caractères} 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 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.

Contributeurs

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

Continuez de la section « 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, » : « Présentation pour les détails d'implémentation dans L'aperçu Fonctionnalités pour les détails d'implémentation dans Fonctionnalités 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.