'adb' não é reconhecido como um comando no Windows: como resolver

Você digita adb devices e o Windows responde:

'adb' não é reconhecido como um comando interno
ou externo, um programa operável ou um arquivo em lotes.

Num Windows em inglês a mensagem é:

'adb' is not recognized as an internal or external command,
operable program or batch file.

No PowerShell a mensagem é adb : The term 'adb' is not recognized... (ou a versão em português), e no macOS ou Linux é adb: command not found. Todas querem dizer a mesma coisa: o computador não encontra o programa adb. Ou ele não está instalado, ou a pasta onde ele está não faz parte do seu PATH.

Passo 1: baixe o platform-tools

O ADB vem no pacote gratuito Android SDK Platform-Tools do Google.

1. Baixe o Platform-Tools para o seu sistema no site oficial do Android Developers.
2. Descompacte num lugar fixo, por exemplo C:\platform-tools no Windows ou ~/platform-tools no macOS e Linux.

Se você instalou o Android Studio, já tem o pacote, normalmente em %LOCALAPPDATA%\Android\Sdk\platform-tools no Windows ou em ~/Library/Android/sdk/platform-tools no macOS.

Teste rápido sem mudar nada

Abra um terminal dentro da pasta platform-tools e rode o adb de lá:

• Prompt de Comando do Windows: cd C:\platform-tools, depois adb devices
• Windows PowerShell: cd C:\platform-tools, depois .\adb devices (o PowerShell precisa do .\)
• macOS / Linux: cd ~/platform-tools, depois ./adb devices

Se isso funcionar, o adb está certo e só falta o PATH.

Passo 2: coloque o platform-tools no PATH do Windows

1. Clique em Iniciar, digite variáveis de ambiente e abra Editar as variáveis de ambiente do sistema (Edit the system environment variables).
2. Clique em Variáveis de Ambiente... (Environment Variables...).
3. Em Variáveis de usuário (User variables), selecione Path e clique em Editar (Edit).
4. Clique em Novo (New) e digite C:\platform-tools (a sua pasta de verdade).
5. Clique em OK em todas as janelas.
6. Feche e abra de novo o terminal. Janelas antigas continuam com o PATH antigo.

Teste com adb version.

Passo 2: coloque o platform-tools no PATH do macOS e Linux

Adicione esta linha ao ~/.zshrc (macOS) ou ao ~/.bashrc (a maioria das distribuições Linux):

export PATH="$HOME/platform-tools:$PATH"

Depois abra um terminal novo, ou rode source ~/.zshrc, e confira com adb version. No macOS também dá para instalar com o Homebrew (brew install --cask android-platform-tools), e no Debian ou Ubuntu com sudo apt install adb.

Várias cópias do adb

Programas de gerenciamento de celular, emuladores e SDKs antigos costumam trazer o próprio adb. Se o adb version mostra uma versão antiga depois que você instalou uma nova, outra cópia vem antes no PATH. No Windows, where adb lista todas as cópias em ordem. No macOS e Linux use which -a adb. Tire a pasta antiga do PATH ou mova a nova para o topo. Versões misturadas também são um motivo comum para dispositivos aparecerem como offline.

Pule a configuração com o ADBKit

Se você só precisa das tarefas de ADB do dia a dia, nem precisa do adb no computador. O ADBKit roda o ADB dentro do Chrome ou Edge pelo USB: tela ao vivo, digitação pelo teclado, logcat, shell, transferência de arquivos e instalação de APK, sem nada para instalar e nada para colocar no PATH. Num notebook corporativo bloqueado, onde você não pode instalar programas, muitas vezes esse é o caminho mais fácil.

Próximo passo depois que o adb funcionar: ative a depuração USB e deixe à mão o guia rápido de comandos ADB.