Recuperar registros de un dispositivo Android

Resumen

Use Android Debug Bridge (ADB) para capturar los registros del dispositivo (logcat) para la resolución de problemas.

Si puede reproducir el problema en un entorno controlado, capture los registros justo alrededor del flujo que falla.

Si necesita registros de tiempo de ejecución del SDK que permanezcan dentro del sandbox de la aplicación, use LogService en su lugar. Consulte Recopilar registros con LogService.

Requisitos previos

Antes de poder recuperar los archivos de registro de un dispositivo Android, asegúrese de haber realizado la siguiente configuración:

• Instale Android Debug Bridge (ADB) en la máquina host.
• Habilite Depuración USB en el dispositivo bajo prueba.
• Conecte el dispositivo Android a la máquina host mediante un cable USB.
• Instale el controlador USB del dispositivo en Windows (si es necesario).

Para verificar la configuración, ejecute:

adb devices

El dispositivo es accesible cuando ve una entrada con estado dispositivo:

Lista de dispositivos adjuntos
228b0e100d047ece device

Si no ve el dispositivo, vuelva a revisar los requisitos previos. Para la configuración y solución de problemas de ADB, consulte la documentación oficial de Android: Android Debug Bridge (adb).

Algunos dispositivos requieren habilitar el registro del dispositivo en un menú específico del proveedor.

Por ejemplo, en algunos dispositivos Huawei puede acceder al menú marcando *#*#2846579#*#*. Consulte Huawei logcat no muestra el registro de mi aplicación para contexto.

Capturar registros (recomendado)

1. Borre los búferes de registro del dispositivo:

   adb logcat -b all -c

2. Comience a capturar registros (marcas de tiempo en milisegundos, todas las prioridades):

   adb logcat -v threadtime -b all *:V > TestLogFileName.txt

3. Reproduzca el problema en su aplicación de cartera digital.
4. Detenga la captura y recopile el archivo:

   • Presione CTRL+C.
   • Obtenga TestLogFileName.txt de la carpeta donde ejecutó el comando.

Para obtener los registros más detallados, reproduzca usando una compilación de su aplicación de cartera digital que integra el SDK de NFC Wallet dev compilación.

Consulte Entregables para los tipos de compilación admitidos.

Capture registros solo alrededor del flujo que falla. Comience justo antes de los pasos. Deténgase justo después.

Evite los filtros de logcat. A menudo ocultan las líneas necesarias para el análisis de la causa raíz.

Verificación de la configuración

Puede verificar la configuración ejecutando un flujo que llame a la API del SDK, por ejemplo Recuperar lista de tarjetas en Mostrar tarjetas digitales.

Con el comando recomendado, el archivo de registro debe tener:

• Una marca de tiempo con precisión de milisegundos en cada línea.
• Letras de prioridad de registro hasta V (Detallado) después de los campos PID y TID.
• Una línea que contenga PublicAPI::Start of DigitalizedCardManager.getAllCards.

El siguiente ejemplo muestra el fragmento de registro que demuestra esas características:

08-06 17:11:21.790 14171 14171 D SDK_ENTRY_POINT: PublicAPI::Start of DigitalizedCardManager.getAllCards
08-06 17:11:21.790 14171 14171 D SDK_ENTRY_POINT: PublicAPI::Start of SDKController.getInstance
08-06 17:11:21.791 14171 14171 D SDK_ENTRY_POINT: PublicAPI::Start of SDKController.getService
08-06 17:11:21.791 14171 14171 V util.h.xy.by.mb: Intentando recuperar el servicio con el nombre: DigitalizedCardBuinsessService
08-06 17:11:21.791 14171 14171 D util.h.xy.by.mb: servicio de negocio = util.h.xy.l.a@f9a06e1
08-06 17:11:21.791 14171 14171 V util.h.xy.l.a: se llama a getAllCards
08-06 17:11:21.791 14171 14171 D util.h.xy.aj.b: [DCM.getAllCards].increment
08-06 17:11:21.791 14171 14171 V util.h.xy.aj.b: [DCM.getAllCards]Queda 1 operación
08-06 17:11:21.792 14171 18982 I util.h.xy.n.mb: -----------------------------------------------------------------------GET_ALLCARDS-START----------------------------------------------------------------------