Cómo depurar las instalaciones y actualizaciones de apps

Después de que se actualice la política de un dispositivo, se realizarán automáticamente todas las actualizaciones necesarias de la app, siempre y cuando el dispositivo cumpla con ciertas condiciones. Para depurar problemas relacionados con la actualización y la instalación de apps desde Play administrado, puedes recuperar los registros de Play administrado desde un dispositivo para su análisis.

Recupera registros de Play administrado

Tus clientes pueden recuperar registros de Play administrado y enviártelos para su análisis mediante la captura de un informe de errores directamente desde un dispositivo o con Android Debug Bridge (adb).

Cómo capturar un informe de errores

Las versiones de Android 4.2 y posteriores pueden capturar y guardar informes de errores. Los informes de errores contienen registros de eventos que puedes usar para solucionar problemas relacionados con las instalaciones y actualizaciones de apps.

Las Opciones para desarrolladores deben estar habilitadas para que un dispositivo pueda capturar informes de errores (se recomiendan los informes interactivos). Los informes de errores se guardan en un archivo ZIP que los clientes pueden enviarte para que los analices. Android proporciona información general para leer los informes de errores. También puedes consultar Cómo analizar los registros de Play administrado si quieres obtener orientación más específica para solucionar problemas relacionados con instalaciones y actualizaciones de apps.

Cómo usar Android Debug Bridge

En lugar de capturar informes de errores, puedes indicar a tus clientes que usen Android Debug Brige (adb) con un dispositivo conectado a través de USB. Antes de usar adb:

* Las funciones de depuración también deben estar habilitadas. Asegúrate de que advancedSecurityOverrides.developerSettings esté configurado como DEVELOPER_SETTINGS_ALLOWED en la política del dispositivo.

Después de conectar un dispositivo, usa logcat para ver un registro de mensajes del sistema de todas las apps del dispositivo, incluida Play. Tus clientes pueden enviarte este registro para que lo analices.

Analiza registros de Play administrado

Independientemente de si tu cliente capturó un informe de errores desde un dispositivo o usó adb logcat, el formato básico de un registro de eventos es el siguiente:

timestamp PID TID log-level log-tag tag-values

Todos los registros de Google Play incluyen la etiqueta de registro Finsky. Por ejemplo:

02-11 08:42:08.600 10031 14335 14335 I Finsky logged-message

Para depurar problemas con Google Play, te recomendamos filtrar los mensajes del sistema y los de otras apps. Por ejemplo, con adb:

adb logcat | grep Finsky

Play administrado escribe el siguiente mensaje en el registro antes de solicitar la política de apps más reciente:

Start enterprise client policy sync: account=...

Si la política se sincroniza con éxito, escribirá lo siguiente:

Received enterprise client policy: account=...

Si la política no se sincroniza, escribe lo siguiente:

Error while getting the Enterprise client policy: ... for the account.

Ejemplo: Error de sincronización de políticas

En el siguiente registro de ejemplo, se muestra un dispositivo que no se pudo sincronizar con la última política de Play administrado porque no estaba conectado a Internet. Como resultado, las apps no se instalan ni se actualizan según sea necesario.

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

Revisar las instalaciones y actualizaciones de aplicaciones

Cuando un dispositivo se sincroniza con la política de Play administrado correctamente, las instalaciones o actualizaciones obligatorias de la app se programan de inmediato. Play administrado no registra toda la política que recibe, pero puedes consultar los registros de Play administrado para verificar si se programó la instalación de apps y seguir el progreso de esas instalaciones.

Google Play administrado realiza instalaciones y actualizaciones de apps a lo largo de varios pasos, incluida la descarga del APK, su verificación e instalación. Para seguir el progreso de una instalación o actualización de una app, grep a Finsky y el ID del paquete de la app. Puedes encontrar el ID de paquete de una app en la URL de su página de Google Play Store. Por ejemplo, el ID del paquete de Google Chrome es com.android.chrome.

Para ver registros relacionados con el progreso de instalación o actualización de Google Chrome en un dispositivo, con adb:

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

Si la app no se instala o actualiza, se deben mostrar en estos registros el error y la etapa en la que falló la instalación o la actualización. Si la app se instala o actualiza correctamente, los registros deben contener un mensaje similar al siguiente:

02-11 08:42:30.187 10031 14335 14335 I Finsky  : [2] mqd.c(4): IT:
Successful install of com.android.chrome (isid: ...)