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 do usuário comum. Geralmente, isso é 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 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 ABD?

Como existem três partes que compõem o ADB (o cliente, o daemon e o servidor), isso requer que certas partes estejam 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 no 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 ouvir nessa porta específica os comandos enviados pelo cliente ADB. Em seguida, ele estabelecerá conexões com 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

Observação: 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. Lançar o Configurações aplicativo em seu telefone.
2. Toque em Sobre telefone opção geralmente perto da parte inferior da lista.
   • Dependendo da capa OEM, o Sobre telefone página pode ser chamada de outra coisa ou enterrada em outro lugar no Configurações aplicativo em seu dispositivo.
3. Em seguida, toque no Número da versão opção sete vezes para habilitar o modo de desenvolvedor. Você verá uma mensagem de brinde quando terminar.
4. Agora volte para a tela principal de Configurações e você verá um novo Opções de desenvolvedor menu que você pode acessar. Nos telefones Google Pixel e em 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 habilite 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 de 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 do 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 do mouse na pasta e, em seguida, 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, mesmo sem pressionar o botão Shift no teclado.
5. Conecte seu smartphone ou tablet ao computador com um cabo USB. Altere o modo USB para o modo “transferência de arquivo (MTP)”. Alguns OEMs podem ou não exigir isso, mas é melhor deixá-lo nesse modo para compatibilidade geral.
6. Na janela Prompt de Comando/Terminal, digite o seguinte comando para iniciar o daemon ADB: dispositivos adb
7. Na tela do seu telefone, você deve 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, insira novamente o comando da etapa 6. Se tudo foi bem-sucedido, agora você deve 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 de 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 em que você extraiu o ADB, digite o seguinte comando: cd /caminho/para/extraída/pasta/
   • Por exemplo, você pode colocar o conteúdo em sua área de trabalho: cd /Users/XDA/Desktop/platform-tools/
5. Conecte seu dispositivo ao seu Mac com um cabo USB compatível. Altere o modo de conexão USB para o modo “transferência de arquivo (MTP)”. Isso nem sempre é necessário para todos os dispositivos, mas é melhor deixá-lo nesse modo para não ter problemas.
6. Quando o Terminal estiver na mesma pasta em que estão as ferramentas ADB, você pode executar o seguinte comando para iniciar o daemon ADB: ./adb dispositivos
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ê deve 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 Homebrew 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 de 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 /caminho/para/extraída/pasta/
5. Isso mudará o diretório para 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 arquivo (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 estão as ferramentas ADB, você pode executar o seguinte comando para iniciar o daemon ADB: ./adb dispositivos
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, insira novamente o comando da etapa 8. Se tudo foi bem-sucedido, agora você deve 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 ou A distro 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-pegar instalar android-sdk-plataforma-ferramentas

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

  sudo dnf instalar ferramentas android

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

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

Subsistema do 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, ADB sob WSL não pode acessar seu dispositivo Android, mesmo se você instalá-lo usando o método mencionado acima. No entanto, existe uma solução oficial, que utiliza o software de código aberto usbipd-win projeto. Para saber mais, dê uma olhada em nosso tutorial sobre como configurar a passagem USB no WSL.

Para o ChromeOS, você precisa ativar o ambiente de desenvolvimento integrado do Linux primeiro. Por padrão, ele oferece uma instância Debian. Você pode 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 listamos em tutoriais futuros, especialmente quando eles estão usando os binários extraídos diretamente do ZIP de ferramentas de 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 máximo de pessoas possível para entender como fazer esses ajustes para o 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 controle telefones Android diretamente de navegadores da web. Mais um WebADB, também conhecido como ya-webadb, é um desses projetos 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 o que você precisa é de um navegador da Web compatível com a API WebUSB (como Google Chrome, Microsoft Edge ou Firefox) e pronto.

Opcional: Como usar o ADB via Wi-Fi

O Android 11 e as 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 do 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 Dispositivo de emparelhamento com código de emparelhamento.
4. Anote o código de emparelhamento, o endereço IP e o número da porta exibidos na tela do telefone.
5. No seu PC/Mac, execute o seguinte comando:

   adbparEndereço de IP:Porta

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

   adbconectarEndereço de IP:Porta

   Olhe para a endereço IP e porta seção sob 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 a seguinte:

   conectadopara 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 seu PC/Mac com o cabo USB e execute o dispositivos adb comando conforme descrito acima. Ele deve exibir seu dispositivo listado na janela Prompt de Comando/PowerShell/Terminal. Se você obtiver uma saída diferente, recomendamos recomeçar com as etapas.

Como mencionado acima, você pode usar o ADB para fazer todo tipo de coisa em um dispositivo Android. Alguns desses comandos são criados diretamente no binário ADB e devem funcionar em todos os dispositivos. Você também pode abrir o que é chamado de ADB Shell, que permite executar comandos diretamente no dispositivo. Os comandos que são 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 comandos de exemplo que você pode executar em seu dispositivo:

• Imprima uma lista de dispositivos conectados: dispositivos adb
• Mate o servidor ADB: adb kill-server
• Instale um aplicativo: adb instalar
• 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 querem dar um passo adiante, você pode seguir este novo tutorial que preparamos para orientá-lo como configurar o ADB para que você possa usar o comando de qualquer diretório em uma área de trabalho Windows ou Linux.

O que mais posso fazer com o ADB?

Abaixo está uma lista de tutoriais XDA para vários dispositivos que detalham muitos aplicativos 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 raiz
• Como desinstalar bloatware de operadora/OEM sem acesso root
• Como desinchar seu telefone (e mais) sem conectar a um PC
• Como fazer o sideload de aplicativos na Android TV: os métodos APK Install 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 a partir 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 dicas e truques mais úteis para usar o ADB!