Como instalar o ADB no Windows, macOS e Linux

Vários recursos do sistema operacional Android podem ser acessados ​​apenas por meio de caminhos e métodos ocultos ao usuário médio. Geralmente, isso foi feito com a ajuda de alguns comandos de linha de comando do Android Debug Bridge (ADB), uma ferramenta que o Google oferece para os desenvolvedores depurarem várias partes de seus aplicativos ou do sistema, mas que podemos usar para todos os tipos de tarefas limpas e ocultas truques. Um pré-requisito para esses truques é instalar o ADB no seu computador. Portanto, neste guia mostraremos como instalar o ADB no Windows, macOS e Linux em etapas rápidas e fáceis de seguir.

O que é o Android Debug Bridge (ADB)?

A estrutura interna do Android Debug Bridge (ADB) é baseada na arquitetura cliente-servidor clássica. Existem três componentes que compõem todo o processo.

1. O cliente, ou seja, o PC/Mac/Chromebook que você conectou ao seu dispositivo Android. Estamos enviando comandos para o nosso dispositivo a partir do computador através do cabo USB ou sem fio.
2. Um daemon (conhecido como “adbd”) que executa comandos em um dispositivo. O daemon é executado como um processo em segundo plano em cada dispositivo.
3. Um servidor que gerencia a comunicação entre o cliente e o daemon. O servidor é executado como um processo em segundo plano no computador.

Como funciona o ADB?

Como há três partes que compõem o ADB (o cliente, o daemon e o servidor), isso exige que certas partes estejam instaladas e funcionando em primeiro lugar. Se você inicializou o computador recentemente (e não o configurou para iniciar o daemon na inicialização), então você precisará que ele esteja em execução antes que qualquer comunicação possa ser enviada para o Android de destino dispositivo. Você verá a seguinte mensagem no prompt de comando ou terminal, que verificará se o daemon está em execução.

Se o daemon não estiver em execução, ele iniciará o processo e informará em qual porta TCP local ele foi iniciado. Depois que o serviço ADB for iniciado, ele continuará a escutar nessa porta específica os comandos que foram enviados pelo cliente ADB. Em seguida, ele configurará conexões para todos os dispositivos em execução conectados ao computador (incluindo emuladores). Este é o momento em que você receberá a solicitação de autorização no dispositivo Android, caso o computador não tenha sido autorizado anteriormente.

Como configurar o ADB

Nota: Configurar o ADB no computador é apenas metade da equação, pois você também precisará fazer algumas coisas no smartphone ou tablet para aceitar os comandos do ADB.

Configuração do telefone

1. Inicie o Configurações aplicativo no seu telefone.
2. Toque em Sobre telefone opção geralmente perto do final da lista.
   • Dependendo da capa OEM, o Sobre telefone página pode ter outro nome ou estar enterrada em algum outro lugar no Configurações aplicativo no seu dispositivo.
3. Em seguida, toque no Número da versão opção sete vezes para ativar o modo de desenvolvedor. Você verá uma mensagem de brinde quando terminar.
4. Agora volte para a tela principal de configurações e você deverá ver um novo Opções de desenvolvedor menu que você pode acessar. Em telefones Google Pixel e alguns outros dispositivos, pode ser necessário navegar até Configurações > Sistema para encontrar o Opções de desenvolvedor cardápio.
5. Entre lá e ative o Depuração USB opção.
6. Você concluiu parcialmente o processo de configuração do telefone. Em seguida, você precisará rolar abaixo e seguir o restante das instruções para o seu sistema operacional específico.

Como configurar o ADB no Microsoft Windows

1. Faça o download do Arquivo ZIP das ferramentas da plataforma Android SDK para Windows.
2. Extraia o conteúdo deste arquivo ZIP em uma pasta de fácil acesso (como C:\platform-tools).
3. Abrir Explorador de arquivos e navegue até onde você extraiu o conteúdo deste arquivo ZIP.
4. Abra uma instância de prompt de comando/terminal no mesmo diretório deste binário ADB. Isso pode ser feito segurando Shift e clicando com o botão direito na pasta e clicando em Abra a janela de comando aqui ou Abra a janela do PowerShell aqui. Os usuários do Windows 11 devem ver Abrir no Terminal no menu de contexto do botão direito, sem sequer pressionar o botão Shift no teclado.
5. Conecte seu smartphone ou tablet ao computador com um cabo USB. Mude o modo USB para o modo “transferência de arquivos (MTP)”. Alguns OEMs podem ou não exigir isso, mas é melhor deixá-lo neste modo para compatibilidade geral.
6. Na janela Prompt de Comando/Terminal, digite o seguinte comando para iniciar o daemon ADB: adb devices
7. Na tela do seu telefone, você verá um prompt para permitir ou negar o acesso à depuração USB. Naturalmente, você desejará conceder acesso à depuração USB quando solicitado (e toque na caixa de seleção sempre permitir se nunca mais quiser ver esse prompt novamente).
8. Por fim, digite novamente o comando da etapa 6. Se tudo deu certo, agora você deverá ver o número de série do seu dispositivo no prompt de comando (ou na janela do PowerShell).

Agora você pode executar qualquer comando ADB no seu dispositivo! Agora vá em frente e comece a modificar seu telefone seguindo nossa extensa lista de tutoriais!

Como configurar o ADB no macOS

1. Faça o download do Arquivo ZIP das ferramentas da plataforma Android SDK para macOS.
2. Extraia o ZIP para um local de fácil acesso (como a área de trabalho, por exemplo).
3. Terminal aberto.
4. Para navegar até a pasta na qual você extraiu o ADB, digite o seguinte comando: cd /path/to/extracted/folder/
   • Por exemplo, você pode colocar o conteúdo na sua área de trabalho: cd /Users/XDA/Desktop/platform-tools/
5. Conecte seu dispositivo ao Mac com um cabo USB compatível. Altere o modo de conexão USB para o modo “transferência de arquivos (MTP)”. Isso nem sempre é necessário para todos os dispositivos, mas é melhor deixá-lo neste modo para não ter problemas.
6. Quando o Terminal estiver na mesma pasta em que suas ferramentas ADB estão, você pode executar o seguinte comando para iniciar o daemon ADB: ./adb devices
7. No seu dispositivo, você verá um Permitir depuração USB incitar. Permita a conexão.
8. Por fim, digite novamente o comando da etapa 7. Se tudo deu certo, agora você deverá ver o número de série do seu dispositivo na janela Terminal do macOS.

Parabéns! Agora você pode executar qualquer comando ADB no seu dispositivo! Agora vá em frente e comece a modificar seu telefone.

Embora o guia acima certamente funcione, usuários veteranos do macOS também podem optar por instalar o ADB em seus Macs usando um gerenciador de pacotes não oficial, como Cerveja caseira ou MacPorts. Dessa forma, você não precisa atualizar manualmente os binários.

Como configurar o ADB no Linux

1. Faça o download do Arquivo ZIP das ferramentas da plataforma Android SDK para Linux.
2. Extraia o ZIP para um local de fácil acesso (como a área de trabalho, por exemplo).
3. Abra uma janela do Terminal.
4. Digite o seguinte comando: cd /path/to/extracted/folder/
5. Isso mudará o diretório onde você extraiu os arquivos ADB.
   • Exemplo: cd /home/XDA/Desktop/platform-tools/
6. Conecte seu dispositivo à sua máquina Linux com o cabo USB. Altere o modo de conexão para o modo “transferência de arquivos (MTP)”. Isso nem sempre é necessário para todos os dispositivos, mas é recomendado para que você não tenha problemas.
7. Quando o Terminal estiver na mesma pasta em que suas ferramentas ADB estão, você pode executar o seguinte comando para iniciar o daemon ADB: ./adb devices
8. De volta ao seu smartphone ou tablet, você verá um prompt solicitando que você permita a depuração USB. Vá em frente e conceda.
9. Por fim, digite novamente o comando da etapa 8. Se tudo deu certo, agora você deverá ver o número de série do seu dispositivo na saída da janela do Terminal.

Parabéns! Agora você pode executar qualquer comando ADB no seu dispositivo!

Os usuários do Linux devem saber que existe uma maneira mais fácil de instalar o ADB em seus computadores. O guia acima certamente funcionará para você, mas aqueles que possuem um Debian/Ubuntu convencional ou A distribuição do Linux baseada em Fedora/SUSE pode pular as etapas 1 e 2 do guia acima e usar um dos seguintes comandos:

• Usuários Linux baseados em Debian/Ubuntu podem digitar o seguinte comando para instalar o ADB:

  sudo apt-get install android-sdk-platform-tools

• Usuários Linux baseados em Fedora/SUSE podem digitar o seguinte comando para instalar o ADB:

  sudo dnf install android-tools

No entanto, é sempre melhor optar pelo binário mais recente do lançamento do Android SDK Platform Tools, uma vez que os pacotes específicos da distribuição geralmente contêm compilações desatualizadas.

Caso especial: Como configurar o ADB no subsistema Windows para Linux e ChromeOS

Subsistema Windows para Linux (WSL) oferece aos usuários do Windows uma maneira perfeita de executar aplicativos Linux. No entanto, o ambiente ainda não oferece acesso completo ao hardware USB. Como consequência, o ADB no WSL não pode acessar o seu dispositivo Android, mesmo que você o instale da maneira mencionada acima. No entanto, existe uma solução alternativa oficial, que utiliza o código aberto usbipd-win projeto. Para saber mais, dê uma olhada em nosso tutorial em como configurar a passagem USB no WSL.

Para ChromeOS, você precisa ligue o ambiente de desenvolvimento Linux integrado primeiro. Por padrão, ele oferece uma instância Debian. Você pode então configurar facilmente o ADB usando as etapas mencionadas acima.

Apenas para cobrir todas as nossas bases aqui, os usuários podem precisar colocar um ./ na frente dos comandos ADB que listaremos em tutoriais futuros, especialmente quando eles estiverem usando os binários extraídos diretamente do ZIP de ferramentas da plataforma fornecido pelo Google. Isso é algo que qualquer usuário *nix (ou usuário do Windows executando PowerShell/Terminal) provavelmente saberá, mas, novamente, queremos como o maior número possível de pessoas para entender como fazer esses ajustes no Android, não importa quanto do seu sistema operacional você saber.

Opcional: como configurar o ADB no seu navegador

O protocolo ADB pode ser implementado usando a API WebUSB para controlar telefones Android diretamente de navegadores da web. Mais um WebADB, também conhecido como sim-webadb, é um projeto que permite aos usuários executar a maior parte da funcionalidade fornecida pelo ADB diretamente do navegador da web, sem instalar nenhum binário ou driver. Tudo que você precisa é de um navegador da web que suporte a API WebUSB (como Google Chrome, Microsoft Edge ou Firefox) e pronto.

Opcional: como usar ADB por Wi-Fi

O Android 11 e edições superiores oferecem suporte nativo à conexão ADB por Wi-Fi. Isso elimina a necessidade de lidar com problemas comuns de conexão USB e etapas adicionais, como Instalação do driver OEM Android no Windows.

Para configurar a depuração sem fio, faça o seguinte:

1. Certifique-se de que seu PC/Mac e o telefone estejam conectados à mesma rede sem fio.
2. No seu telefone, vá para Opções de desenvolvedor sob Configurações e habilitar Depuração sem fio. No Permitir depuração sem fio nesta rede? pop-up, selecione Permitir.
3. Toque no Depuração sem fio opção e selecione Emparelhar dispositivo com código de emparelhamento.
4. Anote o código de emparelhamento, endereço IP e número da porta exibidos na tela do telefone.
5. No seu PC/Mac, execute o seguinte comando:

   adbpairIP_Address:Port

   Use o endereço IP e o número da porta da etapa 4.
6. Quando solicitado, insira o código de emparelhamento que você recebeu na etapa 4. Uma mensagem deverá indicar que seu dispositivo foi emparelhado com sucesso.
7. Em seguida, execute o seguinte comando na janela do terminal do PC/Mac:

   adbconnectIP_Address:Port

   Olhe para a Endereço IP e porta seção abaixo Depuração sem fio na etapa 3 para o endereço IP e a porta.
8. Se tudo der certo, você deverá ver uma mensagem como esta:

   connectedto 192.168.68.100:37173

9. Agora você está pronto para digitar qualquer comando shell ADB que desejar.

Exemplos de comandos ADB

Para verificar se você instalou o ADB com sucesso, conecte seu dispositivo ao PC/Mac com o cabo USB e execute o adb devices comando conforme descrito acima. Ele deve exibir seu dispositivo listado na janela Prompt de Comando/PowerShell/Terminal. Se você obtiver um resultado diferente, recomendamos recomeçar com as etapas.

Conforme mencionado acima, você pode usar o ADB para fazer todo tipo de coisa em um dispositivo Android. Alguns desses comandos são integrados diretamente no binário ADB e devem funcionar em todos os dispositivos. Você também pode abrir o que é conhecido como ADB Shell, que permitirá executar comandos diretamente no dispositivo. Os comandos executados diretamente no dispositivo podem variar de dispositivo para dispositivo (já que os OEMs podem remover acesso a determinados e também modificar o comportamento do ADB) e pode variar de uma versão do Android para outra, conforme bem.

Abaixo, você encontrará uma lista de exemplos de comandos que você pode executar em seu dispositivo:

• Imprima uma lista de dispositivos conectados: adb devices
• Mate o servidor ADB: adb kill-server
• Instale um aplicativo: adb install
• Configure o encaminhamento de porta: adb forward tcp: 6100 tcp: 7100
• Copie um arquivo/diretório do dispositivo: adb pull
• Copie um arquivo/diretório para o dispositivo: adb push
• Inicie um shell ADB: adb shell

Bônus

Para aqueles que desejam dar um passo adiante, você pode seguir este novo tutorial que elaboramos e que irá orientá-lo como configurar o ADB para que você possa usar o comando de qualquer diretório em um desktop Windows ou Linux.

O que mais posso fazer com o ADB?

Abaixo está uma lista de tutoriais XDA para vários dispositivos que detalham muitas aplicações de comandos ADB para modificar configurações ocultas, personalizar recursos OEM ou interfaces de usuário e muito mais!

• Como inicializar no modo de recuperação usando combinações de botões, ADB e aplicativos root
• Como desinstalar bloatware de operadora/OEM sem acesso root
• Como descarregar seu telefone (e muito mais) sem conectar a um PC
• Como fazer o sideload de aplicativos na Android TV: métodos de instalação de APK e ADB Sideload explicados em etapas fáceis de seguir!
• Traga de volta os blocos de configurações rápidas de Wi-Fi e dados móveis no Android 12 e superior
• Controle seu smartphone Android do seu PC gratuitamente com scrcpy
• Como emparelhar relógios Android Wear com novos telefones sem redefinição de fábrica

Esta é apenas a ponta do iceberg. Não se esqueça de conferir nossos comandos ADB para cada tutorial de usuário avançado para saber mais dicas e truques úteis para usar o ADB!