O ADB (Android Debug Bridge) é uma das ferramentas mais poderosas para quem quer ir além do que a interface do Android permite. Com ele você controla o celular pelo computador via linha de comando — instala e remove apps, faz backup completo, acessa o terminal do Android, transfere arquivos, captura a tela e muito mais, tudo sem precisar de root. Este tutorial cobre desde a instalação até os comandos mais úteis do dia a dia.
O que é o ADB?
O ADB é uma ferramenta de linha de comando desenvolvida pelo Google que faz parte do Android SDK Platform Tools. Ele cria uma ponte de comunicação entre o computador e o dispositivo Android via cabo USB ou Wi-Fi.
O que você pode fazer com ADB:
- Instalar e desinstalar apps — inclusive apps de sistema
- Fazer backup e restaurar dados
- Acessar o shell (terminal) do Android
- Transferir arquivos entre computador e celular
- Capturar a tela e gravar vídeo
- Simular toques e entrada de texto
- Depurar aplicativos
- Remover bloatware (apps pré-instalados pelo fabricante)
- Ativar recursos ocultos do sistema
- Acessar logs do sistema
Parte 1 — Instalando o ADB no computador
No Windows
Método 1 — Platform Tools (oficial, recomendado)
- Acesse developer.android.com/tools/releases/platform-tools
- Clique em Download SDK Platform-Tools for Windows
- Aceite os termos e baixe o arquivo ZIP
- Extraia para uma pasta de fácil acesso — ex:
C:\adb\ - Abra a pasta extraída — você verá os arquivos
adb.exe,fastboot.exee outros
Adicionar ao PATH (para usar de qualquer pasta):
- Pressione
Win + Se pesquise Variáveis de ambiente - Clique em Editar as variáveis de ambiente do sistema
- Clique em Variáveis de Ambiente
- Em Variáveis do sistema, selecione Path → Editar
- Clique em Novo e adicione o caminho da pasta (ex:
C:\adb\) - Clique em OK em todas as janelas
- Feche e abra um novo Prompt de Comando
Método 2 — Winget (mais rápido)
winget install Google.PlatformTools
No macOS
Via Homebrew (recomendado):
brew install android-platform-tools
Manual:
- Baixe o ZIP em developer.android.com/tools/releases/platform-tools
- Extraia para
~/adb/ - Adicione ao PATH:
echo 'export PATH="$HOME/adb:$PATH"' >> ~/.zprofile
source ~/.zprofile
No Linux (Ubuntu/Debian)
Via repositório (mais simples):
sudo apt update
sudo apt install -y android-tools-adb android-tools-fastboot
Via Platform Tools oficial:
# Baixar e extrair
wget https://dl.google.com/android/repository/platform-tools-latest-linux.zip
unzip platform-tools-latest-linux.zip -d ~/
# Adicionar ao PATH
echo 'export PATH="$HOME/platform-tools:$PATH"' >> ~/.bashrc
source ~/.bashrc
Configurar regras udev (necessário no Linux):
sudo apt install -y android-sdk-platform-tools-common
sudo usermod -aG plugdev $USER
Desconecte e reconecte após aplicar.
Verificar a instalação
adb version
# Android Debug Bridge version 1.0.41
Parte 2 — Ativando o ADB no Android
Passo 1 — Ativar as Opções do Desenvolvedor
- Vá em Configurações → Sobre o telefone
- Toque em Número da versão 7 vezes seguidas
- Aparecerá: “Você agora é um desenvolvedor!”
O caminho varia por fabricante. Consulte o tutorial “Como ativar opções de desenvolvedor no Android” no blog para instruções específicas por marca.
Passo 2 — Ativar a Depuração USB
- Vá em Configurações → Opções do desenvolvedor
- Ative Depuração USB
- Confirme o aviso que aparece
Passo 3 — Conectar o cabo USB
- Conecte o celular ao computador com um cabo USB
- No celular, uma janela aparece perguntando:
“Permitir depuração USB?”
- Marque “Sempre permitir deste computador”
- Toque em Permitir
Use sempre um cabo de dados — cabos de apenas carregamento não funcionam com ADB.
Passo 4 — Verificar a conexão
adb devices
Saída esperada:
List of devices attached
R5CT103ABCD device
Se aparecer unauthorized em vez de device, desbloqueie o celular e aceite a permissão novamente. Se aparecer offline, desconecte e reconecte o cabo.
Parte 3 — Comandos essenciais
Gerenciar conexões
adb devices # lista dispositivos conectados
adb devices -l # lista com detalhes (modelo, transporte)
adb kill-server # mata o servidor ADB
adb start-server # inicia o servidor ADB
adb reconnect # reconecta o dispositivo
Informações do dispositivo
adb shell getprop ro.product.model # modelo do aparelho
adb shell getprop ro.build.version.release # versão do Android
adb shell getprop ro.product.manufacturer # fabricante
adb shell getprop ro.serialno # número de série
adb shell wm size # resolução da tela
adb shell wm density # densidade de pixels (DPI)
adb shell cat /proc/meminfo # informações de memória
adb shell df -h # uso de armazenamento
adb shell uptime # tempo ligado
adb shell dumpsys battery # status da bateria
Parte 4 — Gerenciamento de aplicativos
Instalar apps
# Instalar um APK
adb install app.apk
# Instalar e substituir versão existente
adb install -r app.apk
# Instalar permitindo downgrade (versão mais antiga)
adb install -d app.apk
# Instalar app dividido em múltiplos APKs (split APKs)
adb install-multiple base.apk split1.apk split2.apk
# Instalar em todos os usuários do dispositivo
adb install --user all app.apk
Desinstalar apps
# Desinstalar app pelo package name
adb uninstall com.exemplo.app
# Desinstalar mantendo os dados
adb uninstall -k com.exemplo.app
Listar apps instalados
adb shell pm list packages # todos os apps
adb shell pm list packages -3 # apenas apps de terceiros
adb shell pm list packages -s # apenas apps do sistema
adb shell pm list packages | grep spotify # filtrar por nome
adb shell pm list packages -f # com caminho do APK
Encontrar o package name de um app
# Método 1 — pelo nome parcial
adb shell pm list packages | grep whatsapp
# package:com.whatsapp
# Método 2 — pelo app em primeiro plano
adb shell dumpsys window | grep -E "mCurrentFocus|mFocusedApp"
Extrair o APK de um app instalado
# Encontrar o caminho do APK
adb shell pm path com.whatsapp
# package:/data/app/~~xxxx/com.whatsapp-xxxx/base.apk
# Baixar o APK para o computador
adb pull /data/app/~~xxxx/com.whatsapp-xxxx/base.apk ./whatsapp.apk
Desativar e reativar apps do sistema (sem root)
# Desativar app (não remove, apenas desativa)
adb shell pm disable-user --user 0 com.fabricante.bloatware
# Reativar app
adb shell pm enable com.fabricante.bloatware
# Remover app apenas para o usuário atual (sem root)
adb shell pm uninstall --user 0 com.fabricante.bloatware
Este é um dos usos mais populares do ADB — remover bloatware pré-instalado pelo fabricante sem precisar de root.
Parte 5 — Transferência de arquivos
Copiar arquivos para o Android
# Copiar arquivo para o celular
adb push arquivo.pdf /sdcard/Download/
# Copiar pasta inteira
adb push pasta/ /sdcard/MinhasPastas/
# Copiar múltiplos arquivos
adb push foto1.jpg foto2.jpg video.mp4 /sdcard/DCIM/
Copiar arquivos do Android para o computador
# Copiar arquivo do celular
adb pull /sdcard/Download/arquivo.pdf ./
# Copiar pasta inteira
adb pull /sdcard/DCIM/ ./backup-fotos/
# Copiar com progresso
adb pull -a /sdcard/Download/ ./downloads-backup/
Caminhos importantes no Android
| Caminho | O que contém |
|---|---|
/sdcard/ | Armazenamento interno (raiz) |
/sdcard/DCIM/ | Fotos e vídeos da câmera |
/sdcard/Download/ | Pasta de downloads |
/sdcard/WhatsApp/ | Arquivos do WhatsApp |
/sdcard/Pictures/ | Imagens diversas |
/sdcard/Music/ | Músicas |
/sdcard/Documents/ | Documentos |
/data/data/ | Dados internos dos apps (root) |
Parte 6 — Shell do Android
O adb shell abre o terminal do Android — você pode executar comandos Linux diretamente no dispositivo.
Abrir o shell interativo
adb shell
Você verá um prompt como:
TA2B5701C7:/ $
Para sair: exit ou Ctrl + D
Executar comandos sem abrir o shell
adb shell ls /sdcard/
adb shell cat /proc/version
adb shell pwd
Comandos úteis dentro do shell
# Navegação
ls /sdcard/ # listar arquivos
ls -la /sdcard/Download/ # listar com detalhes
cd /sdcard/Download/ # mudar de pasta
pwd # pasta atual
# Arquivos
cp /sdcard/foto.jpg /sdcard/backup/ # copiar
mv /sdcard/foto.jpg /sdcard/DCIM/ # mover
rm /sdcard/arquivo.txt # remover
mkdir /sdcard/NovaPasta # criar pasta
# Sistema
ps # listar processos
top # monitor de processos
free # uso de memória
df -h # uso de disco
netstat # conexões de rede
ifconfig # interfaces de rede
Parte 7 — Captura de tela e gravação
Capturar a tela
# Capturar e salvar no celular
adb shell screencap /sdcard/screenshot.png
# Capturar e salvar direto no computador
adb shell screencap -p | base64 -d > screenshot.png
# Capturar, baixar e apagar do celular
adb shell screencap /sdcard/screenshot.png
adb pull /sdcard/screenshot.png ./
adb shell rm /sdcard/screenshot.png
Gravar a tela
# Gravar por 30 segundos (máximo: 180 segundos)
adb shell screenrecord /sdcard/gravacao.mp4
# Gravar com resolução personalizada
adb shell screenrecord --size 1080x1920 /sdcard/gravacao.mp4
# Gravar com bitrate personalizado (qualidade)
adb shell screenrecord --bit-rate 8000000 /sdcard/gravacao.mp4
# Gravar por tempo específico
adb shell screenrecord --time-limit 60 /sdcard/gravacao.mp4
Pressione Ctrl + C para parar a gravação antes do tempo limite.
# Baixar a gravação
adb pull /sdcard/gravacao.mp4 ./
Parte 8 — Simulação de entrada
Toques e gestos na tela
# Simular toque em coordenadas (x, y)
adb shell input tap 500 1000
# Simular swipe (deslizar)
adb shell input swipe x1 y1 x2 y2 duração_ms
adb shell input swipe 500 1500 500 500 300 # deslizar para cima
adb shell input swipe 500 500 500 1500 300 # deslizar para baixo
# Simular pressão longa (long press)
adb shell input swipe 500 1000 500 1000 1000 # mesmo ponto por 1 segundo
Digitar texto
# Digitar texto (sem espaços ou caracteres especiais)
adb shell input text "HelloWorld"
# Para textos com espaços — substitua espaço por %s
adb shell input text "Hello%sWorld"
Pressionar teclas
adb shell input keyevent KEYCODE_HOME # botão Home
adb shell input keyevent KEYCODE_BACK # botão Voltar
adb shell input keyevent KEYCODE_MENU # botão Menu
adb shell input keyevent KEYCODE_POWER # botão Power
adb shell input keyevent KEYCODE_VOLUME_UP # Volume +
adb shell input keyevent KEYCODE_VOLUME_DOWN # Volume -
adb shell input keyevent KEYCODE_CAMERA # Câmera
adb shell input keyevent KEYCODE_ENTER # Enter
adb shell input keyevent KEYCODE_DEL # Backspace
adb shell input keyevent 26 # Power (pelo código numérico)
Parte 9 — Backup e restauração
Backup com ADB (método nativo)
# Backup completo (todos os apps e dados)
adb backup -all -apk -shared -f backup_completo.ab
# Backup apenas de um app específico
adb backup -apk -f backup_whatsapp.ab com.whatsapp
# Backup de múltiplos apps
adb backup -apk -f backup.ab com.whatsapp com.instagram.android
# Backup sem dados de sistema
adb backup -all -apk -noshared -f backup.ab
Flags do backup:
-all— todos os apps-apk— inclui os arquivos APK-shared— inclui armazenamento compartilhado (fotos, downloads)-noapk— não inclui APKs, só dados-noshared— não inclui armazenamento compartilhado-f arquivo.ab— nome do arquivo de saída
Durante o backup, o celular mostrará uma tela pedindo confirmação. Você pode definir uma senha para criptografar o backup.
Restaurar backup
adb restore backup_completo.ab
Backup de arquivos com ADB pull
Para um backup mais confiável e sem as limitações do adb backup:
# Backup completo do armazenamento interno
adb pull /sdcard/ ./backup-android/
# Backup apenas das fotos
adb pull /sdcard/DCIM/ ./backup-fotos/
# Backup de pasta específica
adb pull /sdcard/WhatsApp/ ./backup-whatsapp/
Parte 10 — ADB via Wi-Fi
Desde o Android 11, o ADB via Wi-Fi é nativo. Não precisa mais do cabo após a configuração inicial.
Android 11 e superior — método nativo
- No celular: Configurações → Opções do desenvolvedor
- Ative Depuração sem fio
- Toque em Depuração sem fio para abrir as opções
- Toque em Parear dispositivo com código de pareamento
- Anote o endereço IP:porta e o código de pareamento
No computador:
# Parear (feito apenas uma vez)
adb pair IP:PORTA_PAREAMENTO
# Digite o código de pareamento quando solicitado
# Conectar
adb connect IP:PORTA_CONEXAO
# Verificar
adb devices
Android 10 e anterior — via cabo + Wi-Fi
# Com o cabo conectado, ative o ADB via TCP
adb tcpip 5555
# Descubra o IP do celular
adb shell ip addr show wlan0 | grep "inet "
# Desconecte o cabo e conecte via Wi-Fi
adb connect 192.168.1.100:5555
# Verificar
adb devices
# Desconectar
adb disconnect 192.168.1.100:5555
# Voltar ao modo USB
adb usb
Parte 11 — Logs e diagnóstico
Logcat — logs do sistema em tempo real
# Ver todos os logs
adb logcat
# Limpar logs antigos e ver apenas novos
adb logcat -c && adb logcat
# Filtrar por tag
adb logcat -s "ActivityManager"
# Filtrar por nível (V=verbose, D=debug, I=info, W=warning, E=error)
adb logcat *:E # apenas erros
adb logcat *:W # avisos e erros
# Salvar logs em arquivo
adb logcat > logs.txt
# Limitar número de linhas
adb logcat -t 100 # últimas 100 linhas
# Filtrar por app específico
adb logcat --pid=$(adb shell pidof com.whatsapp)
Informações do sistema
# Informações completas do sistema
adb shell dumpsys
# Informações de bateria
adb shell dumpsys battery
# Informações de rede Wi-Fi
adb shell dumpsys wifi
# Apps em execução
adb shell dumpsys activity
# Uso de memória por app
adb shell dumpsys meminfo com.whatsapp
# Informações da tela
adb shell dumpsys display
# Notificações ativas
adb shell dumpsys notification
Parte 12 — Comandos avançados e dicas
Reiniciar o dispositivo
adb reboot # reiniciar normalmente
adb reboot recovery # reiniciar no modo recovery
adb reboot bootloader # reiniciar no bootloader/fastboot
adb reboot fastboot # reiniciar no fastboot (Pixels)
Controlar configurações do sistema
# Ativar/desativar Wi-Fi
adb shell svc wifi enable
adb shell svc wifi disable
# Ativar/desativar dados móveis
adb shell svc data enable
adb shell svc data disable
# Ativar/desativar Bluetooth
adb shell svc bluetooth enable
adb shell svc bluetooth disable
# Mudar brilho (0-255)
adb shell settings put system screen_brightness 128
# Desativar brilho automático
adb shell settings put system screen_brightness_mode 0
# Mudar volume de mídia (0-15 no Android padrão)
adb shell media volume --stream 3 --set 8
# Mudar tempo de tela (em ms: 30000 = 30 segundos)
adb shell settings put system screen_off_timeout 30000
Abrir apps e atividades
# Abrir app pelo package name
adb shell monkey -p com.whatsapp 1
# Abrir configurações
adb shell am start -a android.settings.SETTINGS
# Abrir configurações de Wi-Fi
adb shell am start -a android.settings.WIFI_SETTINGS
# Abrir URL no navegador
adb shell am start -a android.intent.action.VIEW -d "https://google.com"
# Abrir app da câmera
adb shell am start -a android.media.action.IMAGE_CAPTURE
# Forçar fechar um app
adb shell am force-stop com.whatsapp
# Limpar dados de um app
adb shell pm clear com.whatsapp
Múltiplos dispositivos conectados
Quando há mais de um dispositivo:
adb devices # listar todos
adb -s SERIAL_DO_DISPOSITIVO comando # especificar qual usar
adb -s R5CT103ABCD shell # shell em dispositivo específico
adb -d comando # apenas dispositivo físico (USB)
adb -e comando # apenas emulador
Problemas comuns e soluções
“adb: command not found” O ADB não está no PATH. Adicione o caminho da pasta do Platform Tools ao PATH do sistema ou execute dentro da pasta onde está o adb.
“device unauthorized”
# No celular, revogue as autorizações e tente novamente
# Configurações → Opções do desenvolvedor → Revogar autorizações de depuração USB
adb kill-server
adb start-server
adb devices
“device offline”
adb kill-server
adb start-server
# Desconecte e reconecte o cabo
“error: no devices/emulators found” Verifique se a Depuração USB está ativada, o cabo é de dados e o celular está desbloqueado.
Conexão Wi-Fi cai constantemente Mantenha o celular conectado ao mesmo Wi-Fi do computador e desative o modo de economia de bateria para Wi-Fi:
adb shell settings put global wifi_sleep_policy 2
ADB não reconhece o dispositivo no Linux
# Verificar se o dispositivo aparece no USB
lsusb
# Adicionar regra udev
echo 'SUBSYSTEM=="usb", ATTR{idVendor}=="ID_FABRICANTE", MODE="0666", GROUP="plugdev"' | sudo tee /etc/udev/rules.d/51-android.rules
sudo udevadm control --reload-rules
sudo udevadm trigger
Resumo — Referência rápida
| Comando | O que faz |
|---|---|
adb devices | Lista dispositivos conectados |
adb install app.apk | Instala APK |
adb uninstall com.app | Desinstala app |
adb push arquivo /sdcard/ | Envia arquivo para o Android |
adb pull /sdcard/arquivo ./ | Baixa arquivo do Android |
adb shell | Abre o terminal do Android |
adb shell pm list packages | Lista todos os apps |
adb shell pm disable-user --user 0 com.app | Desativa app do sistema |
adb shell screencap /sdcard/screen.png | Captura a tela |
adb shell screenrecord /sdcard/video.mp4 | Grava a tela |
adb logcat | Ver logs do sistema |
adb backup -all -f backup.ab | Faz backup completo |
adb restore backup.ab | Restaura backup |
adb tcpip 5555 | Ativa ADB via Wi-Fi |
adb connect IP:5555 | Conecta via Wi-Fi |
adb reboot | Reinicia o dispositivo |
Dica final: O ADB parece intimidador no começo, mas na prática você vai usar sempre os mesmos 5 ou 6 comandos. Comece com
adb devicespara confirmar a conexão,adb shell pm list packagespara ver os apps instalados eadb pullpara fazer backup de arquivos. À medida que for ficando confortável, explore os comandos mais avançados. O ADB é uma das ferramentas que, uma vez que você aprende, não consegue mais imaginar usar o Android sem ela.
- Como Usar o ADB no Android
- Como Formatar Pen Drive no macOS
- Como Configurar SSH no Linux
- Como Liberar Espaço em Disco no Windows
- Como Gerenciar Armazenamento no iPhone
