Como parear a depuração por Wi-Fi do Android com um Mac

A depuração por Wi-Fi é a conexão de desenvolvedor do Android, o adb, levada pela sua rede Wi-Fi em vez de um cabo USB. Você precisa do Android 11 ou posterior, das Opções do desenvolvedor ativadas e do celular e do Mac na mesma rede. No celular, abra Opções do desenvolvedor > Depuração por Wi-Fi, ative e toque em Parear o dispositivo com um código de pareamento. O celular mostra um código de seis dígitos, que você passa ao Mac uma vez. Depois disso, os dois se conectam sempre que estiverem na mesma rede.

Há dois jeitos de fazer a parte do Mac: a ferramenta adb do próprio Google, no Terminal, ou um app que pareia por você. Os dois estão abaixo, seguidos do que tentar quando o celular e o Mac não pareiam.

Antes de começar

• Android 11 ou posterior. Confira em Configurações > Sobre o dispositivo. As versões mais antigas só oferecem adb pelo Wi-Fi depois de uma conexão USB, com adb tcpip 5555.
• Opções do desenvolvedor ativadas. Toque sete vezes no número da versão. Como ativar a depuração USB mostra onde fica o número da versão em cada marca. Num Pixel, as Opções do desenvolvedor aparecem depois em Configurações > Sistema.
• A mesma rede. O celular no Wi-Fi, e o Mac no mesmo Wi-Fi ou ligado por cabo ao mesmo roteador. Nada de rede de convidados: mais sobre isso abaixo.

Ative a depuração por Wi-Fi

Abra as Opções do desenvolvedor e encontre Depuração por Wi-Fi. Toque no texto, e não na chave, para abrir a página dela, e então ative. O celular pergunta se você quer permitir a depuração por Wi-Fi nesta rede. Marque Sempre permitir nesta rede se a rede for sua e toque em Permitir.

A página agora mostra o endereço e a porta do celular, uma lista de dispositivos pareados e dois jeitos de parear: Parear o dispositivo com um QR code e Parear o dispositivo com um código de pareamento. O QR code é para o Android Studio e para apps que mostram um. O código de pareamento funciona com tudo.

Se você vai ligar e desligar com frequência, adicione o bloco: Opções do desenvolvedor > Blocos de desenvolvedor para configurações rápidas > Depuração por Wi-Fi.

Parear com o adb no Terminal

Instale o SDK Platform-Tools do Google, que contém o adb. Com o Homebrew, é uma linha; senão, baixe-o no site de desenvolvedores Android do Google.

brew install --cask android-platform-tools

No celular, toque em Parear o dispositivo com um código de pareamento. Uma caixa de diálogo mostra um código de seis dígitos e um endereço com porta, como 192.168.1.23:37155. Deixe-a aberta. No Mac, rode adb pair com esse endereço e digite o código quando ele pedir:

adb pair 192.168.1.23:37155

O Terminal avisa que pareou, e o Mac aparece no celular em Dispositivos pareados. Aquela porta de pareamento servia só para parear. Para conectar, use o endereço e a porta mostrados no topo da página Depuração por Wi-Fi, que é outra porta:

adb connect 192.168.1.23:41689
adb devices

As versões recentes do adb muitas vezes encontram um celular pareado na rede e se conectam sozinhas, então o adb devices pode listá-lo antes de você digitar adb connect. A porta de conexão pode mudar quando a depuração por Wi-Fi é desligada e ligada de novo, então leia-a no celular a cada vez.

Daqui em diante, o adb funciona como pelo cabo: adb pull /sdcard/DCIM/Camera ~/Desktop/Camera copia a pasta da câmera, adb shell abre um shell. Para desparear, toque no Mac em Dispositivos pareados e escolha Esquecer.

Parear com o SideMount

O SideMount monta um celular como um volume no Finder, pelo cabo ou, depois de pareado, pelo Wi-Fi. Ele mesmo fala adb, então você não precisa das platform-tools. Abra o painel dele na barra de menus e escolha Connect over Wi-Fi, que aparece enquanto não há celular conectado, ou Pair, ao lado de Pair a phone over Wi-Fi, nos ajustes dele. O painel mostra um QR code para Parear o dispositivo com um QR code ou, se você escolher Use a pairing code instead, espera por um celular que esteja mostrando um código. Toque em Parear o dispositivo com um código de pareamento no celular e digite os seis dígitos no painel.

Na primeira vez, o macOS pergunta se o app pode encontrar dispositivos na sua rede local. Permita, ou nada vai aparecer. Você pode mudar a resposta em Ajustes do Sistema > Privacidade e Segurança > Rede Local.

Depois disso, o celular é montado no Finder sempre que estiver na mesma rede com a depuração por Wi-Fi ativada, e, se você conectar o cabo também, o cabo assume. Ele precisa do macOS 26 ou posterior; o guia de configuração cobre o resto da primeira conexão.

Seja realista quanto à velocidade. Nas nossas medições, um celular montado pelo Wi-Fi de casa transferiu de 13 a 18 MB/s, contra 270 a 280 MB/s do mesmo celular no cabo. Tudo bem para alguns documentos ou fotos, e lento para um celular cheio de vídeos. Todas as formas sem fio do Android para o Mac compara as alternativas.

Quando o pareamento falha

O código expirou ou a caixa de diálogo fechou

O celular só aceita um código enquanto a caixa de diálogo de pareamento está aberta na tela. Se a tela bloqueou, ou se você trocou de app, toque de novo em Parear o dispositivo com um código de pareamento e use o código novo. Um código digitado errado falha sem nenhuma explicação, então um código novo também resolve isso.

Uma rede de convidados, ou uma que mantém os aparelhos separados

Muitas redes de convidados, e muitas redes de hotel, escola e escritório, usam isolamento de clientes: cada aparelho chega à internet, mas não aos outros aparelhos. A depuração por Wi-Fi precisa que o celular e o Mac se alcancem diretamente, e qualquer coisa que encontra o celular para você depende de o celular se anunciar na rede, o que essas redes muitas vezes bloqueiam. Use a rede da sua casa e, se o pareamento ainda falhar ali, procure nas configurações do roteador por isolamento de clientes ou isolamento AP (client isolation ou AP isolation, em inglês) e confirme que está desligado na rede que você usa.

Uma VPN no Mac ou no celular

Uma VPN pode mandar o tráfego local para fora da sua rede, e aí os dois nunca se encontram. Desligue-a enquanto pareia, ou permita o acesso à rede local nas configurações dela, e tente de novo.

A depuração por Wi-Fi se desligou sozinha

No Android 16 e anteriores, a depuração por Wi-Fi costuma se desligar sozinha quando o celular troca de rede ou reinicia. Ative de novo e confira a porta, que pode ter mudado. No Android 17, com as platform-tools 37.0.0 ou posteriores no Mac, o ADB Wi-Fi 2.0 do Google faz o celular religá-la sozinho nas redes que você permitiu.

adb antigo, ou um servidor adb travado

Parear exige um adb recente. Atualize as platform-tools, rode adb kill-server e tente de novo. Se o que falha é a descoberta, o adb connect com o endereço e a porta do celular funciona sem ela.

Perguntas