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é: Si l'ID de l'appareil est explicitement forcé à un canal (la Appareils page du canal), ce canal gagne toujours. Les cartographies forçées sont des overrides console/API. Capgo les supprime 90 jours après la dernière écriture d'override. Voir Console et overrides API expirent.
2. Surcharge Cloud (Tableau de bord ou Public API): La modification du canal d'un appareil dans le tableau de bord ou via le Public API écrit une surcharge liée à cet ID d'appareil. La réinstallation de l'application ne la supprime pas ; la suppression de la surcharge le fait. La même rétention de 90 jours s'applique. Plugin (local)
3. : Sur les versions actuelles des plugins, setChannel() stocke le canal sur l'appareil après validation par l'arrière-plan. Il ne s'agit pas d'une surcharge du tableau de bord. La réinstallation de l'application la supprime ; l'application doit appelerà nouveau si vous souhaitez toujours ce canal. setChannel() __CAPGO_KEEP_0__ config (défaut de build de test) setChannel() : Pour les builds internes / bêta / de test, vous pouvez définir
4. Capacitor config (défaut de build de test) defaultChannel : Pour les builds internes / bêta / de test, vous pouvez définir__CAPGO_KEEP_0__ config (défaut de build de test) defaultChannel (clé legacy) channelen capacitor.config.* ainsi les appareils de test commencent sur un canal de pré-sortie (par exemple, beta, pr-123. Si absent, l'appareil se dirigera vers le paramétrage par défaut du cloud. Les builds de production laissent généralement cela non défini.
5. 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 dispositif sans force, sans surcharge, sans local setChannel()et sans une configuration defaultChannel utilise cela. La modification de cela déclenche un déploiement (ou un retrait) pour tout le monde en secondes, sans nouvelle version native.

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

• Déploiement ou retrait instantané sans reconstruction ou ré-publication de binaires natifs.
• Un seul endroit pour gérer le comportement iOS, Android et Electron.
• Sûr : vous pouvez confirmer que les ensembles 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 / annuler / configurer) sont exceptions

(debugger pour un utilisateur unique, QA qui bascule, les paramètres par défaut de la version de test). Les utilisateurs normaux suivent la version par défaut du cloud. La modification de la version par défaut du cloud affecte les nouveaux

• dispositifs normaux qui :
• Ne sont pas forcés
• Do pas avoir une application defaultChannel definie

Si une version de test embarque defaultChannel: 'beta' et que vous modifiez ensuite la valeur par défaut de Cloud par productionet les appareils qui ont démarré sur beta via la configuration restent là jusqu'à ce qu'une affectation de priorité supérieure s'applique, ou jusqu'à ce que vous embarquez une version binaire sans defaultChannel. Supprimer une force, une surcharge de Cloud ou une affectation locale n'efface pas la valeur de la configuration ; cette valeur de fallback reste jusqu'à la nouvelle version binaire. setChannel() Les appareils restent sur leur canal actuel à moins que vous:

Forcez-les à un autre canal (console ou Public __CAPGO_KEEP_0__).

• Modifiez la surcharge de Cloud dans le tableau de bord ou Public API.
• Change the cloud override in the dashboard or Public API.
• context setChannel() (affectation locale sur les versions actuelles du plugin).
• Supprimer / archiver le canal sur lequel ils se trouvent (puis ils retomberont à travers la priorité à nouveau lors du prochain contrôle).
• Attendre jusqu'à ce qu'un console/API override expire après 90 jours.
• Réinstaller l'application, ce qui efface une affectation locale mais pas un console/__CAPGO_KEEP_0__ override. setChannel() assignment but not a console/API override.

Remarque : Définir

signifie changer cela nécessite un nouveau binaire ; utilisez-l’intentionnellement pour les tests / QA, pas pour le contrôle de production général. defaultChannel __CAPGO_KEEP_0__ config exemple

Sous-section intitulée “Capacitor config exemple”

capacitor.config.ts

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

Si vous changez ultérieurement la page d'accueil par défaut en productionles appareils déjà sur 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èrent.

---

Gestion des canaux

Tout d’abord, examinons 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.

Titre de la section « Créer un canal »

protectedTokens1 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 ?

column Misconfigured pour un ou plusieurs de ces canaux. Vous pouvez en savoir plus ici Yes supprimer un canal ici

What does misconfigured mean?

Pour supprimer un canal depuis l'application web, ouvrez le Canaux context Nom du canal de Capgo. Page/zone : page de marketing de solutions de Capgo. Rôle : étiquette de navigation ou élément de l'interface utilisateur court. Vu dans : page solutions/white-label.astro. Clé de message `solutions_white_label_visual_cell2_value` (Valeur de la cellule visuelle de Solutions White Label). tab 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 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>

Une clé liée à une organisation et à une application Aperçu de l'application Une clé d'organisation et d'application peut supprimer atomiquement uniquement le canal de prévisualisation non public et le bundle créé avec channel delete <preview-channel> <app-id> --delete-bundleElle ne peut pas modifier ou supprimer un canal par défaut principal existant, un autre canal de prévisualisation de clé, ou un bundle d'une autre clé. Voir API Clés pour la configuration de moindre privilège.

Gestion d'un canal

Cliquez sur le nom du canal pour ouvrir la page du canal. Il s'agit d'une page complète avec des onglets, et non d'un modèle.

Onglets du canal

• Tableau de bordAdoption de l'actuel bundle et stats d'installation pour ce canal.
• Informations: Channel settings listed below, plus progressive rollout and Test Update API.
• Paramètres du canal listés ci-dessous, plus déploiement progressif et Mise à jour de test __CAPGO_KEEP_0__.: Forced mappings created from the console or Public API only. It does not list every device currently on the channel, and it does not list devices that used setChannel()Appareils fortement liés créés à partir de la console ou Public __CAPGO_KEEP_0__ uniquement. Il ne liste pas tous les appareils actuellement sur le canal, et il ne liste pas les appareils qui ont utilisé Console and API overrides expire.
• Console et __CAPGO_KEEP_0__ overrides expireHistoire
• Évolution et modifications de bundle pour ce canal.: Prévisualisation en-ligne et native du paquet lié. Activez la prévisualisation du paquet dans Informations de l'application tout d'abord.

Paramètres d'information

Restez sur la rubrique Informations Les paramètres s'affichent dans cet ordre :

Premièrement, Le canal de téléchargement par défaut est une vignette de statut, et non un commutateur. Actif signifie que ce canal est le par défaut du cloud pour les nouveaux appareils. Cliquez Gérer dans les paramètres de l'application pour changer le par défaut sur Informations sur l'application. Pour les valeurs par défaut spécifiques aux plateformes (une pour iOS, une pour Android et une pour Electron), consultez la même section.

Second est la IOS 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ème est la 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.

Quatrième est la Electron si ce paramètre est faux, les applications Electron ne seront pas autorisées à télécharger des mises à jour à partir de ce canal.

Cinquième est la Disable auto downgrade under native Paramètres. Si ceci est vrai, alors il sera impossible de descendre d'une version native. Cela signifie que si vous avez téléchargé une version vers le magasin d'applications ou le magasin Play et que vous essayez de définir la version du canal à __CAPGO_KEEP_0__, alors la mise à jour (dégradation) échouera. 1.2.0 Sixième est le 1.1.0 Ce paramètre est assez complexe, et vous pouvez en savoir plus à ce sujet

Septième est le Disable auto updateParamètre de mise à jour du package Huitième est le

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 __CAPGO_KEEP_1__ défini à faux sera rejetée. Cela est principalement utile pour des fins de test. Update package Neufième est le Dixième est le .

onzième est le Allow development buildDouzième est le prod Treizième est le

Ninth est Allow production build. Si ceci est faux, les builds de production (magasin) ne recevront pas les mises à jour de ce canal. Laissez cela activé pour les canaux qui servent des utilisateurs réels.

Tenth 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 Allow physical devices. If this is false then Capgo will reject update requests from real phones and tablets. Leave this on for production channels.

Eleventh est Allow devices to self dissociate/associate. Si ceci est faux, le Capgo refusera les demandes de mise à jour provenant de vrais téléphones et tablettes. Laissez cela activé pour les canaux de production. Twelfth est . Si ceci est vrai, la méthode setChannel sera disponible. Si ceci est défini sur faux et que vous essayez d'appeler setChannel avec ce canal, l'appel échouera.

Test Mise à jour API

En bas de la Information ouvrir Test Mise à jour API. Capgo affiche une commande curl contre /updates pour un appareil d'essai sur ce canal.

Les modifications peuvent prendre jusqu'à 60 secondes pour s'afficher dans l’API en raison du cache. Si le canal ne peut pas être testé, le console vous avertit : le canal nécessite au moins une plateforme (iOS ou Android), des builds de production, des appareils physiques et soit être le canal de téléchargement par défaut ou permettre l'auto-assignation des appareils.

Envoyer notification de mise à jour

Après avoir modifié le bundle lié, le console peut demander à Envoyer une notification d'actualisationCe qui met en file d'attente une mise à jour silencieuse afin que les appareils sur le canal vérifient la nouvelle version maintenant. Configurez les informations de connexion de push Android et iOS sur la rubrique Notifications de l'application avant de procéder.

Console et les API redéfinitions expirent

Les mappages forcés et les redéfinitions de canal public API sont supprimés 90 jours après la dernière écriture de redéfinition. La dernière connexion de l'appareil ne réinitialise pas ce chronomètre. Pour une affectation qui survit à cette suppression, définissez defaultChannel dans votre Capacitor config (survive la réinstallation, nécessite un nouveau binaire pour changer) ou appelez setChannel() à partir de l'application (évite la suppression après 90 jours, mais la réinstallation efface cela, il faut donc que l'application appele setChannel() à nouveau).

Conservation des redéfinitions sur la page de configuration de canal. Le même avertissement s'affiche lorsque vous forcez un ID d'appareil sur le canal.

Cela est séparé de la conservation de l'inventaire des appareilsL'inventaire supprime les appareils qui n'ont pas été connectés à Capgo pendant 90 jours. La suppression de la mise à jour supprime même la correspondance si l'appareil est toujours actif. Détails complets : Console et API des mises à jour expirent après 90 jours.

Mise à jour du package

Ouvrez un canal et restez sur la Informations rubrique. La mise à jour du package se trouve dans la liste des paramètres, sous Désactiver la mise à jour automatique.

Mettre à jour le package sur la page d'informations du canal. Les nouveaux canaux définissent par défaut Zip et delta.

Cette configuration choisit ce que Capgo envoie lorsque le dispositif sur ce canal vérifie une mise à jour. Laissez Zip et delta à moins que vous ayez besoin de forcer un type.

Étiquette dans la console	CLI / API valeur	Quels appareils téléchargent
Zip et delta	all	Un zip complet et un delta lorsque les deux existent. C'est la valeur par défaut.
Zip uniquement	zip	Seul le zip complet.
Delta uniquement	delta	Seuls les fichiers modifiés. Les plugins qui ne peuvent pas appliquer une différence reçoivent toujours un zip.
Zip uniquement depuis builtin	zip_from_builtin	Zip uniquement pendant que le dispositif est toujours sur la version du magasin. Après la première mise à jour en direct, Capgo fournit à nouveau zip et delta.
Delta uniquement depuis builtin	delta_from_builtin	Delta uniquement pendant que le dispositif est toujours sur la version du magasin. Après la première mise à jour en direct, Capgo fournit à nouveau zip et delta.

Intégré est les actifs web embarqués dans l'application de l'App Store ou du Play Store, avant toute mise à jour Capgo. Utilisez un from builtin mode lorsque la première mise à jour à partir de la version du magasin devrait être zip-unique ou delta-unique, et les mises à jour ultérieures peuvent utiliser les deux.

Capgo ne paira pas un canal zip-unique avec un bundle delta-unique, ou l'inverse. Le console, CLI, et Les canaux API refusent le sauvegarder et vous avertissent de télécharger le paquet manquant ou de changer le mode.

Vous pouvez définir la même valeur à partir de CLI. Le canal doit déjà exister :

npx @capgo/cli@latest channel set production com.example.app --update-package zip

Valeurs valides : all, zip, delta, zip_from_builtin, delta_from_builtin.

Déploiements progressifs

Le canal Informations La rubrique « Informations » comprend une Déploiement progressif section avec Objectif de déploiement et Contrôle de fallback stable, Cible de déploiement de changement, Appliquer un pourcentageActions, et Déploiement complet, Annuler le déploiement, Activer le déploiement, Désactiver le déploiement, Mettre en pause le déploiementEt Reprendre le déploiement.

Les contrôles de déploiement progressif s'affichent en haut de la page d'informations du canal.

Lire Les déploiements progressifs Avant de les activer. Cette guide couvre la mise en route de l'upload (Automatique (recommandé) / Cible de déploiement / Remplacer stable; CLI --stable / API target: "stable" Cette chaîne utilise un déploiement progressif dialogue de lien de paquet, et un flux de travail sûr avec Les déploiements progressifs Observez et Logiciels d'analyse.

Continuez de la section des canaux

Canal connectez-l’avec Canal pour les détails d'implémentation dans Canal Canal pour les détails d'implémentation dans Canal Canal Solution de Test Beta pour le flux de workflow du produit dans Solution de Test Beta Solution de Ciblage de Version pour le flux de workflow du produit dans Solution de Ciblage de Version, et Capgo Pratiques d'Environnement : Étapes avec un ID d'Application Mobile unique pour le contexte pratique dans Capgo Pratiques d'Environnement : Étapes avec un ID d'Application Mobile unique.