adb: o básico que todo testador de apps precisa

adb (Android Debug Bridge) é uma ferramenta de linha de comando que se comunica com um celular ou emulador por USB ou Wi-Fi. Você não precisa aprender tudo. Uma dúzia de comandos cobre a maior parte do que um testador ou desenvolvedor faz no dia a dia: instalar um build, redefinir o app, definir uma permissão e salvar um log para um relatório de bug.

Configuração em dois minutos

1. Instale as Platform-Tools do Android SDK (elas contêm o adb).
2. No celular, ative as Opções do desenvolvedor (toque no número da versão em Configurações > Sobre o telefone várias vezes) e depois ative a depuração USB.
3. Conecte o celular e aceite o aviso "Permitir depuração USB?".
4. Rode adb devices. Seu aparelho deve aparecer como device. Se aparecer unauthorized, aceite o aviso no celular de novo.

Se mais de um aparelho estiver conectado, adicione -s <serial> a cada comando, usando o serial de adb devices.

Instalar e remover builds

Troque com.example.app pelo nome do seu pacote. Se a instalação falhar, o texto do erro (por exemplo, incompatibilidade de assinatura ou problema de código de versão) geralmente indica a causa. Um bundle (.aab) não é instalado diretamente; para testes, instale os APKs gerados a partir dele, ou use uma trilha de teste da loja.

Redefinir o estado

• adb shell pm clear com.example.app apaga os dados e o cache do app, como uma instalação limpa sem reinstalar. Use antes de todo teste de primeira execução.
• adb shell am force-stop com.example.app encerra o app. Útil para testar aberturas a frio.
• adb shell monkey -p com.example.app -c android.intent.category.LAUNCHER 1 abre o app sem precisar saber o nome da atividade.

Permissões

• Conceder: adb shell pm grant com.example.app android.permission.CAMERA
• Revogar: adb shell pm revoke com.example.app android.permission.CAMERA

Conceder e revogar é a forma rápida de testar os caminhos "permitido" e "negado". Só permissões de tempo de execução que o app declara podem ser alteradas assim.

Logs

• adb logcat transmite o log do sistema. É barulhento; filtre pelo seu pacote ou por uma tag.
• adb logcat -c limpa o buffer antes, para que a sua captura comece limpa.
• adb logcat -d > log.txt despeja o buffer atual em um arquivo e encerra.

Uma rotina confiável para reproduzir um bug: limpe o log, reproduza o problema uma vez, despeje o log e anexe-o. Veja também como ler relatórios de crash.

Arquivos, capturas de tela e gravações de tela

• adb pull /sdcard/file.png . copia um arquivo do celular.
• adb exec-out screencap -p > screen.png salva uma captura de tela.
• adb shell screenrecord /sdcard/demo.mp4 grava a tela (pare com Ctrl+C e depois copie o arquivo). Ele para após um limite de tempo que depende do aparelho.

Limites

O adb mostra o que o aparelho fez, não o que uma pessoa sentiu. Ele não substitui testes com pessoas reais em celulares reais, mas melhora muito os relatos delas: um log e um build exato valem mais do que "travou".

Parte do guia de teste de apps Android. Relacionados: relatório pré-lançamento do Play Console e noções básicas do Android vitals.

Quer feedback sobre um build de pessoas reais? Comece grátis e receba feedback privado e estruturado sobre o seu app.