Page d'application

Qu'est-ce que la page de l'application affiche ?

Premièrement, examinons la page principale de l'application :

Dans Capgo, une application représente votre application mobile intégrée au système d'actualisation en temps réel de Capgo. Cela vous permet de gérer les mises à jour, les canaux et les appareils de manière fluide.

Examinons cela de plus près. La page principale de l'application est divisée en plusieurs zones clés :

1. Barre de navigation en haut : Fournit accès aux vues de gestion de l'application principale. La capture d'écran est illustrative ; la console actuelle comprend :

   • Tableau de bord : Indications et résumés pour l'application.
   • Observez (beta) : Lancement natif, WebView, signaux de problèmes et de santé de la mise à jour.
   • Informations : Paramètres et détails de l'application principale (voir Informations sur l'application).
   • Ensembles: Versions et mises à jour.
   • Canaux: context
   • Canaux de mise à jour et contrôles de déploiement progressif.: Appareils
   • Appareils enregistrés et paramètres de remplacement.: Log Insights et les journaux bruts.
   • Builds : Gestion de construction native.

2. Affichage de statistiques : Affiche les principaux indicateurs pour la dernière période de facturation (les données reflètent l'utilisation de votre jour de facturation, et non le 1er du mois) :

   • Utilisateurs actifs mensuels (8) : Suivi du nombre d'utilisateurs uniques actifs au fil du temps.
   • Stockage (9) : Affiche la consommation de stockage actuelle.
   • Bandwidth (10) : Affiche l'utilisation de la bande passante.
   • Bundle Actif (11): Affiche la répartition des appareils actifs en fonction de différents lots d'applications.

3. Cartes de Résumé : Propose un aperçu rapide des comptes clés :

   • Téléchargements de Bundles (12): Nombre total de lots d'applications téléchargés.
   • Statistiques des Mises à Jour (13): Nombre total de mises à jour effectuées, y compris les requêtes, les installations et les échecs.
   • Statistiques des Déploiements (14): Nombre total de déploiements.

4. Options de Affichage (15-18): Contrôles pour filtrer et afficher les statistiques :

   • Journalier (15): Afficher les statistiques sur une base journalière.
   • Cumulatif (16): Afficher les statistiques cumulatives sur le temps.
   • Période de facturation (17): Afficher les statistiques pour la période de facturation actuelle.
   • Intervalle de dates (18): Sélectionnez un intervalle de dates personnalisé (par exemple, les 30 derniers jours).

Information de l'application

Cette section correspond à l'onglet « Information » (1) de la barre de navigation supérieure. Vous pouvez ici consulter et gérer les détails et les paramètres essentiels de votre application.

Page d'informations de l'application

La capture d'écran est plus ancienne que la console actuelle et ne montre pas tous les paramètres actuels. Utilisez les descriptions des champs ci-dessous comme source de vérité.

Voici un aperçu des champs et actions disponibles :

• Appareil d'icône (2) : Affiche l'icône de votre application. Vous pouvez cliquer sur le bouton « Changer » pour télécharger une nouvelle icône.
• ID d'application (3) : Un identifiant unique pour votre application au sein de Capgo. Ce ID n'est pas éditable.
• Nom d'application (4) : Le nom affiché pour votre application. Vous pouvez le modifier si nécessaire.
• Canal de téléchargement par défaut (5) : Spécifie le canal par défaut vers lequel les nouveaux lots seront téléchargés. Vous pouvez cliquer sur l'icône de modification pour sélectionner un canal de téléchargement par défaut différent.
• Canal de téléchargement par défaut (6) : Spécifiez le canal par défaut à partir duquel les appareils téléchargeront les mises à jour. Vous pouvez cliquer sur l'icône de modification pour sélectionner un canal de défaut différent. La page du canal montre si un canal est le canal de défaut, mais vous le changez ici, et non avec un commutateur sur le canal. Ouvrez un canal et cliquez Gérer les paramètres de l'application pour passer à ce champ. Consultez la Configuration du canal par défaut section ci-dessous pour plus d'informations.
• Supprimer automatiquement les Bundles non utilisés (après x secondes) (7) : Cette configuration vous permet de supprimer automatiquement les anciens bundles qui n'ont pas été utilisés pendant une durée spécifiée (en secondes). Définissez sur 0 pour désactiver la suppression automatique. Cela aide à gérer l'espace de stockage et à garder votre liste de bundles propre.
• Exposer les métadonnées du Bundle aux plugins (8) : Lorsque ce paramètre est activé, les champs de lien et de commentaire du bundle seront envoyés au plugin de mise à jour Capacitor. Cette fonctionnalité nécessite une version du plugin supérieure ou égale à 7.35.0.
• Empêcher les requêtes d'infrastructure de fournisseur : Lorsque ce paramètre est activé, Capgo rejette les requêtes d'actualisation, de statistiques et de canal-self provenant des adresses IP de centres de données Google et Apple connus. Laissez-l’activé pour le trafic de production normal. Désactivez-le temporairement uniquement lorsque vous testez intentionnellement depuis l'infrastructure de fournisseur. Les nouvelles applications activent cette protection par défaut ; les applications existantes conservent leur paramétrage précédemment désactivé jusqu'à ce que vous le modifiiez.
• Transfert de la propriété de l'application (9) : Cette section fournit une option pour initier le transfert de votre application vers une organisation différente dont vous faites partie.
• Bouton de suppression de l'application : Supprime définitivement votre application de Capgo. Cette action est irréversible et supprimera toutes les données associées, les ensembles, les canaux et les appareils.
• Bouton de mise à jour : Enregistre toutes les modifications que vous avez apportées aux champs éditables de cette page (par exemple, le nom de l'application, le canal de téléchargement par défaut, la configuration de suppression automatique des ensembles).

Configuration du canal par défaut

Le Canal de téléchargement par défaut est l'une des configurations les plus importantes pour votre application. Il détermine quel canal les nouveaux appareils recevront des mises à jour lorsqu'ils se connectent pour la première fois à Capgo.

Comment fonctionnent les canaux par défaut

Lorsqu'un appareil demande une mise à jour à Capgo, le système détermine le canal à utiliser en fonction de la priorité suivante (priorité la plus élevée en premier) :

1. Cartographie de l'appareil forcé: Si l'ID de l'appareil est explicitement forcé à un canal dans les paramètres du canal, ce canal gagne toujours.
2. Surcharge de Cloud: Si l'appareil a été affecté à un canal depuis le tableau de bord ou Public API, cette surcharge est utilisée.
3. Plugin setChannel(): Dans les versions actuelles de plugin, c'est une affectation locale et non une surcharge du tableau de bord. Voir Comment un appareil choisit un canal.
4. Capacitor config defaultChannel: Si défini dans votre capacitor.config.* fichier, cela est utilisé pour les builds de test/bêta.
5. Canal de Téléchargement Par Défaut: La configuration configurée ici. C'est ce que ~99% de vos utilisateurs de production utiliseront.

Canaux Par Défaut Spécifiques à la Plateforme

Vous pouvez configurer des canaux par défaut spécifiques à la plateforme — par exemple un pour iOS, un pour Android et un pour Electron. Cela est utile lorsque :

• Vous souhaitez déployer des mises à jour sur une plateforme avant les autres
• 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 défauts par défaut par plateforme :

1. Créez des canaux séparés pour chaque plateforme (par exemple production-ios, production-android, et production-electron)
2. Dans les paramètres de chaque canal, activez uniquement la plateforme pertinente (iOS, Android ou Electron)
3. On Informations sur l'application, définissez chaque canal comme le canal de téléchargement par défaut pour sa plateforme. Capgo permet d'avoir plus d'un canal par défaut lorsque les canaux ciblent différentes plateformes.

Lorsqu'un appareil demande une mise à jour :

• Les appareils iOS recevront des mises à jour du canal par défaut iOS activé
• Les appareils Android recevront des mises à jour du canal par défaut Android activé

Un Canal de Téléchargement Par Défaut Unique (Recommandé pour la plupart des Applications)

Pour la plupart des applications, une seule chaîne de téléchargement par défaut qui prend en charge les trois plateformes de base est l'approche la plus simple :

1. Créez un canal (par exemple, production)
2. Assurez-vous que les boutons iOS, Android et Electron soient activés
3. Définissez-le comme le canal de téléchargement par défaut sur Information de l'application

Cela garantit un comportement cohérent sur tous les plateformes et simplifie votre flux de publication.

Modification du canal par défaut

Lorsque vous modifiez le canal par défaut :

• Les nouveaux appareils recevront immédiatement des mises à jour à partir du nouveau canal par défaut
• Les appareils existants qui ont déjà une affectation de canal (via un décalage ou une force) NE seront PAS automatiquement mis à jour
• Pour déplacer les appareils existants, vous devez soit :
  • Utiliser setChannel() (ou unsetChannel()) à partir de l'application. La suppression du registre du périphérique backend n'efface pas une affectation locale. setChannel() l'affectation.
  • Forcer leur canal à l'interface de ligne de commande (console/API ; expire après 90 jours)
  • Supprimer leur console/API pour qu'ils retombent dans l'ordre de priorité. Les appareils avec uniquement la valeur par défaut cloud reprennent ensuite la nouvelle valeur par défaut.

Conseil: Testez toujours votre nouveau canal par défaut avec un petit groupe d'appareils forcés avant de le rendre par défaut pour tous les utilisateurs.

Continuez de la page d'application

Si vous utilisez la page d'application pour planifier l'interface de ligne de commande et les opérations API , connectez-l’à l'aperçu API Détails d'implémentation dans API Vue d'ensemble, Introduction Détails d'implémentation dans Introduction, API Clés Détails d'implémentation dans API Clés, Appareils Détails d'implémentation dans Appareils, et Paquets Détails d'implémentation dans Paquets.