Une fois la règle d'un appareil mise à jour, toutes les mises à jour d'applications requises sont effectuées automatiquement tant que l'appareil remplit certaines conditions. Pour déboguer les problèmes liés à la mise à jour et à l'installation d'applications à partir de Play d'entreprise, vous pouvez récupérer les journaux Play d'entreprise à partir d'un appareil à des fins d'analyse.
Récupérer les journaux Play d'entreprise
Vos clients peuvent récupérer les journaux Play gérés à vous envoyer pour analyse en enregistrant un rapport de bug directement à partir d'un appareil ou à l'aide d'Android Debug Bridge (adb).
Enregistrer un rapport de bug
Les versions 4.2 et ultérieures d'Android permettent de capturer et d'enregistrer des rapports de bug. Les rapports de bug contiennent des journaux d'événements que vous pouvez utiliser pour résoudre les problèmes liés à l'installation et à la mise à jour d'applications.
Les options pour les développeurs doivent être activées pour qu'un appareil puisse enregistrer des rapports de bug (les rapports interactifs sont recommandés). Les rapports de bug sont enregistrés dans un fichier ZIP que les clients peuvent vous envoyer pour analyse. Android fournit des informations générales sur la lecture des rapports de bugs. Vous pouvez également consulter Analyser les journaux Play d'entreprise pour obtenir des conseils plus spécifiques sur le dépannage des installations et des mises à jour d'applications.
Utiliser Android Debug Bridge
Au lieu d'enregistrer des rapports de bugs, vous pouvez demander à vos clients d'utiliser Android Debug Brige (adb) avec un appareil connecté via USB. Avant d'utiliser adb:
- Votre client doit activer les Options pour les développeurs sur l'appareil.
advancedSecurityOverrides.developerSettings est défini sur DEVELOPER_SETTINGS_ALLOWED dans la règle de l'appareil.
Après avoir connecté un appareil, utilisez logcat pour afficher un journal des messages système de toutes les applications de l'appareil, y compris Play. Vos clients peuvent vous envoyer ce journal pour analyse.
Analyser les journaux Play d'entreprise
Que votre client ait enregistré un rapport de bug à partir d'un appareil ou utilisé adb logcat, le format de base d'un journal des événements est le suivant:
timestamp PID TID log-level log-tag tag-values
Tous les journaux de Google Play incluent la balise de journal Finsky. Exemple :
02-11 08:42:08.600 10031 14335 14335 I Finsky logged-message
Pour déboguer les problèmes liés à Google Play, nous vous recommandons de filtrer les messages système et les messages d'autres applications. Par exemple, avec adb:
adb logcat | grep Finsky
Google Play d'entreprise écrit le message suivant dans le journal avant de demander la dernière règle d'application:
Start enterprise client policy sync: account=...
Si la stratégie est synchronisée avec succès, elle écrit:
Received enterprise client policy: account=...
Si la synchronisation de la stratégie échoue, elle écrit:
Error while getting the Enterprise client policy: ... for the account.
Exemple: Erreur de synchronisation des règles
L'exemple de journal suivant montre un appareil qui n'a pas pu se synchroniser avec la dernière règle Play gérée, car il n'était pas connecté à Internet. Par conséquent, les applications ne sont pas installées ni mises à jour comme nécessaire.
02-11 07:52:01.083 10030 22896 22896 W Finsky : [2] jur.a(13):
Error while getting the Enterprise client policy:
accountID@android-for-work.gserviceaccount.com for the account.
com.android.volley.NoConnectionError:
org.chromium.net.impl.NetworkExceptionImpl:
Exception in CronetUrlRequest:
net::ERR_INTERNET_DISCONNECTED, ErrorCode=2, InternalErrorCode=-106, Retryable=false
Examiner les installations et les mises à jour d'applications
Lorsqu'un appareil se synchronise avec la règle Google Play d'entreprise, toutes les installations ou mises à jour d'applications requises sont immédiatement planifiées. Google Play d'entreprise ne journalise pas l'intégralité de la règle reçue, mais vous pouvez consulter les journaux Google Play d'entreprise pour vérifier si l'installation d'applications a été planifiée et suivre la progression de ces installations.
Google Play d'entreprise effectue des installations et des mises à jour d'applications en plusieurs étapes, y compris le téléchargement de l'APK, sa validation et son installation. Pour suivre la progression de l'installation ou de la mise à jour d'une application, exécutez la commande grep pour Finsky et l'ID de package de l'application. Vous trouverez l'ID de package d'une application dans l'URL de sa page Google Play Store. Par exemple, l'ID de package de Google Chrome est com.android.chrome.
Pour afficher les journaux concernant la progression de l'installation ou de la mise à jour de Google Chrome sur un appareil, avec adb:
adb logcat | grep Finsky | grep com.android.chrome
Si l'installation ou la mise à jour de l'application échoue, l'erreur et l'étape de l'installation ou de la mise à jour doivent être renvoyées dans ces journaux. Si l'application est installée ou mise à jour correctement, les journaux doivent contenir un message semblable à celui-ci:
02-11 08:42:30.187 10031 14335 14335 I Finsky : [2] mqd.c(4): IT:
Successful install of com.android.chrome (isid: ...)