O que é ADB? Android Debug Bridge explicado de forma simples

ADB, sigla de Android Debug Bridge, é a ferramenta que o computador usa para conversar com um celular, tablet ou TV Android. Com ela você instala apps, lê logs, copia arquivos, roda comandos de shell e controla a tela, tudo pelo computador. O Google distribui o ADB junto com o Android SDK, e é a mesma ferramenta que o Android Studio usa por baixo dos panos sempre que você clica em Run.

Uma ponte com três partes

O ADB parece um comando só, mas na verdade são três programas trabalhando juntos:

Na primeira vez que você digita um comando adb, o cliente inicia o servidor se ele ainda não estiver rodando. O servidor então procura dispositivos no USB e na rede. Quando você roda adb shell ls, o cliente passa o pedido ao servidor, o servidor encaminha para o adbd no celular, e a resposta volta pelo mesmo caminho.

Por isso só um programa por vez deve rodar um servidor ADB. Se o Android Studio, o scrcpy e um terminal tentam ficar com a conexão USB ao mesmo tempo, eles brigam por ela e aparecem erros como "device busy". Normalmente resolve com adb kill-server ou fechando a outra ferramenta. Mais detalhes em como resolver dispositivo ocupado ou não autorizado.

Como o celular libera o acesso ao computador

O ADB pode fazer muita coisa, então o Android não deixa qualquer computador usar.

1. A Depuração USB precisa estar ativada. Ela fica em Opções do desenvolvedor, que ficam escondidas até você tocar sete vezes no número da versão. Veja como ativar a depuração USB.
2. O celular precisa aprovar o computador. Cada computador tem sua própria chave RSA. Na primeira conexão, o celular mostra "Permitir a depuração USB?" com a impressão digital dessa chave. Até você tocar em Permitir, o aparelho aparece como unauthorized e nada funciona.

Você pode retirar essa aprovação quando quiser em Revogar autorizações de depuração USB, dentro de Opções do desenvolvedor.

USB ou Wi-Fi

O ADB funciona por dois tipos de conexão:

• Cabo USB: o padrão. Rápido, confiável e o mais fácil de configurar.
• Rede: o clássico adb tcpip, que precisa do cabo uma vez para colocar o celular na porta 5555, ou a Depuração por Wi-Fi do Android 11 em diante, que pareia com um código e dispensa o cabo. As diferenças estão em adb tcpip vs Depuração por Wi-Fi.

O ADB pela rede é a única opção para a maioria das TVs, que não dá para ligar ao computador por USB. Veja como controlar uma Android TV com ADB.

ADB vs fastboot

Muita gente confunde os dois porque eles vêm no mesmo download, o Android SDK platform-tools.

O adb reboot bootloader é a ponte comum entre os dois: ele leva um celular ligado para o modo fastboot. O que dá para fazer lá está no guia do modo fastboot.

Como conseguir o ADB

Há dois caminhos comuns:

• Android SDK platform-tools: download gratuito do Google para Windows, macOS e Linux. Você descompacta, adiciona a pasta ao PATH e usa o adb no terminal.
• No navegador: o Chrome e o Edge conseguem falar com dispositivos USB pelo WebUSB, então uma página web pode usar o protocolo ADB diretamente. É assim que o ADBKit funciona, sem instalar nada para USB. A parte técnica está em o que são WebADB e WebUSB.

O ADB é seguro?

O ADB é uma ferramenta de depuração, então dá ao computador aprovado um acesso profundo: ele pode instalar apps, ler logs de apps e copiar arquivos do armazenamento compartilhado. Isso é seguro quando o computador é seu e você sabe o que está rodando. Alguns hábitos ajudam:

• Só toque em Permitir para computadores de confiança.
• Desative a Depuração USB quando não precisar mais, principalmente no celular que você usa todo dia.
• Não deixe o ADB pela rede ligado em Wi-Fi público ou compartilhado.

Próximos passos

• Para que serve o ADB, com exemplos reais
• A lista de comandos ADB
• Ative a Depuração USB e conecte seu primeiro aparelho