A Visualização do desenvolvedor para Android 11 já está disponível. Teste e compartilhe seu feedback.

Gerar um rastro do sistema em um dispositivo

Dispositivos com o Android 9 (API de nível 28) ou versões posteriores incluem um app de nível de sistema chamado Rastreamento do sistema. Esse app é parecido com o utilitário de linha de comando systrace, mas permite que você registre os rastros diretamente de um dispositivo de teste, sem precisar conectar o dispositivo por cabo e por ADB. Você pode usar o app para compartilhar os resultados desses rastros com sua equipe de desenvolvimento.

Registrar os rastros é especialmente útil ao lidar com bugs de desempenho no app, como inicialização lenta, transições lentas ou instabilidade da IU.

Registrar um rastro do sistema

O app Rastreamento do sistema permite registrar um rastro do sistema usando as "Configurações rápidas" ou um menu dentro do próprio app. As seções a seguir descrevem como realizar o processo de registro usando essas interfaces.

Registrar usando o bloco "Configurações rápidas"

Normalmente, o bloco "Configurações rápidas" é a maneira mais conveniente de concluir o processo de geração de rastros do sistema no dispositivo.

Configurar o bloco

Figura 2. Botão Mostrar bloco de configurações rápidas no app Rastreamento do sistema.

Se você estiver usando o Rastreamento do sistema pela primeira vez no seu dispositivo de teste ou se não vir o bloco Rastreamento do sistema no painel Configurações rápidas do dispositivo (Figura 1), siga as seguintes etapas de configuração:

  1. Ative as opções do desenvolvedor, caso ainda não tenha feito isso.
  2. Abra a tela de configurações Opções do desenvolvedor.
  3. Na seção Depuração, selecione Rastreamento do sistema. O app Rastreamento do sistema será aberto e mostrará o menu do app.
  4. No menu do app, ative a opção Mostrar bloco de configurações rápidas, como mostrado na Figura 2. O sistema adiciona o bloco Rastreamento do sistema ao painel Configurações rápidas, que aparece na Figura 1:

    Figura 1. Bloco Rastreamento do sistema no painel Configurações rápidas.

    Observação: por padrão, o sistema adiciona o bloco Rastreamento do sistema como o primeiro bloco no painel Configurações rápidas. Se você quiser que o bloco apareça em outra posição, use o modo de edição do painel para movê-lo.

Concluir um registro de rastro do sistema

Para registrar um rastro do sistema usando o painel Configurações rápidas, siga as seguintes etapas:

  1. Toque no bloco Rastreamento do sistema, que tem o marcador "Registrar rastros". O bloco será ativado, e uma notificação contínua será exibida para informar que o sistema está registrando um rastro, como mostrado na Figura 3:

    Notificação com a mensagem "O rastreamento está sendo gravado. Toque para parar o rastreamento".
    Figura 3. Notificação contínua exibida após o início da geração de um rastro do sistema no dispositivo.
  2. Realize as ações no app que você gostaria que o sistema inspecionasse.

  3. Quando concluir essas ações, pare o rastreamento tocando no bloco Rastreamento do sistema no painel Configurações rápidas ou na notificação do Rastreamento do sistema.

    O sistema exibe uma nova notificação com a mensagem "Salvando rastros". Após salvar, o sistema dispensará essa notificação e exibirá uma terceira notificação, confirmando que seu rastreamento foi salvo e que está tudo pronto para compartilhar o rastro do sistema, conforme mostrado na Figura 4:

    Notificação com a mensagem "Rastros salvos. Toque para compartilhar seus rastros".
    Figura 4. Notificação contínua que aparece depois que o sistema termina de salvar um rastro registrado.

Registrar usando o menu do app

O menu do app permite que você defina várias configurações avançadas relacionadas à geração de rastros do sistema e oferece uma opção para iniciar e interromper um rastro do sistema.

Para registrar um rastro do sistema usando o menu do app Rastreamento do sistema, siga as seguintes etapas:

  1. Ative as opções do desenvolvedor, caso ainda não tenha feito isso.
  2. Abra a tela de configurações Opções do desenvolvedor. Na seção Depuração, selecione Rastreamento do sistema. O app Rastreamento do sistema será aberto.

    Como alternativa, se tiver configurado o bloco Rastreamento do sistema, você pode manter o bloco pressionado para entrar no app Rastreamento do sistema.

  3. Há a opção de escolher as Categorias de chamadas do sistema e do sensor a serem rastreadas e escolher um Tamanho do buffer (em KB). Escolha categorias que correspondam ao caso de uso sendo testado, como a categoria de Áudio para testar as operações de Bluetooth.

    Figura 5. Opção Registrar rastros no app Rastreamento do sistema.
  4. Ative a opção Registrar rastros, destacada na Figura 5. O bloco será ativado, e uma notificação contínua aparecerá para informar que o sistema está registrando um rastro (Figura 3).

  5. Realize as ações no app que você gostaria que o sistema inspecionasse.

  6. Quando concluir essas ações, pare o rastreamento desativando a opção Registrar rastros.

    O sistema exibe uma nova notificação com a mensagem "Salvando rastros". Após salvar, o sistema dispensará essa notificação e exibirá uma terceira notificação, confirmando que seu rastreamento foi salvo e que está tudo pronto para compartilhar o rastro do sistema, conforme mostrado na Figura 4:

Compartilhar um rastro do sistema

O app Rastreamento do sistema ajuda você a compartilhar os resultados de rastros do sistema como parte de vários fluxos de trabalho diferentes.

Compartilhar como mensagem

O Rastreamento do sistema permite que você compartilhe seu rastreamento coletado com outros apps no dispositivo. Ao fazer isso, você pode enviar o rastreamento para sua equipe de desenvolvimento por e-mail ou por um app de rastreamento de bugs, sem precisar conectar o dispositivo à máquina de desenvolvimento.

Depois de registrar um rastro do sistema, toque na notificação que aparece no dispositivo (veja a Figura 4). O seletor de intent da plataforma é exibido, permitindo que você compartilhe seu rastreamento usando o app de mensagens de sua escolha.

Fazer o download do relatório usando ADB

Se você quiser, também pode extrair um rastro do sistema de um dispositivo usando o ADB. Conecte o dispositivo que registrou o rastreamento à sua máquina de desenvolvimento e execute os seguintes comandos em uma janela de terminal:

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

Criar um relatório HTML

Ao compartilhar o rastro por uma mensagem ou pelo ADB, o relatório reside em um arquivo .ctrace Usando esse arquivo, você pode gerar um relatório HTML do rastreamento. Para fazer isso, execute os seguintes comandos em uma janela de terminal:

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

Se você ainda não tem o programa de linha de comando systrace, é possível fazer o download dele pelo projeto Catapult no GitHub ou diretamente do Android Open Source Project (links em inglês).