Como usar ADB no Android: guia prático
Resposta curta
O ADB é uma ferramenta de linha de comando do Android SDK para se comunicar com um aparelho Android. Com ela, dá para instalar apps, transferir arquivos, rodar comandos no shell e consultar logs de depuração. Este guia mostra como instalar o ADB, conectar o aparelho e usar os comandos mais úteis.
Pontos principais
- ADB faz parte do Android SDK Platform Tools e funciona em Windows, macOS, Linux e Chrome OS.
- A depuração USB precisa ser ativada antes da primeira conexão.
- O comando adb devices confirma se o computador reconhece o aparelho.
- A maioria das tarefas comuns não exige root.
- Comandos incorretos podem alterar ou apagar dados do dispositivo.
O que é o Android Debug Bridge
Como usar ADB de forma segura começa por entender que ele é uma ferramenta de linha de comando que acompanha o Android SDK. Com ela, o computador se comunica com o Android para instalar ou depurar apps, transferir arquivos em ambas as direções e executar comandos em um shell Unix. Embora tenha sido feita para desenvolvedores, também serve para manutenção, diagnóstico e outras tarefas.
O funcionamento depende de três partes: o cliente no computador, o servidor que gerencia a conexão e o daemon no aparelho. Na prática, você digita comandos no terminal e o ADB envia a instrução ao dispositivo. Isso torna possível automatizar tarefas repetitivas e acessar recursos que não aparecem na interface comum.
Como usar ADB passo a passo
A preparação começa baixando o Android SDK Platform Tools para o seu sistema operacional. O pacote vem em ZIP e pode ser extraído em qualquer pasta, pois os executáveis são portáteis. Depois, guarde o caminho dessa pasta, pois será preciso abri-la no terminal.
- Baixe o Platform Tools no site oficial do Android.
- Extraia o ZIP em uma pasta fácil de localizar.
- Ative a depuração USB no aparelho.
- Conecte o dispositivo ao computador por USB.
- Autorize a depuração na tela do aparelho.
- Abra o terminal na pasta do Platform Tools.
- Execute adb devices para confirmar a conexão.
Se o aparelho aparecer na lista com o status device, a comunicação está pronta. Se aparecer unauthorized, revise a autorização na tela do Android. Se nada aparecer, verifique o cabo, a porta USB e os drivers.
Como ativar a depuração USB
A depuração USB é um recurso das opções de desenvolvedor. Para ativá-lo, abra Configurações, acesse Sobre o telefone e toque sete vezes em Número da versão. Uma mensagem avisará que você virou desenvolvedor. Volte ao menu principal de configurações, abra Sistema ou Configurações adicionais, entre em Opções do desenvolvedor e ative a Depuração USB.
Ao conectar o cabo, o Android mostra o aviso Permitir depuração USB. Selecione a opção de sempre permitir naquele computador e toque em OK. Essa autorização fica associada à chave do computador, por isso repetir o processo em outra máquina exige nova confirmação.
Se você precisar de mais detalhes sobre esse menu, consulte o guia sobre como ativar as opções de desenvolvedor no Android.
Instalação e drivers
As Platform Tools são portáteis, então não há instalador tradicional. Basta extrair o ZIP e usar os executáveis da pasta. No Windows, use o Prompt de Comando; no macOS, o Terminal; no Linux, o terminal de sua preferência. Depois, acesse a pasta extraída com o comando cd.
Se o aparelho estiver conectado, mas não aparecer na lista, instale os drivers corretos. Os drivers podem ser obtidos com o fabricante ou com o Google. Na pasta de drivers, procure um executável ou um arquivo INF e siga as instruções do fabricante. Após a instalação, desconecte e reconecte o cabo, então execute adb devices novamente.
Comandos básicos do ADB
Os comandos mais usados são curtos e diretos. O primeiro deve ser sempre adb devices, porque ele lista os aparelhos reconhecidos e evita enviar instruções para o dispositivo errado. Em seguida, use comandos específicos para a tarefa.
| Comando | Função |
|---|---|
| adb devices | Lista dispositivos conectados e seus estados. |
| adb install arquivo.apk | Instala um aplicativo a partir de um arquivo APK. |
| adb uninstall pacote | Remove um aplicativo pelo nome do pacote. |
| adb push origem destino | Copia um arquivo do computador para o aparelho. |
| adb pull origem destino | Copia um arquivo do aparelho para o computador. |
| adb shell | Abre um shell no dispositivo para comandos Unix. |
| adb logcat | Exibe logs do sistema e de aplicativos. |
| adb reboot | Reinicia o aparelho. |
Para instalar um APK, o caminho do arquivo deve estar correto. Se o nome tiver espaços, use aspas. Para copiar arquivos, confira as permissões da pasta de destino no Android. O comando adb logcat ajuda a encontrar mensagens de erro durante testes de aplicativos.
Se o objetivo for instalar aplicativos manualmente, veja também o guia sobre como instalar arquivo APK no Android.
Tarefas comuns com ADB
Entre os usos do ADB estão o sideload de APKs, a remoção de apps do sistema, a instalação de atualizações, a redefinição de fábrica, o desbloqueio do bootloader e o root em situações específicas. Nem todas essas ações são recomendadas para usuários comuns, e algumas exigem conhecimento adicional sobre o modelo do aparelho.
Para diagnóstico, o adb logcat produz um registro com mensagens de erro e informações de depuração. Para manutenção, adb shell permite executar comandos diretamente no dispositivo. Para transferência de arquivos, adb push e adb pull evitam depender de aplicativos de sincronização.
Se o aparelho apresentar falhas de inicialização, o modo de recuperação pode ser a próxima etapa. Nesse caso, consulte o guia sobre modo de recuperação no iPhone e Android. Para problemas de armazenamento, o guia sobre como limpar o cache no Android pode ajudar antes de usar comandos mais invasivos.
Problemas comuns
Quando adb devices não lista o aparelho, comece pelo básico: cabo de dados, porta USB e autorização na tela. Cabos de carregamento sem fios de dados não funcionam para depuração. Também verifique se a depuração USB ainda está ativa após atualizações do sistema.
Se o status for unauthorized, revogue as autorizações de depuração USB nas opções do desenvolvedor e conecte novamente. Se o status for offline, reinicie o servidor ADB com adb kill-server seguido de adb start-server. Em seguida, execute adb devices outra vez.
Erros de instalação de APK podem ocorrer por incompatibilidade de arquitetura, versão do Android ou assinatura do pacote. Nesses casos, confirme a origem do arquivo e a compatibilidade com o aparelho. Não instale APKs de fontes desconhecidas.
Cuidados e limites
ADB é poderoso porque acessa o sistema do aparelho. Comandos incorretos podem apagar dados, desinstalar componentes importantes ou deixar o dispositivo instável. Faça backup antes de operações destrutivas e leia a documentação do comando antes de executá-lo.
A maioria das tarefas comuns não precisa de root, mas ações avançadas podem depender do modelo, da versão do Android e do estado do bootloader. Se não houver certeza sobre um comando, teste em um dispositivo secundário ou procure a documentação oficial.
Outras perguntas comuns
ADB funciona sem cabo USB?
Sim, o ADB pode funcionar por rede local após a configuração inicial, mas a primeira conexão costuma ser feita por USB para autorizar o computador.
É preciso root para usar ADB?
Não. A maioria das tarefas comuns, como instalar APKs e copiar arquivos, não exige root. Ações avançadas podem depender do modelo e do estado do bootloader.
O que fazer se adb devices não mostrar o aparelho?
Verifique cabo, porta, autorização na tela e drivers. Se necessário, reinicie o servidor ADB com adb kill-server e adb start-server.
ADB pode apagar dados do celular?
Sim, se usado com comandos destrutivos ou redefinição de fábrica. Faça backup antes de executar operações que alteram o sistema.
Páginas relacionadas
- Como fazer o backup do celular Android
O backup do Android pode ser feito com a conta Google, Google One, Google Photos ou um computador. A restauração depende da versão do Android e de alguns dados só voltarem durante a configuração inicial. Verifique espaço, conexão e criptografia antes de confiar no backup.
- Como liberar espaço no Android
Limpar cache, remover apps inúteis, mover fotos e organizar downloads costuma recuperar vários gigabytes. O Android também precisa de espaço livre para atualizações e arquivos temporários, então a limpeza deve ser feita com método, não apagando dados pessoais.
- Como ativar as opções de desenvolvedor no Android
As opções de desenvolvedor no Android ficam ocultas por padrão e são ativadas tocando sete vezes no número de compilação. Depois de ativar, você pode habilitar depuração USB, ajustar animações e acessar configurações avançadas. Desative o menu quando terminar para manter a segurança e a estabilidade do aparelho.
- Como tirar print no Android: guia completo
A maioria dos celulares Android captura a tela com Power e Volume para baixo por cerca de um segundo. Também existem gestos, comandos de voz, atalhos no painel rápido e gravação de tela, com variações por marca e versão.
- Modo de recuperação iPhone e Android: guia
O modo de recuperação do Android é um ambiente separado do sistema principal, usado para manutenção, atualização e reparo. Ele permite reiniciar, limpar cache, resetar de fábrica e acessar opções avançadas, com navegação feita pelas teclas de volume e confirmação pelo botão Power.
- Como instalar arquivo apk no android: guia completo
Um APK é o pacote de instalação usado pelo Android. Para instalar um arquivo APK, é preciso permitir a instalação pela origem usada, como navegador ou gerenciador de arquivos, e depois abrir o arquivo. O processo varia um pouco entre versões antigas e recentes do sistema.
Como esta página foi preparada
Antes da redação, o tema foi pesquisado nas fontes abaixo. Depois, a página passou por verificações automáticas de qualidade.