De V3 à V4

Pourquoi cette mise à jour

After many talk in the discord community with you. I discovered the manual mode was very too manual and not safe to use, for example, auto-revert was not possible, so if you failed update in manual the user have to remove the app and install back, what is terrible UX.

Meanwhile, I took this as an opportunity to give more freedom to you, and remove all bad code I made.

Install

npm i @capgo/capacitor-updater@4

Mise à jour automatique du cloud

Si vous utilisez l'exemple de base dans votre application, vous pouvez migrer vers la nouvelle version en toute sécurité, 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 à profusion, Lisez attentivement.

Changements

• autoUpdateUrl devient updateUrl Maintenant que cette configuration peut être utilisée en mode manuel également.
• Suppression de cancelDelay et delayUpdate au lieu de setDelay
• plus versionName en ensemble
• Modifier version clé, qui a été 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 expliquer ne peut pas être clair, mais à l'utilisation est facile à comprendre le nouveau) :
  • ce qui était appelé un version is maintenant référencé à un bundle
  • id se réfèrent à 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 se réfèrent maintenant à versionName que vous choisissez pour un ensemble, par exemple 1.0.0
• updateUrl passer de get à postPuisque les en-têtes personnalisés posaient problème pour certains d'entre vous et que le post est plus logique, tous les en-têtes précédents vont dans le corps et sont précédés de cap_ disappear.
• versionName La méthode est supprimée, au profit de getId
• list 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 d'accéder à votre ensemble de serveurs défini updateUrl La dernière version disponible.
• Méthode setDelay type {kind: “background” | “kill” | “nativeVersion” | “date”, valeur? : chaîne de caractères} en tant que argument pour définir un délai dans différentes modes.
• Méthode next, pour définir la version dans le prochain backgrounding, à l'opposé de set qui le fait instantanément.
• Méthode isAutoUpdateEnabledPour vous informer si vous êtes en contexte d'auto-mise à jour
• É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 était impossible de faire fonctionner cette mise à jour sans vous.

Continuez de From V3 à V4

Si vous utilisez From V3 à V4 pour planifier la livraison live update, connectez-l’avec Capgo Mises à jour en direct for the product workflow in Capgo Live Updates, Overview pour les détails d'implémentation dans Vue d'ensemble 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.