Capturar rastros com o Winscope

Execute o Winscope localmente ou acesse-o em um servidor da Web.

É possível capturar rastros usando o Winscope para desenvolvimento e depuração locais. O Winscope usa adb, que oferece suporte à conexão de dispositivos por USB ou Wi-Fi.

Ao iniciar o Winscope, a tela Coletar rastros aparece.

Conexão do dispositivo

É possível conectar dispositivos no Winscope usando o Winscope Proxy ou o Web Device Proxy. Por padrão, a página inicial do Winscope mostra a interface de configuração da conexão do Winscope Proxy.

Para começar a capturar rastros, escolha um dos seguintes mecanismos de conexão de dispositivos.

Configuração do Winscope Proxy

Siga estas etapas para configurar o Winscope Proxy:

1. Na seção Coletar rastros da página inicial, selecione Winscope Proxy no menu Selecionar tipo de conexão:

   

   Figura 1. Capturar rastros usando o Winscope Proxy.

2. Inicie o proxy do Winscope ADB Connect para capturar rastros diretamente do navegador executando o seguinte comando:

   python3 $ANDROID_BUILD_TOP/development/tools/winscope/src/adb/winscope_proxy.py
   

3. Anote o token do proxy do Winscope exibido no terminal após a execução.

4. Depois de iniciar o proxy do Winscope ADB Connect, a tela muda da seguinte maneira. Para estabelecer a conexão inicial com o proxy, insira o token do proxy do Winscope da etapa 3 e clique em Conectar.

   

   Figura 2. Conectar-se ao Winscope Proxy.

Configuração do Web Device Proxy

Siga estas etapas para configurar o Web Device Proxy:

1. Na seção Coletar rastros da página inicial, selecione Web Device Proxy no menu Selecionar tipo de conexão:

   

   Figura 3. Capturar rastros usando o Web Device Proxy.

2. Se você não tiver o daemon do Web Device Proxy na sua máquina, clique em Instalar ou execute o instalador.

3. Aprove o acesso de origem ao Web Device Proxy pela caixa de diálogo.

   

   Figura 4. Autorizar origem.

4. Aprove o acesso para cada novo dispositivo na primeira vez que você se conectar a ele. Se a caixa de diálogo não aparecer automaticamente, clique no ícone lock_open ao lado do dispositivo:

   

   Figura 5. Autorizar dispositivo.

Traces

Siga estas etapas para coletar rastros:

1. Quando conectado, para iniciar o processo de captura, selecione os destinos e configure as definições. Em seguida, clique em Iniciar rastreamento para começar a captura:

   

   Figura 6. Coletar rastros no Winscope.

2. Para interromper a captura, clique em Finalizar rastreamento:

   

   Figura 7. Finalizar rastreamento no Winscope.

Opções de rastreamento

Esta seção descreve as opções para cada tipo de rastreamento.

Gravação de tela

Com o Winscope, é possível gravar a tela de vários monitores. Escolha um monitor no menu para gravar a tela. Se você não fizer uma seleção, o Winscope vai gravar o monitor ativo por padrão.

SurfaceFlinger

• Tamanho do buffer:ajusta o tamanho do buffer de anel na memória para o rastreamento do SurfaceFlinger. Um buffer maior permite a coleta de mais dados, mas aumenta o uso da memória.

• Entrada:se a superfície contiver dados de entrada, rastreia os detalhes da janela de entrada.

• Composição:rastreia o tipo de composição e a região visível.

• Metadados:rastreia metadados de superfície adicionais, incluindo camadas fora da tela.

• HWC:rastreia metadados adicionais não estruturados do compositor de hardware.

• Buffers de rastreamento:configura o SurfaceFlinger para rastrear todas as mudanças de buffer na superfície. Por padrão, o SurfaceFlinger rastreia um novo estado somente quando a geometria é alterada.

• Monitores virtuais:inclui camadas de monitor virtual no rastreamento.

WindowManager

• Tamanho do buffer:ajusta o tamanho do buffer de anel na memória para o rastreamento do WindowManager. Um buffer maior permite a coleta de mais dados, mas aumenta o uso da memória.

• Tipo de rastreamento:define as opções de frequência para coletar estados:

  • frame:nesse modo, o WindowManager despeja um único estado por frame, garantindo que apenas estados válidos do WindowManager sejam capturados. Esse modo tem a menor sobrecarga de desempenho.
  • transaction:esse modo registra um estado do WindowManager sempre que uma transação é confirmada. É possível confirmar várias transações em um frame, o que permite depurar estados intermediários do WindowManager durante um frame. No entanto, esse modo tem uma sobrecarga de desempenho maior em comparação com o modo de frame.

• Nível de rastreamento:determina o nível de detalhe dos rastros do WindowManager:

  • verbose:inclui todas as janelas e informações de configuração de cada janela. Esse modo tem a maior sobrecarga de memória e desempenho.
  • debug:inclui informações sobre todas as janelas, mas registra apenas a configuração da janela se ela contiver uma configuração de substituição solicitada.
  • critical:inclui as mesmas informações do modo de depuração, mas inclui apenas janelas visíveis. Esse modo tem a menor sobrecarga de memória e desempenho.

Despejos

Para fazer um despejo de estado usando o Winscope, em Coletar rastros na página inicial selecione a guia Despejo e clique em Estado de despejo:

Figura 8. Estado de despejo no Winscope.

Configuração de captura de tela

O Winscope permite fazer uma captura de tela para vários monitores. Escolha um monitor no menu para fazer uma captura de tela. Se nenhuma seleção for feita, uma captura de tela será coletada para o monitor ativo.