ADB su Mac: installare Platform-Tools e verificare il collegamento del dispositivo

Per usare adb su Mac, non è necessario installare l'intero Android Studio. Per la riga di comando è sufficiente il pacchetto ufficiale Android SDK Platform-Tools per Mac. Se Studio gestisce già il tuo Android SDK, Google consiglia di ottenere Platform-Tools tramite SDK Manager, anziché creare un'altra copia indipendente.

Questa guida si basa sulla documentazione Google e non è un resoconto di una prova pratica: i passaggi non sono stati verificati su un Mac e un dispositivo Android. I comandi riportati di seguito sono destinati all'esecuzione sul tuo Mac con il tuo dispositivo; qui non sono presenti risultati di esecuzione né screenshot.

1. Scegli un'unica fonte di installazione

Se Android Studio è già installato

Apri Tools > SDK Manager. Nella scheda SDK Tools, seleziona Android SDK Platform-Tools, quindi Apply oppure OK e leggi le condizioni di licenza. Annota il valore di Android SDK Location: il programma adb installato si trova nella sottocartella platform-tools di quello specifico SDK.

Nella documentazione Google, android_sdk/platform-tools/ indica la cartella del tuo SDK, non un percorso letterale da incollare nel Terminale. Non dare per scontato che l'SDK si trovi necessariamente nella cartella predefinita: fai riferimento a SDK Manager. Istruzioni Google per SDK Manager.

Se ti serve solo adb

Apri la pagina ufficiale di Platform-Tools, seleziona Download SDK Platform-Tools for Mac, leggi le condizioni dell'Android SDK License Agreement e scarica il file ZIP. Estrai l'archivio e conserva la cartella platform-tools in una posizione permanente a tua scelta. Non eseguire la versione per Windows o Linux.

Nel Terminale, digita cd seguito da uno spazio, trascina la cartella platform-tools estratta dal Finder nella finestra del Terminale e premi Invio. In questo modo passerai alla cartella effettiva senza inserire il nome utente di qualcun altro o un percorso inventato. Quindi verifica:

./adb version

Il prefisso ./ significa «esegui adb dalla cartella corrente». La sola presenza del file in questa cartella non significa che il comando adb senza prefisso venga trovato tramite PATH. Per le prime verifiche non è necessario aggiungere la cartella al PATH globale.

Google fornisce un file ZIP separato per la riga di comando senza Studio; il pacchetto ufficiale è distribuito secondo le condizioni dell'SDK, non con una generica «licenza gratuita senza restrizioni». Fonte e condizioni di download.

La scheda di Platform-Tools su OpenNavo raccoglie informazioni sul pacchetto. Al momento della stesura di questo articolo, la raccomandazione nel catalogo è sospesa. Questo è lo stato su OpenNavo, non un'affermazione secondo cui Google abbia smesso di distribuire gli strumenti: il file ZIP ufficiale per Mac è ancora elencato nella pagina Google. Questa guida utilizza la fonte ufficiale, senza modificare lo stato della scheda.

2. Verifica quale copia di adb stai eseguendo

Se vuoi eseguire adb da qualsiasi cartella, esegui:

which -a adb
adb version

which -a adb aiuta a visualizzare le copie trovate nel PATH; adb version mostra la versione del client eseguito. Confronta i percorsi trovati con la cartella scelta nel passaggio precedente. Queste verifiche hanno scopi diversi: conoscere la versione, da solo, non dimostra che tu stia usando l'installazione desiderata.

Se il comando non viene trovato, torna nella cartella platform-tools scelta e usa ./adb version. Anche per i comandi successivi di questo articolo, sostituisci quindi l'elemento iniziale adb con ./adb: per esempio, ./adb devices -l. Questa modalità funziona anche per la cartella installata tramite SDK Manager.

Se vengono rilevate più installazioni, determina prima quale sia necessaria per il tuo SDK o per il tuo flusso di lavoro. Non eliminare altre copie e non riscrivere le impostazioni della shell a caso. I client adb si collegano a un server comune sulla porta TCP locale 5037, quindi la scelta del file del client e lo stato del server già in esecuzione non sono la stessa cosa. Per questa guida è sufficiente usare in modo coerente la copia scelta. Come funziona adb.

3. Collega il tuo dispositivo Android tramite USB

1. Su un dispositivo di tua proprietà, apri le opzioni sviluppatore e attiva USB debugging / Debug USB. Se la sezione è nascosta, segui le istruzioni Google per attivare le opzioni sviluppatore; i nomi delle voci possono variare a seconda del produttore.
2. Collega il dispositivo al Mac con un cavo in grado di trasferire dati. Sblocca lo schermo.
3. Esegui il comando che elenca i dispositivi:

adb devices -l

4. Controlla la richiesta sul dispositivo stesso. Android 4.2.2 e versioni successive richiedono la conferma della chiave RSA del computer per il debug. Autorizza l'accesso solo al tuo computer fidato e solo per un collegamento previsto; su un computer altrui non memorizzare un'autorizzazione permanente.
5. Dopo la conferma, esegui di nuovo adb devices -l.

Secondo la documentazione Google, per il rilevamento del dispositivo su macOS non è necessaria un'ulteriore configurazione del sistema operativo. Non applicare qui le istruzioni relative ai driver USB di Windows o a udev per Linux. Questo non garantisce il funzionamento con qualsiasi cavo e qualsiasi dispositivo. Collegamento USB e autorizzazione RSA.

Il comando devices elenca i dispositivi, mentre -l abilita l'output dettagliato. Il comando adb tcpip 5555 non elenca i dispositivi: modifica la modalità di ascolto del servizio sul dispositivo. Non è necessario per questa verifica USB e non va eseguito. Riferimento dei comandi adb.

4. Interpreta il risultato, non limitarti alla presenza di una riga

Di seguito sono descritti degli stati, non i risultati di test su un dispositivo specifico.

Cosa vedi	Cosa significa	Cosa verificare dopo
command not found	La shell non ha trovato il comando con quel nome	Passa alla cartella scelta e verifica con ./adb version; quindi usa ./adb devices -l
Intestazione dell'elenco senza righe di dispositivi	Questa richiesta non ha mostrato dispositivi collegati	Verifica il collegamento, il cavo per il trasferimento dati, lo sblocco del dispositivo e l'attivazione del debug USB; prova un altro cavo funzionante o un'altra porta USB
Riga con unauthorized	Il collegamento non è ancora autorizzato per il debug	Controlla lo schermo sbloccato del telefono e conferma la richiesta RSA prevista; se la richiesta non compare, scollega e ricollega il cavo USB e controlla di nuovo l'elenco
Riga con device	Il dispositivo è collegato al server adb	Verifica il numero di serie e il modello; questo non dimostra che Android abbia completato l'avvio né che i comandi successivi avranno esito positivo
Riga con offline	Il dispositivo non è collegato ad adb oppure non risponde	Verifica il collegamento e lo stato del dispositivo; non considerarlo un'autorizzazione riuscita
Più righe	Sono stati rilevati più dispositivi o emulatori	Prima del comando successivo, seleziona esplicitamente il dispositivo desiderato

Le verifiche del cavo e delle impostazioni corrispondono ai consigli Google per il collegamento USB. Se non risolvono il problema, consulta la documentazione del produttore del dispositivo; non disattivare le protezioni di macOS e non tentare di aggirare l'autorizzazione del telefono.

Google avverte espressamente che lo stato device non significa che Android abbia completato l'avvio e sia già pronto per tutte le operazioni. Stati nell'elenco dei dispositivi.

5. Se ci sono più dispositivi, selezionane uno esplicitamente

Copia il numero di serie della riga desiderata da adb devices -l. Per verificare lo stato di un dispositivo specifico, puoi usare:

adb -s SERIAL get-state

SERIAL è un segnaposto: sostituiscilo con il numero di serie effettivo del tuo dispositivo, senza digitare letteralmente questa parola. Se esegui lo strumento dalla cartella corrente, usa ./adb -s SERIAL get-state. Si tratta di una richiesta di stato, non dell'installazione di un'applicazione o della modifica di file.

Il parametro -s seleziona il dispositivo con il numero di serie indicato. Non fare affidamento sull'ordine delle righe, soprattutto quando è in esecuzione anche un emulatore. Selezione del dispositivo nella guida Google ad adb.

6. Concludi la sessione senza lasciare autorizzazioni superflue

Dopo la verifica, scollega il cavo e disattiva il debug USB se non è più necessario. Se hai autorizzato il computer per il debug futuro e vuoi revocare questa autorizzazione, usa la voce per revocare le autorizzazioni di debug USB nelle opzioni sviluppatore del dispositivo, se disponibile. Il nome e la posizione dipendono dal produttore; la revoca può interessare anche altri computer precedentemente autorizzati.

La sola chiusura del Terminale non comporta la revoca dell'autorizzazione. Non eliminare manualmente chiavi e file di servizio per questa verifica. Non pubblicare numeri di serie, impronte delle chiavi e altri identificatori del dispositivo in screenshot o resoconti.

Risposte brevi

È necessario installare Android Studio solo per adb? No. Google offre un pacchetto Platform-Tools separato per Mac. Se usi già Studio, è più comodo lasciare la gestione degli strumenti a SDK Manager.

Perché ./adb version funziona, mentre adb version no? La prima forma indica il file nella cartella corrente, mentre la seconda dipende dalla ricerca del comando da parte della shell. Per questa guida puoi continuare con ./adb, senza modificare le impostazioni globali.

device significa che è tutto pronto? Indica un collegamento con adb, non garantisce che il sistema abbia completato l'avvio, che l'applicazione funzioni o che qualsiasi comando successivo sia sicuro.

È necessario il debug wireless? No, non è richiesto per questo scenario USB. Qui non sono previsti passaggi per aprire una porta di rete o stabilire un collegamento wireless.

Fonti e limiti della verifica

• Google: SDK Platform-Tools e download per Mac.
• Google: Android Debug Bridge — autorizzazione, elenco e selezione dei dispositivi.
• Google: SDK Manager.
• Google: collegamento di un dispositivo reale e verifica USB.
• AOSP: riferimento adb.

Il materiale è stato redatto sulla base della documentazione ufficiale Google; non è stata effettuata alcuna verifica pratica su un Mac e un dispositivo Android. Qui non sono presenti risultati confermati sulle prestazioni, test di compatibilità con una specifica versione di macOS o screenshot di comandi che si pretende siano stati eseguiti.