Canaux

Copiez un prompt de configuration avec les étapes d'installation et le guide Markdown complet pour ce plugin.

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) :

Cartographie de l'appareil forcée: Si l'ID de l'appareil est explicitement forcé à un canal (voir la liste à l'intérieur des paramètres du canal), ce canal gagne toujours. Surcharge de Cloud (créée par
ou l'action Webapp) setChannel() Appareils forcés: Appel setChannel (ou modifier le canal d'un appareil dans l'interface de dashboard) écrit une mise à jour persistante dans le cloud liée à cet ID d'appareil. Cette mise à jour est consultée après une mise en correspondance forcée mais avant toute valeur par défaut. La réinstallation de l'application ne ne la supprime pas ; la suppression de l'entrée de l'appareil le fait.
Capacitor config defaultChannel (version de test par défaut): Pour les versions de test internes / bêta, vous pouvez définir defaultChannel (ancienne clé 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 la valeur par défaut du cloud. Les versions de production laissent généralement cela non défini.
Canal par défaut du Cloud (stratégie principale pour environ 99 % des utilisateurs): La principale chaîne de production vers laquelle aboutissent presque tous les utilisateurs réels. Toute nouvelle appareil sans force, sans un débordement, et sans une configuration defaultChannel Utilise cette chaîne. La modification de celle-ci déclenche (ou annule) une mise à jour pour tout le monde en secondes – sans nouvelle version binaire.

Pourquoi la chaîne par défaut du cloud est la principale voie :

Déploiement instantané ou annulation sans recompiler ou républier les binaires natifs.
Un seul endroit pour gérer le comportement d'iOS, d'Android et d'Electron.
Plus sûr : vous pouvez confirmer que les ensembles existent et que les paramètres sont corrects avant de passer à la chaîne par défaut.
Les modifications audibles (les membres de l'équipe peuvent voir qui a modifié quoi dans l'interface utilisateur / les journaux). Principe de conception : Les couches au-dessus (force / débordement / configuration) sont des exceptions

(debuggage d'un utilisateur unique, modification de la configuration de QA, test de la version par défaut). Les utilisateurs normaux s'écoulent vers la chaîne par défaut du cloud. La modification de la par défaut du cloud affecte le canal nouveau Les appareils normaux qui :

Ne sont pas contraints
Ne possèdent pas déjà une mise à jour de 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 le par défaut de 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()ou (b) les forcer, ou (c) supprimer l'entrée du dispositif.

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

Forcer leur passage à un autre canal.
Appeler setChannel() context
ou (la création/remplacement de la configuration cloud) ou la modifier manuellement dans le tableau de bord.

Supprimer/ archiver le canal sur lequel ils sont (puis ils retomberont à travers la priorité à nouveau à la prochaine vérification).

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

Capacitor config example

// 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 ensuite la page d'accueil par défaut production, les appareils déjà sur 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 annulez la prise en charge/la force) les récupèrent.

Gestion des canaux

Premièrement, voyons la page des canaux. Vous pouvez y accéder en cliquant sur votre application et puis en cliquant sur l'onglet des canaux liste des canaux.

Section intitulée “Créer un canal”

As vous pouvez le voir, il existe un bouton plus dans le coin inférieur droit. (1 dans l'image) En cliquant dessus, une fenêtre modale s'ouvrira où vous pourrez créer un nouveau canal.

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 column Yes indiquera pour un ou plusieurs des canaux. Vous pouvez en savoir plus sur cela

Supprimer un canal

Pour supprimer un canal depuis l'application web, ouvrez la Canaux context : nom de fonctionnalité de canaux de Capgo. Page/zone : page de marketing de solutions de Capgo. Rôle : étiquette de navigation ou élément UI court. Vu dans : page solutions/white-label.astro. Clé de message `solutions_white_label_visual_cell2_value` (Valeur de cellule visuelle de Solutions White Label) rubrique pour votre application et trouvez la ligne du canal. Dans la Action colonne, cliquez sur l'icône de la poubelle, puis cliquez sur Supprimer

Ligne de canal de la colonne d'action montrant l'icône de la poubelle channel.delete Si l'icône de la poubelle n'est pas visible, votre compte n'a pas la 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é liée à une organisation et à une application Aperçu de l'application Une clé peut supprimer atomiquement uniquement le canal de prévisualisation non public et le paquet qu'elle a créé avec. Elle ne peut pas modifier ou supprimer un canal par défaut/existant, un autre canal de prévisualisation ou un paquet d'une autre clé. Voir channel delete <preview-channel> <app-id> --delete-bundle__CAPGO_KEEP_0__ Clés API Keys Gestion d'un canal

Section intitulée « Gestion d'un canal »

comme dans l'image)3 Gestion d'un canal

La page Paramètres de canal contient toutes les options de configuration pour votre canal. Passons en revue chaque paramètre.

Premièrement le Default channel Contexte : Page/zone : Page de construction Capgo / produit de construction cloud native. Rôle : Étiquette de navigation ou élément de navigation court. Clé de message `native_build_builder_credit_first` (Premier crédit du constructeur de construction native). 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 mise en place de configurations par plateforme (une pour iOS, une pour Android et une pour Electron), consultez la Configuration du canal par défaut

section. IOS 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. Android Troisièmement le IOSparamètre. C'est similaire à

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 le Electron paramètres. Cela ressemble à IOS et Android. Si ceci est faux, les applications Electron ne seront pas autorisées à télécharger des mises à jour à partir 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 1.2.0 version vers le magasin d'applications ou le magasin Play et que vous essayez de définir la version du canal sur 1.1.0 alors la mise à jour (régression) échouera.

Sixième est le Disable auto update. Ce paramètre est assez complexe, et vous pouvez en savoir plus sur ici

Quant à Allow development build. Si ceci est vrai, 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, toute demande de mise à jour qui a le prod sera rejeté. Cela est principalement utile aux fins de test.

Septième est le Allow EmulatorsSi cela est faux, alors Capgo ne permettra aucune mise à jour de requête qui provient d'un émulateur. Cela est principalement utile aux fins de test.

Huit est le Allow devices to self associateSi cela est vrai, alors le setChannel la 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.

Déploiements progressifs

Le canal Informations La page comprend un Déploiement progressif section. Définissez un ensemble de packages, 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 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.

Déploiement progressif dans un canal Capgo — Les contrôles de déploiement progressif apparaissent en haut de la page d'informations du canal.

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

Continuez depuis les canaux

Si vous utilisez Canaux pour planifier la mise en route des canaux et la mise en production étape par étape, connectez-l’à Canaux pour les détails d'implémentation dans Canaux, Canaux pour les détails d'implémentation 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 l'environnement : Staging avec un seul ID d'application mobile pour le contexte pratique dans Capgo Pratiques de l'environnement : Staging avec un seul ID d'application mobile.