Depois de carregar os traces, clique em Ver traces para visualizar os traces enviados. As guias de cada trace aparecem no painel superior da janela. Se o arquivo enviado contiver os traces relevantes, o Winscope vai sobrepor uma visualização flutuante do trace de gravação de tela ou da captura de tela na tela:
Figura 1. Ver traces no Winscope.
As seções a seguir descrevem os elementos da interface do usuário (IU) na tela Ver traces.
Visualização em 3D
O painel de visualização em 3D para visualizações do Winscope, como WindowManager, SurfaceFlinger e ViewCapture, mostra elementos retangulares do trace, representando visualmente a posição e a ordem do eixo z.
Use os controles de navegação no painel para modificar o modo de desenho de camadas retangulares, além do espaçamento e da rotação:
Figura 2. Controles de visualização em 3D.
Formato de gradiente
Para inspecionar todos os elementos na hierarquia de maneira mais eficaz, clique no botão formato de retângulo para mudar o formato de desenho do retângulo para Gradiente. No formato gradiente, o botão formato de retângulo fica cinza claro.
Nesse modo, o Winscope reduz a opacidade de cada retângulo com base na ordem z. Retângulos com ordens z mais altas são mais translúcidos. Isso permite que você veja todos os elementos na hierarquia sem se preocupar com retângulos que se obscurecem:
Figura 3. Gradiente de retângulo.
Formato de opacidade
Para mudar o formato de desenho do retângulo para opacidade, clique no botão formato de retângulo. No formato opacidade, o botão formato de retângulo fica cinza escuro.
Nesse modo, o Winscope desenha cada retângulo com base na opacidade, como a opacidade da superfície ou da visualização:
Figura 4. Opacidade do retângulo.
Formato de wireframe
Para mudar a representação do retângulo para wireframe, clique no botão formato de retângulo. Essa representação simplifica o exame e a análise de elementos individuais na hierarquia. No formato wireframe, o botão formato de retângulo se transforma em um contorno sem sombreamento:
Figura 5. Wireframe de retângulo.
Rotação
Use o controle deslizante de rotação para mudar a perspectiva dos retângulos entre 0 e 45 graus, permitindo que você identifique cenários em que os elementos saem da tela:
Figura 6. Rotação do retângulo.
Espaçamento
Use o controle deslizante de espaçamento para controlar o espaçamento entre as camadas, criando uma visualização mais plana ou mais espalhada para inspecionar melhor a ordem z dos elementos:
Figura 7. Espaçamento do retângulo.
Tela e seleção de janelas
Nas visualizações do SurfaceFlinger e do WindowManager, quando você grava dados em dispositivos com várias telas, um menu mostra as telas disponíveis, permitindo que você selecione apenas as telas de interesse.
No ViewCapture, ao gravar várias janelas do sistema, como a barra de notificações, a barra de tarefas e o iniciador, o menu lista as janelas disponíveis.
Panorâmica e zoom
Você pode ajustar a posição dos retângulos horizontal ou verticalmente clicando na área deles e arrastando o mouse. Para aumentar, diminuir ou redefinir o nível de zoom, use a roda de rolagem ou os botões de zoom na barra de controle.
Hierarquia
Os visualizadores do Winscope geralmente incluem um visualizador de hierarquia. O visualizador na Figura 1 mostra várias hierarquias com base no trace que você está analisando. Por exemplo, o visualizador pode mostrar a hierarquia de janelas no WindowManager ou a hierarquia de visualizações em uma janela da interface do sistema.
Para informações sobre tipos de hierarquia específicos, consulte as seções sobre os respectivos traces.
Esta seção descreve o uso geral da hierarquia, como os recursos Mostrar diferença, Mostrar apenas visíveis, Plano e Pesquisar.
Figura 8. Controles de hierarquia.
Mostrar diferença
Quando você ativa o recurso Mostrar diferença, o Winscope monitora e mostra automaticamente as mudanças entre os estados atual e anterior. O recurso Mostrar diferença destaca os elementos removidos em vermelho, os elementos modificados em azul, e os novos elementos em verde. Essa representação visual permite identificar e entender rapidamente as diferenças entre os dois estados, facilitando o acompanhamento das mudanças e a identificação de possíveis problemas.
Figura 9. Mostrar hierarquia de diferenças.
Pesquisar e filtrar
O visualizador de hierarquia oferece um recurso de Pesquisa que usa expressões regulares (regex). Esse filtro tem como destino o nome e o valor do elemento (para propriedades). Quando o filtro corresponde a um elemento filho na hierarquia, toda a cadeia de pais até a raiz da árvore fica visível, conforme mostrado na figura a seguir:
Figura 10. Pesquisar hierarquia.
Mostrar apenas visíveis
Use o recurso Mostrar apenas visíveis para filtrar todos os elementos ocultos em uma hierarquia. Por padrão, o Winscope mostra elementos visíveis e invisíveis. O Winscope desenha elementos visíveis em preto, enquanto os invisíveis aparecem em cinza.
Plano
O botão Plano reorganiza a estrutura hierárquica eliminando os relacionamentos pai-filho entre os elementos. Essa ação renderiza todos os elementos no mesmo nível. Quando combinada com a opção Mostrar apenas visíveis, a hierarquia resultante mostra apenas os elementos visíveis, excluindo os elementos pai, conforme mostrado na figura a seguir:
Figura 11. Hierarquia plana.
Propriedades
No Winscope, muitos visualizadores integram um visualizador de propriedades. Esse visualizador apresenta várias listas de propriedades associadas a um elemento selecionado na visualização de hierarquia. Por exemplo, o visualizador pode mostrar as propriedades de uma atividade no WindowManager ou de uma visualização na interface do sistema.
Para informações sobre propriedades específicas, consulte as seções sobre traces do SurfaceFlinger, do WindowManager e do View Capture.
Esta seção descreve a hierarquia geral nos recursos Mostrar diferença, Pesquisar e Mostrar padrões.
Mostrar diferença
O uso do recurso Mostrar diferença é o mesmo que Mostrar diferença na hierarquia visualização.
Pesquisar e filtrar
O uso do recurso Pesquisar é o mesmo que Pesquisar na visualização de hierarquia.
Mostrar padrões
Por padrão, o Winscope mostra apenas valores de propriedade modificados, que são valores não padrão para os respectivos tipos de dados. Por exemplo, o Winscope omite false para booleanos, 0 para números inteiros, null para objetos e [] para matrizes.
Essa simplificação simplifica a lista de propriedades visíveis para o usuário.
No entanto, em determinadas situações, é útil ter uma visão abrangente de todas as informações relacionadas ao elemento. Nesses casos, a opção Mostrar padrões revela todas as propriedades disponíveis no Winscope, incluindo aquelas com valores vazios ou nulos.
Figura 12. Padrões de propriedades.
Atalhos em geral
O Winscope oferece suporte aos seguintes atalhos:
Figura 13. Atalhos em geral.