Se ti capita spesso di collegare lo smartphone al PC solo per lanciare adb logcat, installare un APK di test o fare un push veloce di un file, il cavo USB è l'ultimo dei tuoi problemi finché non lo dimentichi a casa. Da Android 11 in poi, Google ha reso ufficiale e stabile una funzione che prima esisteva solo come trucco per sviluppatori: il pairing wireless con codice a 6 cifre, senza bisogno di collegare mai il telefono via cavo.
Cosa cambia rispetto al vecchio ADB over Wi-Fi
Il metodo "storico" richiedeva comunque un primo collegamento USB per lanciare adb tcpip 5555 e poi adb connect ip:5555. Funziona ancora oggi su versioni più vecchie di Android, ma ha due difetti: la porta è fissa e prevedibile, e la connessione non è autenticata in modo forte. Il pairing introdotto con Android 11 usa invece un protocollo simile al pairing Bluetooth, con un codice OTP a 6 cifre e una porta generata dinamicamente, quindi puoi accoppiare il PC senza mai staccare il cavo dal cassetto.
Requisiti
- Un dispositivo con Android 11 o superiore.
- PC e smartphone sulla stessa rete Wi-Fi (il pairing wireless non funziona tra reti diverse o con isolamento client attivo sul router).
- Android Platform Tools (adb) installati sul PC, anche solo la versione a riga di comando scaricabile dal sito Android Developers.
1. Attiva le opzioni sviluppatore e il debug wireless
Vai in Impostazioni > Info sul telefono e tocca 7 volte "Numero build" finché non compare il messaggio che conferma l'attivazione delle opzioni sviluppatore. Torna indietro, entra in Impostazioni > Opzioni sviluppatore e attiva la voce Debug wireless (su alcuni produttori si trova sotto un sottomenu dedicato). Il sistema chiederà conferma: accetta.
2. Avvia il pairing dal telefono
Entra nella schermata "Debug wireless" e tocca Accoppia dispositivo con codice. Comparirà una finestra con:
- un codice numerico a 6 cifre;
- un indirizzo IP e una porta dedicati esclusivamente al pairing (diversi da quelli della connessione ADB vera e propria).
3. Completa il pairing dal PC
Con il telefono ancora sulla schermata di pairing, apri un terminale sul PC e lancia:
adb pair 192.168.1.42:41381
Il terminale chiederà il codice a 6 cifre mostrato sul telefono: digitalo e premi invio. Se tutto va bene vedrai un messaggio di conferma tipo "Successfully paired". Da questo momento il PC è autorizzato, ma non è ancora connesso: il pairing e la connessione sono due passaggi distinti.
4. Connettiti per il debug vero e proprio
Torna nella schermata principale di "Debug wireless" (non quella di pairing): qui trovi un secondo indirizzo IP con una porta diversa, che resta stabile finché il debug wireless è attivo. Usalo per connetterti:
adb connect 192.168.1.42:37831
adb devices
Se il dispositivo compare nell'elenco come "device" (e non "unauthorized" o "offline"), sei operativo esattamente come con il cavo: adb install app.apk, adb logcat, adb shell funzionano tutti allo stesso modo.
Rendere la connessione più comoda
Se il tuo router assegna sempre lo stesso IP al telefono (DHCP reservation) o hai impostato un IP statico, puoi salvare il comando adb connect in uno script o in un alias di shell e lanciarlo ogni volta che ti serve, senza rifare il pairing: quello resta valido finché non disattivi il debug wireless o non revochi manualmente le autorizzazioni.
Problemi comuni
- "failed to connect": verifica che telefono e PC siano davvero sulla stessa subnet e che il router non isoli i client Wi-Fi tra loro (funzione comune su reti guest).
- Il dispositivo sparisce dopo un po': normale se lo smartphone va in standby profondo o cambia rete; basta ripetere il comando
adb connect, il pairing resta valido. - adb non trova il device dopo un riavvio del telefono: l'IP e la porta della schermata "Debug wireless" possono cambiare a ogni riavvio, quindi controlla i valori aggiornati prima di rilanciare
adb connect.
Una nota sulla sicurezza
Il debug wireless espone comunque un canale con pieno accesso shell al dispositivo a chiunque riesca ad autenticarsi sulla stessa rete durante la finestra di pairing. È buona norma lasciarlo attivo solo quando serve davvero e disattivarlo (o revocare le autorizzazioni salvate) su reti pubbliche o non fidate, esattamente come faresti con qualsiasi altra porta di gestione remota.