Retours en arrière

Tandis que les mises à jour en direct de Capgo vous permettent de livrer rapidement des améliorations et des correctifs à vos utilisateurs, il peut y avoir des situations où vous devez 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 du retrait.

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 la notifyAppReady() Lorsque cette méthode est appelée, le plugin reverra automatiquement à la version fonctionnelle précédente.

Comment fonctionne le redémarrage automatique

Lorsqu'une mise à jour est téléchargée et appliquée, Capgo attend que votre application appelle notifyAppReady() à l'intérieur d'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() n'est pas appelée en raison d'un crash JavaScript ou d'une erreur critique, Capgo fera :

1. Déterminera que la mise à jour n'a pas pu s'initialiser correctement
2. Reverra automatiquement à la version de bundle fonctionnelle précédente
3. Marquez l'update problématique comme échoué pour l'empêcher d'être appliqué à 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 du rollback 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 poussez par erreur une mise à jour cassée, vos utilisateurs ne seront pas coincés avec une application non fonctionnelle.

Configuration de la Durée d'Attente

Vous 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. Le temps d'attente 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 pouvez peut-être augmenter cette valeur.

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

Every time you upload a new build and assign it to a channel, Capgo keeps a history of those builds. If you need to revert a specific update, you can select one of these previous builds to redeploy to the channel.

The primary way to roll back is through the rollback interface, which is located in the 4th tab (History) when viewing a channel in the Capgo Dashboard. This tab provides a comprehensive view of all available builds for the channel, allowing you to easily select and revert to any previous version.

Pour faire une mise à niveau à l'aide de l'onglet Histoire :

1. Se connecter au Capgo Dashboard.

2. Naviguer vers la section « Canaux ».

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

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

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

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 moyen, vous pouvez également remonter directement à partir de la première onglet en cliquant sur l'icône de couronne à côté de toute version de construction dans l'historique des versions de construction du canal :

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

Note

Seul le canal sélectionné est affecté par le retour en arrière vers une version précédente. Si vous avez plusieurs canaux (par exemple, Production, Staging, etc.), vous devrez répéter le processus de retour en arrière pour chaque canal affecté.

Après le retour en arrière, les appareils configurés pour écouter le canal mis à jour recevront la version précédente la prochaine fois qu'ils rechercheront une mise à jour. La version retournée 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 version actuelle.

Pour délier un canal :

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

2. Cliquez sur le bouton « Délier » à 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 aucune mise à jour nouvelle. Les appareils configurés pour ce canal resteront sur leur version actuelle jusqu'à ce que le canal soit lié à une version à nouveau.

Si vous avez identifié un problème avec une mise à jour mais n'êtes pas encore sûr du build vers lequel vous souhaitez revenir, cela peut être utile. L'annulation du canal vous donne du temps pour enquêter sans déployer de mises à jour supplémentaires.

Forcer le Bundle Intégré

Dans des situations plus graves, vous pouvez vouloir rétablir tous les appareils d'un canal vers la version web qui a été initialement emballée avec votre paquet 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 vers la version web emballée initialement sur leur prochaine vérification de mise à jour. Cela se produit quel que soit le build sur lequel ils se trouvent actuellement.

Cela constitue une option de reversion plus agressive que la reversion vers un build précédent spécifique, car elle élimine toutes les mises à jour en cours depuis la dernière publication de l'application dans les magasins d'applications.

Attention

Soyez prudent lors de la mise en place du bundle intégré, 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.

Surveiller et répondre aux problèmes

Pour détecter rapidement les problèmes et minimiser l'impact des mises à jour problématiques, il est important d'avoir un plan pour surveiller vos releases et répondre aux problèmes.

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 large diffusion
• Avoir un processus de décision clair pour savoir quand revenir en arrière, délier ou forcer le bundle intégré, et qui a l'autorité pour le faire
• Communiquer aux utilisateurs sur le problème et la résolution, si nécessaire

En combinant une surveillance soigneuse 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.

Continuez à partir des Retours en arrière

Si vous utilisez Rollbacks pour planifier le rôle inverse et le contrôle de version, connectez-le avec Version Targeting pour les détails d'implémentation dans Version Targeting, Comportement de mise à jour pour les détails d'implémentation dans Comportement de mise à jour, bundle pour les détails d'implémentation dans bundle, Capgo Mises à jour en direct pour le flux de travail du produit dans Capgo Mises à jour en direct, et Stratégies de rôle inverse pour Capacitor Mises à jour en direct pour le contexte pratique dans les stratégies de Rollback pour les mises à jour en direct Capacitor.