Déboguer les installations et les mises à jour d'applications

Après la mise à jour des règles d'un appareil, toutes les mises à jour d'appli requises seront transférées automatiquement à condition que l'appareil réponde à certaines conditions. Pour déboguer liés à la mise à jour et à l'installation d'applications depuis Google Play d'entreprise, vous peut récupérer les journaux Play d'entreprise d'un appareil pour les analyser.

Récupérer les journaux Play d'entreprise

Vos clients peuvent récupérer les journaux Play d'entreprise à vous envoyer pour analyse en enregistrant un rapport de bug directement depuis un appareil ou à l'aide d'Android Debug Bridge (ADB).

Enregistrer un rapport de bug

Android 4.2 et versions ultérieures permettent de générer et d'enregistrer des rapports de bugs. Les rapports de bug contiennent des journaux d'événements que vous pouvez utiliser pour résoudre les problèmes liés aux installations et mises à jour des applications.

Les options pour les développeurs doivent être activées pour qu'un appareil puisse Capturer les rapports de bug (des rapports interactifs sont recommandés). Rapports de bugs 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 vous référer à Analyser les journaux Play d'entreprise pour obtenir des conseils de dépannage plus spécifiques les installations et les mises à jour d'applications.

Utiliser Android Debug Bridge

Au lieu de générer des rapports de bugs, vous pouvez demander à vos clients d'utiliser Android Debug Brige (adb) avec un appareil connecté via USB. Avant de l'utiliser adb:

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 à des fins d'analyse.

Analyser les journaux Play d'entreprise

Que votre client ait récupéré un rapport de bug sur un appareil ou qu'il l'ait 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 d'exclure 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 le dernier règlement relatif aux applications:

Start enterprise client policy sync: account=...

Si la stratégie se synchronise correctement, elle écrit:

Received enterprise client policy: account=...

Si la stratégie ne se synchronise pas, 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 dont la synchronisation avec les dernières de Google Play d'entreprise, car il n'était pas connecté à Internet. Par conséquent, les applis ne sont pas installées ou mises à jour comme requis.

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

Passer en revue les installations et les mises à jour d'applications

Lorsqu'un appareil se synchronise correctement avec les règles de Google Play d'entreprise, les applications les installations ou les mises à jour sont planifiées immédiatement. Play d'entreprise ne consigne pas l'intégralité de la règle reçue, mais vous pouvez consulter les journaux Play d'entreprise pour vérifier toutes les applications dont l'installation a été planifiée et suivre l'avancement installations.

Google Play d'entreprise effectue des installations et des mises à jour d'applications en plusieurs étapes, télécharger l'APK, le vérifier et installer APK. Pour suivre la progression de l'installation ou de la mise à jour d'une application, utilisez la commande grep correspondant à Finsky et l'ID de package de l'application. L'identifiant de package d'une application se trouve dans l'URL de son page Google Play Store. Par exemple, l'ID de package de Google Chrome est com.android.chrome

Pour afficher les journaux relatifs à 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 d'installation ou l'échec de la mise à jour doivent être renvoyés dans ces journaux. Si l'application est installée ou mis à jour avec succès, 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: ...)