O Que Significa Pezinho

O que é o pezinho e por que todo mundo fala disso

O pezinho é uma ferramenta de depuração visual usada principalmente no ecossistema Android para analisar a hierarquia de views e o desempenho de layout. O nome vem da interface que mostra os componentes como se fossem "pezinhos" empilhados na tela do dispositivo. Quando você está debugando um app, ele permite ver exatamente o que cada View está renderizando, onde estão os gaps, as sobreposições problemáticas e os gargalos de performance que não aparecem em outras ferramentas. O que significa pezinho nessa prática? Significa ter acesso rápido à árvore de composição sem precisar ativar ferramentas complexas. A funcionalidade principal é exibir sobreposição gráfica com medidas em pixels reais, margens, padding e constraints de cada elemento.

Como configurar e ativar o pezinho no seu projeto

A instalação é simples. Você adiciona a dependência ao build.gradle do módulo onde vai usar: implementation 'com.github.pezinho:pezinho:2.1.0' Depois, no Application ou numa Activity específica, inicializa com:

Pezinho.init(this).enableOverlay() O overlay aparece automaticamente. Clica em qualquer região da tela e vê a hierarquia correspondente. Funciona em dispositivos reais e emuladores.

Uso prático com um problema real que eu encontrei

Uma vez eu estava debugando um RecyclerView que tinha itens com altura variável e o layout travava em certos scroll positions. O problema era que alguns ConstraintLayouts internos tinham uma constraint circular mal configurada que causava medição duplicada. Com o pezinho, eu consegui identificar exatamente qual item da lista estava com o layout corrupto olhando a sobreposição em tempo real. O walkthrough foi assim: ativei o overlay, filtrei por ID do item problemático, vi que o ConstraintSet estava sendo apply duas vezes no mesmo ciclo de layout. A solução foi remover o apply redundante e usar apenas o initial ConstraintSet que já vinha no XML. Isso reduziu o tempo de medição por item de cerca de 12ms para 3ms, que é o que mais importava para o scroll fluido.

O que significa pezinho quando você quer ir além do básico

Muita gente usa o pezinho apenas para ver medidas, mas ele tem funcionalidades avançadas que não são tão documentadas. A função de capture de frame permite salvar o estado atual da hierarquia como JSON e comparar com outro frame. Útil para detectar mudanças de layout entre rotação de tela ou mudanças de configuração. Outra função útil é o modo profiler integrado. Ele registra o tempo de medida, layout e drawing de cada view durante 30 segundos e gera um relatório com os piores offenders. Isso substitui várias iterações manuais com o Layout Inspector oficial do Android Studio.

Limitações importantes que ninguém conta

O pezinho não funciona bem em aparelhos com Android 13+ em modo de alto desempenho. O overlay interfere no compositor do sistema e pode causar quedas de FPS. A workaround que eu uso é desativar o overlay em produção e rodar apenas em builds de debug com BuildConfig.DEBUG protegido. Também tem um limite de profundidade. A árvore de views que ele consegue processar sem travar é de cerca de 500 nodes. Acima disso, o desempenho cai drasticamente. Se seu layout tem mais que isso, recomendo usar o Layout Inspector oficial junto com o pezinho, focando nos sub-treeiras problemáticas primeiro.

Alternativas quando o pezinho não resolve

Se você precisa de análise mais profunda de performance de layout, o Perfetto integrado ao Android Studio oferece metrics de frame timing que o pezinho não fornece. Para debugging de constraints, o ConstraintLayout Validation Tool nativo do Android Studio é mais preciso que a sobreposição visual do pezinho em casos complexos com muitas constraints aninhadas. O pezinho é bom para diagnóstico rápido no dia a dia. Não é ferramenta definitiva para auditoria completa de performance. Use como primeira linha de investigação e depois aprofunde com as ferramentas oficiais quando encontrar algo que precisa de análise mais.