ADB sem cabo: como usar o ADB sem cabo USB
Use o ADB sem nenhum cabo USB. Depuração por Wi-Fi no Android 11+, adb tcpip nos celulares mais antigos e controle do celular pelo navegador via Wi-Fi.
Dá para usar o ADB sem cabo USB. No Android 11 em diante, a Depuração por Wi-Fi pareia o computador com o celular pela rede e nunca precisa de cabo. No Android 10 ou anterior, você precisa do cabo uma vez para colocar o celular no modo de rede com adb tcpip, e depois pode desconectar. Este guia mostra os dois jeitos e também como fazer isso pelo navegador com o ADBKit.
Qual jeito funciona no seu celular
| Seu celular | Precisa de cabo? | Método |
|---|---|---|
| Android 11 ou mais novo | Nunca | Depuração por Wi-Fi (pareamento com código ou QR code) |
| Android 10 ou anterior | Uma vez a cada reinício | adb tcpip 5555 e depois adb connect |
| Android TV, Google TV, Fire TV | Geralmente nunca | O ADB pela rede já vem embutido quando a depuração ADB está ligada |
Confira sua versão em Configurações › Sobre o telefone › Versão do Android. A comparação completa está em adb tcpip vs Depuração por Wi-Fi.
Antes de começar
- Ative as Opções do desenvolvedor (toque sete vezes em Número da versão em Sobre o telefone) e a Depuração USB. Veja como ativar a Depuração USB.
- Deixe o celular e o computador na mesma rede Wi-Fi ou local. Wi-Fi de convidados e redes com "isolamento de AP" impedem que os aparelhos se enxerguem.
- Use o Android SDK platform-tools 30 ou mais novo para o
adb pair, ou use o ADBKit no Chrome ou no Edge.
Método 1: Depuração por Wi-Fi (Android 11+, nunca precisa de cabo)
- No celular, abra Opções do desenvolvedor › Depuração por Wi-Fi e ative. Em alguns aparelhos, como os Samsung, a opção se chama Depuração sem fio.
- Toque em Parear o dispositivo com um código de pareamento. O celular mostra um endereço IP, uma porta e um código de 6 dígitos.
- No computador, rode:
adb pair 192.168.1.20:37011- Digite o código de 6 dígitos. Deve aparecer
Successfully paired. - De volta à tela da Depuração por Wi-Fi, anote o Endereço IP e porta no topo (essa porta é diferente da porta de pareamento) e conecte:
adb connect 192.168.1.20:41237
adb devicesO pareamento só é feito uma vez por computador. Na próxima vez, ative a Depuração por Wi-Fi e rode adb connect com a porta nova, porque a porta muda a cada vez.
Método 2: adb tcpip (Android 10 ou anterior)
Celulares mais antigos não conseguem parear pelo Wi-Fi, então você usa o cabo uma vez:
adb tcpip 5555Tire o cabo, veja o endereço IP do celular em Configurações › Wi-Fi › sua rede e conecte:
adb connect 192.168.1.20:5555Aceite o aviso "Permitir a depuração USB?" no celular se ele aparecer. Esse modo de rede fica ligado até o celular reiniciar. Depois de um reinício aparece Connection refused e você precisa do cabo mais uma vez. Esse erro está explicado em como resolver adb connect: Connection refused.
Método 3: pelo navegador com o ADBKit
Uma página web não consegue abrir conexões de rede com o seu celular sozinha, então o ADBKit usa um pequeno agente que roda no seu próprio computador. Ele escuta só no seu computador e repassa a conexão. Nada é enviado para um servidor do ADBKit.
- Abra o ADBKit no Chrome ou no Edge e escolha Network: Wireless debugging (Android 11+) ou Network: TCP/IP (celulares mais antigos).
- Siga os passos para iniciar o agente com uma instalação de uma linha. O código-fonte dele é público.
- Na Depuração por Wi-Fi, faça o pareamento com o código de 6 dígitos ou lendo um QR code com o celular. No TCP/IP, o ADBKit pode ligar o modo de rede para você se você conectar o celular por cabo uma vez.
Aí você tem a tela ao vivo, digitação pelo teclado, logcat, shell, arquivos e instalação de APK pelo Wi-Fi. A configuração do agente está na referência do agente do ADBKit.
Problemas comuns
failed to connect ... Connection refused: o celular não está escutando nessa porta. No Android 10 ou anterior, o modo de rede foi desligado no último reinício. No Android 11+, a Depuração por Wi-Fi foi desligada ou a porta mudou.failed to connect ... timed out: IP errado, ou o celular e o computador estão em redes diferentes.- O pareamento falha: o código expirou ou você fechou a tela de pareamento. Abra de novo e use o código novo.
- A conexão cai quando a tela apaga: alguns celulares economizam bateria pausando o Wi-Fi. Deixe o celular carregando e ative Permanecer ativo em Opções do desenvolvedor enquanto trabalha.
ADB sem fio é seguro?
Use só em redes de confiança. A Depuração por Wi-Fi criptografa a conexão e só aceita computadores pareados. O adb tcpip clássico não é criptografado e deixa a porta 5555 aberta até o celular reiniciar, então evite em Wi-Fi público. Desligue o ADB sem fio quando terminar.