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. La réinstallation de l'application ne la efface pas ; la suppression de l'entrée de l'appareil le fait.
3. Capacitor configuration defaultChannel (construction de test par défaut): Pour les constructions de test internes / bêta, vous pouvez définir defaultChannel (clé 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, l'appareil se dirigera vers le paramètre par défaut du cloud. Les constructions de production laissent généralement cela non défini.
4. Canal par défaut du cloud (stratégie principale pour environ 99 % des utilisateurs): Le canal de production principal sur lequel se retrouvent presque tous les utilisateurs réels. N'importe quel nouveau dispositif sans force, sans surcharge, et sans configuration defaultChannel utilise celui-ci. La modification le déploie (ou le recule) pour tout le monde en quelques secondes—pas de nouvelle version.

Pourquoi le canal par défaut du cloud is the main path:

• Déploiement instantané ou annulation sans recompiler ou républier des 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 utilisateur / les journaux). Principe de conception : Les couches au-dessus (forcer / surcharger / configurer) sont exceptions (debugger pour un utilisateur unique, QA qui bascule, les paramètres par défaut de la construction de test). Les utilisateurs normaux suivent la version par défaut du cloud.

La modification de la version par défaut du cloud affecte de nouveaux dispositifs normaux qui :

• Ne sont pas imposés
• Ne disposez pas déjà d'une configuration de cloud personnalisée
• Ne disposez pas d'une configuration d'application defaultChannel définie

Si une version de test est expédiée avec defaultChannel: 'beta' et que vous modifiez ultérieurement la valeur par défaut de cloud en production, les appareils qui ont démarré sur beta restent sur cette configuration jusqu'à ce que vous les modifiez via la configuration en setChannel() (a) les surécrivant,

(b) les forçant, ou

• (c) supprimant l'entrée de l'appareil.
• Les appareils restent sur leur canal actuel sauf si vous les forcez à un autre canal. setChannel() (créer/remplacer l'override cloud) ou le modifier manuellement dans le tableau de bord.
• Supprimer / archiver le canal sur lequel ils se trouvent (puis ils retomberont à travers la priorité à nouveau à 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.

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

Capacitor config exemple

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 à production, les appareils déjà sur un autre canal (via config, override ou force) NE seront PAS automatiquement déplacés ; seuls les appareils frais (ou ceux dont vous avez annulé l'override/force) les récupèrent.

---

Gestion des canaux

Tout d’abord, voyons la page des canaux. Vous pouvez y accéder en cliquant sur votre application, puis en cliquant sur l’onglet des canaux votre application et enfin 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) En cliquant dessus, cela ouvrira un modale où vous pourrez créer un nouveau canal.

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

Qu'est-ce que cela 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 ces canaux. Vous pouvez en savoir plus sur cela ici

Supprimer un canal

Supprimer un canal est tout à fait simple. Il suffit de cliquer sur l'icône de la poubelle et de confirmer la suppression. (2 dans l'image)

Gestion d'un canal

Cliquez sur le nom du canal pour ouvrir une boîte de dialogue où vous pouvez gérer les paramètres du canal. (3 dans l'image)

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

---

Premièrement le Default channel bouton d'alternance. 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 configuration des valeurs par plateforme (une pour iOS, une pour Android et une pour Electron), voir la section « Configuration du canal par défaut ». Deuxièmement le paramètre. C'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.

---

Default Channel Configuration IOS Default Channel Configuration

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

Quatrième est le Electron paramètre. Cela ressemble à IOS et Android. Si c'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 c'est vrai, il sera impossible de descendre d'une version native. Cela signifie que si vous avez téléchargé une 1.2.0 version dans l'app store ou le play store et que vous essayez de définir la version du canal sur 1.1.0 alors la mise à jour (dégradation) échouera.

Sixième est le Disable auto update. Cette configuration est assez complexe, et vous pouvez en savoir plus sur elle ici

Quant à Allow development build. Si c'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 prod réglé sur faux sera rejetée. C'est surtout utile pour des fins de test.

Septième est le 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.

__CAPGO_KEEP_0__ Allow devices to self associatene permettra aucune demande de mise à jour qui provient d'un émulateur. C'est surtout utile pour des fins de test. Huitième est le . Si c'est vrai, le sera disponible. Si ce n'est pas le cas et que vous essayez d'appeler le méthode avec ce canal, puis l'appel échouera.

Continuez de là des canaux

Si vous utilisez les canaux pour planifier la mise en route des canaux et la mise en ligne étape par étape, connectez-le à les canaux pour les détails d'implémentation dans les canaux, les 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 Solution de ciblage de version, et Capgo Pratiques de l'environnement : Étapes de mise en scène avec un ID d'application mobile unique pour le contexte pratique dans Capgo Pratiques de l'environnement : Étapes de mise en scène avec un ID d'application mobile unique.