Page de l'app

Que contient la page de l'app ?

Tout d'abord, jetons un œil à 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 :

1. 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ôle du déploiement progressif.
   • Appareils: Appareils enregistrés et overrides.
   • Logs: Analyse des logs et logs bruts.
   • Builds : Gestion des builds natifs.

2. 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.

3. 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, installations et échecs.
   • Statistiques de déploiement (14) : Nombre total de déploiements.

4. 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) : Consultez les statistiques de la période de facturation actuelle.
   • Plage de dates (18) : Select a custom date range (e.g., last 30 days).

Informations sur l'application

Cette section correspond à l'onglet « Information » (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.

Page Informations sur l'application

Cette capture d'écran est antérieure à la version actuelle de la console et ne montre pas tous les paramètres. Référez-vous aux descriptions des champs ci-dessous pour obtenir les informations exactes.

Voici le détail des champs et actions disponibles :

• Icône de l'application (2) : Affiche l'icône de votre application. Cliquez sur le bouton « Changer » pour envoyer une nouvelle icône.
• ID de l'app (3) : Un identifiant unique pour votre application au sein de Capgo. Cet ID n'est pas modifiable.
• Nom de l'app (4) : Le nom d'affichage de votre application. Vous pouvez le modifier si nécessaire.
• Canal d'upload par défaut (5) : Spécifie le canal par défaut vers lequel les nouveaux bundles seront envoyés. Vous pouvez cliquer sur l'icône d'édition pour sélectionner un autre canal par défaut.
• Canal de téléchargement par défaut (6) : Spécifie le canal par défaut depuis lequel les appareils téléchargeront les mises à jour. Vous pouvez cliquer sur l'icône d'édition pour sélectionner un autre canal par défaut. La page du canal indique s'il est par défaut, mais le changement s'effectue ici, et non via un bouton sur le canal. Ouvrez un canal et cliquez sur Gérer dans les paramètres de l'application pour accéder directement à ce champ. Consultez la section Configuration du canal par défaut ci-dessous pour plus d'informations.
• Suppression auto des bundles inutilisé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). Réglez sur 0 pour 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) : Une fois activé, les champs de lien du bundle et de commentaire seront 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 : Capgo rejette les requêtes de mise à jour, de stats et de canal provenant des plages IP connues des datacenters Google et Apple. Laissez cette option activée pour le trafic de production normal. Ne la désactivez temporairement que si vous testez intentionnellement depuis une infrastructure de fournisseur. Les nouvelles apps activent cette protection par défaut ; les apps existantes conservent leur paramètre précédent jusqu'à ce que vous le modifiiez.
• Transférer la propriété de l'app (9) : Cette section propose une option pour initier le transfert de votre application vers une autre organisation dont vous faites partie.
• Bouton de suppression de l'app : 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 toutes les modifications apportées aux champs éditables de cette page (ex: nom de l'app, canal d'upload par défaut, paramètre de suppression auto des bundles).

Configuration du canal par défaut

Le Canal de téléchargement par défaut est l'un des paramètres les plus importants pour votre app. Il détermine le canal depuis lequel les nouveaux appareils recevront des mises à jour lors de leur première connexion à Capgo.

Fonctionnement des canaux par défaut

Lorsqu'un appareil demande une mise à jour à Capgo, le système détermine quel canal utiliser selon l'ordre de priorité suivant (du plus prioritaire au moins prioritaire) :

1. Mapping forcé de l'appareil: Si l'ID de l'appareil est explicitement forcé vers un canal dans les paramètres de canal, ce canal est toujours prioritaire.
2. Surcharge Cloud: Si l'appareil a été assigné à un canal depuis le dashboard ou via API Public, cette priorité est appliquée.
3. 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.
4. Configuration Capacitor defaultChannel: S'il est défini dans votre capacitor.config.* fichier, il est utilisé pour les builds de test/beta.
5. 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

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
• Vous avez besoin de stratégies de mise à jour différentes par plateforme
• Vous testez une nouvelle version sur une plateforme tout en gardant l'autre stable

Pour configurer les valeurs par défaut par plateforme :

1. Créez des canaux distincts pour chaque plateforme (par exemple production-ios, production-android, et production-electron)
2. Dans les paramètres de chaque canal, activez uniquement la plateforme concernée (bouton iOS, Android ou Electron)
3. Activé Informations sur l'application, définissez chacun de ces canaux comme canal de téléchargement par défaut pour sa plateforme. Capgo permet d'avoir plusieurs canaux par défaut si ceux-ci ciblent des plateformes différentes.

Lorsqu'un appareil demande une mise à jour :

• Les appareils iOS recevront les mises à jour du canal par défaut compatible iOS
• Les appareils Android recevront les mises à jour du canal par défaut pour Android

Canal par défaut unique (recommandé pour la plupart des apps)

Pour la plupart des applications, un canal par défaut unique prenant en charge les trois plateformes principales est l'approche la plus simple :

1. Créez un canal (ex : production)
2. Assurez-vous que les commutateurs iOS, Android et Electron sont activés
3. 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

Lorsque vous changez 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() (ou unsetChannel()) depuis l'app. Supprimer l'enregistrement de l'appareil côté backend n'efface pas une affectation setChannel() 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.

Astuce: Testez toujours votre nouveau canal par défaut avec un petit groupe d'appareils forcés avant de l'appliquer à tous les utilisateurs.

Continuer depuis la page de l'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.