Eseguire app su un dispositivo hardware

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

Nota: utilizza l'emulatore di Android per testare la tua app su diverse versioni della piattaforma Android e dimensioni dello schermo diverse. Prendi in considerazione l'utilizzo di Firebase Test Lab per eseguire la tua app su un'ampia gamma di dispositivi reali ospitati in un'infrastruttura basata su cloud.

Configurare un dispositivo per lo sviluppo

Prima di iniziare il debug sul tuo dispositivo, decidi se vuoi connetterlo al dispositivo con un cavo USB o una rete Wi-Fi. Quindi, procedi nel seguente modo:

1. Sul dispositivo, apri l'app Impostazioni, seleziona Opzioni sviluppatore e 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 è richiesta alcuna configurazione aggiuntiva.
   • macOS: non è richiesta alcuna ulteriore configurazione.
   • Windows: installa un driver USB per ADB (se applicabile). Per una guida all'installazione e link ai driver OEM, consulta Installare driver USB OEM.

   • Ubuntu Linux: configura quanto segue:

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

     sudo usermod -aG plugdev $LOGNAME
     

     I gruppi vengono aggiornati solo all'accesso, perciò devi uscire affinché la modifica abbia effetto. Quando accedi di nuovo, puoi utilizzare id per verificare di far parte del gruppo plugdev.

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

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

Connetti al dispositivo tramite USB

Al termine della configurazione e del collegamento tramite USB, fai clic su Esegui in Android Studio per creare ed eseguire la tua app sul dispositivo.

Puoi anche utilizzare adb per inviare comandi, come segue:

• Verifica che il dispositivo sia connesso eseguendo il comando adb devices dalla directory android_sdk/platform-tools/. Se è connesso, il dispositivo viene visualizzato 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 workstation tramite Android Debug Bridge (ADB). Ad esempio, puoi eseguire il deployment dell'app di cui è possibile eseguire il debug su più dispositivi remoti senza collegare fisicamente il dispositivo tramite USB e non incorrere in problemi di connessione USB comuni, ad esempio l'installazione di driver.

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 ulteriori informazioni, consulta Controllare e aggiornare la versione di Android.
3. Assicurati di avere installato la versione più recente di Android Studio. Scaricala qui.
4. Sulla workstation, esegui l'aggiornamento all'ultima versione degli SDK Platform Tools.

Per connetterti al tuo dispositivo, procedi nel seguente modo:

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

   

   Figura 1. Esegui configurazioni.

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

   

   Figura 2. Finestra di dialogo per accoppiare i dispositivi tramite codice QR o codice di accoppiamento.

2. Attiva le opzioni per gli sviluppatori sul dispositivo.
3. Attiva il debug tramite Wi-Fi sul dispositivo.

   

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

4. Tocca Debug wireless e accoppia il dispositivo:
   1. Per accoppiare il dispositivo con un codice QR, seleziona Accoppia il dispositivo con codice QR e scansiona il codice QR, mostrato nella figura 2.
   2. Per accoppiare il dispositivo con un codice di accoppiamento, seleziona Accoppia dispositivo con codice di accoppiamento nella finestra di dialogo Accoppia nuovi dispositivi tramite Wi-Fi. Sul dispositivo, seleziona Accoppia utilizzando il codice di accoppiamento. Viene visualizzato un codice a sei cifre. Quando il dispositivo viene visualizzato nella finestra Accoppia dispositivi tramite Wi-Fi, inserisci il codice a sei cifre mostrato sul dispositivo e seleziona Accoppia .

      

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

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

Per accoppiare un altro dispositivo o eliminare questo dispositivo sulla workstation:

1. Vai a Debug wireless sul dispositivo.
2. Tocca il nome della workstation nella sezione Dispositivi accoppiati.
3. Seleziona Elimina.

Risolvere i problemi di connessione del dispositivo

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

Risolvere i problemi con l'Assistente connessioni

Connection Assistant fornisce istruzioni dettagliate per aiutarti a configurare e utilizzare un dispositivo tramite la connessione ADB.

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

Connection Assistant 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 esaminare le pagine in base alle tue esigenze:

• Connetti il dispositivo tramite USB: l'Assistente connessioni innanzitutto ti chiede di collegare il dispositivo tramite USB e fornisce un pulsante Nuova scansione dispositivi USB con cui puoi avviare una nuova ricerca dei dispositivi connessi.
• Attiva debug USB. Connection Assistant ti spiega come attivare il debug USB nelle opzioni sviluppatore sul dispositivo.
• Riavvia il server ADB: se il tuo dispositivo non compare ancora nell'elenco dei dispositivi disponibili, utilizza il pulsante Riavvia server ADB nell'ultima pagina dell'Assistente connessioni. Inoltre, il riavvio del server ADB causa una nuova scansione dei dispositivi da parte di ADB. Se il tuo dispositivo non è ancora presente nell'elenco dei dispositivi disponibili, prova a eseguire i passaggi per la risoluzione dei problemi descritti nella sezione seguente.

Risolvi i problemi di connessione USB

Se Assistente connessioni non rileva il tuo dispositivo tramite USB, prova a risolvere il problema svolgendo 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, procedi nel seguente modo:

1. Apri Gestione dispositivi.
2. Crea una nuova durata di visualizzazione media, se non ne hai già una.
3. Esegui l'emulatore utilizzando la durata di visualizzazione media.
4. Esegui una delle seguenti operazioni:
   • Se Android Studio non riesce a connettersi all'emulatore, scarica l'ultima versione degli SDK Platform Tools 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 tramite il cavo secondario.
2. Controlla se l'Assistente connessioni è ora in grado di rilevare il dispositivo.
3. Se il dispositivo non viene rilevato, riprova a usare il cavo principale.
4. Se il dispositivo continua a non essere rilevato, supponiamo che il problema riguardi il dispositivo e controlla se il dispositivo è 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 connessioni è in grado di rilevare il dispositivo secondario, supponiamo che il problema sia relativo al dispositivo principale e controlla se il dispositivo è configurato per lo sviluppo.

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

Verificare se il dispositivo è configurato per lo sviluppo

Per verificare se il problema è causato dalle impostazioni del dispositivo, procedi nel seguente modo:

1. Segui i passaggi della sezione Configurare un dispositivo per lo sviluppo.
2. Se il problema persiste, contatta l'assistenza clienti dell'OEM del dispositivo. 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 difficoltà a connetterti al tuo dispositivo in modalità wireless, puoi provare a risolvere il problema svolgendo i seguenti passaggi per la risoluzione dei problemi:

Verificare se la workstation e il dispositivo soddisfano i prerequisiti

Per soddisfare i prerequisiti per il debug wireless, assicurati che:

• La workstation e il dispositivo siano connessi alla stessa rete wireless.
• Sul tuo dispositivo è installato Android 11 o versioni successive. Per maggiori informazioni, consulta la pagina Controllare e aggiornare la versione di Android.
• Disporre della versione più recente di Android Studio. Puoi scaricarla dalla pagina principale di Android Studio.
• La versione più recente degli SDK Platform Tools è installata sulla tua workstation.

Verifica la presenza di altri problemi noti

Di seguito è riportato un elenco degli attuali problemi noti relativi al debug wireless in Android Studio e le relative soluzioni:

• Il Wi-Fi non si connette: alcune reti Wi-Fi, come le reti Wi-Fi aziendali, potrebbero bloccare le connessioni p2p e impedirti di connetterti tramite Wi-Fi. Prova a connetterti con un cavo o un'altra rete Wi-Fi.
• A volte l'ADB tramite Wi-Fi si disattiva automaticamente: questo può accadere se il dispositivo cambia rete Wi-Fi o si disconnette dalla rete.

Token di sicurezza RSA

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