Page de l'app
Copiez un prompt de configuration incluant les étapes d'installation et le guide markdown complet pour ce plugin.
Qu'affiche la page de l'app ?
Section intitulée « Que montre la page de l’application ? »Commençons par examiner la page principale de l’app :
Dans Capgo, une app représente votre application mobile intégrée au système live update de Capgo. Elle vous permet de gérer les mises à jour, les canaux et les appareils en toute simplicité.

Examinons cela de plus près. La page principale de l’app est divisée en plusieurs zones clés :
-
Barre de navigation supérieure : Donne accès aux principales vues de gestion de l’app. La capture d’écran est illustrative ; la console actuelle inclut :
- Dashboard : Métriques et résumés de l’app.
- Observe (beta) : Signaux de lancement natif, WebView, incidents et santé des releases.
- Informations : Paramètres et détails principaux de l’app (voir Informations sur l'application).
- Les bundles: Versions et releases.
- Canaux: Canaux de mise à jour et contrôles de déploiement progressif.
- Appareils: Appareils enregistrés et overrides.
- Logs: Analyse des logs et logs bruts.
- Builds : Gestion des builds natifs.
-
Affichage des statistiques : Visualise les métriques importantes de la dernière période de facturation (les données reflètent l'usage depuis votre date de facturation, pas depuis le 1er du mois) :
- Utilisateurs actifs mensuels (8) : Suit le nombre d'utilisateurs actifs uniques au fil du temps.
- Stockage (9) : Affiche la consommation de stockage actuelle.
- Bande passante (10) : Affiche l'utilisation de la bande passante.
- Bundle actif (11) : Affiche la répartition des appareils actifs entre les différents bundles de l'application.
-
Cartes de synthèse : Offre une vue d'ensemble rapide des chiffres clés :
- Uploads de bundles (12) : Nombre total de bundles d'app envoyés.
- Statistiques des mises à jour (13) : Nombre total de mises à jour effectuées, incluant les requêtes, les installations et les échecs.
- Statistiques de déploiement (14) : Nombre total de déploiements.
-
Options d'affichage (15-18) : Contrôles pour filtrer et visualiser les statistiques :
- Quotidien (15) : Afficher les statistiques par jour.
- Cumulé (16) : Afficher les statistiques cumulées au fil du temps.
- Période de facturation (17) : Afficher les statistiques de la période de facturation en cours.
- Plage de dates (18) : Sélectionnez une plage de dates personnalisée (ex. : 30 derniers jours).
Informations sur l'application
Section intitulée « Informations sur l’application »Cette section correspond à l’onglet « Informations » (1) de la barre de navigation supérieure. Vous pouvez y consulter et gérer les détails et paramètres essentiels de votre application.

La capture d’écran est antérieure à la console actuelle et n’affiche pas tous les paramètres actuels. Utilisez les descriptions des champs ci-dessous comme référence.
Voici le détail des champs et actions disponibles :
- Icône de l’application (2) : Affiche l’icône de votre application. Vous pouvez cliquer sur le bouton « Changer » pour envoyer une nouvelle icône.
- ID de l’app (3) : Un identifiant unique pour votre application dans Capgo. Cet ID n’est pas modifiable.
- Nom de l’application (4) : Le nom d’affichage de votre application. Vous pouvez le modifier selon vos besoins.
- Canal d’upload par défaut (5) : Indique le canal par défaut vers lequel les nouveaux bundles seront envoyés. Vous pouvez cliquer sur l’icône de modification pour sélectionner un autre canal par défaut.
- Canal de téléchargement par défaut (6) : Indique le canal par défaut depuis lequel les appareils téléchargeront les mises à jour. Vous pouvez cliquer sur l’icône de modification pour sélectionner un autre canal par défaut. La page du canal indique si un canal est celui par défaut, mais vous le modifiez ici, et non via un interrupteur sur le canal. Ouvrez un canal et cliquez sur Gérer dans les paramètres de l'application pour accéder à ce champ. Consultez la Configuration du canal par défaut section ci-dessous pour plus de détails.
- Suppression automatique des bundles non utilisés (après x secondes) (7) : Ce paramètre permet de supprimer automatiquement les anciens bundles qui n’ont pas été utilisés pendant une durée définie (en secondes). Définissez la valeur sur
0pour désactiver la suppression automatique. Cela aide à gérer le stockage et à garder votre liste de bundles propre. - Exposer les métadonnées du bundle au plugin (8) : Lorsqu’activé, les champs de lien et de commentaire du bundle sont envoyés au plugin Capacitor Updater. Cette fonctionnalité nécessite la version 7.35.0 ou supérieure du plugin.
- Bloquer les requêtes d’infrastructure des fournisseurs : Lorsqu’activé, Capgo rejette les requêtes de mise à jour, de statistiques et de canal auto provenant des plages d’IP de datacenters Google et Apple connues. Laissez-l’activé pour le trafic de production normal. Désactivez-le temporairement uniquement si vous testez intentionnellement depuis l’infrastructure des fournisseurs. Les nouvelles applications activent cette protection par défaut ; les applications existantes conservent leur paramètre précédent (désactivé) jusqu’à ce que vous le modifiiez.
- Transférer la propriété de l’application (9) : Cette section propose une option pour initier le transfert de votre application vers une autre organisation dont vous êtes membre.
- Bouton Supprimer l’application : Supprime définitivement votre application de Capgo. Cette action est irréversible et supprimera toutes les données, bundles, canaux et appareils associés.
- Bouton de mise à jour : Enregistre les modifications apportées aux champs modifiables de cette page (par ex. : nom de l’application, canal d’upload par défaut, paramètre de suppression automatique des bundles).
Configuration du canal par défaut
Section intitulée « Configuration du canal par défaut »Le Canal de téléchargement par défaut est l’un des paramètres les plus importants de votre application. Il détermine le canal depuis lequel les nouveaux appareils recevront les mises à jour lors de leur première connexion à Capgo.
Fonctionnement des canaux par défaut
Section intitulée « Fonctionnement des canaux par défaut »Lorsqu’un appareil demande une mise à jour à Capgo, le système détermine le canal à utiliser selon la priorité suivante (de la plus haute à la plus basse) :
- Mapping forcé de l’appareil: Si l’ID de l’appareil est explicitement forcé vers un canal dans les paramètres du canal, ce canal a toujours la priorité.
- Remplacement cloud: Si l'appareil a été assigné à un canal depuis le dashboard ou via l'API publique, cet override est utilisé.
- Plugin
setChannel(): Sur les versions actuelles du plugin, il s'agit d'une assignation locale et non d'un override via le dashboard. Voir Comment un appareil choisit un canal. - Configuration Capacitor
defaultChannel: S'il est défini dans votrecapacitor.config.*fichier, il est utilisé pour les builds de test/beta. - Canal de téléchargement par défaut: Le paramètre configuré ici. C'est ce que ~99 % de vos utilisateurs en production utiliseront.
Canaux par défaut par plateforme
Section intitulée « Canaux par défaut spécifiques à la plateforme »Vous pouvez configurer des canaux par défaut spécifiques à chaque plateforme — par exemple un pour iOS, un pour Android et un pour Electron. C'est utile quand :
- Vous souhaitez déployer des mises à jour sur une plateforme avant l’autre
- Des stratégies de mise à jour différentes selon la plateforme
- Vous testez une nouvelle version sur une plateforme tout en gardant l’autre stable
To set up platform-specific defaults:
- Créez des canaux séparés pour chaque plateforme (par exemple
production-ios,production-android, etproduction-electron) - Dans les paramètres de chaque canal, activez uniquement la plateforme concernée (iOS, Android ou Electron)
- Activé Informations sur l'application, définissez chacun de ces canaux comme canal de téléchargement par défaut pour sa plateforme. Capgo autorise plus d’un canal par défaut si les canaux ciblent des plateformes différentes.
Lorsqu’un appareil demande une mise à jour :
- Les appareils iOS recevront les mises à jour depuis le canal par défaut activé pour iOS
- Les appareils Android recevront les mises à jour depuis le canal par défaut activé pour Android
Canal par défaut unique (recommandé pour la plupart des apps)
Section intitulée « Canal par défaut unique (recommandé pour la plupart des applications) »Pour la plupart des applications, un canal par défaut unique prenant en charge les trois plateformes principales est l’approche la plus simple :
- Créez un canal (par ex. :
production) - Assurez-vous que les toggles iOS, Android et Electron sont activés
- Définissez-le comme canal de téléchargement par défaut sur Informations sur l'application
Cela garantit un comportement cohérent sur toutes les plateformes et simplifie votre workflow de release.
Changer le canal par défaut
Section intitulée « Changer le canal par défaut »Lorsque vous modifiez le canal par défaut :
- Nouveaux appareils recevront immédiatement les mises à jour du nouveau canal par défaut
- Appareils existants qui ont déjà une affectation de canal (via override ou force) ne basculeront PAS automatiquement
- Pour déplacer les appareils existants, deux options :
- Utiliser
setChannel()(ouunsetChannel()) depuis l'app. Supprimer l'enregistrement de l'appareil côté backend n'efface pas une affectationsetChannel()locale. - Les forcer sur le nouveau canal dans le dashboard (override console/API ; expire après 90 jours)
- Supprimer leur override console/API pour qu'ils retombent sur la priorité suivante. Les appareils qui n'ont que le défaut cloud adoptent alors le nouveau défaut.
- Utiliser
Astuce: Testez toujours votre nouveau canal par défaut sur un petit groupe d’appareils forcés avant d’en faire le canal par défaut de tous les utilisateurs.
Continuer depuis la page de l'app
Section intitulée « Continuer depuis la page App »Si vous utilisez Page de l'app pour planifier les opérations du dashboard et de API, connectez-l’avec Aperçu de API pour les détails d'implémentation dans « Vue d'ensemble de API », Introduction pour les détails d'implémentation dans l'introduction, Clés API pour les détails d'implémentation dans API Keys, Appareils pour les détails d'implémentation dans Devices, et Les bundles pour les détails d'implémentation dans Bundles.