Captura un registro del sistema en un dispositivo

Los dispositivos con Android 9 (nivel de API 28) o versiones posteriores incluyen una app a nivel del sistema llamada Registro del sistema. Esta app es similar a la utilidad de la línea de comandos systrace, aunque te permite registrar seguimientos directamente desde un dispositivo de prueba, sin tener que enchufarlo y conectarte a él mediante ADB. Luego, puedes usar la app para compartir los resultados de estos seguimientos con tu equipo de desarrollo.

Es especialmente útil para registrar seguimientos cuando abordas errores relacionados con el rendimiento en tu app, como tiempos de inicio y transición lentos o bloqueos de IU.

Cómo registrar un seguimiento del sistema

La app Registro del sistema te permite registrar un seguimiento del sistema mediante el mosaico Configuración rápida o un menú dentro de la app. En las siguientes secciones se describe cómo completar el proceso de registro mediante estas interfaces.

Cómo grabar mediante el mosaico Configuración rápida

Por lo general, el mosaico Configuración rápida es la manera más conveniente de completar el proceso de seguimiento del sistema en el dispositivo.

Cómo configurar el mosaico

Figura 2: Interruptor del mosaico Mostrar el mosaico de Configuración rápida en la app Registro del sistema

Si usas Registro del sistema por primera vez en el dispositivo de prueba o si no ves el mosaico Registro del sistema en el panel Configuración rápida de tu dispositivo (figura 1), completa los siguientes pasos de configuración:

  1. Habilita las opciones para desarrolladores, si todavía no lo hiciste.
  2. Abre la pantalla de configuración Opciones para desarrolladores.
  3. En la sección Depuración, selecciona Registro del sistema. Se abre la app Registro del sistema y se muestra el menú de la app.
  4. Desde el menú de la app, habilita el mosaico Mostrar el mosaico de Configuración rápida, como se muestra en la figura 2. El sistema agrega el mosaico Registro del sistema al panel Configuración rápida, que se muestra en la figura 1:

    Figura 1: Mosaico Registro del sistema en el panel Configuración rápida

    Nota: De manera predeterminada, el sistema agrega el mosaico Registro del sistema como primer mosaico en el panel Configuración rápida. Si quieres que el mosaico se muestre en una posición diferente, usa el modo de edición del panel para mover el mosaico.

Cómo completar el registro de un seguimiento del sistema

Para registrar un seguimiento del sistema con el panel Configuración rápida, completa los siguientes pasos:

  1. Presiona el mosaico Registro del sistema, en el que se muestra la etiqueta "Grabar seguimiento". El mosaico se habilita y aparece una notificación persistente para informarte que el sistema ahora está registrando un seguimiento, como se muestra en la figura 3:

    Notificación con el mensaje "Se están guardando registros. Presiona para detener el registro".
    Figura 3: Notificación persistente que se muestra después de iniciar un seguimiento del sistema en el dispositivo
  2. En tu app, realiza las acciones que deseas que el sistema inspeccione.

  3. Una vez que hayas completado estas acciones, detén el seguimiento. Para ello, presiona el mosaico Registro del sistema en el panel Configuración rápida o en la notificación de Registro del sistema.

    El sistema muestra una notificación nueva con el mensaje "Guardando seguimiento". Cuando se termina de guardar, el sistema descarta la notificación y muestra una tercera notificación, que confirma que el seguimiento se guardó y que ya puedes compartir el seguimiento del sistema, como se muestra en la figura 4:

    Notificación con el mensaje "Se guardó el seguimiento. Toca para compartir el seguimiento".
    Figura 4: Notificación persistente que se muestra una vez que el sistema terminó de guardar un seguimiento registrado

Cómo grabar usando el menú de la app

El menú de la app te permite definir varias opciones de configuración avanzada relacionadas con el seguimiento del sistema y proporciona un interruptor para iniciar y detener el seguimiento del sistema.

Si deseas registrar un seguimiento del sistema con el menú de la app Registro del sistema, completa los siguientes pasos:

  1. Habilita las opciones para desarrolladores, si todavía no lo hiciste.
  2. Abre la pantalla de configuración Opciones para desarrolladores. En la sección Depuración, selecciona Registro del sistema. Se abrirá la app Registro del sistema.

    O bien, si configuraste el mosaico Registro del sistema, puedes mantenerlo presionado para iniciar la app Registro del sistema.

  3. También puedes elegir las categorías de llamadas del sistema y el sensor que deseas registrar, y seleccionar un tamaño de búfer (en KB). Elige las categorías que correspondan al caso práctico que estás probando, como la categoría Audio para probar operaciones de Bluetooth.

    Figura 5: Interruptor Grabar seguimiento en la app Registro del sistema
  4. Habilita el interruptor Grabar seguimiento, destacado en la figura 5. El mosaico se habilita y aparece una notificación persistente para informarte que el sistema ahora está registrando un seguimiento (figura 3).

  5. En tu app, realiza las acciones que deseas que el sistema inspeccione.

  6. Cuando hayas completado estas acciones, detén el seguimiento. Para ello, inhabilita el interruptor Grabar seguimiento.

    El sistema muestra una notificación nueva con el mensaje "Guardando seguimiento". Cuando se termina de guardar, el sistema descarta la notificación y muestra una tercera notificación, que confirma que el seguimiento se guardó y que ya puedes compartir el seguimiento del sistema, como se muestra en la figura 4.

Cómo compartir un seguimiento del sistema

La app Registro del sistema te ayuda a compartir los resultados del seguimiento del sistema como parte de varios flujos de trabajo diferentes.

Cómo compartir como mensaje

Registro del sistema te permite compartir el seguimiento que recopilaste con otras apps en tu dispositivo. Al hacerlo, puedes enviar el seguimiento a tu equipo de desarrollo por correo electrónico o una app de seguimiento de errores sin necesidad de conectar un dispositivo a tu máquina de desarrollo.

Después de haber registrado un seguimiento del sistema, presiona la notificación que se muestra en el dispositivo (consulta la figura 4). Aparecerá el selector de intent de la plataforma, que te permite compartir tu seguimiento mediante la app de mensajería que desees.

Cómo descargar un informe con ADB

Si lo deseas, también puedes usar ADB para extraer un seguimiento del sistema de un dispositivo. Conecta el dispositivo que grabó el seguimiento a tu máquina de desarrollo y, luego, ejecuta los siguientes comandos en una ventana de la terminal:

    cd /path-to-traces-on-my-dev-machine && \
      adb pull /data/local/traces/ .

Cómo crear un informe HTML

Cuando compartes el seguimiento mediante un mensaje o a través de ADB, el informe reside en un archivo .ctrace. Usa este archivo para generar un informe HTML del seguimiento. Para ello, ejecuta los siguientes comandos en una ventana de la terminal:

    cd /path-to-traces-on-my-dev-machine && \
      systrace --from-file trace-file-name.ctrace

Si todavía no tienes el programa de línea de comandos systrace, puedes descargarlo del proyecto Catapult en GitHub, o bien directamente del Proyecto de código abierto de Android.