Nós usamos cookies em nossos sites. Informações sobre cookies e sobre como você pode se opor ao uso de cookies a qualquer momento, ou encerrar seu uso, podem ser encontradas em Política de Privacidade.

9 min para ler 24 Comentários

ADB: drivers, ferramentas, comandos e mensagens de erro

Você quer aprender a controlar o Android Debug Bridge a partir do seu computador Windows, mac OS ou Linux? Veja aqui tudo sobre as principais ferramentas do ADB, encontre os drivers para Windows, instale no mac OS ou no Linux, conheça os comandos mais importantes e encontre soluções para os erros mais comuns.

O Android Debug Bridge (ADB) é uma interface lógica entre o seu smartphone Android e seu computador pessoal. Através dele, comandos podem ser enviados diretamente do PC para o smartphone (confira a lista de comandos disponíveis). O uso mais comum para o ADB é o rooteamento do telefone, instalação de firmwares diferentes ou de atualizações de software.

O que você precisa saber

O que é ADB?

O ADB, ou Android Debug Bridge, é um cliente e um servidor que se comunicam entre si. Em outras palavras, é uma ferramenta de comunicação entre o seu smartphone e o computador. Ele é acessado através do prompt do Windows ou Terminal do mac OS ou Linux e é usado para enviar comandos para o Android através do computador, ou seja, é um modo prático para a comunidade para fazer root, instalar novas ROMs ou só resolver problemas no smartphone.

O que é fastboot?

O Fastboot é basicamente uma ferramenta de diagnóstico usada para modificar o sistema de arquivos Android através de um computador quando o telefone estiver em modo bootloader. Os comandos são básicos e incluem, por exemplo, "flash" (instalar) uma imagem de boot ou um bootloader.

nexus 5 fastboot unlocked
Você pode iniciar em modo recovery pelos comandos do ADB / © AndroidPIT

O que são drivers?

Um driver é um pequeno programa que permite que um sistema operacional – o Windows, no caso – reconheça um aparelho e interaja com ele ou o utilize. Cada aparelho tem seu próprio driver, o HD, mouse, teclado, etc. Em nossos smartphones, o sistema usa o driver, e o modo ADB e o modo fastboot também, já que a interface não é a mesma. Resumindo, o Windows precisa de um driver para o smartphone, para o fastboot e para o ADB. Eles são comuns a todos os smartphones.

Drivers ADB para Windows

Em nosso teste com o Windows 10, não foi necessário instalar drivers adicionais para acessar imediatamente a interface do ADB. Até o Windows 7, a comunicação entre o computador e o smartphone era mais complexa.

O Windows 7 normalmente não reconhece a interface do ADB. Se o driver apropriado estiver faltando, fica impossível a comunicação entre o telefone e o PC. Felizmente, há uma solução simples para isso: o ADB Driver Installer. Apenas baixe o arquivo ADB Driver Installer (9.22 MB), descompacte-o e abra o executável. 

windows adb tools overview
Não é fácil instalar o ADB no Windows 7 / © AndroidPIT

Conecte o smartphone ao PC e clique em Refresh no ADB Driver Installer. Caso o seu dispositivo não apareça, pode ser necessário ativar a depuração USB e/ou mudar o modo de conexão USB:

Ativando a depuração USB

Nas Configurações do smartphone, vá em Sobre o telefone/dispositivo ou em Sistema > Sobre o dispositivo, toque 7 vezes em Número de compilação ou em Número da versão; uma mensagem informando que o Modo do desenvolvedor foi ativado (ou que já está ativado) aparecerá. Depois, volte às Configurações (e talvez dentro de Sistema) e dentro de Opções do desenvolvedor, habilite a Depuração USB.

depuracao usb adb tutorial
Toque 7 vezes seguidas em Número da versão para tornar-se desenvolvedor / © AndroidPIT

Mudando o modo de conexão USB

Conecte o smartphone ao PC e puxe a aba de notificações; nela, toque na notificação do Sistema Android. Escolha qualquer um dos modos de transferência: Transferência de Arquivo, Transferência de imagens MTP ou PTP.

depuracao usb adb tutorial 1
Selecione Opções USB e escolha um dos protocolos de transmissão / © AndroidPIT

Volte para o ADB Driver Installer e clique em Refresh. Se o seu dispositivo ainda não estiver visível, clique em Device Manager e apague todas as entradas existentes relativas ao seu aparelho.

Instalando o ADB Tools no Windows

Agora vamos usar os drivers ADB. Para garantir que todos são os mais recentes, visite esse site e baixe o arquivo android-studio-ide-NUMERODAVERSÃO-windows.exe

android sdk PT
Como instalar e atualizar as ferramentas ADB / © AndroidPIT

Descompacte o arquivo e abra o SDK Manager.exe. Aguarde alguns segundos até que a janela correta apareça (imagem acima). Como não queremos programar um app, podemos remover várias marcações. Na verdade, apenas o Android SDK Plataform Tools precisa ficar marcado.

Nota: repita esse processo se o ADB Tools começar a apresentar problemas.

Agora, abra a pasta plataform-tools na pasta em que os arquivos foram extraídos. Com o shift apertado, clique com o botão direito no espaço em branco da janela e selecione Abrir janela de comando aqui. Com o telefone conectado ao computador pelo USB, digite na janela de comando adb devices. No seu smartphone você verá uma mensagem de aviso.

Uma vez que tenha habilitado o USB debugging no seu smartphone e o permitido pelo computador, o seu aparelho deverá aparecer na lista de dispositivos na janela de comando.

Instalando o ADB no Linux e Mac

Os sistemas Linux e MacOS são baseados em Unix, o que deixa o processo mais fácil, já que não precisamos nos preocupar com os drivers. Além disso, as ferramentas se mantêm atualizadas graças aos sistemas de gerenciamento de pacotes mais simples.

Usuários Mac instalam o gerenciador Homebrew e rodam brew cask install android-platform-tools no aplicativo Terminal. Usuários Linux precisam procurar pelo sistema para android-platform-tools e instalá-lo. Além disso, as ferramentas ADB devem ser definidas globalmente, para que você possa usar os seguintes comandos ADB.

Depois de instalado o ADB no mac OS, conecte o smartphone com o depurador ativado e rode adb devices no Terminal. O Terminal indicará um dispositivo não autorizado, e a autorização será pedida no seu smartphone. Você deve conceder essa permissão.

Usando o ADB para instalar apps e atualizações

adb sideload update.zip: esse comando é usado para instalar arquivos, como atualizações oficiais, no seu telefone. Instalações mais complexas, como as de custom ROMs, no entanto, devem ser feitas através da interface fastboot.

adb install [android app].apk: é usado para instalar um app Android (apk) no seu smartphone ou tablet.

Instalando uma atualização no Windows

Troque

Instalando uma atualização no mac OS

Troque o nome do arquivo de update baixado para update.zip. Desligue o seu aparelho, e com ele ainda conectado ao computador via cabo USB, ligue ele com o botão de energia e o de volume para baixo apertados. Quando o menu aparecer, use os botões de volume para selecionar Recovery Mode. Outra forma de fazer isso é rodando adb reboot recovery no Terminal, com o smartphone ligado normalmente. 

Caso o aviso No command apareça, mantenha pressionados os botões de energia e volume para cima até que um novo menu, apenas com palavras, apareça. Usando os botões de volume, selecione Apply update from ADB.

Agora, coloque o arquivo da atualização dentro da pasta de usuário. No Terminal, rode adb sideload update.zip. No Terminal, aparecerá uma porcentagem correndo, e na tela do seu smartphone aparecerá a frase Installing update.... Basta deixar rodando que o update será feito sozinho a partir daí.

Quando finalizar, você volta ao menu de palavras e a frase no final da tela será Install from ADB complete. Você pode então selecionar Reboot system now no menu.

Outros comandos do ADB

adb backup -f FullBackup.ab -apk -all: Aqui a ideia é fazer backup dos dados do seu app. Na prática, os resultados não são confiáveis. Nem todos os apps permitem um backup pelo ADB, ou seja, talvez seja melhor você usar um método alternativo.

adb devices: Com esse comando, você tem uma visão geral de todos os dispositivos conectados ao computador com suporte ADB. Aqui você pode ver o identificados do dispositivo e o status dele. Se a palavra Unauthorized (não autorizado) aparecer, isso significa que é necessário permitir que o computador se comunique com o smartphone.

adb reboot: faz o reboot do seu smartphone.

adb reboot recovery: faz o reboot em modo recovery.

adb reboot bootloader: faz o reboot no bootloader. Nesse modo, você pode se comunicar com o dispositivo pelo fastbootcommand.

adb push [pasta no computador / nomedoarquivo.extensão] [Pasta no computador]: esse comando move um arquivo da pasta indicada no seu computador para a pasta indicada do seu smartphone

adb pull [pasta no computador / nomedoarquivo.extensão] [Pasta no computador]: ao rodar esse comando, você vai salvar o arquivo do seu smartphone no seu computador. Se o diretório não for especificado, o arquivo irá para a pasta do executável ADB ou para a /home.

adb shell screencap -p /sdcard/screenshot.png
adb pull /sdcard/screenshot.png
adb shell rm /sdcard/screenshot.png

: Faz um print e envia para o computador.

adb help: uma visão geral de todos os comandos ADB, sintaxe ajuda.

Erros do ADB: mensagens de erro comuns e soluções

Command Not Found/Comando não encontrado: você cometeu um erro ou o comando feito ainda não está disponível na sua versão do ADB. Confira o comando pela ajuda do ADB ou atualize para uma nova versão do ADB.

No Device/Sem dispositivo: O cabo USB não está conectado propriamente, a interface ADB não está rodando no seu telefone ou o seu computador não reconhece o smartphone. Tente usar uma porta USB diferente, outro cabo, ligue o USB debugging, confira os drivers, o computador ou reinicie o aparelho/computador.

Server is out of date: A versão do ADB Tools no seu computador e a versão do Android no seu smartphone devem ser compatíveis, senão, esse erro ocorre. Atualize a versão do ADB Tools.

Waiting for device: Esse erro é basicamente o mesmo do No Device/Sem dispositivo. O seu computador não reconhece o seu smartphone. Tente as soluções acima.

E agora?

Agora você conhece os modos pelos quais pode modificar o seu smartphone. Seja instalando um update, fazendo root, ou instalando um firmware diferente, você terá controle total sobre o seu telefone.

Precisa de mais ajuda? Use os comentários.

Os comentários favoritos dos leitores

  • Fernando Camargo 07/10/2016

    Sem sombra de dúvidas um dos melhores artigos do AndroidPIT, pra quem é usuário avançado e já passou horas nessa telinha, procurando os comandos que tinha que ser feitos pelo internet a fora (tinha coisa que eu só achava em sites russos), agora está tudo em um lugar só!!

24 Comentários

Escreva um comentário:
Todas as mudanças foram salvas. Não há rascunhos salvos no seu aparelho.
Mostrar todos os comentários

Artigos recomendados