Dopo l'aggiornamento dei criteri di un dispositivo, eventuali aggiornamenti dell'app richiesti verranno eseguiti automaticamente, a condizione che il dispositivo soddisfi determinate condizioni. Per eseguire il debug dei problemi relativi all'aggiornamento e all'installazione di app dalla versione gestita di Google Play, puoi recuperare i log della versione gestita di Google Play da un dispositivo a scopo di analisi.
Recupera i log della versione gestita di Play
I tuoi clienti possono recuperare i log gestiti di Play da inviarti per l'analisi acquisendo una segnalazione di bug direttamente da un dispositivo o utilizzando Android Debug Bridge (adb).
Acquisisci una segnalazione di bug
Le versioni Android 4.2 e successive sono in grado di acquisire e salvare le segnalazioni di bug. Le segnalazioni di bug contengono log eventi che puoi utilizzare per risolvere i problemi relativi a installazioni e aggiornamenti delle app.
È necessario attivare le Opzioni sviluppatore prima che un dispositivo possa acquisire segnalazioni di bug (sono consigliati report interattivi). Le segnalazioni di bug vengono salvate in un file ZIP, che i clienti possono inviarti per l'analisi. Android fornisce informazioni generali sulla lettura delle segnalazioni di bug. Puoi anche consultare Analizzare i log della versione gestita di Google Play per indicazioni più specifiche sulla risoluzione dei problemi di installazione e aggiornamenti delle app.
Utilizza Android Debug Bridge
Anziché acquisire le segnalazioni di bug, puoi chiedere ai tuoi clienti di utilizzare Android Debug Brige (adb) con un dispositivo connesso tramite USB. Prima di utilizzare adb:
- Il cliente deve attivare le Opzioni sviluppatore sul dispositivo.
advancedSecurityOverrides.developerSettings sia impostato su
DEVELOPER_SETTINGS_ALLOWED nel criterio del dispositivo.
Dopo aver connesso un dispositivo, utilizza logcat per visualizzare un log dei messaggi di sistema da tutte le app sul dispositivo, inclusa Play. I tuoi clienti possono inviarti questo log per sottoporlo ad analisi.
Analizza i log della versione gestita di Play
Indipendentemente dal fatto che il cliente abbia acquisito una segnalazione di bug da un dispositivo o utilizzato adb logcat, il formato di base di un log eventi è:
timestamp PID TID log-level log-tag tag-values
Tutti i log di Google Play includono il tag log Finsky. Ad esempio:
02-11 08:42:08.600 10031 14335 14335 I Finsky logged-message
Per eseguire il debug dei problemi relativi a Google Play, ti consigliamo di filtrare i messaggi di sistema e i messaggi di altre app. Ad esempio, con ab:
adb logcat | grep Finsky
La versione gestita di Google Play scrive il seguente messaggio nel log prima di richiedere il criterio più recente dell'app:
Start enterprise client policy sync: account=...
Se il criterio viene sincronizzato, scrive:
Received enterprise client policy: account=...
Se il criterio non viene sincronizzato, scrive:
Error while getting the Enterprise client policy: ... for the account.
Esempio: errore di sincronizzazione dei criteri
Il log di esempio seguente mostra un dispositivo che non è riuscito a eseguire la sincronizzazione con il criterio della versione gestita più recente perché non era connesso a internet. Di conseguenza, le app non vengono installate o aggiornate come necessario.
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
Esamina installazioni e aggiornamenti di app
Quando un dispositivo si sincronizza correttamente con il criterio della versione gestita di Google Play, tutte le installazioni o gli aggiornamenti necessari dell'app vengono pianificati immediatamente. La versione gestita di Google Play non registra l'intero criterio che riceve, ma puoi visualizzare i log della versione gestita per verificare se è stata pianificata l'installazione di un'app e seguire lo stato di avanzamento delle installazioni.
La versione gestita di Google Play esegue installazioni e aggiornamenti di app in diversi passaggi, inclusi il download dell'APK, la verifica dell'APK e l'installazione effettiva dell'APK. Per seguire l'avanzamento di un'installazione o di un aggiornamento di app, utilizza grep per Finsky e l'ID pacchetto dell'app. Puoi trovare l'ID pacchetto di un'app nell'URL della relativa
pagina del Google Play Store. Ad esempio, l'ID pacchetto di Google Chrome è
com.android.chrome.
Per visualizzare i log relativi all'avanzamento dell'installazione o dell'aggiornamento di Google Chrome su un dispositivo, con ADB:
adb logcat | grep Finsky | grep com.android.chrome
Se l'installazione o l'aggiornamento dell'app non riesce, questi log devono riportare l'errore e la fase in cui l'installazione o l'aggiornamento non è riuscita. Se l'app viene installata o aggiornata correttamente, i log dovrebbero contenere un messaggio simile al seguente:
02-11 08:42:30.187 10031 14335 14335 I Finsky : [2] mqd.c(4): IT:
Successful install of com.android.chrome (isid: ...)