In questa guida
adb (Android Debug Bridge) è uno strumento da riga di comando che comunica con un telefono o un emulatore via USB o Wi-Fi. Non devi impararlo tutto. Una dozzina di comandi copre la maggior parte di ciò che un tester o uno sviluppatore fa ogni giorno: installare una build, resettare l'app, impostare un permesso e salvare un log per una segnalazione di bug.
Configurazione in due minuti
- Installa Android SDK Platform-Tools (contiene
adb). - Sul telefono, attiva le Opzioni sviluppatore (tocca più volte il numero build in Impostazioni > Info sul telefono), poi attiva il debug USB.
- Collega il telefono e accetta il messaggio "Consentire il debug USB?".
- Esegui
adb devices. Il tuo dispositivo dovrebbe comparire comedevice. Se diceunauthorized, accetta di nuovo il messaggio sul telefono.
Se sono collegati più dispositivi, aggiungi -s <serial> a ogni comando, usando il seriale indicato da adb devices.
Installare e rimuovere build
| Obiettivo | Comando |
|---|---|
| Installare un APK | adb install app.apk |
| Aggiornare, mantenendo i dati | adb install -r app.apk |
| Consentire il downgrade di versione (build di debug) | adb install -r -d app.apk |
| Disinstallare | adb uninstall com.example.app |
| Disinstallare mantenendo i dati | adb uninstall -k com.example.app |
Sostituisci com.example.app con il nome del tuo pacchetto. Se un'installazione fallisce, il testo dell'errore (per esempio una mancata corrispondenza della firma o un problema di version code) di solito indica la causa. Un bundle (.aab) non si installa direttamente; per i test installa gli APK generati da esso, oppure usa una traccia di test dello store.
Reimpostare lo stato
adb shell pm clear com.example.appcancella i dati e la cache dell'app, come un'installazione nuova senza reinstallare. Usalo prima di ogni test del primo avvio.adb shell am force-stop com.example.apptermina l'app. Utile per testare gli avvii a freddo.adb shell monkey -p com.example.app -c android.intent.category.LAUNCHER 1avvia l'app senza conoscere il nome dell'activity.
Permessi
- Concedere:
adb shell pm grant com.example.app android.permission.CAMERA - Revocare:
adb shell pm revoke com.example.app android.permission.CAMERA
Concedere e revocare è il modo veloce per testare sia il percorso "consentito" sia quello "negato". Si possono modificare in questo modo solo i permessi runtime che la tua app dichiara.
Log
adb logcattrasmette il log di sistema. È rumoroso; filtralo per il tuo pacchetto o per un tag.adb logcat -csvuota prima il buffer, così la registrazione parte pulita.adb logcat -d > log.txtscarica il buffer corrente in un file ed esce.
Una routine affidabile per riprodurre un bug: svuota il log, riproduci il problema una volta, scarica il log, allegalo. Vedi anche come leggere i report sui crash.
File, screenshot e registrazioni dello schermo
adb pull /sdcard/file.png .copia un file dal telefono.adb exec-out screencap -p > screen.pngsalva uno screenshot.adb shell screenrecord /sdcard/demo.mp4registra lo schermo (interrompi con Ctrl+C, poi scarica il file). Si ferma dopo un limite di tempo che dipende dal dispositivo.
Limiti
adb ti dice cosa ha fatto il dispositivo, non cosa ha provato una persona. Non può sostituire i test con persone reali su telefoni reali, ma rende molto migliori le loro segnalazioni: un log e una build esatta valgono più di "si è bloccata".
Parte della guida ai test delle app Android. Correlati: report pre-lancio della Play Console e nozioni base di Android vitals.
Vuoi un feedback su una build da persone reali? Inizia gratis e ottieni feedback privato e strutturato sulla tua app.