Una guida passo passo per iniziare a utilizzare lo strumento Android Debug Bridge.
Link veloci
- Che cos'è Android Debug Bridge (ADB)?
- Come funziona l'ADB?
- Come configurare ADB
- Esempi di comandi ADB
- Cos'altro posso fare con ADB?
È possibile accedere a numerose funzionalità del sistema operativo Android solo attraverso percorsi e metodi nascosti all'utente medio. Questi sono stati generalmente eseguiti con l'aiuto di alcuni comandi della riga di comando Android Debug Bridge (ADB), uno strumento offerto da Google per gli sviluppatori per eseguire il debug di varie parti delle loro applicazioni o del sistema, ma che possiamo utilizzare per tutti i tipi di operazioni pulite e nascoste trucchi. Un prerequisito per questi trucchi è l'installazione di ADB sul tuo computer. Quindi, in questa guida, ti mostreremo come installare ADB su Windows, macOS e Linux in passaggi rapidi e facili da seguire.
Che cos'è Android Debug Bridge (ADB)?
La struttura interna dell'Android Debug Bridge (ADB) si basa sulla classica architettura client-server. Ci sono tre componenti che compongono l’intero processo.
- Il client, ovvero il PC/Mac/Chromebook che hai collegato al tuo dispositivo Android. Stiamo inviando comandi al nostro dispositivo dal computer tramite il cavo USB o in modalità wireless.
- Un demone (noto come "adbd") che esegue comandi su un dispositivo. Il demone viene eseguito come processo in background su ciascun dispositivo.
- Un server che gestisce la comunicazione tra il client e il demone. Il server viene eseguito come processo in background sul computer.
Come funziona l'ADB?
Poiché ci sono tre parti che compongono ADB (il client, il demone e il server), ciò richiede innanzitutto che alcune parti siano attive e funzionanti. Se hai appena avviato il computer (e non lo hai configurato per avviare il demone all'avvio), quindi sarà necessario che sia in esecuzione prima che qualsiasi comunicazione possa essere inviata all'Android di destinazione dispositivo. Vedrai il seguente messaggio nel prompt dei comandi o nel terminale, che controllerà per assicurarsi che il demone sia in esecuzione.
Se il demone non è in esecuzione, avvierà il processo e ti dirà su quale porta TCP locale è stato avviato. Una volta avviato, il servizio ADB continuerà ad ascoltare su quella porta specifica i comandi inviati dal client ADB. Quindi imposterà le connessioni a tutti i dispositivi in esecuzione collegati al computer (inclusi gli emulatori). Questo è il momento in cui riceverai la richiesta di autorizzazione sul dispositivo Android se il computer non è stato autorizzato in passato.
Come configurare ADB
Nota: configurare ADB sul computer è solo metà dell'equazione poiché dovrai eseguire alcune operazioni anche sullo smartphone o sul tablet per accettare i comandi ADB.
Configurazione del telefono
- Avvia il Impostazioni applicazione sul tuo telefono.
- Clicca il Info sul telefono opzione generalmente vicino alla fine dell'elenco.
- A seconda della skin OEM, il Info sul telefono la pagina può essere chiamata qualcos'altro o sepolta da qualche altra parte nel file Impostazioni sul tuo dispositivo.
- Quindi tocca Numero di costruzione opzione sette volte per abilitare la modalità sviluppatore. Al termine vedrai un messaggio di avviso popup.
- Ora torna alla schermata principale delle Impostazioni e dovresti vederne una nuova Opzioni sviluppatore menu a cui puoi accedere. Sui telefoni Google Pixel e su alcuni altri dispositivi potrebbe essere necessario accedere a Impostazioni > Sistema per trovare il Opzioni sviluppatore menù.
- Entra e abilita il file Debug USB opzione.
- Hai parzialmente completato il processo di configurazione del telefono. Successivamente, dovrai scorrere di seguito e seguire il resto delle istruzioni per il tuo particolare sistema operativo.
Come configurare ADB su Microsoft Windows
- Scarica il File ZIP degli strumenti della piattaforma Android SDK per Windows.
- Estrai il contenuto di questo file ZIP in una cartella facilmente accessibile (come C:\platform-tools).
- Aprire Esplora file e vai al punto in cui hai estratto il contenuto di questo file ZIP.
- Apri un'istanza del prompt dei comandi/terminale dalla stessa directory di questo binario ADB. Questo può essere fatto tenendo premuto Maiusc e facendo clic con il pulsante destro del mouse all'interno della cartella, quindi facendo clic Apri la finestra di comando qui O Apri la finestra di PowerShell qui. Gli utenti di Windows 11 dovrebbero vedere Apri nel terminale nel menu contestuale del tasto destro senza nemmeno premere il pulsante Maiusc sulla tastiera.
- Collega il tuo smartphone o tablet al computer con un cavo USB. Cambiare la modalità USB in modalità “trasferimento file (MTP)”. Alcuni OEM potrebbero richiederlo o meno, ma è meglio lasciarlo in questa modalità per compatibilità generale.
- Nella finestra Prompt dei comandi/Terminale, inserisci il seguente comando per avviare il demone ADB:
adb devices
- Sullo schermo del telefono, dovresti visualizzare una richiesta per consentire o negare l'accesso al debug USB. Naturalmente, vorrai concedere l'accesso al debug USB quando richiesto (e toccare la casella di controllo Consenti sempre se non vuoi mai più vedere quella richiesta).
- Infine, inserisci nuovamente il comando dal passaggio 6. Se tutto è andato a buon fine, ora dovresti vedere il numero di serie del tuo dispositivo nel prompt dei comandi (o nella finestra di PowerShell).
Ora puoi eseguire qualsiasi comando ADB sul tuo dispositivo! Ora vai avanti e inizia a modificare il tuo telefono seguendo il nostro ampio elenco di tutorial!
Come configurare ADB su macOS
- Scarica il File ZIP degli strumenti della piattaforma SDK Android per macOS.
- Estrai lo ZIP in una posizione facilmente accessibile (come ad esempio il desktop).
- Apri Terminale.
- Per accedere alla cartella in cui hai estratto ADB, inserisci il seguente comando:
cd /path/to/extracted/folder/
- Ad esempio, puoi posizionare i contenuti sul desktop:
cd /Users/XDA/Desktop/platform-tools/
- Ad esempio, puoi posizionare i contenuti sul desktop:
- Collega il tuo dispositivo al Mac con un cavo USB compatibile. Modificare la modalità di connessione USB in modalità “trasferimento file (MTP)”. Questo non è sempre necessario per tutti i dispositivi, ma è meglio lasciarlo in questa modalità per non incorrere in problemi.
- Una volta che il Terminale si trova nella stessa cartella in cui si trovano gli strumenti ADB, puoi eseguire il seguente comando per avviare il demone ADB:
./adb devices
- Sul tuo dispositivo vedrai un file Consenti il debug USB richiesta. Consenti la connessione.
- Infine, inserisci nuovamente il comando dal passaggio 7. Se tutto è andato a buon fine, ora dovresti vedere il numero di serie del tuo dispositivo nella finestra Terminale di macOS.
Congratulazioni! Ora puoi eseguire qualsiasi comando ADB sul tuo dispositivo! Ora vai avanti e inizia a modificare il tuo telefono.
Sebbene la guida di cui sopra funzionerà sicuramente, gli utenti macOS veterani possono anche scegliere di installare ADB sui propri Mac utilizzando un gestore di pacchetti non ufficiale come Birra fatta in casa O MacPort. In questo modo, non è necessario aggiornare manualmente i file binari.
Come configurare ADB su Linux
- Scarica il File ZIP degli strumenti della piattaforma Android SDK per Linux.
- Estrai lo ZIP in una posizione facilmente accessibile (come ad esempio il desktop).
- Apri una finestra di Terminale.
- Immettere il seguente comando:
cd /path/to/extracted/folder/
- Ciò cambierà la directory in cui hai estratto i file ADB.
- Esempio:
cd /home/XDA/Desktop/platform-tools/
- Esempio:
- Collega il tuo dispositivo alla tua macchina Linux con il cavo USB. Modificare la modalità di connessione in modalità “trasferimento file (MTP)”. Questo non è sempre necessario per tutti i dispositivi, ma è consigliato per non incorrere in problemi.
- Una volta che il Terminale si trova nella stessa cartella in cui si trovano gli strumenti ADB, puoi eseguire il seguente comando per avviare il demone ADB:
./adb devices
- Tornando al tuo smartphone o tablet, vedrai un messaggio che ti chiede di consentire il debug USB. Vai avanti e concedilo.
- Infine, inserisci nuovamente il comando dal passaggio 8. Se tutto è andato a buon fine, ora dovresti vedere il numero di serie del tuo dispositivo nell'output della finestra Terminale.
Congratulazioni! Ora puoi eseguire qualsiasi comando ADB sul tuo dispositivo!
Gli utenti Linux dovrebbero sapere che esiste un modo più semplice per installare ADB sui propri computer. La guida sopra funzionerà sicuramente per te, ma per coloro che possiedono una versione tradizionale di Debian/Ubuntu o La distribuzione Linux basata su Fedora/SUSE può saltare i passaggi 1 e 2 della guida sopra e utilizzare uno dei seguenti comandi:
- Gli utenti Linux basati su Debian/Ubuntu possono digitare il seguente comando per installare ADB:
sudo apt-get install android-sdk-platform-tools
- Gli utenti Linux basati su Fedora/SUSE possono digitare il seguente comando per installare ADB:
sudo dnf install android-tools
Tuttavia, è sempre meglio optare per l'ultimo binario della versione Android SDK Platform Tools, poiché i pacchetti specifici della distribuzione spesso contengono build obsolete.
Caso speciale: come configurare ADB sul sottosistema Windows per Linux e ChromeOS
Sottosistema Windows per Linux (WSL) offre agli utenti Windows un modo semplice per eseguire app Linux. Tuttavia, l'ambiente deve ancora offrire un accesso hardware USB completo. Di conseguenza, ADB sotto WSL non può accedere al tuo dispositivo Android, anche se lo installi utilizzando il metodo sopra menzionato. Tuttavia, esiste una soluzione ufficiale che utilizza l'open source usbipd-win progetto. Per saperne di più, dai un'occhiata al nostro tutorial su come impostare il passthrough USB in WSL.
Per ChromeOS, è necessario attivare l'ambiente di sviluppo Linux integrato Primo. Per impostazione predefinita, ti offre un'istanza Debian. Puoi quindi configurare facilmente ADB utilizzando i passaggi sopra menzionati.
Giusto per coprire tutte le nostre basi qui, gli utenti potrebbero dover inserire a ./ davanti ai comandi ADB che elencheremo nei tutorial futuri, soprattutto quando utilizzano i file binari estratti direttamente dallo ZIP degli strumenti della piattaforma fornito da Google. Questo è qualcosa che probabilmente saprà qualsiasi utente *nix (o utente Windows che esegue PowerShell/Terminal), ma ancora una volta, vogliamo come quante più persone possibile per capire come eseguire queste modifiche per Android, indipendentemente dal tuo sistema operativo Sapere.
Facoltativo: come configurare ADB sul tuo browser
A tal fine, il protocollo ADB può essere implementato utilizzando l'API WebUSB controllare i telefoni Android direttamente dai browser web. Ancora un altro WebADB, alias ya-webadb, è uno di questi progetti che consente agli utenti di eseguire la maggior parte delle funzionalità fornite da ADB direttamente dal browser web senza installare alcun binario o driver. Tutto ciò di cui hai bisogno è un browser web che supporti l'API WebUSB (come Google Chrome, Microsoft Edge o Firefox) e sei a posto.
Facoltativo: come utilizzare ADB tramite Wi-Fi
Android 11 e le edizioni successive supportano nativamente la connessione ADB tramite Wi-Fi. Ciò elimina la necessità di gestire problemi comuni di connessione USB e passaggi aggiuntivi come Installazione del driver Android OEM Su Windows.
Per impostare il debug wireless, procedi come segue:
- Assicurati che il tuo PC/Mac e il telefono siano connessi alla stessa rete wireless.
- Sul tuo telefono, vai a Opzioni sviluppatore Sotto Impostazioni e abilitare Debug wireless. Sul Consentire il debug wireless su questa rete? popup, seleziona Permettere.
- Tocca il Debug wireless opzione e selezionare Associa il dispositivo con il codice di abbinamento.
- Prendere nota del codice di accoppiamento, dell'indirizzo IP e del numero di porta visualizzati sullo schermo del telefono.
- Sul tuo PC/Mac, esegui il seguente comando:
Utilizzare l'indirizzo IP e il numero di porta del passaggio 4.adbpairIP_Address:Port
- Quando richiesto, inserisci il codice di accoppiamento ricevuto al passaggio 4. Un messaggio dovrebbe indicare che il tuo dispositivo è stato accoppiato con successo.
- Successivamente, esegui il seguente comando nella finestra del terminale del PC/Mac:
Guarda al Indirizzo IP e porta sezione sotto Debug wireless al punto 3 per l'indirizzo IP e la porta.adbconnectIP_Address:Port
- Se tutto va bene, dovresti vedere un messaggio come il seguente:
connectedto 192.168.68.100:37173
- Ora sei pronto per digitare qualunque comando della shell ADB desideri.
Esempi di comandi ADB
Per verificare se hai installato correttamente ADB, collega il tuo dispositivo al PC/Mac con il cavo USB ed esegui il file adb devices
comando come descritto sopra. Dovrebbe visualizzare il tuo dispositivo elencato nella finestra Prompt dei comandi/PowerShell/Terminale. Se ottieni un output diverso, ti consigliamo di ricominciare con i passaggi.
Come accennato in precedenza, puoi utilizzare ADB per fare ogni sorta di cose su un dispositivo Android. Alcuni di questi comandi sono integrati direttamente nel binario ADB e dovrebbero funzionare su tutti i dispositivi. Puoi anche aprire quella che viene definita ADB Shell che ti consentirà di eseguire comandi direttamente sul dispositivo. I comandi eseguiti direttamente sul dispositivo possono variare da dispositivo a dispositivo (poiché gli OEM possono rimuovere accedere ad alcuni e anche modificare il comportamento di ADB) e può variare da una versione di Android a quella successiva BENE.
Di seguito troverai un elenco di comandi di esempio che puoi eseguire sul tuo dispositivo:
- Stampa un elenco dei dispositivi collegati:
adb devices
- Uccidi il server ADB:
adb kill-server
- Installa un'applicazione:
adb install
- Configura il port forwarding:
adb forward tcp: 6100 tcp: 7100
- Copiare un file/directory dal dispositivo:
adb pull
- Copia un file/directory sul dispositivo:
adb push
- Avvia una shell ADB:
adb shell
Bonus
Per coloro che vogliono fare un ulteriore passo avanti, puoi seguire questo nuovo tutorial che abbiamo creato che ti guiderà attraverso come configurare ADB in modo da poter utilizzare il comando da qualsiasi directory su un desktop Windows o Linux.
Cos'altro posso fare con ADB?
Di seguito è riportato un elenco di tutorial XDA per vari dispositivi che descrivono in dettaglio molte applicazioni dei comandi ADB per modificare le impostazioni nascoste, personalizzare le funzionalità OEM o le interfacce utente e molto altro!
- Come avviare in modalità di ripristino utilizzando combinazioni di pulsanti, ADB e app root
- Come disinstallare il bloatware dell'operatore/OEM senza accesso root
- Come svuotare il telefono (e altro) senza collegarlo a un PC
- Come eseguire il sideload delle app su Android TV: metodi di installazione APK e sideload ADB spiegati in passaggi facili da seguire!
- Ripristina i riquadri Impostazioni rapide Wi-Fi e dati mobili in Android 12 e versioni successive
- Controlla gratuitamente il tuo smartphone Android dal tuo PC con scrcpy
- Come abbinare gli orologi Android Wear ai nuovi telefoni senza ripristinare le impostazioni di fabbrica
Questa è solo la punta dell'iceberg. Non dimenticare di controllare i nostri comandi ADB per ogni tutorial per utenti esperti per conoscere suggerimenti e trucchi più utili per l'utilizzo di ADB!