De V2 à V3

Cette documentation explique comment passer à la version 3 de la mise à jour automatique.

Migrez d'abord vers les derniers outils :

npm remove -g capgo
npm remove capacitor-updater

npm i @capgo/cli
npm i @capgo/capacitor-updater@3
npx cap sync

Supprimez toute votre ancienne configuration :

{
  CapacitorUpdater: {
      autoUpdateURL: "https...",
      ...
  },
}

pour ne conserver que ceci :

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

⚠️ Si vous utilisiez votre propre serveur, avec autoUpdateURL, je mettrai bientôt ce guide à jour pour vous. En attendant, jetez un œil à la nouvelle option d'upload external qui vous permet d'envoyer uniquement le lien de votre zip, et non le code dans le cloud Capgo. Cette option a été conçue pour les entreprises ayant des politiques de confidentialité strictes. En mode externe, le code n'atterrira jamais sur le serveur Capgo, nous stockons simplement l'URL et l'envoyons à l'appareil, qui la téléchargera directement. En mode standard, le code est zippé et stocké sur notre serveur, mais nous ne l'ouvrirons ni ne l'utiliserons jamais.

Quel changement

Toutes les configurations de Live Update passent côté serveur pour vous offrir plus de contrôle sur l'envoi des mises à jour aux utilisateurs.

Cela nous permet de faire un rollback, et même de déployer auprès d'un seul utilisateur grâce aux canaux ! Ces paramètres sont ajoutés à l'interface web :

• désactiver le revert sous native
• désactiver l'update au-delà d'une version majeure

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

Cela évitera également de devoir mettre à jour le plugin fréquemment : la plupart des mises à jour se feront côté serveur, et vous en bénéficierez sans aucune modification de votre côté.

⚠️ Réinitialisé lorsqu'une mise à jour devient la version par défaut. Si vous préférez ne pas supprimer toutes les versions téléchargées lors d'une mise à jour via le store, faites ceci :

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

Mettez à jour votre code

Enfin, mettez à jour tous vos imports JS de :

import { CapacitorUpdater } from 'capacitor-updater'

vers

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

Ensuite, compilez à nouveau votre code npm run build et copiez les assets une nouvelle fois npx cap copy.

Vous devriez maintenant pouvoir tester le dernier système d'auto-update

Envoyez votre version avec :

npx @capgo/cli@latest bundle upload

au lieu de

npx capgo upload

Évolution future

Pour l'instant, seul le premier canal public est utilisé ; à l'avenir, « public » passera à plusieurs canaux publics si plus d'un est configuré.

Problèmes courants :

• Problème de build après la mise à jour : si vous avez déjà ouvert le code source code du plugin dans Android Studio ou Xcode, la synchronisation ne le supprime parfois pas, ce qui cause le problème. Ouvrez l'IDE natif et supprimez capacitor-updater manuellement, et cela devrait npx cap sync résoudre le problème.

Continuer de la V2 à la V3

Si vous utilisez De V2 à V3 pour planifier la livraison de live update, connectez-l’à Capgo Live Updates pour le workflow produit dans Capgo Live Updates, Aperçu pour les détails d'implémentation dans Vue d'ensemble, Fonctionnalités pour le détail d’implémentation dans Fonctionnalités, Comportement de mise à jour pour les détails d'implémentation dans Update Behavior, et Types de mise à jour pour les détails d'implémentation dans Update Types.