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 imposée: Si l'ID de l'appareil est explicitement forcé à un canal (le Appareils tab on the channel page), that channel always wins. Forced mappings are console/API overrides. Capgo removes them 90 days after the last override write. See Console et les API de console expirent.
2. Console et surcharges API expirent: La modification du canal d'un appareil dans l'interface de dashboard ou via le Public API écrit une mise à jour liée à cet ID d'appareil. non effacer cela ; la suppression de l'override fonctionne. La même rétention de 90 jours s'applique.
3. Plugin setChannel() (local): Sur les versions actuelles des plugins, setChannel() stocke le canal sur le dispositif après validation par l'arrière-plan. Il ne s'agit pas d'une surcharge de tableau de bord. La réinstallation de l'application l'efface ; l'application doit appeler setChannel() à nouveau si vous souhaitez toujours ce canal.
4. Capacitor configuration defaultChannel (build de test par défaut): Pour les builds internes / bêta / de test, vous pouvez définir defaultChannel (clé legacy) channel) capacitor.config.* Les appareils de test commencent sur un canal de pré-version (par exemple, beta, pr-123Si absent, l'appareil se dirigera vers la valeur par défaut du cloud. Les builds de production laissent généralement cela non défini.
5. Canal par défaut du Cloud (stratégie principale pour environ 99 % des utilisateurs): Le principal canal de production où la plupart des utilisateurs réels atterrissent. N'importe quel appareil nouveau sans force, sans surcharge, sans une configuration locale setChannel(), et sans une configuration defaultChannel Utilisez ceci. La modification est déployée (ou annulée) pour tous en quelques secondes, sans nouvelle version binaire.

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

• Rollout ou retrait instantané sans reconstruction ou républication de binaires natifs.
• Un seul endroit pour gérer le comportement d'iOS, d'Android et d'Electron.
• Sûr : vous pouvez confirmer l'existence des lots et la conformité des paramètres avant de passer à la version par défaut.
• Les modifications auditable (les membres de l'équipe peuvent voir qui a modifié quoi dans l'interface / les journaux). exceptions (debug single user, QA switching, test build defaults). Normal users flow to the cloud default.

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

• Ne sont pas forcés
• Ne possèdent pas déjà un surclassement du cloud
• Ne disposent pas d'une configuration d'application defaultChannel définie

If un test de build embarque avec defaultChannel: 'beta' et que vous modifiez ensuite la valeur par défaut du cloud productionles appareils qui ont démarré sur beta via la configuration jusqu'à ce qu'une affectation de priorité supérieure s'applique, ou jusqu'à ce que vous expédiez un binaire sans. defaultChannelSupprimant une force, un masquage cloud ou local setChannel() Les appareils restent sur leur canal actuel à moins que vous :

Forcer un autre canal (console ou Public __CAPGO_KEEP_0__).

• Forcer les utilisateurs vers un autre canal (console ou Public API).
• Changer la configuration de cloud dans l'interface de dashboard ou Public API.
• context setChannel() Affectation locale sur les versions actuelles du plugin.
• Supprimer ou archiver le canal sur lequel ils sont actuellement (ils retomberont ensuite dans la hiérarchie de priorité lors du prochain contrôle).
• Attendez que la console/API expire après 90 jours.
• Reinstall the app, which clears a local setChannel() affectation mais pas un redéfinir la console/API.

If a channel is disabled for a platform (see iOS / Android / Electron toggles) and would otherwise have been selected, the selection skips it and falls back to the next rule.

Remarque : Définition defaultChannel Changer cela nécessite un nouveau binaire ; utilisez-l’intentionnellement pour les tests/la validation qualité, et non pour le contrôle de production général.

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 config, override ou force) NE seront PAS déplacés automatiquement ; seuls les appareils frais (ou ceux dont vous avez effacé 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 Cliquez sur votre application et ensuite Cliquez sur l'onglet des canaux.

Section intitulée “Créer un canal”

dans l’image) En cliquant dessus, une boîte de dialogue s’ouvrira où vous pourrez créer un nouveau canal.1 Cliquez sur l'icône (représentée dans l'image) pour ouvrir un modal où vous pouvez 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 « 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 des canaux. Vous pouvez en savoir plus sur cela ici

Supprimer un canal

Section titled “Supprimer un canal” Canaux tab pour votre application et trouvez la ligne de canal. Dans la Action Cliquez sur l'icône de la poubelle, puis cliquez Supprimer dans le dialogue de confirmation.

Si l'icône de la corbeille n'est pas visible, votre compte n'a pas la possibilité. 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 organisation et une application liées App Preview La clé peut supprimer atomiquement uniquement le canal de prévisualisation non public et le bundler créé avec channel delete <preview-channel> <app-id> --delete-bundleIl ne peut pas modifier ou supprimer un canal par défaut/existant, un canal de clé de prévisualisation ou un bundle d'une autre clé. Voir Clés API __CAPGO_KEEP_0__ Clés

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'une fenêtre modale.

Paramètres du canal

• Dashboard: Adoption of l'actuel bundle et les statistiques d'installation pour ce canal.
• Informations: Paramètres du canal listés ci-dessous, plus le lancement progressif et la mise à jour de test API.
• Appareils: Mappages forcés créés à partir de la console ou Public API uniquement. Il ne liste pas tous les appareils actuellement sur le canal, et il ne liste pas les appareils qui ont utilisé setChannel()Voir Console et les API de console expirent.
• Historique: Modifications et les changements de bundle pour ce canal.
• Aperçu: Prévisualisation en ligne et native du bundle lié. Activez l'aperçu de bundle dans Informations sur l'application Premier.

Paramètres d'informations

Restez sur la Informations onglet. Les paramètres apparaissent dans cet ordre :

Premier, Canal de téléchargement par défaut C'est une vignette d'état, pas un commutateur. Active signifie que ce canal est le par défaut du cloud pour les nouveaux appareils. Cliquez Gérer les paramètres de l'application pour modifier la valeur par défaut sur Informations sur l'applicationPour les paramètres par défaut spécifiques à la plateforme (un pour iOS, un pour Android et un pour Electron), consultez la même section.

le deuxième IOS Paramètres. Si ce paramètre est faux, les appareils iOS ne pourront pas télécharger les mises à jour de ce canal.

le troisième est le Android Paramètres. Si ce paramètre est faux, les appareils Android ne pourront pas télécharger les mises à jour de ce canal.

le quatrième est le Electron Paramètres. Si ce paramètre est faux, les applications Electron ne pourront pas télécharger les mises à jour de ce canal.

le cinquième est le Disable auto downgrade under native paramètre. Si ce paramètre 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 Publiez une nouvelle version vers l'app store ou play store et essayez de définir la version du canal à 1.1.0 alors que l'update (dégradation) échouera.

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

Septième est le Download format paramètre. Il détermine si les appareils téléchargent un zip complet, uniquement les fichiers delta modifiés ou le meilleur des deux. Consultez Format de téléchargement.

Huitième est Allow development buildSi c'est vrai, les builds de développement pourront télécharger des mises à jour à partir de ce canal. Sinon, toute demande de mise à jour qui a prod set à false sera rejetée. C'est principalement utile pour des fins de test.

Neuvième est Allow production build. Si ce n'est pas vrai, les builds de production (magasin) ne recevront pas de mises à jour de ce canal. Laissez-l’activé pour les canaux qui servent des utilisateurs réels.

Le dixième est le Allow EmulatorsSi ceci est faux, alors Capgo ne permettra pas de requête d'actualisation provenant d'un émulateur. Cela est principalement utile aux fins de test.

L’onzième est Allow physical devicesSi ceci est faux, alors Capgo refusera les requêtes d'actualisation provenant de vrais téléphones et tablettes. Laissez cela activé pour les canaux de production.

Le douzième est Allow devices to self dissociate/associateSi ceci est vrai, alors la setChannel méthode sera disponible. Si ceci est défini sur faux et que vous essayez d'appeler setChannel avec ce canal, alors l'appel échouera.

Test d'actualisation API

At the bottom of the Information expand Test Update 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 que le canal soit soit le canal de téléchargement par défaut, soit autoriser l'auto-assignation des appareils.

Envoyer une notification d'actualisation

Après que vous ayez modifié le bundle lié, le console peut demander à Envoyer une notification d'actualisation. That queues a silent push so devices on the channel check for the new bundle now. Configure Android and iOS push credentials on the app Notifications tab first.

Console et les API redéfinitions expirent

Les mappages forcés et les surcharges de canal Dashboard/Public API sont supprimés 90 jours Après la dernière mise à jour, l'horloge ne sera pas réinitialisée. Pour un affectation qui survivra à cette suppression, définir defaultChannel dans votre Capacitor de configuration (survient à la réinstallation, nécessite un nouveau binaire pour changer) ou appelez setChannel() à partir de l'application (évite la purge de 90 jours, mais la réinstallation la supprime donc l'application doit appeler setChannel() à nouveau).

Surpasser la rétention sur l'onglet appareils du canal. Le même avertissement s'affiche lorsque vous imposez un ID de appareil sur le canal.

Cela est séparé de la conservation de l'inventaire de périphérique. L'inventaire supprime les appareils qui n'ont pas connecté à Capgo pendant 90 jours. Supprimer les mises à jour supprime la correspondance même si l'appareil est toujours actif. Détails complets: Console et les API de console expirent après 90 jours.

Format de téléchargement

Ouvrir un canal et rester sur le Informations tab. Format de téléchargement is in the settings list, under Disable auto update.

Téléchargez le format sur l'onglet Informations du canal. Les nouveaux canaux par défaut sont Zip + delta.

Cette configuration détermine ce que Capgo envoie lorsque le dispositif sur ce canal vérifie une mise à jour. Laissez Zip + delta sauf si vous devez forcer un type.

Étiquette dans la console	CLI / API valeur	Quels appareils téléchargent
Zip + delta (par défaut)	all	Chaque appareil obtient le meilleur paquet qu'il supporte. Les appareils sur une version de plugin avec prise en charge Delta téléchargent uniquement les fichiers delta modifiés lorsque le bundle les a. Seuls les appareils sur une ancienne version de plugin sans prise en charge Delta, ou les bundles téléchargés sans fichiers delta, retournent à la zip complète.
Zip complet uniquement	zip	Tous les appareils téléchargent la zip du bundle entière, même lorsque des fichiers delta existent.
Delta uniquement	delta	Les appareils sur une ancienne version de plugin sans prise en charge Delta reçoivent toujours la zip complète lorsque le bundle en a une.
Full zip depuis la build du magasin uniquement	zip_from_builtin	Seulement en zip complet pendant que le dispositif est toujours sur la build du magasin. Après la première live update, Capgo sert à nouveau zip + delta.
Seulement delta depuis la build du magasin.	delta_from_builtin	Seulement delta pendant que le dispositif est toujours sur la build du magasin. Après la première live update, Capgo sert à nouveau zip + delta.

Avec Zip + delta, il est attendu de voir quelques téléchargements de zip complets. Ils proviennent de dispositifs qui exécutent encore une ancienne build native avec une version de plugin sans prise en charge de Delta (ci-dessous) 5.10.0, 6.25.0, ou 7.0.35 pour leur version majeure). Consultez Mises à jour de Delta.

context store build Les web assets sont-ils embarqués dans le fichier binaire de l'App Store ou de Play Store, avant tout Capgo mise à jour. Utilisez un from store build only mode when the first update off the store build should be full zip only or delta only, and later updates can use both.

Capgo ne paiera pas un canal zip uniquement avec un bundle delta uniquement, ou l'inverse. La console, CLI, et Canaux API refuseront le sauvegardage et vous diront de télécharger le paquet manquant ou de basculer le mode.

Vous pouvez définir la même valeur à partir du 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 Information onglet inclut un Déploiement progressif section avec Cible de déploiement et Fonctionnalité stable par défaut, Changer la cible de déploiement, Appliquer un pourcentage, et actions Déploiement complet, Annuler le déploiement, Activer le déploiement, Disable la mise en production, Pause la mise en production, et Rétablir la mise en production.

Contrôles de lancement progressif apparaissent en haut de l'onglet Informations du canal.

Lire Mises en production progressives Avant de l'activer. Cette guide couvre la mise en ligne de routage ("Automatique (recommandé) / Déploiement cible / Automatique (recommandé); CLI --stable / API target: "stable" pour le dépasser) ce canal utilise le déploiement progressif dialogue de lien de paquet, et un flux de travail sûr avec Observez et Log d'informations.

Continuez d'ici les canaux

S'il vous plaît, si vous utilisez Canaux pour planifier la routage du canal et le lancement étape par étape, connectez-l’avec 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 Beta. Solution de ciblage de version pour le flux de travail du produit dans la Solution de ciblage de version. Capgo Environment Best Practices: Staging with One Mobile App ID Capgo Pratiques recommandées pour l'environnement : mise en scène avec un seul ID d'application mobile