Rollbacks

Même si les mises à jour en temps réel de Capgo vous permettent de livrer rapidement des améliorations et des correctifs à vos utilisateurs, il peut y avoir des situations où vous avez besoin de revenir à une version précédente de votre application. Peut-être que la mise à jour récente a introduit une erreur critique inattendue, ou peut-être que vous souhaitez rétablir une modification spécifique pendant que vous travaillez sur une correction.

Capgo fournit plusieurs moyens de gérer les builds d'un canal et de contrôler la version de votre application que les utilisateurs reçoivent, y compris des options de retrait manuel et des mécanismes de sécurité automatiques.

Protection automatique de rollback

Capgo comprend un mécanisme de sécurité intégré pour protéger vos utilisateurs des mises à jour brisées. Si une erreur JavaScript se produit avant l'appel de la notifyAppReady() méthode, le plugin se met automatiquement en mode rollback vers la version fonctionnelle précédente.

Comment fonctionne la Protection automatique de rollback

Lorsqu'une nouvelle mise à jour est téléchargée et appliquée, Capgo attend que votre application appelle notifyAppReady() dans un délai configurable pour confirmer que la mise à jour s'est chargée avec succès. Cette méthode signale que :

• Le bundle JavaScript s'est chargé sans erreurs critiques
• La fonctionnalité de base de votre application fonctionne
• La mise à jour est sûre à conserver

Si notifyAppReady() ne sera pas appelé en raison d'une panne ou d'une erreur critique JavaScript, Capgo fera :

1. Déterminera que l'actualisation n'a pas pu s'initialiser correctement
2. Reviendra automatiquement à la version de travail précédente
3. Marquera l'actualisation problématique comme ayant échoué pour l'empêcher d'être appliquée à nouveau

Conseil

Assurez-vous d'appeler notifyAppReady() dans l'initialisation de votre application code après que vos composants de base aient chargé avec succès. Cela garantit que la protection automatique de reversion fonctionne comme prévu.

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

// Call this after your app has successfully initialized
await CapacitorUpdater.notifyAppReady()

Cette protection automatique aide à s'assurer que même si vous avez accidentellement poussé une mise à jour brisée, vos utilisateurs ne seront pas coincés avec une application non fonctionnelle.

Configuration du temps d'attente

You pouvez configurer la durée pendant laquelle Capgo attend notifyAppReady() pour être appelé en définissant le appReadyTimeout dans votre configuration Capacitor :

{
  "plugins": {
    "CapacitorUpdater": {
      "appReadyTimeout": 10000
    }
  }
}

La appReadyTimeout valeur est spécifiée en millisecondes. La durée de temps par défaut est généralement de 10 secondes, mais vous pouvez l'ajuster en fonction des besoins d'initialisation de votre application. Si votre application prend plus de temps à charger en raison de processus d'initialisation complexes, vous devriez peut-être augmenter cette valeur.

Retour en arrière vers une version précédente

Chaque fois que vous publiez une nouvelle version et que vous l'affectez à un canal, Capgo garde une histoire de ces versions. Si vous avez besoin de rétablir une mise à jour spécifique, vous pouvez sélectionner l'une de ces versions précédentes pour la rédeployer sur le canal.

La principale façon de revenir en arrière est par l'interface de retour en arrière, qui se trouve dans la 4ème onglet (Histoire) lors de la consultation d'un canal dans le tableau de bord Capgo. Cette onglet fournit une vue complète de toutes les versions disponibles pour le canal, vous permettant de sélectionner facilement et de rétablir n'importe quelle version précédente.

Pour revenir en arrière en utilisant l'onglet Histoire :

1. Se connecter à la Capgo Console de bord.

2. Naviguez vers la section « Canaux ».

3. Cliquez sur le nom du canal que vous souhaitez remonter.

4. Allez dans le 4ème onglet (Histoire) de la vue du canal.

5. Trouvez la version que vous souhaitez rétablir dans l'historique des versions.

6. Sélectionnez cette version pour la rendre la version active pour le canal.

7. Confirmez que vous souhaitez remonter à cette version.

Méthode alternative : Utilisation de l'icône de couronne

Comme deuxième méthode, vous pouvez également remonter directement depuis la première page en cliquant sur l'icône de couronne à côté de toute version dans l'historique des versions du canal :

1. Dans la première page de la vue du canal, trouvez la version que vous souhaitez rétablir.
2. Cliquez sur l'icône de couronne à côté de cette mise à jour pour la rendre la mise à jour active pour le canal.
3. Confirmez que vous souhaitez revenir à cette mise à jour.

Remarque

La mise à jour vers une mise à jour précédente n'affecte que le canal sélectionné. Si vous avez plusieurs canaux (par exemple, Production, Staging, etc.), vous devrez répéter le processus de mise à jour pour chaque canal affecté.

Après la mise à jour, les appareils configurés pour écouter le canal mis à jour recevront la mise à jour précédente la prochaine fois qu'ils vérifieront les mises à jour. La mise à jour roulée-back sera traitée comme une mise à jour nouvelle, donc le flux de mise à jour habituel et les conditions s'appliquent.

Délier un Canal

Si vous souhaitez suspendre temporairement les mises à jour sur un canal pendant que vous investigatez un problème, vous pouvez délier le canal de sa mise à jour actuelle.

Pour délier un canal :

1. Naviguez vers le canal dans le tableau de bord Capgo.

2. Cliquez sur le bouton « Délier » situé à côté de la version actuelle.

3. Confirmez que vous souhaitez délier le canal.

Une fois qu'un canal est délié, il ne distribuera plus de mises à jour nouvelles. Les appareils configurés pour ce canal resteront sur leur version actuelle jusqu'à ce que le canal soit lié à une nouvelle version.

Cela est utile si vous avez identifié un problème avec une mise à jour mais n'êtes pas encore sûr de la version à laquelle vous souhaitez revenir. Délier le canal vous donne du temps pour enquêter sans pousser de nouvelles mises à jour.

Forcer le Bundle Intégré

Dans des situations plus graves, vous pouvez vouloir rétablir tous les appareils sur un canal à la version web qui était initialement emballée avec votre application native. Cela s'appelle le « bundle intégré ».

Pour forcer le bundle intégré sur un canal :

1. Naviguez vers le canal dans le tableau de bord Capgo.

2. Cliquez sur le bouton « Bundle Intégré ».

3. Confirmez que vous souhaitez forcer le bundle intégré.

Lorsque vous forcez le bundle intégré, tous les appareils configurés pour ce canal reverront à la version web emballée initialement sur leur prochaine vérification de mise à jour. Cela se produit quel que soit la version sur laquelle ils se trouvent actuellement.

Cette option de retraitement est plus agressive que la reversion à une version précédente spécifique, car elle élimine toutes les mises à jour en direct publiées depuis la dernière mise à jour de l'application dans les magasins d'applications.

Attention

Faites preuve de prudence lors de la mise en place de la bibliothèque intégrée, car cela affectera tous les appareils sur le canal. Assurez-vous d'avoir considéré l'impact et avoir un plan pour avancer avant de prendre cette action.

Surveillance et Réponse aux Problèmes

Il est important d'avoir un plan pour surveiller vos lancements et répondre aux problèmes pour attraper les problèmes rapidement et minimiser l'impact des mises à jour problématiques.

Certaines stratégies incluent :

• Surveiller les rapports de crash et les commentaires des utilisateurs immédiatement après la mise en ligne d'une mise à jour
• Utiliser des déploiements étalés ou un système de canal étalé pour tester les mises à jour sur un groupe plus petit avant la mise en large diffusion
• Avoir un processus de décision clair pour savoir quand revenir en arrière, délier ou forcer la bibliothèque intégrée, et qui a l'autorité pour le faire
• Communiquer aux utilisateurs sur le problème et la résolution, si nécessaire

En combinant un suivi attentif avec la capacité de gérer rapidement les mises à jour problématiques, vous pouvez livrer une expérience d'application en constante amélioration tout en minimisant les perturbations pour vos utilisateurs.