Como instalar e usar ADB e Fastboot no Windows, Linux e macOS

Se você trabalha com Android em um nível um pouco mais técnico, mais cedo ou mais tarde você se deparará com o ADB (Android Debug Bridge) e o Fastboot . Essas ferramentas permitem a comunicação entre o seu telefone e o computador para depurar, instalar aplicativos, atualizar partições, desinstalar bloatware e muito mais, sem a necessidade de acesso root . Neste guia, você aprenderá como instalar, configurar e usar o ADB no Windows, Linux e macOS passo a passo, incluindo recursos avançados como depuração Wi-Fi, encaminhamento de portas e captura e gravação de tela.

Vamos explicar de forma clara e direta: o ADB é um aplicativo cliente-servidor com três componentes. Primeiro, o cliente no seu computador que envia comandos; segundo, um servidor intermediário que gerencia as conexões; e, finalmente, o daemon adbd que roda no dispositivo Android. Também abordaremos o Fastboot para tarefas de bootloader e instalação de ROMs. Tudo com comandos reais, atalhos úteis e dicas para você se familiarizar desde o início.

O que é ADB e para que serve?

O ADB, ou Android Debug Bridge, é uma ferramenta de linha de comando que conecta seu computador a um dispositivo Android via USB ou TCP/IP. Ele é usado para instalar e depurar aplicativos, executar um shell Unix , transferir arquivos, gerenciar pacotes, tirar screenshots, gravar a tela e automatizar fluxos de trabalho.

Sua arquitetura é cliente-servidor : o cliente é invocado com o comando adb; o servidor escuta na porta 5037 e orquestra as conexões; e no telefone, o adbd é executado como um processo em segundo plano. O servidor também detecta emuladores em portas ímpares no intervalo de 5555 a 5585 e associa cada instância a um número de série (por exemplo, emulator-5554 ).

Além da depuração USB, o ADB suporta depuração sem fio no Android 11+ através do emparelhamento via código QR, e em versões anteriores é possível usar o esquema clássico adb tcpip 5555 após uma conexão com fio inicial.

Preparações: Opções do desenvolvedor e depuração USB

Antes de executar qualquer comando, ative as Opções do desenvolvedor no seu telefone: Configurações > Sobre o telefone > toque em Número da versão de 7 a 10 vezes. Em seguida, acesse Opções do desenvolvedor e ative a Depuração USB . Ao conectar o telefone ao computador, aceite a solicitação da chave RSA para autorizar a depuração a partir desse computador.

Para uma verificação inicial, conecte o dispositivo com um cabo de dados e execute o comando `adb devices` . Se tudo estiver funcionando corretamente, você verá o número de série junto com o status do dispositivo; se uma notificação aparecer na tela , toque em "Permitir" e liste os dispositivos novamente.

Instalando ADB e Fastboot no Windows

No Windows, a maneira mais fácil é baixar o pacote oficial Android SDK Platform-Tools (que inclui adb e fastboot). Extraia o arquivo ZIP para um local simples (por exemplo, C:\Android\platform-tools). Lembre-se de que, no Windows, você precisa dos drivers do fabricante para que o computador reconheça o seu telefone: você pode obtê-los em sites de desenvolvedores Android ou com fabricantes como OnePlus, Xiaomi, etc.

Para abrir um console na pasta de ferramentas, navegue até esse caminho e use Shift + clique com o botão direito do mouse > “Abrir janela do PowerShell aqui” (ou CMD ). A partir daí, tente executar o comando `adb devices` com o seu telefone conectado e a depuração USB ativada.

Se você quiser executar o adb a partir de qualquer pasta, adicione platform-tools ao seu PATH : Painel de Controle > Sistema > Configurações avançadas do sistema > Variáveis ​​de ambiente > editar "Path" e adicionar o caminho para platform-tools. Isso permite que você digite adb em qualquer terminal sem precisar navegar até a pasta.

Após a instalação das Platform-Tools, você também terá o Fastboot . Se o seu fluxo de trabalho incluir o desbloqueio do bootloader ou a gravação de partições, você estará pronto sem nenhuma instalação adicional.

Instalando ADB e Fastboot no macOS

No macOS, baixe o Android SDK Platform-Tools , extraia o arquivo ZIP e crie uma pasta "Android" no seu diretório de usuário para organização. Como alternativa, você pode instalar o ADB usando o Homebrew . O macOS não requer drivers adicionais para dispositivos móveis , o que simplifica bastante o processo.

Abra o Terminal, navegue até o caminho onde você extraiu as ferramentas (por exemplo, cd ~/Desktop/Android/platform-tools ) e execute ./adb devices . Alternativamente, adicione platform-tools ao PATH do seu shell (bash/zsh) para invocar o adb de qualquer diretório.

Instalando ADB e Fastboot no Linux

No Linux, você pode optar por instalar a partir dos repositórios ou baixar as Ferramentas da Plataforma do Google. A maioria das distribuições não exige drivers para smartphones, então é só conectar e usar.

Distribuições baseadas em Debian/Ubuntu/Linux Mint: instale com `sudo apt install android-tools-adb android-tools-fastboot` . No Debian clássico, `sudo apt-get install` também funciona com os mesmos pacotes.

No Fedora e derivados: instale com `sudo dnf install android-tools` . No openSUSE, o equivalente geralmente é `sudo zypper install adb` ou o metapacote `android-tools`.

No Arch Linux: use `sudo pacman -S android-tools` . Em outras distribuições, também existem pacotes: `sudo emerge -a dev-util/android-tools` no Gentoo ou `sudo apk add adb` no Alpine.

Se preferir a versão oficial mais recente, baixe o arquivo ZIP do Platform-Tools, extraia-o e execute `./adb version` para verificar a versão; você pode colocar a pasta onde quiser e adicioná-la ao PATH do shell em `~/.bashrc` ou `~/.zshrc`.

Introdução ao ADB: verificações e usos básicos

Conecte seu dispositivo móvel via USB, habilite a depuração USB e execute `adb devices` para listar os dispositivos. Adicione `-l` para ver detalhes como produto, modelo e transport_id, o que é útil ao trabalhar com vários dispositivos ou emuladores simultaneamente.

Principais comandos ADB para uso diário: `adb shell` para abrir um terminal no dispositivo; `adb push caminho_do_arquivo` para enviar arquivos para o celular; `adb pull caminho` para baixar arquivos para o computador; `adb install arquivo.apk` e `adb uninstall pacote` para instalar e desinstalar aplicativos.

Gerenciamento rápido do status: `adb reboot` reinicia o Android; `adb reboot-bootloader` entra no modo fastboot; `adb reboot recovery` inicializa no modo de recuperação. Se algo travar, reinicie o servidor com `adb kill-server` e repita o processo.

Quando você tiver mais de um dispositivo conectado, especifique o destino com o comando `adb -s SERIAL` , ou use `-e` para enviar para o emulador único ou `-d` para o dispositivo físico único. Você também pode definir a variável `ANDROID_SERIAL` em seu ambiente.

Fastboot: Instalação e Comandos de Tecla

O Fastboot está incluído nas Ferramentas da Plataforma do Google . No Linux, também está disponível nos repositórios android-tools. É a ferramenta usada para interagir com o bootloader e gravar partições flash.

Comandos essenciais: fastboot devices para verificar a conexão no modo bootloader; fastboot oem unlock (ou fastboot flashing unlock em muitos modelos) para desbloquear o bootloader — isso pode apagar todos os seus dados , faça um backup e veja como formatar um telefone a partir de um PC —.

Para instalar uma recuperação personalizada: `fastboot flash recovery recovery.img`; ` fastboot flash boot boot.img` para o kernel/ramdisk; `fastboot flash system system.img` para o sistema; e `fastboot flashall` para instalar todos os arquivos .img presentes na pasta tools.

Remover bloatware sem root com ADB

O ADB permite desinstalar aplicativos do usuário atual sem acesso root, ideal para remover bloatware . O fluxo de trabalho típico consiste em localizar o nome do pacote e desinstalá-lo para o usuário 0.

Procedimento: Abra um terminal com `adb shell` , depois liste os pacotes com `pm list packages | grep "palavra"` para encontrar o nome do pacote . Finalmente, execute `pm uninstall -k --user 0 nome.do.pacote` . Por exemplo, para o Google Maps: `pm uninstall -k --user 0 com.google.android.apps.maps .`

Instalando e gerenciando aplicativos, arquivos e portas

Para instalar um APK: execute `adb install caminho/para.apk` ; para APKs de teste, adicione `-t` . Se seu aplicativo for distribuído em vários APKs (distribuições divididas), use `adb install-multiple` fornecendo todos os arquivos.

Copiar conteúdo: `adb push local remote` envia arquivos ou pastas para o telefone; `adb pull remote local` faz o oposto. Um exemplo rápido seria `adb push myfile.txt /sdcard/myfile.txt` para colocá-lo no armazenamento interno.

Encaminhamento de portas: Com o comando `adb forward`, você encaminha o tráfego do host para o dispositivo. Por exemplo, `adb forward tcp:6100 tcp:7100` ou para um endpoint interno, como `adb forward tcp:6100 local:logd`, para registrar dados no log do sistema.

Seleção de dispositivo: Se vários dispositivos estiverem disponíveis, o ADB solicitará que você especifique o destino . Use -s com o número de série exatamente como aparece em adb devices -l.

Depuração sem fio (Android 11+) e conexão TCP/IP

Com o Android 11 e versões posteriores, você pode usar a depuração sem fio via Wi-Fi . Requisitos: dispositivo e computador na mesma rede, Platform Tools atualizadas e, se estiver usando uma IDE, a versão mais recente do Android Studio.

Emparelhamento pelo Android Studio: Ative a depuração sem fio no seu telefone, abra "Emparelhar dispositivos usando Wi-Fi" no IDE e escolha o código QR ou o código de emparelhamento . Após o emparelhamento, o dispositivo aparecerá pronto para implantação e depuração.

Emparelhamento via linha de comando: Habilite a depuração sem fio no dispositivo móvel, encontre o endereço IP:porta e o código de emparelhamento, acesse o diretório platform-tools no computador e execute o comando adb pair ip:porta , insira o código e, se necessário, execute adb connect ip:porta .

Android 10 e versões anteriores: Conecte via USB, execute `adb tcpip 5555` , desconecte o cabo, localize o endereço IP do telefone e use `adb connect IP:5555` . Verifique com `adb devices` se o status é "device".

Solução de problemas: Algumas redes corporativas bloqueiam P2P , nesse caso, use uma conexão com fio ou uma rede diferente. Se o dispositivo parar de ser detectado ao trocar de rede Wi-Fi, emparelhe-o novamente. Se sua rede não for compatível com mDNS, conecte-se manualmente usando `adb connect ip:porta`.

Shell, Gerenciador de Atividades (am) e Gerenciador de Pacotes (pm)

O comando `adb shell` coloca você no ambiente de linha de comando do dispositivo; consulte o comando `shell` para Android se precisar de uma referência. O Android Platform Tools 23+ lida com argumentos como SSH , portanto, se você estiver enviando metacaracteres ou aspas , lembre-se de que pode ser necessário usar aspas duplas para que eles cheguem corretamente ao shell remoto.

Gerenciador de atividades ( am ): permite iniciar atividades , enviar transmissões, forçar paradas, criar perfis, modificar o tamanho e a densidade da tela, etc. Exemplos típicos: adb shell am start -a android.intent.action.VIEW ou ajustar a tela com am display-size 1280×800 e am display-density 480.

Ao executar o comando ` am start`, você pode usar opções como `-D` (depurar), `-W` (aguardar inicialização), `-start-profiler`, `-S` (forçar parada antes de abrir), `-user` para escolher o usuário e criar intents com `-a action`, `-d data`, `-t mime`, `-n component` e extras (por exemplo, `-e key value` ou `-ez` para booleanos).

Gerenciador de Pacotes ( pm ): lista e gerencia pacotes. Comandos comuns: pm lista pacotes com filtros (-f, -d, -e, -s, -3, -user), pm caminho do pacote para ver o caminho para o APK, pm limpar pacote para limpar os dados, pm habilitar/desabilitar para habilitar/desabilitar componentes e pm conceder/revogar para permissões de tempo de execução.

Gerenciamento de políticas (DPM), capturas de tela e gravação de tela

Para testes corporativos, o dpm permite ativar administradores e proprietários de perfil/dispositivo: `adb shell dpm set-active-admin component` ou `set-device-owner` . Você também pode forçar a coleta de logs de rede e segurança no Android 9+ com `force-network-logs` e `force-security-logs`.

Captura de tela: Use `adb shell screencap /sdcard/screen.png` para capturar a imagem e, em seguida, baixe-a usando `adb pull /sdcard/screen.png` . É rápido e não requer aplicativos de terceiros.

Gravação de tela: Use `adb shell screenrecord /sdcard/demo.mp4` . Opções úteis: `--size larguraXaltura` , `--bit-rate` em bps (por exemplo, 6000000 para ~6 Mbps), `--time-limit` em segundos, `--rotate` e `--verbose` . Lembre-se de que não captura áudio e o tempo máximo de gravação padrão é de 3 minutos.

Se você precisar de um ambiente de teste limpo, habilite `adb shell cmd testharness enable` : o dispositivo será reiniciado, mantendo a chave RSA para depuração, desativando o bloqueio de tela e os assistentes iniciais, além de ajustar as opções para facilitar a automação.

Consultas avançadas, SQLite, backends USB/mDNS e modo Burst

Para inspecionar bancos de dados em emuladores ou sistemas com acesso root, você pode usar o sqlite3 a partir do shell: comandos como .schema ou .dump ajudam a revisar as estruturas e o conteúdo das tabelas.

Backends USB: O servidor pode usar o backend nativo do sistema operacional ou o libusb . Algumas funções (conectar/desconectar, velocidade USB) estão disponíveis apenas no libusb. Controle o backend com ADB_LIBUSB=1/0 ; a partir do ADB 34, o libusb é o padrão, exceto no Windows, onde o backend nativo é usado.

Backends mDNS: o ADB descobre dispositivos usando Bonjour ou Openscreen . No macOS, o daemon da Apple está sempre ativo; no Windows/Linux, você pode precisar do mdnsd. Você pode alternar com ADB_MDNS_OPENSCREEN=1/0 se precisar desativar o daemon.

Modo Burst (ADB ≥ 36.0.0): Um modo experimental que melhora significativamente o desempenho de transferência e reduz a latência durante a depuração. Habilite-o com ADB_DELAYED_ACK=1 ou nas configurações do depurador no Android Studio.

Dicas práticas e cenários típicos

Se o comando `adb devices` não mostrar o seu emulador em determinadas condições (por exemplo, se você iniciou o emulador com portas específicas e o servidor não estava ativo), inicie o servidor primeiro com `adb start-server` ou deixe o emulador escolher as portas automaticamente.

Ao automatizar processos, lembre-se de que você pode encadear scripts com o adb para fluxos de teste e que o comando `adb --help` lista todas as opções disponíveis, caso precise de uma visão geral rápida pelo terminal.

No Windows, quando algo não funciona, quase sempre o problema é resolvido com os drivers OEM corretos , uma porta USB diferente, um cabo de dados de qualidade ou reiniciando o servidor com `adb kill-server` . No Linux/macOS, verifique as permissões e execute `udev` se o sistema não detectar o dispositivo.

Para sua conveniência, adicione o platform-tools ao PATH do seu sistema: no Windows, usando variáveis ​​de ambiente; no Linux/macOS, exportando o caminho no seu arquivo .bashrc ou .zshrc. Isso evitará que você precise navegar até a pasta tools toda vez.

Dominar o ADB e o Fastboot permite um controle preciso do Android: desde a instalação e depuração de aplicativos até a criação de partições, automação de tarefas , trabalho via Wi-Fi ou captura de tela sem aplicativos de terceiros. Com as Ferramentas da Plataforma atualizadas, os drivers corretos e os principais comandos AM/PM ao seu alcance, você estará pronto para lidar com tarefas cotidianas e cenários avançados com facilidade.

Artigo relacionado:

Métodos fáceis para formatar ou redefinir um celular Android do PC de forma rápida e fácil – Como fazer

Isaac

Escritor apaixonado pelo mundo dos bytes e da tecnologia em geral. Adoro compartilhar meu conhecimento por meio da escrita, e é isso que farei neste blog, mostrar a vocês tudo o que há de mais interessante sobre gadgets, software, hardware, tendências tecnológicas e muito mais. Meu objetivo é ajudá-lo a navegar no mundo digital de uma forma simples e divertida.