Passer au contenu
Capgo

Canaux

Un canal de mise à jour en direct pointe vers une build JS spécifique de votre application qui sera partagée avec tous les appareils configurés pour écouter ce canal pour les mises à jour. Lorsque vous installez le SDK Capgo Live Updates dans votre application, tout binaire natif configuré sur ce canal vérifiera les mises à jour disponibles à chaque lancement de l’application. Vous pouvez modifier la build vers laquelle pointe un canal à tout moment et revenir aux builds précédentes si nécessaire.

Configuration d’un Canal

Chaque application dispose d’un canal par défaut appelé “Production” qui ne peut pas être supprimé. Pour ajouter de nouveaux canaux :

  1. Allez dans la section “Canaux” du tableau de bord Capgo
  2. Cliquez sur le bouton “Nouveau Canal”
  3. Saisissez un nom pour le canal et cliquez sur “Créer”

Les noms des canaux peuvent être ce que vous voulez. Une stratégie courante consiste à faire correspondre les canaux à vos étapes de développement, comme :

  • Development - pour tester les mises à jour en direct sur les appareils locaux ou les émulateurs
  • QA - pour que votre équipe QA vérifie les mises à jour avant une diffusion plus large
  • Staging - pour les tests finaux dans un environnement similaire à la production
  • Production - pour la version de votre application que les utilisateurs finaux reçoivent des stores

Configuration du Canal dans Votre Application

Avec vos canaux créés, vous devez configurer votre application pour écouter le canal approprié. Dans cet exemple, nous utiliserons le canal Development.

Ouvrez votre fichier capacitor.config.ts (ou capacitor.config.json). Dans la section plugins, définissez la propriété channel du plugin CapacitorUpdater avec le nom de votre canal souhaité :

import { CapacitorConfig } from '@capacitor/cli';


const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      defaultChannel: 'Development',
    },
  },
};

Ensuite, construisez votre application web et exécutez npx cap sync pour copier le fichier de configuration mis à jour vers vos projets iOS et Android. Si vous sautez cette étape de synchronisation, vos projets natifs continueront d’utiliser le canal pour lequel ils étaient précédemment configurés.

Attribution d’un Bundle à un Canal

Pour déployer une mise à jour en direct, vous devez télécharger une nouvelle build JS et l’attribuer à un canal. Vous pouvez le faire en une seule étape avec le CLI Capgo :

Fenêtre de terminal
npx @capgo/cli@latest upload --channel=Development

Cela téléchargera vos ressources web construites et définira le nouveau bundle comme build active pour le canal Development. Toutes les applications configurées pour écouter ce canal recevront la mise à jour la prochaine fois qu’elles en vérifieront une.

Vous pouvez également attribuer des builds aux canaux depuis la section “Bundles” du tableau de bord Capgo. Cliquez sur l’icône de menu à côté d’une build et sélectionnez “Attribuer au Canal” pour choisir le canal pour cette build.

Versionnement des Bundles et Canaux

Il est important de noter que les bundles dans Capgo sont globaux à votre application, et non spécifiques à des canaux individuels. Le même bundle peut être attribué à plusieurs canaux.

Pour le versionnement de vos bundles, nous recommandons d’utiliser le versionnement sémantique semver avec des identifiants de pré-version pour les builds spécifiques aux canaux. Par exemple, une version bêta pourrait être versionnée comme 1.2.3-beta.1.

Cette approche présente plusieurs avantages :

  • Elle communique clairement la relation entre les builds. 1.2.3-beta.1 est évidemment une pré-version de 1.2.3
  • Elle permet de réutiliser les numéros de version entre les canaux, réduisant la confusion
  • Elle permet des chemins de retour en arrière clairs. Si vous devez revenir de 1.2.3, vous savez que 1.2.2 est la version stable précédente

Voici un exemple de comment vous pourriez aligner vos versions de bundle avec une configuration typique de canal :

  • Canal Development : 1.2.3-dev.1, 1.2.3-dev.2, etc.
  • Canal QA : 1.2.3-qa.1, 1.2.3-qa.2, etc.
  • Canal Staging : 1.2.3-rc.1, 1.2.3-rc.2, etc.
  • Canal Production : 1.2.3, 1.2.4, etc.

Retour en Arrière d’une Mise à Jour en Direct

Si vous déployez une mise à jour en direct qui introduit un bug ou qui doit être annulée pour une autre raison, vous pouvez facilement revenir à une build précédente. Depuis la section “Canaux” du tableau de bord :

  1. Cliquez sur le nom du canal que vous souhaitez restaurer
  2. Trouvez la build vers laquelle vous voulez revenir et cliquez sur l’icône de couronne Retour à une build
  3. Confirmez l’action

La build sélectionnée deviendra immédiatement la build active pour ce canal. Les applications recevront la version restaurée la prochaine fois qu’elles vérifieront une mise à jour.

Automatisation des Déploiements

Pour des flux de travail plus avancés, vous pouvez automatiser vos déploiements de mises à jour en direct dans le cadre de votre pipeline CI/CD. En intégrant Capgo dans votre processus de build, vous pouvez automatiquement télécharger de nouveaux bundles et les attribuer à des canaux chaque fois que vous poussez vers certaines branches ou créez de nouvelles versions.

Consultez la documentation Intégration CI/CD pour en savoir plus sur l’automatisation des mises à jour en direct Capgo.

Déploiement vers un Appareil

Maintenant que vous comprenez les canaux, vous êtes prêt à commencer à déployer des mises à jour en direct sur des appareils réels. Le processus de base est :

  1. Installez le SDK Capgo dans votre application
  2. Configurez l’application pour écouter votre canal souhaité
  3. Téléchargez une build et attribuez-la à ce canal
  4. Lancez l’application et attendez la mise à jour !

Pour un guide plus détaillé, consultez le guide Déploiement des Mises à Jour en Direct. Bonnes mises à jour !