Canaux

Comment Capgo choisit un canal (préférence)

Lorsqu'un appareil demande à Capgo une mise à jour, le canal qu'il utilisera est décidé dans l'ordre suivant (priorité la plus élevée en premier):

1. Mappage de dispositif forcé: Si l'ID du dispositif est explicitement forcé à un canal (voir la Appareils forcés liste à l'intérieur des paramètres du canal), ce canal gagne toujours.
2. Cloud override (créé par setChannel() ou action Webapp): Appeler setChannel (ou modifier le canal d'un appareil dans le tableau de bord) écrit une mise à jour persistante dans le cloud liée à cet ID d'appareil. Cette mise à jour est consultée après la mise en correspondance forcée mais avant les valeurs par défaut. Réinstaller l'application ne la supprime pas; supprimer l'entrée de l'appareil ne le fait pas. __CAPGO_KEEP_0__ config
3. Capacitor config defaultChannel : Pour les builds internes / bêta / de test, vous pouvez définir (clé legacy, defaultChannel ) dans channel: Appeler capacitor.config.* les appareils de test commencent sur un canal de pré-lancement (par exemple, beta, pr-123). Si absent, l'appareil se rendra sur la valeur par défaut du cloud. Les builds de production laissent généralement cela non défini.
4. Cloud Default Channel (stratégie principale pour ~99% des utilisateurs): La principale chaîne de production où la plupart des utilisateurs réels atterrissent. N'importe quel nouveau appareil sans force, sans surcharge, et sans configuration defaultChannel utilise cela. La modification de cela déclenche (ou annule) pour tout le monde en secondes—sans nouvelle version native.

Pourquoi le cloud default est la voie principale :

• Rollout instantané ou annulation sans recompiler ou républier les binaires natifs.
• Un seul endroit pour gérer le comportement d'iOS, Android et Electron.
• Plus sûr : vous pouvez confirmer que les bundles existent et que les paramètres sont corrects avant de passer à la valeur par défaut.
• Changements auditable (les membres de l'équipe peuvent voir qui a changé quoi dans l'interface utilisateur / les journaux). Principe de conception : Les couches au-dessus (force / surcharge / configuration) sont exceptions (flux de débogage unique utilisateur, basculement QA, valeurs par défaut de build de test). Flux normal vers la valeur par défaut du cloud.

La modification de la valeur par défaut du cloud affecte les nouvelles dispositifs normaux qui :

• Ne sont pas contraints
• Ne possèdent pas déjà une surcharge du cloud
• Ne possèdent pas une surcharge d'application defaultChannel définie

Si une build de test est expédiée avec defaultChannel: 'beta' And vous changez ensuite la valeur par défaut de la cloud en productionles appareils qui ont démarré sur beta via la configuration restent là jusqu'à ce que vous : (a) les surécriviez avec setChannel(), (b) les forcéz, ou (c) supprimiez l'entrée de l'appareil.

Les appareils restent sur leur canal actuel sauf si vous :

• Forcer un autre canal.
• Appeler setChannel() (création/remplacement de la mise à jour cloud) ou le modifier manuellement dans le tableau de bord.
• Supprimer / archiver le canal sur lequel ils se trouvent (ils retomberont ensuite par la priorité à la prochaine vérification).

Si un canal est désactivé pour une plateforme (voir les boutons iOS / Android / Electron) et aurait sinon été sélectionné, la sélection le passe et retombe sur la règle suivante.

Remarque : Définir defaultChannel signifie que la modification nécessite un nouveau binaire ; utilisez-le intentionnellement pour les tests/QA, et non pour le contrôle de production général.

Capacitor exemple de configuration

capacitor.config.ts

// Example: a TestFlight or internal QA build defaults to the beta channel.
const config = {
  plugins: {
    Capgo: {
      defaultChannel: 'beta', // Test build default. Omit in production so users attach to cloud default.
      // legacy key: channel
    },
  },
};
export default config;

Si vous modifiez ultérieurement la configuration par défaut du tableau de bord, les appareils déjà connectés à un autre canal (via la configuration, la prise en charge, ou la force) NE seront PAS automatiquement déplacés ; seuls les appareils frais (ou ceux dont vous annulez la prise en charge/la force) les récupéreront. productionGestion des canaux

---

Section intitulée « Gestion des canaux »

appareil et clic sur l'onglet des canaux clic sur l'onglet des canaux.

Créer un canal

Comme vous pouvez le voir, il existe un bouton plus en coin inférieur droit. (1 dans l'image) Cliquez dessus pour ouvrir un modale où vous pouvez créer un nouveau canal.

Ensuite, après avoir cliqué sur Add un nouveau canal devrait apparaitre dans la liste.

Qu'est-ce que « misconfiguré » signifie ?

Parfois, la configuration d'un canal n'est pas valide. Dans ce cas, vous obtiendrez un grand avertissement et le Misconfigured La colonne indiquera Yes pour une ou plusieurs de ces canaux. Vous pouvez en savoir plus ici ici

Supprimer un canal

Pour supprimer un canal de l'application web, ouvrez la Canaux rubrique pour votre application et trouvez la ligne de canal. Dans la Action colonne, cliquez sur l'icône de la poubelle, puis cliquez sur Supprimer dans le dialogue de confirmation.

Si l'icône de la poubelle n'est pas visible, votre compte n'a pas la permission pour cet application. Demandez à un administrateur d'organisation ou d'application de vous accorder un rôle qui peut supprimer des canaux, ou supprimez le canal avec une clé __CAPGO_KEEP_0__ qui a la permission : channel.delete permission for that app. Ask an organization or app admin to grant a role that can delete channels, or delete the channel with an API key that has permission:

npx @capgo/cli@latest channel delete <channel-name> <app-id>

Section intitulée “Gestion d'un canal”

Paramètres du canal3 La page des paramètres du canal contient toutes les options de configuration pour votre canal. Allons-y dans chaque paramètre.

La page des paramètres du canal contient toutes les options de configuration pour votre canal. Allons-y dans chaque paramètre.

---

Premièrement Default channel toggle. Lorsque activé, ce canal devient le canal par défaut pour les nouveaux appareils. Pour une explication complète de la façon dont les canaux par défaut fonctionnent, y compris la configuration de valeurs par plateforme (une pour iOS, une pour Android et une pour Electron), voir le section de la configuration du canal par défaut. Second le

---

paramètre. Cela est relativement simple. Si ce paramètre est faux, les appareils iOS ne seront pas autorisés à télécharger des mises à jour à partir de ce canal. IOS Third est le

paramètre. Cela ressemble à Android . Si ce paramètre est faux, les appareils Android ne seront pas autorisés à télécharger des mises à jour à partir de ce canal. IOSFourth est le

paramètre. Cela ressemble à Electron et IOS . Si ce paramètre est faux, les applications Electron ne seront pas autorisées à télécharger des mises à jour à partir de ce canal. Android__CAPGO_KEEP_0__

Cinquième est le Disable auto downgrade under native Si ceci est vrai, alors il sera impossible de régresser vers une version native. Cela signifie que si vous avez téléchargé une version à l'App Store ou à Google Play et que vous essayez de définir la version du canal sur 1.2.0 alors la mise à jour (régression) échouera. 1.1.0 Sixième est le

. Cette configuration est assez complexe, et vous pouvez en savoir plus sur elle Disable auto updateQuant à . Si ceci est vrai, alors les builds de développement seront autorisés à télécharger des mises à jour à partir de ce canal. Si ce n'est pas le cas, alors toute demande de mise à jour qui a

défini sur false sera rejetée. Cela est principalement utile pour les besoins de test. Allow development buildSeptième est le prod . Si ceci est faux, alors __CAPGO_KEEP_0__ refusera toute demande de mise à jour qui provient d'un émulateur. Cela est principalement utile pour les besoins de test.

setting Allow Emulators. If this is false then Capgo will disallow any update request that comes from an emulator. This is mostly useful for testing purposes.

Huit est le Allow devices to self associate. Si c'est vrai, alors la setChannel méthode sera disponible. Si cela est défini sur faux et que vous essayez d'appeler la setChannel méthode avec ce canal, alors l'appel échouera.

Continuez de la section des canaux

Si vous utilisez les canaux pour planifier la routage des canaux et la mise en production étalée, connectez-le avec les canaux pour les détails d'implémentation dans les canaux, Canaux pour les détails d'implémentation dans les canaux, Solution de test bêta pour le flux de travail du produit dans la Solution de test bêta, Solution de ciblage de version pour le flux de travail du produit dans la Solution de ciblage de version, et Capgo Pratiques d'environnement de meilleures pratiques : mise en scène avec un ID d'application mobile unique pour le contexte pratique dans Capgo Pratiques d'environnement de meilleures pratiques : mise en scène avec un ID d'application mobile unique.