Depurar instalações de apps e atualizações

Depois que a política de um dispositivo for atualizada, todas as atualizações necessárias dos apps serão transferidas automaticamente, desde que o dispositivo atenda a determinadas condições. Para depurar problemas relacionados à atualização e à instalação de apps pelo Google Play gerenciado, pode recuperar os registros do Google Play gerenciado de um dispositivo para análise.

Recuperar logs do Google Play gerenciado

Seus clientes podem recuperar os registros do Google Play gerenciado para enviar a você para análise Capturar um relatório de bug diretamente em 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 podem 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 relacionadas a instalações e atualizações de apps.

As Opções do desenvolvedor precisam ser ativadas antes que um dispositivo possa capturar relatórios de bugs (recomendamos usar relatórios interativos). Relatórios de bugs são salvas em um arquivo ZIP que os clientes podem enviar a você para análise. Android fornece informações gerais sobre como ler relatórios de bugs. Você também pode consultar Analise os registros do Google Play gerenciado para ter orientações mais específicas sobre a solução de problemas. 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 Android Debug Brige (adb) com um dispositivo conectado via USB. Antes de usar O adb:

Depois de conectar um dispositivo, use o logcat para ver um registro das mensagens do sistema do todos os apps no dispositivo, incluindo o Google Play. Seus clientes podem enviar esse registro para análise.

Analisar logs do Google Play gerenciado

Não importa se o cliente capturou o relatório do bug em um dispositivo ou usou 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 mensagens 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 de app mais recente:

Start enterprise client policy sync: account=...

Se a política for sincronizada, ela gravará o seguinte:

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 versão mais recente Política do Google Play gerenciado porque não estava conectada à 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

Analise as instalações e atualizações do app

Quando um dispositivo é sincronizado com a política do Google Play gerenciado, os apps necessários as instalações ou atualizações são agendadas imediatamente. O Google Play gerenciado não registra toda a política recebida, mas você pode conferir os registros do Google Play gerenciado para saber se os aplicativos foram programados para instalação e acompanhe o andamento dessas instalações.

O Google Play gerenciado realiza instalações e atualizações de apps em várias etapas, incluindo fazer o download do APK, verificar o APK e realmente instalar o APK. Para acompanhar o progresso de uma instalação ou atualização de um app, use o comando grep para Finsky e o ID do pacote do app. É possível encontrar o ID do pacote de um app no URL Página da Google Play Store. Por exemplo, o código de 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 o adb:

adb logcat | grep Finsky | grep com.android.chrome

Se a instalação ou atualização do aplicativo falhar, o erro e o estágio em que a instalação ou falha na atualização devem ser retornadas nesses registros. Se o app estiver instalado ou atualizados com sucesso, os registros devem 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: ...)