Passer à la navigation

Depuis V3 vers V4

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 aviez échoué à mettre à jour en mode manuel, l'utilisateur devait supprimer l'application et l'installer à nouveau, ce qui est un terrible UX.

Je vous ai donné plus de liberté et supprimé tous les mauvais code que j'ai faits.

npm i @capgo/capacitor-updater@4

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

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

Pour vous, c'est la modification la plus significative, mais c'est aussi le meilleur ! Vous obtenez des améliorations à profusion, Lisez attentivement.

  • autoUpdateUrl devient updateUrl puisqu'il peut désormais être utilisé en mode manuel également
  • Suppression de cancelDelay et delayUpdate au profit de setDelay
  • Plus jamais versionName dans le set
  • Changement version Qui a été renvoyé dans la plupart des fonctions vers un objet BundleInfo
interface BundleInfo {
id: string;
version: string;
downloaded: string;
status: 'success' | 'error' | 'pending' | 'downloading'
}
  • Les noms renommés de 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 référence maintenant à 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 pour accéder à vos bundles, exemple 7Dfcd2RedN.
    • version fait maintenant référence au versionName que vous avez choisi pour un bundle, exemple 1.0.0
  • updateUrl déplacez-vous de get à postpuisqu'il y avait des en-têtes personnalisés qui posaient problème pour certains d'entre vous et que le post est plus logique, tous les en-têtes précédents sont désormais dans le corps et le préfixe disparaît. cap_ la méthode est supprimée, au profit de
  • versionName la liste retourne maintenant une liste de getId
  • Renommer BundleInfo
  • dans getId devient vrai par défaut, si vous utilisez le mode Manuel, définissez-le sur faux. getDeviceId
  • autoUpdate Actualités

Section intitulée “Actualités”

Méthode
  • cette méthode vous permet de récupérer de votre serveur configuré avec getLatestla dernière version disponible. updateUrl __CAPGO_KEEP_0__
  • méthode setDelay qui prennent {genre: “arrière-plan” | “tuer” | “version native” | “date”, valeur? : chaîne} en tant qu'argument pour définir un 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 font immédiatement.
  • 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.

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

Si vous utilisez De From V3 à V4 pour planifier la livraison d'une mise à jour en direct, connectez-le Capgo Live Updates for the product workflow in Capgo Live Updates, Présentation pour le détail d'implémentation dans Présentation, Caractéristiques pour le détail d'implémentation dans Caractéristiques, 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.