Installa un APK dal Mac ed esegui il debug di Android — con o senza terminale

Dietro l'espressione «installare APK da Mac» si nascondono due attività completamente diverse, e la maggior parte delle guide ne affronta solo una. Questa pagina risponde a entrambe, poi affronta ciò su cui ci si blocca davvero dopo: leggere il logcat e far sì che macOS veda il telefono. Ogni passaggio qui sotto funziona con semplici comandi adb; dove un'interfaccia grafica fa davvero risparmiare lavoro, diciamo esattamente che cosa fa e che cosa non fa. Aggiornato ad agosto 2026.

Prima di tutto: vuoi l'app sul Mac o sul telefono?

I risultati di ricerca per questa espressione sono divisi a metà e i primi posti coprono solo una delle due. Gli articoli che rispondono con «installa BlueStacks / NoxPlayer / LDPlayer» stanno rispondendo alla prima domanda: eseguire software Android su macOS stesso. Per questo serve un emulatore e, su Apple Silicon, le opzioni realistiche sono l'emulatore incluso in Android Studio (gratuito, immagini di sistema arm64) oppure prodotti in stile Google Play Games on PC, non i vecchi emulatori x86.

Se invece hai un telefono o un tablet sulla scrivania e un file .apk nella cartella Download, non ti serve alcun emulatore. Ti servono ADB — l'Android Debug Bridge — e un cavo. Di questo parla il resto della pagina.

1. Vuoi eseguire l'app sul Mac stesso → usa un emulatore; nulla di quanto segue si applica.
2. Vuoi installare l'app su un dispositivo Android fisico collegato al Mac → continua a leggere.

Passo zero: attiva il debug USB (questa parte si fa sul telefono)

Nessuna app per Mac può attivare questo interruttore al posto tuo: Android richiede deliberatamente che venga abilitato a mano sul dispositivo e che la prima connessione sia confermata sullo schermo del telefono. Chi sostiene il contrario si sbaglia.

A differenza di Windows, macOS non richiede driver USB. Quando un dispositivo non compare, la causa è quasi sempre un cavo solo-ricarica, un hub USB o una finestra di autorizzazione mai confermata.

1. Impostazioni → Info sul telefono → tocca sette volte Numero build.
2. Torna indietro in Impostazioni → Sistema → Opzioni sviluppatore → attiva Debug USB.
3. Collega il telefono al Mac con un cavo che trasmetta dati, direttamente e non tramite un hub.
4. Sul telefono conferma «Consentire il debug USB?» e spunta «Consenti sempre da questo computer».

La via del terminale: adb install

È il metodo classico e vale la pena conoscerlo anche se poi userai un'interfaccia grafica. Homebrew installa gli stessi binari platform-tools distribuiti da Google.

Gli errori più comuni, in chiaro: INSTALL_FAILED_UPDATE_INCOMPATIBLE significa che un'app con quel nome di pacchetto è già installata ma firmata con una chiave diversa: disinstallala prima. INSTALL_FAILED_VERSION_DOWNGRADE si risolve aggiungendo -d. «adb: no devices/emulators found» significa che il passaggio di autorizzazione descritto sopra non è andato a buon fine.

1. brew install --cask android-platform-tools
2. adb devices — il numero di serie deve comparire come device, non come unauthorized o offline.
3. adb install -r ~/Downloads/app.apk (l'opzione -r reinstalla sopra una copia esistente, mantenendo i dati).
4. Attendi Success; qualsiasi riga che inizi con INSTALL_FAILED_ è il vero messaggio di errore.

La via senza terminale: trascina l'APK su una finestra

Se non hai intenzione di vivere nel terminale, l'installazione con Homebrew, le modifiche al PATH e il balletto di cd platform-tools sono solo lavoro in più. Super ADB Manager include adb e il server scrcpy dentro l'app, quindi non c'è nulla da installare a parte e nulla da aggiornare separatamente.

È gratuita, non richiede un account, non mostra pubblicità e la telemetria è disattivata per impostazione predefinita. L'app è firmata e notarizzata da Apple, quindi si apre normalmente invece di costringerti al trucco del clic destro → Apri che serve per gli strumenti non firmati scaricati dai siti aggregatori di download.

1. Scarica il DMG, trascina l'app in Applicazioni e aprila.
2. Collega il telefono e conferma la richiesta di debug USB (come sopra).
3. Seleziona il dispositivo, apri la scheda App, poi premi Installa APK oppure trascina il file .apk direttamente sulla finestra.
4. La stessa scheda elenca i pacchetti installati e permette di avviarli, riportare l'APK sul Mac, cancellare i dati o disinstallare.

APK split: base.apk più i file di configurazione

Tutto ciò che scarichi da APKMirror come App Bundle, o che esporti con SAI, arriva sotto forma di più file: base.apk più split_config.arm64_v8a.apk, split_config.xxhdpi.apk, gli split delle lingue e così via. Installare solo base.apk produce un'app che va in crash all'avvio o che non mostra alcuna risorsa.

Tutte le parti devono provenire dalla stessa build e avere la stessa firma; mescolare versioni diverse non funziona. Se hai un contenitore .xapk o .apks, decomprimilo prima — sono entrambi archivi ZIP — poi installa insieme le parti estratte.

1. Terminale: adb install-multiple -r base.apk split_config.arm64_v8a.apk split_config.xxhdpi.apk
2. Interfaccia grafica: nel selettore file scegli tutte le parti in una volta, oppure trascinale sulla finestra tutte insieme — l'app esegue install-multiple al posto tuo e mostra il numero di parti durante l'installazione.

Leggere il logcat su Mac senza Android Studio

adb logcat funziona benissimo da solo e per una caccia rapida a un crash la riga di comando spesso basta. Il problema è la lettura prolungata: il logcat grezzo produce migliaia di righe al minuto da tutti i processi del dispositivo.

Il panorama delle interfacce grafiche qui è scarno e per lo più fermo da anni. I visualizzatori di logcat più noti su macOS sono un progetto Objective-C vecchio di dieci anni con i suoi fork, uno strumento in Tcl/Tk e un paio di utility più recenti in Rust in stile terminale; esiste un'unica opzione commerciale a pagamento. Tutti danno per scontato che sia tu a installare e mantenere i platform-tools, e la maggior parte non è firmata: su macOS 13 e successivi questo significa litigare con Gatekeeper prima di vedere una sola riga.

In Super ADB Manager la scheda Logcat trasmette in diretta dal dispositivo selezionato con un filtro per priorità (Tutti / Info+ / Avvisi+ / Errori / Fatali), filtri predefiniti per Crash, Rete, Sistema e per l'app attualmente in primo piano, ricerca testuale libera, codifica a colori, scorrimento automatico e pulizia. Un limite dichiarato onestamente: la vista tiene in memoria le ultime 2000 righe, quindi è una finestra di debug dal vivo, non un archivio per sessioni lunghe — per una cattura completa reindirizza adb logcat su un file.

1. adb logcat -v time — timestamp leggibili.
2. adb logcat *:E — solo errori e messaggi fatali.
3. adb logcat --pid=$(adb shell pidof -s com.example.app) — l'output di una sola app.
4. adb logcat -c — svuota il buffer prima di riprodurre un bug.
5. adb logcat -v time > ~/Desktop/session.log — cattura tutto in un file.

Quando il Mac non vede il dispositivo

Non esiste una pagina di risoluzione dei problemi specifica per macOS che sia curata e aggiornata, quindi ecco la lista di controllo nell'ordine che risolve davvero. Su alcuni modelli Samsung, Xiaomi e Honor bisogna anche cambiare la modalità USB da «Solo ricarica» a «Trasferimento file» nel pannello delle notifiche prima che ADB si colleghi.

Se adb devices mostra il numero di serie con la parola unauthorized, il telefono è collegato e funziona: manca soltanto la finestra di conferma, oppure è stata negata in precedenza. Revocare le autorizzazioni la fa ricomparire.

1. Cambia il cavo. I cavi USB-C solo per la ricarica sono in assoluto la causa più frequente.
2. Collega direttamente al Mac; evita hub, dock e porte dei monitor.
3. adb kill-server e poi adb devices per riavviare il demone.
4. Opzioni sviluppatore → Revoca autorizzazioni debug USB, poi scollega e ricollega il cavo.
5. system_profiler SPUSBDataType | grep -i -A4 android — se qui non compare nulla, il problema è di hardware o di cavo, non di ADB.

Debug wireless e dispositivi che non parlano ADB

Android 11 e versioni successive supportano l'accoppiamento via Wi-Fi con un codice a sei cifre, davvero utile quando la porta USB è occupata o il dispositivo è montato in un banco di prova. La porta di accoppiamento mostrata sul telefono è temporanea e diversa dalla porta di connessione. Le due macchine devono trovarsi sulla stessa sottorete: le reti Wi-Fi aziendali con isolamento dei client lo bloccano del tutto. Nell'app, il pannello Wireless analizza la rete tramite mDNS e accetta il codice di accoppiamento; mentre un dispositivo è collegato via USB, Scorciatoie → Passa a wireless esegue tutto il passaggio con un solo clic.

A parte questo, non tutti i dispositivi parlano ADB. I Kindle e molte fotocamere o lettori multimediali espongono la memoria solo via MTP, e Google ha dismesso Android File Transfer, che però continua a essere consigliato ovunque sul web. Super ADB Manager include una sezione Dispositivi MTP che permette di sfogliare e trasferire file su quei dispositivi senza ADB. Avvertenza: la sessione MTP può cadere se il dispositivo viene scollegato o espulso durante un trasferimento, e per riprendere occorre riconnettersi.

Requisiti e limiti, detti chiaramente: versione 0.6.0, solo Apple Silicon, macOS 13 Ventura o successivo, circa 27 MB, notarizzata. La registrazione dello schermo si appoggia a screenrecord di Android e non funziona su alcuni dispositivi HONOR e Huawei. È uno strumento di gestione dei dispositivi e di lettura dei log, non un sostituto del debugger di Android Studio: qui non ci sono breakpoint né ispezione delle variabili.

1. Telefono: Opzioni sviluppatore → Debug wireless → Accoppia dispositivo con codice di accoppiamento.
2. Mac: adb pair 192.168.1.20:41234 e poi inserisci il codice a sei cifre.
3. adb connect 192.168.1.20:5555 per collegarti e lavorare normalmente con ADB.
4. Oppure usa il pannello Wireless dell'app: analizza la rete, tocca il dispositivo, digita il codice.

Domande frequenti

Altre guide