Wesloo
Todos os temasTemas

Android

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.

  1. Baixe o Platform Tools no site oficial do Android.
  2. Extraia o ZIP em uma pasta fácil de localizar.
  3. Ative a depuração USB no aparelho.
  4. Conecte o dispositivo ao computador por USB.
  5. Autorize a depuração na tela do aparelho.
  6. Abra o terminal na pasta do Platform Tools.
  7. 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.

ComandoFunção
adb devicesLista dispositivos conectados e seus estados.
adb install arquivo.apkInstala um aplicativo a partir de um arquivo APK.
adb uninstall pacoteRemove um aplicativo pelo nome do pacote.
adb push origem destinoCopia um arquivo do computador para o aparelho.
adb pull origem destinoCopia um arquivo do aparelho para o computador.
adb shellAbre um shell no dispositivo para comandos Unix.
adb logcatExibe logs do sistema e de aplicativos.
adb rebootReinicia 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.

Informar um erro nesta página