Depois que a política de um dispositivo for atualizada, as atualizações necessárias de apps serão realizadas automaticamente, desde que o dispositivo atenda a determinadas condições. Para depurar problemas relacionados à atualização e à instalação de apps do Google Play gerenciado, recupere os registros do Google Play gerenciado de um dispositivo para análise.
Recuperar registros do Play gerenciado
Seus clientes podem recuperar registros do Google Play gerenciado e enviar a você para análise capturando um relatório do bug diretamente de um dispositivo ou usando o Android Debug Bridge (adb).
Capturar um relatório do bug
As versões 4.2 e mais recentes do Android são capazes de capturar e salvar relatórios de bugs. Os relatórios de bugs contêm logs de eventos que podem ser usados para ajudar a resolver problemas relacionados a instalações e atualizações de apps.
As Opções do desenvolvedor precisam estar ativadas antes que um dispositivo possa capturar relatórios de bugs. Recomendamos relatórios interativos. Os relatórios de bugs são salvos em um arquivo ZIP, que os clientes podem enviar a você para análise. O Android fornece informações gerais sobre como ler relatórios de bugs. Você também pode consultar Analisar registros do Google Play gerenciado para conferir orientações mais específicas sobre como resolver problemas de instalações e atualizações de apps.
Usar o Android Debug Bridge
Em vez de capturar relatórios de bugs, você pode instruir seus clientes a usar o Android Debug Brige (adb) com um dispositivo conectado via USB. Antes de usar o adb:
- O cliente precisa ativar as Opções do desenvolvedor no dispositivo.
advancedSecurityOverrides.developerSettings está definido como
DEVELOPER_SETTINGS_ALLOWED na política do dispositivo.
Depois de conectar um dispositivo, use o logcat para conferir um registro de mensagens do sistema de todos os apps no dispositivo, incluindo o Play. Seus clientes podem enviar esse registro para análise.
Analisar registros do Play gerenciado
Independentemente de o cliente ter capturado um relatório de bug de um dispositivo ou usado
adb logcat, o formato básico de um log de eventos é:
timestamp PID TID log-level log-tag tag-values
Todos os registros do Google Play incluem a tag de registro Finsky. Exemplo:
02-11 08:42:08.600 10031 14335 14335 I Finsky logged-message
Para depurar problemas com o Google Play, recomendamos filtrar as mensagens do sistema e de outros apps. Por exemplo, com o adb:
adb logcat | grep Finsky
O Google Play gerenciado grava a seguinte mensagem no registro antes de solicitar a política do app mais recente:
Start enterprise client policy sync: account=...
Se a política for sincronizada, ela gravará:
Received enterprise client policy: account=...
Se a política não for sincronizada, ela gravará:
Error while getting the Enterprise client policy: ... for the account.
Exemplo: erro de sincronização da política
O registro de exemplo a seguir mostra um dispositivo que não foi sincronizado com a política mais recente do Google Play gerenciado porque não estava conectado à Internet. Como resultado, os apps não são instalados ou atualizados conforme necessário.
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
Analisar instalações e atualizações do app
Quando um dispositivo é sincronizado com a política do Google Play gerenciado, todas as instalações ou atualizações necessárias de apps são programadas imediatamente. O Google Play gerenciado não registra toda a política recebida, mas é possível consultar os registros para verificar se algum app foi programado para instalação e acompanhar o progresso dessas instalações.
O Google Play gerenciado realiza instalações e atualizações de apps por várias etapas,
incluindo o download do APK, a verificação dele e a instalação do
APK. Para acompanhar o progresso da instalação ou atualização de um app, use um grep para o Finsky
e o ID do pacote do app. Você pode encontrar o ID do pacote de um app no URL da
página da Google Play Store. Por exemplo, o ID do pacote do Google Chrome é
com.android.chrome.
Para ver registros relacionados ao progresso da instalação ou atualização do Google Chrome em um dispositivo com adb:
adb logcat | grep Finsky | grep com.android.chrome
Se a instalação ou a atualização do app falhar, o erro e o estágio em que a instalação ou a atualização falhou precisam ser retornados nesses registros. Se o app for instalado ou atualizado, os registros deverão conter uma mensagem semelhante a esta:
02-11 08:42:30.187 10031 14335 14335 I Finsky : [2] mqd.c(4): IT:
Successful install of com.android.chrome (isid: ...)