Se ti piace armeggiare con il tuo cellulare o sviluppare app, ADB (Android Debug Bridge) è uno strumento di base per controllare il dispositivo dal computerPermette di fare cose impossibili tramite la normale interfaccia Android, come disinstallare bloatware di sistema, automatizzare attività o accedere alla shell dei comandi del telefono.
Fino a poco tempo fa, era comune affidarsi a un cavo USB per utilizzare ADB, ma da Android 11 le cose sono cambiate: Puoi connettere il tuo telefono cellulare ad ADB tramite Wi-Fi senza doverlo collegare al PC.Il sistema include un'opzione di debug wireless con codici QR e codici di associazione che semplifica notevolmente il processo, e il vecchio metodo ADB su TCP/IP è ancora disponibile dopo una connessione USB iniziale.
Che cos'è ADB e perché dovresti essere interessato a utilizzarlo in modalità wireless?
ADB sta per Android Debug Bridge e funge da collega la comunicazione tra il tuo computer e il tuo dispositivo Android utilizzando i comandi della consoleÈ progettato per gli sviluppatori, ma è anche un vero tesoro per gli utenti avanzati che vogliono andare un po' oltre ciò che l'interfaccia grafica consente.
Questa utility è composta da tre parti: un client che viene eseguito sul PC, un demone (adbd) che viene eseguito sul dispositivo mobile o sull'emulatore e un server che coordina entrambi.Il client invia i comandi, il server li distribuisce e il demone li esegue sul dispositivo. Tutto questo avviene in background ogni volta che si digita un comando adb nel terminale.
Con ADB puoi fare tutto: Installa e disinstalla app, esegui il debug di applicazioni, accedi a una shell Unix completa, copia file, registra lo schermo, acquisisci screenshot o reindirizza le porteConsente persino di gestire autorizzazioni, profili utente o criteri dei dispositivi a livello aziendale.
Il problema classico con ADB è sempre stato lo stesso: Dipende dal cavo USB e dal buono stato delle porte del telefono e del PC.Se il connettore del telefono è danneggiato, se il cavo non fa contatto correttamente o se i driver USB di Windows causano problemi, potresti impazzire nel tentativo di far riconoscere il dispositivo al PC.
Android 11 ha fatto un passo avanti significativo in questo senso, introducendo il cosiddetto Debug wireless, che consente di collegare il telefono al dispositivo tramite Wi-Fi utilizzando un codice QR o un codice PIN di associazioneIn questo modo, puoi dimenticarti del cavo sia per lo sviluppo che per molte attività utente avanzate.
Requisiti di base per l'utilizzo di ADB wireless su Android 11 o versioni successive
Prima di iniziare, è necessario avere ben chiari alcuni requisiti minimi, perché Non tutti i telefoni cellulari o le configurazioni dei PC sono adatti al debug wireless moderno che Google ha introdotto.
Per prima cosa, il tuo telefono cellulare deve funzionare È necessario che Android 11 o versioni successive disponga dell'opzione Debug wireless nelle Opzioni sviluppatoreIn Android 10 e versioni precedenti, ADB può essere utilizzato anche tramite Wi-Fi, ma con il vecchio metodo basato su TCP/IP e una connessione USB iniziale.
Dal lato computer è essenziale avere Strumenti aggiornati della piattaforma Android SDK, tramite Android Studio o scaricando il pacchetto autonomo dal sito web degli sviluppatori Google.All'interno del pacchetto è presente il binario adb che utilizzerai dalla console. Se lavori da macOS, consulta la guida per Collega il tuo dispositivo Android a un Mac senza problemi..
Un altro requisito essenziale è che computer e telefono sono connessi alla stessa rete Wi-FiNon connettere il tuo PC tramite Ethernet a una rete aziendale e il tuo cellulare alla rete Wi-Fi ospite, perché in questo scenario solitamente non saranno in grado di vedersi oppure ci saranno filtri che bloccheranno il traffico P2P.
Infine, devi attivare Le Opzioni sviluppatore sul tuo dispositivo Android e, al loro interno, la funzione Debug wireless.Senza questa opzione, il telefono non accetterà alcuna connessione ADB tramite Wi-Fi. E, cosa importante, quando vedi la notifica che il dispositivo desidera eseguire il debug su una rete specifica, seleziona la casella per consentirgli sempre di funzionare su quella rete se prevedi di utilizzarlo regolarmente.
Abilita le opzioni sviluppatore e il debug wireless
Il primo passo per dimenticare il cavo è procurarselo Android dovrebbe visualizzare le opzioni avanzate per gli sviluppatori e consentire esplicitamente l'uso di ADB tramite Wi-Fi.Il processo è molto simile in quasi tutti i livelli di personalizzazione, anche se i nomi dei menu cambiano leggermente.
Per abilitare le opzioni sviluppatore, vai a Impostazioni > Informazioni sul telefono (o Informazioni sul dispositivo) e tocca ripetutamente Numero build o VersioneDopo alcuni tocchi, il sistema visualizzerà un messaggio del tipo "Ora sei uno sviluppatore" o "Non è necessario, sei già un programmatore". Da quel momento in poi, nelle impostazioni apparirà un nuovo menu Opzioni sviluppatore.
Il modo più veloce per arrivarci è usare la funzione di ricerca integrata nelle impostazioni del tuo telefono e digitare “Opzioni sviluppatore” per andare direttamente alla sezione avanzataAll'interno troverete gli interruttori di debug, sia USB che wireless.
Scorri l'elenco finché non vedi la voce Debug wireless o debug tramite WLANQuando la attivi, Android visualizzerà una finestra pop-up che mostra i parametri della rete Wi-Fi a cui sei connesso e chiederà conferma. Seleziona la casella. Consenti sempre su questa rete Se ti fidi, premi Consenti.
Proprio accanto all'interruttore Wireless Debug, di solito c'è una freccia che punta verso destra; toccandola avrai accesso a la schermata dedicata al debug wireless, dove vedrai opzioni come il collegamento del dispositivo con codice QR, l'associazione con codice di sincronizzazione o il collegamento con codice di associazioneQui lavoreremo per connettere il telefono cellulare al PC in modalità wireless.
Connetti ADB in modalità wireless tramite Android Studio (codice QR o PIN)
Se utilizzi già Android Studio per lo sviluppo, è molto semplice, perché le versioni moderne dell'IDE (da Android Studio Bumblebee in poi) includono Un assistente grafico per associare dispositivi fisici tramite Wi-Fi utilizzando un codice QR o un codice numericoNon dovrai praticamente digitare alcun comando.
Con il progetto aperto, vai su Android Studio per Apri Gestione dispositivi e poi la scheda Fisico per visualizzare i tuoi dispositivi fisici.In alto troverai l'opzione Associa tramite Wi-Fi o Associa dispositivi tramite Wi-Fi, a seconda della versione.
Cliccando su questa opzione si apre una finestra pop-up con due schede: Associa tramite codice QR e Associa tramite codice di associazioneLa scheda predefinita è solitamente quella del codice QR, in cui è già visualizzato un codice QR pronto per essere scansionato.
Quel codice QR non è magia nera: Android Studio genera internamente un profilo di connessione Wi-Fi e dati di associazione codificati nel codice QR.Se lo scansionassi con un altro lettore, vedresti che si tratta di una configurazione specifica, ma non dovresti usare lettori di terze parti per connettere il telefono; la scansione deve essere eseguita dal menu di debug wireless di Android stesso.
Sul tuo telefono, con le Opzioni sviluppatore abilitate, vai su Debug wireless e tocca Associa dispositivo con codice QRSi aprirà la fotocamera in modalità scanner. Inquadra il codice QR che Android Studio visualizza sul tuo computer e attendi qualche secondo affinché il processo di associazione venga completato.
Se tutto va bene, Il dispositivo mobile verrà associato alla tua postazione di lavoro senza che tu debba digitare un solo comando.Android ricorderà il dispositivo come dispositivo collegato e in Android Studio il telefono apparirà nell'elenco dei dispositivi fisici pronti per eseguire e debuggare le app.
È possibile che l'associazione del codice QR non vada a buon fine o si blocchi su "dispositivo di associazione...". In tal caso, passeremo all'altra scheda: Abbinare utilizzando il codice di associazione, che utilizza un codice numerico a sei cifre per completare la sincronizzazioneQuesto metodo è solitamente più affidabile in caso di problemi di rete o di problemi con il lettore QR.
Associa ADB wireless con codice di sincronizzazione (nessun codice QR)
Quando il lettore QR fallisce, il piano B consiste nel Utilizzare un codice di associazione a sei cifre insieme a un indirizzo IP e una porta, che Android visualizza nella schermata di debug wireless.
Sul tuo telefono, torna su Impostazioni > Opzioni sviluppatore > Debug wireless e tocca l'opzione Collega con codice di sincronizzazione o Associa dispositivo con codice di associazioneApparirà una finestra con un campo che mostra qualcosa come 192.168.XY:PORT e un codice numerico di sei cifre. Queste informazioni sono sensibili, quindi è meglio non condividerle con nessuno.
Mantenendo aperta questa schermata sul tuo dispositivo mobile, passa al PC e in Android Studio, all'interno della procedura guidata di associazione Wi-Fi, seleziona la scheda Associare utilizzando il codice di associazione e premere il pulsante Associa per immettere il codiceAndroid Studio inizierà a cercare i dispositivi in attesa di essere associati.
Quando il telefono viene rilevato, l'assistente ti chiederà di Inserisci lo stesso codice di sei cifre che vedi sullo schermo del tuo Android in Android StudioDopo la conferma, l'associazione è completa e il dispositivo diventa disponibile per l'installazione e il debug wireless.
Una volta associato, puoi aprire la scheda Terminale in Android Studio per avviare i comandi adb come se fosse una normale consoleL'unica differenza è che, se non hai aggiunto platform-tools alla variabile d'ambiente PATH, dovrai passare manualmente alla cartella in cui si trova il binario adb (ad esempio, %LOCALAPPDATA%\Android\SDK\platform-tools su Windows).
Tieni presente che, anche se l'abbinamento persiste, La connessione wireless potrebbe interrompersi se il dispositivo cambia rete Wi-Fi, perde il segnale o il router blocca le connessioni P2P.In questi casi, è sufficiente ricollegare il dispositivo da Android Studio o ripetere la procedura di associazione se è stato dimenticato.
Utilizzo di ADB senza Android Studio: riga di comando e associazione manuale
Se preferisci utilizzare direttamente il terminale o se il tuo PC non gestisce bene Android Studio, puoi anche... Utilizza il debug wireless di Android 11+ direttamente dalla riga di comando con `adb pair` e `adb connect`È perfetto per Windows, macOS o Linux senza IDE.
Dopo aver abilitato il debug wireless sul tuo dispositivo mobile, accedi allo stesso menu e tocca Collega il dispositivo con il codice di sincronizzazioneVedrai l'indirizzo IP e la porta di associazione, oltre al famoso codice a sei cifre. Lascialo sullo schermo.
Sul tuo computer, apri un terminale e vai alla cartella in cui hai adb, di solito android_sdk/platform-tools o C:\Users\YOUR_USER\AppData\Local\Android\Sdk\platform-tools su WindowsSe si desidera evitare di scrivere ogni volta quel percorso, è possibile aggiungerlo in un secondo momento alla variabile Path del sistema.
Ora esegui il seguente comando nella console coppia adb ip:porta, sostituendo ip:port con ciò che ti mostra il tuo cellulare, ad esempio adb pair 192.168.1.23:37119. Il programma ti chiederà quindi di inserire il codice di associazione a sei cifre.
Se il codice è corretto e la rete è configurata correttamente, Il dispositivo verrà associato, ma manca ancora una cosa: la connessione ADB effettiva che verrà utilizzata per installare e eseguire il debug delle app.Nella stessa schermata Android Wireless Debugging, nella parte superiore, vedrai un altro indirizzo IP:porta, associato al nome del tuo dispositivo.
Il secondo indirizzo IP con porta è la chiave: È necessario utilizzarlo con il comando `adb connect ip:port` per stabilire la connessione ADB attivaAd esempio, adb connect 192.168.1.23:5555. Se tutto è a posto, il dispositivo apparirà nell'elenco dei dispositivi adb come "dispositivo".
Non sorprenderti se, ogni volta che vuoi riconnetterti da zero, devi Ripetere il processo di associazione con il codice e quindi eseguire adb connect utilizzando il nuovo IP:portaIn molti casi, anche se Android mostra che il computer è già associato, è consigliabile ripetere i passaggi di generazione del codice per evitare errori di rilevamento mDNS.
Configurare il percorso ADB in Windows per un utilizzo più semplice
Lavorare con ADB diventa macchinoso se devi Digitare il percorso completo di platform-tools o cd per accedere alla cartella ogni volta che si apre il prompt dei comandiLa soluzione ideale è aggiungere quella cartella alla variabile d'ambiente Path di Windows.
In Windows 10 o 11, utilizzare la ricerca del menu Start per accedere "Modifica le variabili di ambiente del sistema" o "Modifica le variabili di ambiente per il tuo account"Si aprirà una finestra con due sezioni: Variabili utente e Variabili di sistema.
In alto, sotto Variabili utente, seleziona Percorso e premi Modifica > Nuovo per aggiungere una voce con il percorso completo alla cartella platform-toolsAd esempio, C:\Utenti\nome_utente\AppData\Local\Android\Sdk\platform-tools. Accettare tutte le finestre di dialogo per salvare le modifiche.
Da quel momento in poi, se apri un nuovo prompt dei comandi o una finestra di PowerShell, sarai in grado di Esegui i comandi adb da qualsiasi percorso senza dover specificare la cartellaCiò è particolarmente utile quando si scrivono script o si combina adb con altri strumenti.
Per verificare che tutto sia corretto, basta digitare dispositivi adb e verificare che il sistema riconosca il binario ed elenchi i dispositivi connessi (tramite USB o Wi-Fi). Se ricevi un errore "comando non riconosciuto", verifica che il percorso sia stato digitato correttamente e che sia stata aperta una nuova finestra della console dopo aver modificato il percorso.
Metodo classico: ADB tramite Wi-Fi dopo una connessione USB iniziale (Android 10 e precedenti)
Sebbene Android 11 e le versioni successive abbiano il proprio sistema di associazione wireless, Il vecchio trucco di abilitare ADB tramite TCP/IP sulla porta 5555 è ancora perfettamente validoÈ l'unica opzione Wi-Fi pura su Android 10 e versioni precedenti e funziona anche su Android 11+ se preferisci questo approccio.
La procedura è semplice: per prima cosa, assicurati che PC e cellulare condividono la stessa rete Wi-Fi e collegano il telefono al computer tramite un cavo USBAbilitare il debug USB nelle Opzioni sviluppatore e accettare la chiave RSA del computer quando viene visualizzata la finestra di dialogo.
Dal terminale del tuo computer, usa Eseguire `adb devices` per verificare che il dispositivo venga visualizzato come "device" e che la connessione USB funzioni.Se non è presente nell'elenco o risulta offline, sarà necessario controllare i driver, il cavo o la porta.
Quando il telefono risponde correttamente, eseguire il comando `adb tcpip 5555` per dire ad adbd di iniziare ad ascoltare le connessioni TCP sulla porta 5555Se il comando ha esito positivo, è possibile scollegare il cavo USB dal telefono cellulare.
Sul tuo telefono, vai su Impostazioni > Info sul telefono > Stato > Indirizzo IP (o la sezione Wi-Fi specifica) e prendi nota Indirizzo IP interno del dispositivo, nello stile 192.168.xxSuccessivamente, nella console del computer, utilizzare adb connect ip_address:5555, ad esempio adb connect 192.168.1.50:5555.
Se tutto è corretto, `adb devices` ora mostrerà l'indirizzo IP: 5555 come "dispositivo" e avrai ADB attivo tramite Wi-Fi anche sulle versioni più vecchie di Android.Tieni presente, però, che se cambi rete o riavvii il telefono, probabilmente dovrai ripetere il processo USB + tcpip.
Automatizza ADB tramite Wi-Fi sul tuo dispositivo mobile utilizzando Termux e Tasker
Per gli utenti molto avanzati che vogliono portare le cose al livello successivo, c'è la possibilità di Automatizza l'attivazione ADB tramite Wi-Fi direttamente dal tuo telefono utilizzando Termux e Taskerin modo che ogni volta che si avvia il telefono cellulare, venga attivato il server di debug wireless.
L'idea generale prevede l'installazione Termux (il migliore di F-Droid perché ha un repository aggiornato), il plugin Termux:Tasker e l'app TaskerAll'interno di Termux, il pacchetto android-tools viene aggiunto con pkg install android-tools per rendere disponibile il binario adb sul telefono stesso.
Quindi la struttura delle cartelle viene creata in Termux .termux/tasker e al suo interno scrivi script come adb.sh e adb_pair.shche accettano parametri host e codice ed eseguono comandi come adb connect, adb tcpip 5555, adb pair o adb kill-server direttamente nell'ambiente Termux.
Su Android, Tasker deve avere l'autorizzazione speciale di "Esegui comandi nell'ambiente Termux" in modo da poter avviare quegli script quando vengono soddisfatte determinate condizioni.Una volta fatto, vengono importati i profili Tasker che attivano il Wi-Fi ADB quando il cellulare è sbloccato, ottengono la porta di debug tramite i log Logcat e si connettono automaticamente.
I profili tipici includono quello che Inizializza una variabile di stato all'avvio del dispositivo, un'altra che abilita il debug WLAN dopo un certo tempo di avvio e una terza che analizza i registri, estrae la porta e chiama gli script Termux per connettersi e passare a tcpip 5555Sebbene per la maggior parte delle persone si tratti di una soluzione più da nerd che pratica, dimostra il potenziale del debug wireless.
Per l'associazione iniziale tramite codice, è possibile configurare un profilo Tasker in modo che, quando si tiene premuto il tasto volume su mentre la finestra di associazione del dispositivo con il codice è visualizzata sullo schermo, Invia automaticamente a Termux l'indirizzo IP, la porta e il codice per eseguire adb pair dal telefono stesso.Una volta associato, il profilo viene disattivato perché non è più necessario ripeterlo costantemente.
Principali comandi ADB utili quando si lavora tramite Wi-Fi
Una volta stabilita la connessione, tutta la potenza di ADB è disponibile come se fossi collegato tramite USB, quindi è bene essere chiari su Alcuni dei comandi più comuni per sfruttare il debug wireless.
Per vedere quali dispositivi sono connessi, il comando base è `adb devices -l` elenca ogni istanza con il suo numero di serie, lo stato e una breve descrizione.Se il dispositivo è in modalità wireless, solitamente verrà visualizzato con il suo indirizzo IP:porta.
Se hai più dispositivi contemporaneamente, fisici o emulatori, puoi indirizzare i comandi a uno specifico con comando adb -s serial_number oppure imposta la variabile di ambiente ANDROID_SERIALEsistono anche le scorciatoie -d per "l'unico dispositivo fisico" e -e per "l'unico emulatore" quando ce n'è solo uno per tipo.
Per installare un'app da un APK utilizzerai adb install path_to_apk, o adb install-multiple se si tratta di più APK divisiDurante la disinstallazione, `adb uninstall package.name` rimuove l'app, con l'opzione `-k` per preservare i dati utente.
Per quanto riguarda la manipolazione dei file, hai `adb push archivo_local ruta_remota` per inviare file al dispositivo mobile e `adb pull ruta_remota carpeta_local` per portarli al computerÈ molto utile se abbinato a screenshot o registri.
Per accedere al sistema del dispositivo, c'è il classico adb shell, che apre una shell interattiva sul dispositivo mobile con strumenti simili a UnixDa lì puoi avviare am (Activity Manager) per avviare attività, servizi o inviare intenti, e pm (Package Manager) per elencare, abilitare o disabilitare pacchetti e autorizzazioni.
Funzionalità avanzate: screenshot, registrazione dello schermo e altre utilità
ADB non si limita all'installazione e alla disinstallazione di app; facilita anche una serie di attività di supporto molto potenti che Hanno ancora più senso se puoi usarli senza dover collegare il telefono al computer tramite un cavo..
Per fare uno screenshot, il comando di base è adb shell screencap /sdcard/screen.png e poi adb pull /sdcard/screen.png per portarlo sul PCPuoi anche usare `adb exec-out screencap -p > screen.png` per salvarlo direttamente sul tuo computer locale in una volta sola.
Se vuoi registrare un video, hai lo strumento `adb shell screenrecord /sdcard/demo.mp4`, che per impostazione predefinita catturerà lo schermo del dispositivo in un file MP4 della durata massima di 3 minuti.Una volta terminato, puoi scaricarlo con `adb pull`. Screenrecord ti consente di regolare la risoluzione, il bitrate e il tempo massimo con parametri come `--size`, `--bit-rate` o `--time-limit`.
Un'altra funzione molto potente è la inoltro delle porte con adb forward tcp:host_port tcp:device_port o verso destinazioni speciali come local:logdche è ottimo per il debug dei servizi mobili interni, il test delle API locali o l'ispezione del traffico.
Se in qualsiasi momento ADB inizia a comportarsi in modo strano, non risponde o smette di vedere i dispositivi, puoi Riavviare il server con `adb kill-server` e quindi riavviarlo implicitamente quando si esegue un comando adb.In questo modo si risolvono molti problemi specifici senza dover intervenire su nient'altro.
Infine, per sviluppi molto intensivi, potresti essere interessato a Modalità burst di ADB 36.0.0, che viene attivata con la variabile di ambiente ADB_BURST_MODE=1 o dalle impostazioni di Android StudioMigliora le prestazioni nei trasferimenti di grandi dimensioni e riduce la latenza consentendo ad ADB di inviare pacchetti senza dover attendere a lungo ogni risposta.
Tra il debug wireless integrato in Android 11 e versioni successive, l'associazione tramite QR o PIN, i metodi TCP/IP classici e l'intero arsenale di comandi e utilità offerti dallo strumento stesso, Oggi puoi lavorare con il tuo dispositivo Android dal computer in modo estremamente flessibile e, soprattutto, senza dover dipendere da un cavo che sembra sempre comparire quando meno ne hai bisogno..
