Accoppiare il debug wireless di Android con un Mac

Il debug wireless è la connessione per sviluppatori di Android, adb, portata sulla tua rete Wi-Fi invece che su un cavo USB. Ti servono Android 11 o successivo, le Opzioni sviluppatore attive, e il telefono e il Mac sulla stessa rete. Sul telefono, apri Opzioni sviluppatore > Debug wireless, attivalo e tocca Accoppia dispositivo con codice di accoppiamento. Il telefono mostra un codice a sei cifre, che dai al Mac una volta sola. Da quel momento, i due possono collegarsi ogni volta che sono sulla stessa rete.

Ci sono due modi per fare la parte del Mac: lo strumento adb di Google nel Terminale, o un'app che fa l'accoppiamento per te. Li trovi entrambi qui sotto, seguiti da cosa provare quando telefono e Mac non si accoppiano.

Prima di iniziare

• Android 11 o successivo. Controlla in Impostazioni > Informazioni sullo smartphone. Le versioni più vecchie offrono adb via Wi-Fi solo dopo un collegamento USB, con adb tcpip 5555.
• Opzioni sviluppatore attive. Tocca sette volte il numero build. Come attivare il debug USB mostra dov'è il numero build per ogni marca. Su un Pixel, le Opzioni sviluppatore compaiono poi in Impostazioni > Sistema.
• La stessa rete. Il telefono sul Wi-Fi, e il Mac sullo stesso Wi-Fi o collegato via cavo allo stesso router. Non una rete ospiti: ne parliamo più sotto.

Attivare il debug wireless

Apri Opzioni sviluppatore e trova Debug wireless. Tocca la scritta e non l'interruttore, così si apre la sua pagina, poi attivalo. Il telefono chiede se consentire il debug wireless su questa rete. Spunta Consenti sempre su questa rete se è la tua rete, e tocca Consenti.

Ora la pagina mostra l'indirizzo e la porta del telefono, un elenco di dispositivi accoppiati e due modi per accoppiare: Accoppia dispositivo con codice QR e Accoppia dispositivo con codice di accoppiamento. Il codice QR è per Android Studio e per le app che ne mostrano uno. Il codice di accoppiamento funziona con tutto.

Se lo attiverai e disattiverai spesso, aggiungi il riquadro: Opzioni sviluppatore > Riquadri sviluppatore per impostazioni rapide > Debug wireless.

Accoppiare con adb nel Terminale

Installa gli SDK Platform-Tools di Google, che contengono adb. Con Homebrew basta una riga; altrimenti scaricali dal sito di Google per gli sviluppatori Android.

brew install --cask android-platform-tools

Sul telefono, tocca Accoppia dispositivo con codice di accoppiamento. Una finestra mostra un codice a sei cifre e un indirizzo con una porta, come 192.168.1.23:37155. Lasciala aperta. Sul Mac, esegui adb pair con quell'indirizzo e digita il codice quando ti viene chiesto:

adb pair 192.168.1.23:37155

Il Terminale conferma l'accoppiamento, e il Mac compare sul telefono in Dispositivi accoppiati. Quella porta serviva solo per l'accoppiamento. Per collegarti, usa l'indirizzo e la porta mostrati in cima alla pagina Debug wireless, che è una porta diversa:

adb connect 192.168.1.23:41689
adb devices

Le versioni recenti di adb spesso trovano da sole un telefono accoppiato sulla rete e si collegano, quindi adb devices può elencarlo prima ancora che tu scriva adb connect. La porta di connessione può cambiare quando il debug wireless viene disattivato e riattivato, quindi leggila dal telefono ogni volta.

Da qui adb funziona come con un cavo: adb pull /sdcard/DCIM/Camera ~/Desktop/Camera copia la cartella della fotocamera, adb shell apre una shell. Per annullare l'accoppiamento, tocca il Mac in Dispositivi accoppiati e scegli Elimina.

Accoppiare con SideMount

SideMount monta un telefono come volume nel Finder, con il cavo oppure, una volta accoppiato, via Wi-Fi. Parla adb da sé, quindi non ti servono i platform-tools. Apri il suo pannello dalla barra dei menu e scegli Connect over Wi-Fi, che compare quando nessun telefono è collegato, oppure Pair accanto a Pair a phone over Wi-Fi nelle sue impostazioni. Il pannello mostra un codice QR per Accoppia dispositivo con codice QR, oppure, se scegli Use a pairing code instead, aspetta un telefono che stia mostrando un codice. Tocca Accoppia dispositivo con codice di accoppiamento sul telefono e digita le sei cifre nel pannello.

La prima volta, macOS chiede se l'app può trovare dispositivi sulla tua rete locale. Consentilo, altrimenti non comparirà nulla. Puoi cambiare la risposta in Impostazioni di Sistema > Privacy e sicurezza > Rete locale.

Da quel momento, il telefono si monta nel Finder ogni volta che è sulla stessa rete con il debug wireless attivo, e se colleghi anche il cavo, è il cavo a prendere il sopravvento. Richiede macOS 26 o successivo; la guida alla configurazione copre il resto del primo collegamento.

Sii realista sulla velocità. Nelle nostre misure, un telefono montato sulla Wi-Fi di casa trasferiva da 13 a 18 MB/s, contro i 270-280 MB/s dello stesso telefono collegato con il cavo. Va bene per qualche documento o qualche foto, ed è lento per tutti i video di un telefono. Tutti i modi senza cavo da Android a un Mac confronta le alternative.

Quando l'accoppiamento non riesce

Il codice è scaduto o la finestra si è chiusa

Il telefono accetta un codice solo mentre la finestra di accoppiamento è aperta sul suo schermo. Se lo schermo si è bloccato, o se hai cambiato app, tocca di nuovo Accoppia dispositivo con codice di accoppiamento e usa il nuovo codice. Un codice digitato male fallisce senza spiegazioni, quindi anche in quel caso il rimedio è un codice nuovo.

Una rete ospiti, o una rete che tiene separati i dispositivi

Molte reti ospiti, e molte reti di hotel, scuole e uffici, usano l'isolamento dei client: ogni dispositivo può raggiungere internet ma non gli altri dispositivi. Il debug wireless ha bisogno che telefono e Mac si raggiungano direttamente, e tutto ciò che trova il telefono al posto tuo si basa sul fatto che il telefono si annunci sulla rete, cosa che queste reti spesso bloccano. Usa la tua rete di casa, e se l'accoppiamento non riesce nemmeno lì, cerca nelle impostazioni del router isolamento dei client o isolamento AP (in inglese client isolation o AP isolation) e assicurati che sia disattivato per la rete che usi.

Una VPN sul Mac o sul telefono

Una VPN può mandare il traffico locale fuori dalla tua rete, così i due non si incontrano mai. Disattivala mentre accoppi, oppure consenti l'accesso alla rete locale nelle sue impostazioni, poi riprova.

Il debug wireless si è disattivato da solo

Su Android 16 e precedenti, il debug wireless spesso si disattiva da solo quando il telefono cambia rete o si riavvia. Riattivalo e controlla la porta, che potrebbe essere cambiata. Su Android 17, con i platform-tools 37.0.0 o successivi sul Mac, l'ADB Wi-Fi 2.0 di Google fa sì che il telefono lo riattivi da solo sulle reti che hai autorizzato.

Un adb vecchio, o un server adb bloccato

L'accoppiamento richiede un adb recente. Aggiorna i platform-tools, esegui adb kill-server e riprova. Se è il rilevamento a non funzionare, adb connect con l'indirizzo e la porta presi dal telefono funziona anche senza.

Domande