Aller directement au contenu

De V2 à V3

Cette documentation expliquera comment mettre à niveau vers la version 3 de l'auto-mise à jour.

Migrez d'abord vers l'outil de dernière génération :

Premièrement migrez vers l'outil de dernière génération :
Fenêtre de terminal
npm remove -g capgo
npm remove capacitor-updater
npm i @capgo/cli
npm i @capgo/capacitor-updater@3
npx cap sync

Supprimer toutes vos configurations précédentes :

Section intitulée “Supprimer toutes vos configurations précédentes :”
{
CapacitorUpdater: {
autoUpdateURL: "https...",
...
},
}

pour ne laisser que cela :

{
"CapacitorUpdater": {
"autoUpdate": true
}
}

⚠️ Si vous utilisiez votre serveur, avec autoUpdateURL, je mettrai à jour cette guide pour vous bientôt. En attendant, jetez un coup d'œil à la nouvelle option d'upload external qui vous permet de transmettre uniquement le lien de votre zip, et non le code dans le Capgo cloud. Cela a été fait pour les sociétés ayant des politiques de confidentialité strictes. En mode externe, le code ne touchera jamais le serveur Capgo, nous n'enregistrons que l'URL et la transmettons au dispositif, qui la téléchargera directement. Dans le mode standard, le code est zippé et stocké sur notre serveur, mais nous ne l'ouvrirons jamais ou ne l'utiliserons pas.

Toutes les configurations deviennent côté serveur pour l'auto-mise à jour, pour vous donner plus de contrôle sur la façon dont vous envoyez une mise à jour aux utilisateurs.

Cela nous permet de rétablir, même de déployer uniquement pour un utilisateur avec les canaux ! Ces paramètres sont ajoutés à nouveau à l'interface web :

  • désactiver la reversion sous native
  • désactiver la mise à jour au-dessus de la version majeure

⚠️ Ils deviendront vrais par défaut pour tous les canaux

Cela supprimera également la nécessité de mettre à jour souvent le plugin, la plupart des mises à jour seront effectuées côté serveur, et vous les obtiendrez sans aucune modification de votre côté.

⚠️ Réinitialiser lorsqu'une mise à jour devient la valeur par défaut, afin que si vous préférez ne pas supprimer toutes les versions de téléchargement lors de la mise à jour depuis l'application, faites ceci :

{
"CapacitorUpdater": {
"autoUpdate": true,
"resetWhenUpdate": false
}
}

Enfin, mettez à jour toutes vos importations en JS de :

import { CapacitorUpdater } from 'capacitor-updater'

à

import { CapacitorUpdater } from '@capgo/capacitor-updater'

En construisant ensuite votre code npm run build et copiez les assets une fois de plus npx cap copy.

Vous devriez maintenant être en mesure de tester le dernier système d'auto-mise à jour

Envoyez votre version avec :

npx @capgo/cli@latest bundle upload

au lieu de

npx capgo upload

Pour l'instant, seul le premier canal public est utilisé, à l'avenir, public changera pour les canaux publics multiples, si plus d'un est configuré.

  • Problème de construction après mise à niveau : si vous avez déjà ouvert le code source code du plugin dans Android Studio ou Xcode, il se peut que la synchronisation ne les supprime pas, ce qui est la cause du problème. Ouvrez l'IDE natif et supprimez-les manuellement. capacitor-updater par les mains et faites npx cap sync ce qui devrait résoudre le problème.