ADB: conceitos básicos do Android Debug Bridge e comandos populares

O que é ADB e para que serve

Android Debug Bridge (ADB) é uma aplicação cliente-servidor composta por três componentes: um cliente (executado no computador), um servidor (processo em segundo plano no computador) e um daemon adbd (executado no próprio dispositivo Android). Quando um desenvolvedor ou engenheiro conecta um smartphone ao PC, o ADB cria um canal de comunicação confiável através do qual comandos, arquivos e dados podem ser transmitidos.

Os principais casos de uso do ADB incluem depuração de aplicativos em um dispositivo real sem necessidade de publicar um APK em uma loja, extração de logs para análise de erros, automação de testes, backup de dados, flashing de imagens de recovery e obtenção de acesso root. Mesmo se você não escreve código, o ADB pode ser útil para extrair capturas de tela de aplicativos, gravar um guia em vídeo da tela do telefone ou recuperar um dispositivo após uma atualização de firmware mal-sucedida.

O suporte ao ADB está integrado em todas as compilações oficiais do Android a partir da versão 2.1 (API 7). Requer que a opção Depuração USB esteja ativada nas configurações do desenvolvedor. A partir do Android 4.2, o dispositivo solicita confirmação na primeira conexão: você deve permitir a depuração para o computador específico usando sua chave RSA.

Instalação do ADB no computador

Para Windows — baixe o Platform Tools do site oficial do Google Developers, extraia o arquivo para a pasta C:\adb e adicione este caminho à variável de ambiente PATH. Após reiniciar o terminal, o comando adb estará disponível globalmente.

Para macOS — a maneira mais fácil é instalar o ADB através do gerenciador de pacotes Homebrew: execute brew install android-platform-tools. Todas as dependências serão resolvidas automaticamente.

Para Linux — em distribuições baseadas em Debian / Ubuntu: sudo apt install adb. Após a instalação, adicione o usuário ao grupo plugdev: sudo usermod -aG plugdev $USER e faça login novamente para que o ADB possa acessar dispositivos USB.

Verifique a instalação com o comando adb version. Se a saída mostrar o número da versão do Android Debug Bridge, a ferramenta está pronta para uso.

Conexão do dispositivo e comandos básicos

Primeira conexão sempre começa com o comando adb devices. Ele exibe uma lista dos dispositivos conectados e seu status. Se o dispositivo aparecer como unauthorized, desbloqueie a tela e confirme a depuração no telefone.

adb devices
List of devices attached
emulator-5554   device
0123456789ABCD  device

Instalação de um aplicativo — uma das operações mais frequentes. Basta especificar o caminho para o arquivo APK:

adb install C:\apps\myapp.apk

Se o aplicativo já estiver instalado mas precisar ser substituído por uma versão atualizada, adicione a flag -r (replace):

adb install -r C:\apps\myapp-v2.apk

Desinstalação de um aplicativo é feita pelo nome do pacote:

adb uninstall com.example.myapp

Cópia de arquivos — adb pull extrai um arquivo do dispositivo para o computador, adb push envia um arquivo para o dispositivo:

adb pull /sdcard/DCIM/screenshot.png .
adb push myfile.txt /sdcard/Documents/

Shell interativo — o comando adb shell abre o shell de comandos do dispositivo. Dentro dele você pode executar comandos Linux padrão: ls, ps, top, dumpsys, pm, am e outros.

adb shell
tissot_sprout:/ $ ls -la /sdcard/
tissot_sprout:/ $ ps | grep com.android.chrome

Iniciar uma atividade via ADB permite abrir qualquer aplicativo ou tela sem procurar manualmente pelo ícone:

adb shell am start -n com.android.chrome/com.google.android.apps.chrome.Main

Trabalhando com logs: Logcat

Logcat é o sistema de registro do Android que coleta mensagens de aplicativos, serviços do sistema e do kernel. A ferramenta é indispensável para depuração: os logs ajudam a entender por que um aplicativo travou, qual método causou uma exceção ou quanto tempo uma operação específica leva.

Uma execução simples sem filtros — adb logcat. O fluxo de logs é infinito; pressione Ctrl+C para parar. Para filtrar mensagens por tag, use o parâmetro -s:

adb logcat -s MainActivity:V

Níveis de severidade do registro (do mais detalhado ao crítico): V (Verbose), D (Debug), I (Info), W (Warning), E (Error), F (Fatal). A combinação de uma tag e um nível permite destacar apenas as mensagens necessárias.

Para limpar o buffer acumulado antes de um teste:

adb logcat -c

E para salvar os logs em um arquivo:

adb logcat -d > app_logs.txt

A flag -d (dump) exibe o buffer atual e encerra sem bloquear o terminal. Isso é útil para scripts de automação.

Capturas de tela, gravação e comandos de diagnóstico úteis

Captura de tela é feita com o comando adb shell screencap. O resultado é salvo em um arquivo que é então recuperado via adb pull:

adb shell screencap /sdcard/screen.png
adb pull /sdcard/screen.png

Você pode combinar ambas as operações em uma única linha usando substituição e pipe. Na prática, isso acelera a criação de documentação e relatórios de teste.

Gravação de tela está disponível no Android 4.4+ (API 19). A duração padrão da gravação é de 180 segundos, a taxa de bits é de 4 Mbps. O comando principal:

adb shell screenrecord /sdcard/demo.mp4

Para parar a gravação pressione Ctrl+C. A resolução do vídeo corresponde à resolução da tela do dispositivo, mas não excede 1080p. Para alterar a taxa de bits, especifique --bit-rate:

adb shell screenrecord --bit-rate 8000000 /sdcard/demo.mp4

Comandos de diagnóstico: adb shell dumpsys exibe o estado de todos os serviços do sistema. Para obter apenas informações da bateria:

adb shell dumpsys battery

A lista de pacotes instalados pode ser obtida através do Package Manager:

adb shell pm list packages

Redefinir as configurações de um aplicativo (equivalente a limpar dados nas configurações):

adb shell pm clear com.example.myapp

Recursos avançados do ADB

Depuração Wi-Fi elimina a necessidade de manter o dispositivo conectado via USB. Certifique-se de que o computador e o dispositivo estejam na mesma rede. Primeiro execute adb tcpip 5555, desconecte o USB, depois conecte via IP:

adb tcpip 5555
adb connect 192.168.1.100:5555

Se o endereço IP do dispositivo for desconhecido, descubra-o via adb shell ip addr show wlan0 antes de desconectar o cabo.

Backup de dados de um aplicativo ou de todo o sistema pode ser feito sem root:

adb backup -apk -shared -all -system -f mybackup.ab

Restauração a partir de um backup:

adb restore mybackup.ab

Emulação de entrada — o comando adb shell input permite simular toques, deslizes, pressionamentos de tecla e entrada de texto. Esta é a base para automação de testes de UI sem frameworks adicionais:

adb shell input tap 500 1000
adb shell input swipe 300 500 800 500
adb shell input text "Hello, ADB!"

Reinicialização em diferentes modos:

adb reboot          # normal reboot
adb reboot recovery # recovery mode
adb reboot bootloader # bootloader (fastboot)

O modo fastboot fornece acesso para flashing de imagens, desbloqueio do bootloader e instalação de recovery personalizado.

Trabalhando com vários dispositivos

Quando vários dispositivos ou emuladores estão conectados simultaneamente, o ADB exige um número de série específico. O comando adb devices lista todos os dispositivos conectados com seus números de série.

Para direcionar um comando a um dispositivo específico use a flag -s:

adb -s 0123456789ABCD install myapp.apk

Se houver apenas um dispositivo, a flag pode ser omitida. No entanto, em um ambiente CI onde vários emuladores são executados simultaneamente, especificar o número de série é obrigatório.

Matar o servidor ADB — se um dispositivo parar de ser detectado ou apresentar erro, reiniciar o servidor ajuda:

adb kill-server
adb start-server

Depois disso execute adb devices — o servidor será reiniciado e redirecionará as solicitações aos daemons dos dispositivos.

Principais comandos ADB: tabela de referência

Conclusão

ADB (Android Debug Bridge) é uma ferramenta fundamental para qualquer pessoa que trabalhe com Android em nível profissional. Da instalação básica de aplicativos à automação complexa de testes e recuperação de dispositivos — o ADB cobre praticamente qualquer cenário de interação entre computador e smartphone ou tablet.

Ao dominar os comandos descritos neste artigo, você será capaz de gerenciar com confiança um dispositivo Android pelo terminal, analisar logs, tirar capturas de tela para documentação, fazer backups e acelerar o processo de desenvolvimento. A prática regular e o estudo da saída do adb help farão de você um usuário experiente desta poderosa ferramenta.