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. Cartographie de l'appareil forcée: Si l'ID de l'appareil est explicitement forcé à un canal (voir la liste des appareils forcés intérieure aux paramètres du canal), ce canal gagne toujours.
2. Surcharge de Cloud (créée par setChannel() ou l'action Webapp): Appeler setChannel (ou modifier le canal d'un appareil dans le tableau de bord) écrit une surcharge persistante dans le cloud liée à cet ID d'appareil. Cette surcharge est consultée après la cartographie forcée mais avant les valeurs par défaut. Re-Installer l'application fait perdre cette surcharge. ne pas effacer l'entrée du dispositif ; la suppression de l'entrée du dispositif fait.
3. Capacitor config defaultChannel (construction de test par défaut): Pour les builds internes / bêta / de test, vous pouvez définir defaultChannel (clé de legacy channel) dans capacitor.config.* afin que les appareils de test commencent sur un canal de pré-version (par exemple, beta, pr-123). Si absent, le dispositif procédera par défaut vers le cloud. Les builds de production laissent généralement cela non défini.
4. Cloud Default Channel (stratégie principale pour environ 99% des utilisateurs): Le canal de production principal où virtually tous les utilisateurs réels atterrissent. N'importe quel nouveau dispositif sans force, sans surcharge, et sans config defaultChannel utilise cela. La modification le déploye (ou le recule) pour tout le monde en secondes—pas de nouvelle version binaire.

Why le par défaut du cloud est la voie principale :

• Déploiement 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 version par défaut.
• Les modifications auditable (les membres de l'équipe peuvent voir qui a changé quoi dans l'interface / les journaux). Principe de conception : Les couches au-dessus (forcer / ignorer / configurer) sont exceptions

(debuggage d'un utilisateur unique, QA, build de test). Les utilisateurs normaux suivent la voie par défaut du cloud. Changer le par défaut du cloud nouveaux appareils normaux qui :

• Ne sont pas contraints
• Ne disposent pas déjà d'une mise en surclassement cloud
• Ne disposent pas d'un niveau d'application defaultChannel défini

Si une version de test est expédiée avec defaultChannel: 'beta' et que vous modifiez ultérieurement la valeur par défaut cloud en production, les appareils qui ont démarré sur beta via la configuration restent là jusqu'à ce que vous : (a) les surclassez avec setChannel(), (b) les forcez, ou (c) supprimiez l'entrée de l'appareil.

Les appareils restent sur leur canal actuel à moins que vous :

• Forcer la connexion vers un autre canal.
• Appeler setChannel() (création/remplacement de la configuration cloud) ou 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 commutateurs iOS / Android / Electron) et aurait autrement é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 fichier exécutable; utilisez-le intentionnellement pour les tests/QA, pas 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 le paramètre par défaut du tableau de bord productionLes appareils déjà connectés à un autre canal (via la configuration, la prise en charge ou la force) NE seront PAS déplacés automatiquement ; seuls les appareils frais (ou ceux dont vous avez annulé la prise en charge/la force) les récupèrent.

---

Gestion des canaux

En cliquant sur votre application et en cliquant ensuite sur l'onglet des canaux Liste des canaux Créer un canal.

Comme vous pouvez le voir, il existe un bouton « + » en coin inférieur droit. (

Section titled “Managing channels”1 Section titled “Creating a channel”

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

Qu'est-ce que « mal configuré » signifie ?

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

Supprimer un canal

To 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 channel.delete permission pour cette 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é API qui a la permission :

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

Une clé d'organisation et d'application peut supprimer atomiquement uniquement le canal de prévisualisation non public et le paquet créé avec . Elle ne peut pas modifier ou supprimer un canal par défaut/main existant, un autre canal de prévisualisation de clé, ou un autre paquet de clé. Voir __CAPGO_KEEP_0__ Clés channel delete <preview-channel> <app-id> --delete-bundlepour la configuration d'accès minimal. API Keys Cliquez sur le nom du canal pour ouvrir un modale où vous pouvez gérer les paramètres du canal. (

dans l'image)

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

Paramètres du canal

---

Premièrement le Default channel bouton d'activation. Lorsqu'il est 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 façon de configurer les valeurs par défaut spécifiques aux plateformes (une pour iOS, une pour Android, et une pour Electron), voir la Configuration du Canal Par Défaut section.

---

Deuxièmement la IOS 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.

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

Quatrièmement est le Electron paramètre. Cela est similaire à IOS et Android. Si ceci est faux, les applications Electron ne seront pas autorisées à télécharger des mises à jour de ce canal.

Cinquième est le Disable auto downgrade under native paramètre. Si ceci est vrai, il sera impossible de régresser vers une version native. Cela signifie que si vous avez téléchargé une version à l'application store ou play store et que vous essayez de définir la version du canal à 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 updateEn ce qui concerne . Si ceci est vrai, les builds de développement seront autorisés à télécharger des mises à jour de ce canal. Si ce n'est pas le cas, toute demande de mise à jour qui a le

défini sur faux sera rejetée. Cela est principalement utile pour des fins de test. Allow development buildSeptième est le prod paramètre.

Si ceci est vrai, les builds de développement seront autorisés à télécharger des mises à jour de ce canal. Si ce n'est pas le cas, toute demande de mise à jour qui a le Allow Emulators. Si ceci est faux, alors Capgo ne permettra aucune mise à jour de requête provenant d'un émulateur. Cela est principalement utile aux fins de test.

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

Déroulements progressifs

Le canal L'onglet Information Déploiement progressif Configurez un bundle cible, choisissez le pourcentage et la durée de la cache décisionnelle, puis activez le déploiement. À partir de la même section, vous pouvez suspendre ou reprendre l'exposition, promouvoir la cible vers la version stable, la rouler en arrière ou configurer une pause automatique, un retour en arrière ou une notification lorsque les signaux de failure franchissent un seuil.

Les contrôles de déploiement progressif apparaissent en haut de l'onglet Informations du canal.

Lire Déploiements progressifs avant d'y activer un. Il explique les cohortes collantes, les changements de pourcentage sûrs et le comportement de pause automatique.

Continuez d'ici les canaux

Si vous utilisez Canaux pour planifier la routage des canaux et le déploiement étalé, connectez-le avec Canaux pour le détail de mise en œuvre dans Canaux, Canaux pour le détail de mise en œuvre dans Canaux, Solution de test bêta pour le flux de travail du produit dans Solution de test bêta, Solution de ciblage de version pour le flux de travail du produit dans Solution de ciblage de version, et Capgo Pratiques de meilleures performances de l'environnement : mise en scène avec un seul ID d'application mobile pour le contexte pratique dans Capgo Pratiques de meilleures performances de l'environnement : mise en scène avec un seul ID d'application mobile.