Page d'application

Qu'affiche la page de l'application ?

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 d'actualisation et contrôles de déploiement progressif.: Appareils
   • Appareils enregistrés et paramètres de remplacement.: Log des événements et les journaux bruts.
   • Builds : Gestion de build natif.

2. Affichage des statistiques : Affiche les principales métriques pour la dernière période facturée (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 selon différents bundles d'application.

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

   • Téléchargements de Bundles (12): Nombre total de bundles 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 facturation (17): Afficher les statistiques pour la période facturation actuelle.
   • Intervalle de dates (18): Sélectionnez une plage de dates personnalisée (par exemple, les 30 derniers jours).

Informations de l'application

Cette section correspond à l'onglet « Informations » (1) dans la barre de navigation supérieure. Vous pouvez y 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 une analyse des champs et actions disponibles :

• Appareil d'icône (2) : Affiche l'icône de votre application. Vous pouvez cliquer sur le bouton « Modifier » pour télécharger une nouvelle icône.
• ID d'application (3) : Un identifiant unique pour votre application dans 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 de mise à jour, 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 d'auto-suppression 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 le canal que 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 du dispositif obligatoire: Si l'ID du dispositif est explicitement forcé à un canal dans les paramètres du canal, ce canal gagne toujours.
2. Surcharge 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 effectué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 spécifiques à la plateforme :

1. Créez des canaux séparés pour chaque plateforme (par exemple production-ios, production-android, et production-electron)
2. Activez uniquement la plateforme pertinente (iOS, Android ou Electron) dans les paramètres de chaque canal
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 les mises à jour du canal par défaut iOS activé
• Les appareils Android recevront les 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 principaux plateformes 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 Informations sur l'application

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

Changement de la chaîne par défaut

Lorsque vous changez la chaîne par défaut :

• Les nouveaux appareils recevront immédiatement des mises à jour à partir de la nouvelle chaîne par défaut
• Les appareils existants qui ont déjà une affectation de chaîne (via un override ou une force) NE seront PAS automatiquement mis à jour
• Pour déplacer les appareils existants, vous devez soit :
  • Utiliser setChannel() ou unsetChannel()) de l'application. La suppression du registre du périphérique backend n'efface pas une affectation locale. setChannel() l'affectation.
  • Forcer leur canal dans le tableau de bord (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é 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 le tableau de bord et les opérations de API, connectez-l’avec API Overview pour les détails d'implémentation dans API Vue d'ensemble Introduction pour les détails d'implémentation dans Introduction API Clés pour les détails d'implémentation dans API Clés Appareils pour les détails d'implémentation dans Appareils, et Bundles pour les détails d'implémentation dans Bundles.