Eseguire app su un dispositivo hardware

Testa sempre la tua app per Android su un dispositivo reale prima di rilasciarla agli utenti. Questa pagina descrive come configurare l'ambiente di sviluppo e il dispositivo Android per i test e il debug tramite una connessione Android Debug Bridge (ADB).

Nota: utilizza l'emulatore Android per testare la tua app su diverse versioni della piattaforma Android e su schermi di diverse dimensioni. Valuta se utilizzare Firebase Test Lab per eseguire la tua app su un'ampia gamma di dispositivi reali ospitati in un'infrastruttura basata su cloud.

Configura un dispositivo per lo sviluppo

Prima di poter iniziare il debug sul dispositivo, decidi se vuoi connetterti al dispositivo tramite un cavo USB o Wi-Fi. Poi esegui le seguenti operazioni:

1. Sul dispositivo, apri l'app Impostazioni, seleziona Opzioni sviluppatore e poi attiva Debug USB (se applicabile).

   Nota: se non vedi Opzioni sviluppatore, segui le istruzioni per attivare le opzioni sviluppatore.

2. Configura il sistema in modo che rilevi il dispositivo.

   • ChromeOS: non è necessaria alcuna configurazione aggiuntiva.
   • macOS: non sono necessarie ulteriori configurazioni.
   • Windows: installa un driver USB per ADB (se applicabile). Per una guida all'installazione e i link ai driver OEM, consulta Installa i driver USB OEM.

   • Ubuntu Linux: configura quanto segue:

     • Ogni utente che vuole utilizzare ADB deve far parte del gruppo plugdev. Se visualizzi un messaggio di errore che indica che non fai parte del gruppo plugdev, aggiungiti utilizzando il seguente comando:

     sudo usermod -aG plugdev $LOGNAME
     

     I gruppi vengono aggiornati solo al momento dell'accesso, quindi devi uscire affinché questa modifica diventi effettiva. Quando accedi di nuovo, puoi utilizzare id per verificare di essere nel gruppo plugdev.

     • Nel sistema devono essere installate regole udev che coprono il dispositivo. Il pacchetto android-sdk-platform-tools-common contiene un insieme predefinito di regole udev per i dispositivi Android gestito dalla community. Per installarlo, utilizza il seguente comando:

     apt-get install android-sdk-platform-tools-common
     

Connettiti al dispositivo tramite USB

Una volta completata la configurazione e il collegamento tramite USB, fai clic su Esegui in Android Studio per creare ed eseguire l'app sul dispositivo.

Puoi anche utilizzare adb per eseguire i comandi, come segue:

• Verifica che il dispositivo sia connesso eseguendo il comando adb devices dalla directory android_sdk/platform-tools/. Se è connesso, vedrai il dispositivo nell'elenco.
• Esegui qualsiasi comando adb con il flag -d per scegliere come target il tuo dispositivo.

Connettiti al dispositivo tramite Wi-Fi

Android 11 e versioni successive supportano il deployment e il debug dell'app in modalità wireless dalla tua workstation utilizzando Android Debug Bridge (ADB). Ad esempio, puoi eseguire il deployment della tua app abilitata al debug su più dispositivi remoti senza connettere fisicamente il tuo dispositivo tramite USB e senza dover affrontare i problemi comuni di connessione USB, come l'installazione dei driver.

Android 17, insieme ad adb 37.0.0, introduce adb Wi-Fi 2.0, che risolve molti dei problemi di usabilità della versione precedente. In particolare, il dispositivo si connetterà automaticamente alla workstation quando si connette a una rete attendibile di debug wireless.

Per utilizzare il debug wireless, devi accoppiare il dispositivo alla workstation utilizzando un codice di accoppiamento. Per iniziare, completa i seguenti passaggi:

1. Assicurati che la workstation e il dispositivo siano connessi alla stessa rete wireless.
2. Assicurati che sul dispositivo sia installato Android 11 o versioni successive. Per saperne di più, consulta l'articolo Controlla e aggiorna la versione di Android.
3. Assicurati di aver installato l'ultima versione di Android Studio. Scaricalo qui.
4. Sulla tua workstation, esegui l'aggiornamento all'ultima versione degli SDK Platform Tools.

Per accoppiare il dispositivo, segui questi passaggi:

Nota: devi accoppiare il dispositivo alla workstation una sola volta. Il dispositivo rimarrà accoppiato alla tua workstation finché non lo rimuoverai esplicitamente o non revocherai le autorizzazioni di debug adb sul dispositivo. Il dispositivo e la workstation si connetteranno automaticamente quando si trovano sulla stessa rete.

1. Attiva le opzioni sviluppatore sul dispositivo.

2. Sul dispositivo, tocca Debug wireless.

   

   Figura 1. Il prompt Debug wireless su uno smartphone Google Pixel.

3. Consenti il debug wireless sulla tua rete. Tieni presente che se fai clic sulla casella di controllo Consenti sempre su questa rete, la rete diventa una rete di debug wireless attendibile. Il dispositivo consentirà sempre il debug wireless su questa rete non appena si connette alla rete.

   

   Figura 2. L'impostazione Debug wireless su uno smartphone Google Pixel.

4. Apri Android Studio e seleziona Accoppia dispositivi tramite Wi-Fi dal menu delle configurazioni di esecuzione.

   

   Figura 3. Menu Configurazioni di esecuzione.

   
   

5. Viene visualizzata la finestra di dialogo Accoppia dispositivi tramite Wi-Fi, come mostrato nella figura 4.

   

   Figura 4. Finestra di dialogo per accoppiare i dispositivi tramite Wi-Fi.

   In alternativa, puoi accoppiare il dispositivo da Gestione dispositivi. Ad esempio My Pixel.

   

   Figura 5. Gestione dispositivi con dispositivo disponibile per l'accoppiamento Wi-Fi.

   
   

6. Fai clic su Pair sul dispositivo che vuoi accoppiare. Viene visualizzata la finestra di dialogo di accoppiamento dei dispositivi.

   1. Per accoppiare il dispositivo con un codice QR, seleziona Accoppia dispositivo con codice QR e scansiona il codice QR.

      

      Figura 6. Finestra di dialogo per accoppiare il dispositivo utilizzando il codice QR.

   2. Per accoppiare il dispositivo con un codice di accoppiamento, seleziona Accoppia dispositivo con codice di accoppiamento dalla finestra di dialogo Accoppia nuovi dispositivi tramite Wi-Fi. Sul tuo dispositivo, seleziona Accoppia con codice di accoppiamento. Viene visualizzato un codice di sei cifre. Quando il tuo dispositivo viene visualizzato nella finestra Accoppia dispositivi tramite Wi-Fi, inserisci il codice di sei cifre mostrato sul dispositivo e seleziona Accoppia.

      

      Figura 7. Esempio di inserimento del codice di accoppiamento a sei cifre.

7. Dopo l'accoppiamento, puoi provare a eseguire il deployment dell'app sul dispositivo.

Per disaccoppiare la workstation, vai a Debug wireless sul dispositivo. Tocca il nome della tua workstation in Dispositivi accoppiati e seleziona Elimina. In alternativa, puoi fare clic su Revoca autorizzazioni di debug adb nella pagina Impostazioni del dispositivo per annullare l'accoppiamento della workstation e di tutte le altre workstation accoppiate in precedenza.

Mirroring del dispositivo

Puoi eseguire il mirroring del tuo dispositivo fisico nella finestra Running Devices di Android Studio. Trasmettendo in streaming il display del tuo dispositivo direttamente ad Android Studio, puoi utilizzare l'IDE di Studio per eseguire azioni comuni come l'avvio di app e l'interazione con queste, la rotazione dello schermo, l'apertura e la chiusura dello smartphone e la modifica del volume.

Il mirroring del dispositivo è sempre disponibile quando sono presenti dispositivi connessi al computer con il debug USB o wireless abilitato. Puoi avviare e interrompere il mirroring utilizzando la finestra Running Devices o Gestione dispositivi (Visualizza > Finestre degli strumenti > Gestione dispositivi). Puoi anche personalizzare l'attivazione del mirroring del dispositivo nelle relative impostazioni (Impostazioni > Strumenti > Mirroring del dispositivo).

Nota: se utilizzi determinati dispositivi, ad esempio Xiaomi Redmi K40, Poco F3 o Mi 11X, con Android 12, devi attivare sia il debug USB sia il debug USB (impostazioni di sicurezza), quindi riavviare il dispositivo per attivare il mirroring del dispositivo.

Figura 8. UI Running Devices.

Reindirizzamento audio

Quando utilizzi il mirroring del dispositivo, puoi reindirizzare l'audio dai dispositivi fisici connessi agli altoparlanti o alle cuffie del computer. Con il reindirizzamento audio, tieni le cuffie collegate al computer e ascolta sia il computer sia lo smartphone connesso senza dover ricollegare manualmente un dispositivo e poi l'altro. Per attivare il reindirizzamento dell'audio, vai a File (Android Studio su macOS) > Impostazioni > Strumenti > Mirroring del dispositivo e seleziona Reindirizza l'audio dai dispositivi locali. Tieni presente che l'audio viene sempre reindirizzato, indipendentemente dalle impostazioni, per i dispositivi Firebase Test Lab con Android 12 o versioni successive.

Problemi noti

Alcuni dispositivi potrebbero non essere in grado di codificare a un bitrate sufficiente per supportare il mirroring del dispositivo. In queste situazioni, potresti visualizzare un errore nella finestra Running Devices e log simili ai seguenti.

2023-06-01 15:32:22,675 [  56094]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - Too many video encoder errors:
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - encoder: c2.android.vp8.encoder
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - mime type: video/x-vnd.on2.vp8
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max resolution: 640x640
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - min resolution: 2x2
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - alignment: 2x2
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max frame rate: 960
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max frame rate for 288x640: 960
2023-06-01 15:32:22,870 [  56289]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max bitrate: 20000000
2023-06-01 15:32:22,871 [  56290]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - terminated with code 1

Informativa sulla privacy

In base alle impostazioni di mirroring del dispositivo, Android Studio può avviare automaticamente il mirroring del dispositivo per qualsiasi dispositivo connesso e accoppiato. Ciò potrebbe comportare la divulgazione di informazioni per i dispositivi connessi con il comando adb tcpip, perché le informazioni e i comandi di mirroring vengono trasmessi su un canale non criptato. Inoltre, Android Studio utilizza un canale non criptato per comunicare con il server adb, pertanto le informazioni di mirroring possono essere intercettate da altri utenti sulla tua macchina host.

Risolvi i problemi di connessione del dispositivo

Se il dispositivo non si connette ad Android Studio, prova i seguenti passaggi per risolvere il problema:

Risolvi i problemi con l'assistente alla connessione

L'assistente alla connessione fornisce istruzioni passo passo per aiutarti a configurare e utilizzare un dispositivo tramite la connessione ADB.

Per avviare l'assistente, scegli Strumenti > Risolvi i problemi di connessione dei dispositivi.

L'Assistente alla connessione fornisce istruzioni, controlli contestuali e un elenco di dispositivi connessi in una serie di pagine nel riquadro Assistente. Utilizza i pulsanti Avanti e Indietro nella parte inferiore del riquadro Assistente per spostarti tra le pagine in base alle tue esigenze:

• Connetti il dispositivo tramite USB: l'assistente alla connessione ti chiede innanzitutto di connettere il dispositivo tramite USB e fornisce un pulsante Esegui di nuovo la scansione dei dispositivi USB con cui puoi avviare una nuova scansione dei dispositivi connessi.
• Attiva il debug USB: l'assistente alla connessione ti spiega come attivare il debug USB nelle Opzioni sviluppatore sul dispositivo.
• Riavvia il server ADB: se continui a non vedere il tuo dispositivo nell'elenco dei dispositivi disponibili, utilizza il pulsante Riavvia il server ADB nell'ultima pagina dell'assistente alla connessione. Il riavvio del server ADB comporta anche una nuova scansione dei dispositivi da parte di ADB. Se ancora non vedi il tuo dispositivo nell'elenco dei dispositivi disponibili, prova i passaggi per la risoluzione dei problemi riportati nella sezione seguente.

Risolvi i problemi di connessione USB

Se l'Assistente connessione non rileva il dispositivo tramite USB, prova i seguenti passaggi per la risoluzione dei problemi:

Verifica che Android Studio si connetta all'emulatore Android

Per verificare se il problema è causato da un problema di connessione tra Android Studio e l'emulatore Android, segui questi passaggi:

1. Apri Gestione dispositivi.
2. Crea un nuovo AVD se non ne hai già uno.
3. Esegui l'emulatore utilizzando il tuo AVD.
4. Esegui una delle seguenti operazioni:
   • Se Android Studio non riesce a connettersi all'emulatore, scarica l'ultima versione degli strumenti della piattaforma SDK e riprova.
   • Se l'emulatore si avvia correttamente, controlla il cavo USB come descritto nella sezione seguente.

Controlla il cavo USB

Per verificare se il problema è causato da un cavo USB difettoso, segui i passaggi descritti in questa sezione.

Se hai un altro cavo USB:

1. Collega il dispositivo utilizzando il cavo secondario.
2. Controlla se l'assistente alla connessione ora riesce a rilevare il dispositivo.
3. Se il dispositivo non viene rilevato, riprova con il cavo principale.
4. Se il dispositivo non viene ancora rilevato, supponi che il problema riguardi il dispositivo e controlla se è configurato per lo sviluppo come descritto nella sezione seguente.

Se non hai un altro cavo USB, ma hai un altro dispositivo Android:

1. Collega il dispositivo secondario al computer.

2. Se l'assistente per la connessione riesce a rilevare il dispositivo secondario, supponi che il problema riguardi il dispositivo principale e verifica se il dispositivo è configurato per lo sviluppo.

   Se il dispositivo secondario non viene rilevato, il problema potrebbe essere il cavo USB.

Controlla se il dispositivo è configurato per lo sviluppo

Per verificare se il problema è causato dalle impostazioni del dispositivo, segui questi passaggi:

1. Segui i passaggi descritti nella sezione Configura un dispositivo per lo sviluppo.
2. Se il problema persiste, contatta l'assistenza clienti dell'OEM del dispositivo per ricevere aiuto. Comunica al rappresentante dell'assistenza clienti che il dispositivo non si connette ad Android Studio tramite ADB.

Risolvi i problemi di connessione wireless

Se hai problemi di connessione wireless al dispositivo, prova i seguenti passaggi per la risoluzione dei problemi:

Controlla se la workstation e il dispositivo soddisfano i prerequisiti

Verifica che la workstation e il dispositivo soddisfino i prerequisiti.

Consulta la guida alla risoluzione dei problemi di adb

Segui la guida alla risoluzione dei problemi di adb.

Token di sicurezza RSA

Quando colleghi un dispositivo con Android 4.2.2 (livello API 17) o versioni successive al tuo computer, il sistema mostra una finestra di dialogo che ti chiede se accettare una chiave RSA che consente il debug tramite questo computer. Questo meccanismo di sicurezza protegge i dispositivi degli utenti perché il debug USB e altri comandi adb non possono essere eseguiti a meno che tu non riesca a sbloccare il dispositivo e ad accettare la finestra di dialogo.