Como Resolver de Vez os Problemas de Depuração WiFi no Android Studio
O Problema Comum
Quantas vezes você já passou por esta situação frustrante:
- Ativa a depuração WiFi no dispositivo
- Escaneia o QR Code (ou usa o código de pareamento) no Android Studio
- Funciona por um tempo, mas depois que desliga e liga a desliga ou troca de rede acaba perdendo a conexão
- Precisa repetir todo o processo novamente
- Ou as vezes o QR Code simplesmente não funciona
A depuração WiFi no Android Studio, quando configurada corretamente, oferece uma experiência de desenvolvimento muito mais fluida e produtiva. O segredo está em entender a diferença entre as portas de pareamento e depuração, e usar o comando adb pair para estabelecer um vínculo de confiança duradouro.
Seguindo os passos deste artigo, você nunca mais precisará ficar escaneando QR Codes ou lidando com conexões instáveis. O processo de pareamento via linha de comando é mais confiável, rápido e oferece melhor controle sobre a conexão.
A Solução Definitiva
Pré-requisitos
Antes de começar, certifique-se de que:
- Android Studio está instalado com ADB configurado
- Opções do desenvolvedor estão ativadas no dispositivo 1
- Dispositivo e computador estão na mesma rede WiFi
- Que seu celular está com IP fixo configurado 2
Passo 1: Ativar Depuração Wireless
- No seu dispositivo Android, vá em Settings > Developer options
- Ative "Wireless debugging"
- Toque em "Wireless debugging" para abrir as configurações
- Toque em "Pair device with pairing code"
Você verá uma uma janela similar a esta:
Atenção: Observe que aparecem DUAS informações importantes:
- Código de pareamento (ex: 817324)
- IP e porta de pareamento (ex: 192.168.18.3:39233)
Passo 2: Realizar o Pareamento via Terminal
Abra o terminal (ou Command Prompt no Windows) e execute:
adb pair 192.168.18.3:39233
Importante: Use a porta da seção de pareamento, não a de depuração!
O sistema solicitará o código de pareamento:
Enter pairing code: 817324
Successfully paired to 192.168.18.3:39233 [guid=adb-XXXXXXXXX]
Passo 3: Conectar para Depuração
Agora depois que foi concluído o pareamento ele deve fechar o popup, então observer agora a porta de depuração:
Agora conecte usando a porta de depuração, que no meu caso é a 36541:
adb connect 192.168.18.3:36541
Você deve ver:
connected to 192.168.18.3:36541
Passo 4: Verificar a Conexão
Confirme que o dispositivo está conectado:
adb devices
Saída esperada:
List of devices attached
192.168.18.3:36541 device
Por Que Esta Solução Funciona
Vínculo de Confiança
O comando adb pair estabelece um vínculo de confiança criptográfico entre seu computador e o dispositivo Android. Este vínculo é persistente e não precisa ser refeito a cada sessão.
Diferença Entre as Portas
- Porta de Pareamento: Usada apenas uma vez para estabelecer confiança
- Porta de Depuração: Usada para todas as conexões subsequentes
Reconexão Automática
Após o pareamento inicial, o Android Studio consegue:
- Detectar automaticamente o dispositivo na rede
- Reconectar sem intervenção manual
- Manter a conexão mais estável
Vantagens da Depuração WiFi
- Liberdade de movimento: Sem cabos limitando a mobilidade
- Teste em condições reais: Dispositivo funciona normalmente
- Múltiplos dispositivos: Conecte vários dispositivos simultaneamente
- Preservação de portas: Economia das portas USB do computador
Recursos Adicionais
Footnotes
-
https://developer.android.com/studio/debug/dev-options#enable ↩
-
Eu pessoalmente recomendo fazer essa configuração direto no seu roteador para que fique centralizado a configuração de todos seu IPs fixos ↩