Journaux
Copiez une commande de configuration avec les étapes d'installation et le guide markdown complet pour ce plugin.
Comprendre les journaux d'application
Sous-titre “Comprendre les journaux d'application”La page des journaux fournit une histoire détaillée des événements de mise à jour et des informations de diagnostic pour votre application. Cela est crucial pour surveiller le processus de mise à jour, résoudre les problèmes et comprendre comment vos appareils interagissent avec Capgo. Vous pouvez y accéder par en cliquant sur votre application et ensuite en cliquant sur l’onglet « Logs » (précédemment nommé « mises à jour » dans certaines anciennes captures d’écran ou documentation).
À partir de là, vous devriez voir une page similaire à celle-ci, affichant une liste d'entrées de journal :
L'interface de la page des journaux comprend :
- Onglet des journaux - L'onglet de navigation pour accéder à la vue des journaux
- Bouton de rechargement - Rafraîchir la liste des journaux avec les données les plus récentes
- Filtres de plage de temps et d’actions - Filtrez les journaux par plage de dates et type d'action (voir les sections ci-dessous)
Chaque ligne montre :
- Timestamp (UTC)
- ID de l'appareil
- Action code (ce qui s'est passé)
- Nom de la version (bundle ou
builtin)
Cliquez sur une ligne pour accéder à la page détails de l'appareil pour l'ensemble de l'historique.
Filtrage par plage de dates
Section intitulée “Filtrage par plage de dates”Vous pouvez filtrer les journaux en fonction d'une période de temps spécifique en utilisant le sélecteur de date :
- Préférences rapides - Sélectionnez des plages de temps courantes : Dernières 1h, 3h, 6h ou 12h
- Heure de début - Définir une heure de début personnalisée pour la plage
- Heure de fin - Définir une heure de fin personnalisée pour la plage
- Calendrier - Sélectionnez des dates spécifiques en utilisant la vue du calendrier
Cliquez sur « Sélectionner » pour appliquer votre plage de dates choisie, ou sur « Annuler » pour fermer le sélecteur.
Filtrage par Type d'Action
Titre de la section « Filtrage par Type d'Action »Le menu Actions vous permet de filtrer les journaux en fonction de types d'événements spécifiques :
Les filtres d'action disponibles incluent :
- Pulseur de période du dispositif - Contrôles de santé périodiques des appareils
- Suppression de version demandée - Lorsqu'une version de bundle est supprimée
- Réinitialisation à la version par défaut - Lorsqu'un appareil redevient la version intégrée par défaut
- Version installée avec succès - Installation de la bibliothèque réussie
- Nouvelle version envoyée à l'appareil - Lorsque Capgo envoie une mise à jour à un appareil
- Installation de la version échouée - Lorsque l'installation de la bibliothèque échoue
Utilisez la barre de recherche en haut pour trouver rapidement les types d'actions spécifiques. Vous pouvez sélectionner plusieurs actions pour afficher les journaux correspondant à n'importe lequel des types sélectionnés.
Extrait de journal d'exemple (données fictives)
Section intitulée “Extrait de journal d'exemple (données fictices)”| Heure (UTC) | ID de l'appareil | Action | Version | Ce qu'il vous dit |
|---|---|---|---|---|
| 2025-01-14 10:00:01 | A1B2C3 | get | 2.4.1 | Le dispositif a demandé à Capgo si une mise à jour est disponible |
| 2025-01-14 10:00:03 | A1B2C3 | download_manifest_start | 2.4.1 | La mise à jour du manifeste a démarré; SDK va télécharger des fichiers |
| 2025-01-14 10:00:07 | A1B2C3 | download_40 | 2.4.1 | Téléchargement de l'archive est à 40% |
| 2025-01-14 10:00:12 | A1B2C3 | download_zip_complete | 2.4.1 | L'archive a terminé de télécharger |
| 2025-01-14 10:00:13 | A1B2C3 | set | 2.4.1 | L'archive a été installée et marquée comme prochaine à exécuter |
| 2025-01-14 10:05:00 | B9C8D7 | disableAutoUpdateToMajor | 1.9.0 | La politique de canal a bloqué un saut vers 2.x |
| 2025-01-14 10:05:05 | B9C8D7 | rateLimited | intégré | Le dispositif a atteint la limite de requêtes; SDK se retire jusqu'à redémarrage |
Scénarios de journal d'exemple
Section intitulée “Scénarios de journal d'exemple”Pour vous aider à comprendre ce que les journaux vous disent, voici des séquences d'exemple montrant des parcours de mise à jour réels sur les appareils :
Flux de mise à jour réussie
Section intitulée « Flux de mise à jour réussie »Voici ce que ressemble une mise à jour saine dans vos journaux :
| Temps | ID de l'appareil | Action | Version | Ce que cela signifie |
|---|---|---|---|---|
| 10:00:01 | a1b2c3d4 | get | 1.2.0 | L'appareil a vérifié les mises à jour et a reçu la version 1.2.0 |
| 10:00:02 | a1b2c3d4 | download_10 | 1.2.0 | Téléchargement commencé, 10% terminé |
| 10:00:03 | a1b2c3d4 | download_50 | 1.2.0 | Téléchargement à 50% |
| 10:00:05 | a1b2c3d4 | download_complete | 1.2.0 | Téléchargement terminé avec succès |
| 10:00:06 | a1b2c3d4 | set | 1.2.0 | Bundle installé et activé |
Le dispositif est déjà à jour
Sous-section intitulée “Le dispositif est déjà à jour”Lorsqu'un dispositif vérifie mais dispose déjà de la dernière version :
| Temps | ID du dispositif | Action | Version | Ce que cela signifie |
|---|---|---|---|---|
| 14:30:00 | e5f6g7h8 | noNew | 1.2.0 | Le dispositif est déjà à la dernière version, aucune mise à jour n'est nécessaire |
Mise à jour échouée avec redémarrage
Section intitulée « Mise à jour échouée avec rollback »Lorsqu'une mise à jour échoue et que le dispositif revient en arrière :
| Temps | ID du dispositif | Action | Version | Ce que cela signifie |
|---|---|---|---|---|
| 11:15:00 | i9j0k1l2 | get | 1.3.0 | Le dispositif a reçu les informations de mise à jour |
| 11:15:02 | i9j0k1l2 | download_complete | 1.3.0 | Téléchargement terminé |
| 11:15:03 | i9j0k1l2 | set | 1.3.0 | Le bundle a été configuré |
| 11:15:10 | i9j0k1l2 | update_fail | 1.3.0 | L'application a planté ou n'a pas été appelée - rollback déclenché notifyAppReady() L'application a planté ou n'a pas été appelée - rollback déclenché |
| 11:15:11 | i9j0k1l2 | reset | langue intégrée | Le périphérique est revenu à la version intégrée |
Action nécessaire: Vérifiez que votre application appelle notifyAppReady() après une initialisation réussie. Consultez la documentation du plugin pour plus de détails.
Échec de téléchargement
Section intitulée “Échec de téléchargement”Lorsque des problèmes de réseau empêchent le téléchargement :
| Temps | ID du périphérique | Action | Version | Ce que cela signifie |
|---|---|---|---|---|
| 09:45:00 | m3n4o5p6 | get | 1.2.0 | Le dispositif a reçu des informations d'actualisation |
| 09:45:01 | m3n4o5p6 | download_30 | 1.2.0 | Le téléchargement a commencé mais… |
| 09:45:15 | m3n4o5p6 | download_fail | 1.2.0 | Le téléchargement a échoué (délai de connexion perdu, etc.) |
Action nécessaire : Le dispositif réessayera automatiquement à la prochaine mise à jour de l'application. Aucune action n'est requise à moins que cela se produise fréquemment.
Limite de plan atteinte
Section intitulée « Limite de plan atteinte »Lorsque votre compte atteint sa limite de dispositif :
| Temps | ID de l'appareil | Action | Version | Ce que cela signifie |
|---|---|---|---|---|
| 16:00:00 | q7r8s9t0 | needPlanUpgrade | - | Cette appareil ne recevra pas de mises à jour jusqu'à ce que vous mettiez à niveau ou que le cycle de facturation se réinitialise |
Action nécessaire: Mettez à niveau votre abonnement ou attendez le prochain cycle de facturation.
Blocage des mises à jour par configuration de canal
Section intitulée “Blocage des mises à jour par configuration de canal”Lorsque les paramètres de canal empêchent une mise à jour :
| Temps | ID de l'appareil | Action | Version | Ce que cela signifie |
|---|---|---|---|---|
| 12:00:00 | u1v2w3x4 | disableAutoUpdateToMajor | 2.0.0 | Les appareils sur v1.x ne peuvent pas se mettre à jour automatiquement vers v2.x (le saut de version majeure est bloqué) |
| 12:05:00 | y5z6a7b8 | disableEmulator | 1.2.0 | Un émulateur a été détecté, et le canal bloque les émulateurs |
| 12:10:00 | c9d0e1f2 | disableDevBuild | 1.2.0 | Un build de développement a été détecté, et le canal bloque les builds de développement |
Action nécessaireCes protections sont intentionnelles. Si vous souhaitez autoriser ces mises à jour, modifiez vos paramètres de canal.
Codes de journal (Capgo enum backend)
Section intitulée « Codes de journal (Capgo enum backend) »Ces codes proviennent de l' stats_action enum utilisé par le tableau de bord API (capgo/src/types/supabase.types.ts). Si vous voyez un nouveau code dans l'interface utilisateur, il a été émis par le SDK ou le serveur backend et validé contre cette liste.
Parcours heureux & cycle de vie
| Code(s) | Signification |
|---|---|
get | Le dispositif a demandé au Capgo le manifeste de canal actuel |
download_manifest_start, download_manifest_complete | Le téléchargement du manifeste a commencé / terminé (pour les delta ou les ensembles de fichiers multiples) |
download_zip_start, download_zip_complete | Le téléchargement d'un fichier zip a commencé / terminé |
download_10 … download_90 | Les étapes de progression de téléchargement |
download_complete | Le bundle a été téléchargé intégralement |
set | Le bundle est prêt pour le lancement suivant |
reset | L'appareil est revenu à la version intégrée |
delete | Le bundle a été supprimé de la mémoire cache |
uninstall | Détection d'une désinstallation d'applications |
app_moved_to_foreground, app_moved_to_background | SDK enregistre les événements de cycle de vie de l'app |
ping | Vérification de santé ou de cœur battant de l'appareil |
setChannel, getChannel | Le canal a été surchargé ou récupéré via l'appel SDK |
Les configurations ou les politiques bloquent
| Code(s) | Pourquoi l'update a-t-elle été bloqué |
|---|---|
disableAutoUpdate, disableAutoUpdateToMajor, disableAutoUpdateToMinor, disableAutoUpdateToPatch, disableAutoUpdateMetadata, disableAutoUpdateUnderNative | La stratégie de canal interdit ce saut de version semver |
disablePlatformIos, disablePlatformAndroid | La plateforme est désactivée sur le canal |
disableDevBuild, disableEmulator | Les builds de développement ou les émulateurs ne sont pas autorisés |
cannotUpdateViaPrivateChannel, NoChannelOrOverride, channelMisconfigured | Échec de la sélection ou de l'override du canal |
missingBundle, cannotGetBundle | Le manifeste fait référence à un bundle Capgo qui ne peut pas servir |
needPlanUpgrade | L'organisation a atteint ses limites de plan/dépositaire |
rateLimited | Trop de requêtes; SDK ralentit jusqu'à redémarrage |
blocked_by_server_url, backend_refusal, InvalidIp | La règle côté serveur a bloqué la requête |
Échecs de téléchargement / intégrité / installation
| Code(s) | Signification |
|---|---|
download_fail | Échec du téléchargement du bundle (erreur de réseau ou de réponse) |
download_manifest_file_fail, download_manifest_checksum_fail, download_manifest_brotli_fail | Le fichier de manifeste ne pouvait pas être récupéré ou validé |
checksum_fail, checksum_required | Échec de la vérification d'intégrité ou manque de checksum |
unzip_fail, directory_path_fail, canonical_path_fail, windows_path_fail | Échec de la validation du système de fichiers ou de dézipping |
decrypt_fail | La déchiffrement a échoué (bundle chiffré) |
update_fail | Le bundle a été installé mais l'application n'a jamais appelé notifyAppReady(); le rollback a été déclenché |
download_zip_* sans suite ultérieure set | Le téléchargement a été terminé mais la phase d'installation n'a jamais été complétée |
➡️ Besoin de conseils plus détaillés sur code ? Consultez Guide de référence et de débogage complet de la Code et du journal.
Obtenir plus d'informations sur un journal
Section intitulée “Obtenir plus d'informations sur un journal”Si vous cliquez sur une entrée de journal spécifique, cela vous emmènera généralement à la page du page du appareilCela vous permet de voir l'ensemble de l'historique pour cet appareil en particulier, ce qui peut être très utile pour diagnostiquer les problèmes spécifiques à l'appareil ou comprendre son parcours de mise à jour.