Eseguire app su un dispositivo hardware

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

Configurare un dispositivo per lo sviluppo

Per poter iniziare a eseguire il debug sul tuo dispositivo, devi prima decidere se 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 quindi attiva Debug USB (se applicabile).

2. Configura il sistema per il rilevamento del dispositivo.

   • ChromeOS: non sono necessarie ulteriori configurazioni.
   • macOS: non sono necessarie ulteriori configurazioni.
   • Windows: installa un driver USB per ADB (se applicabile). Per un Guida all'installazione e link ai driver OEM; consulta l'articolo su come installare un dispositivo USB OEM driver.

   • Ubuntu Linux: configura quanto segue:

     • Ogni utente che vuole utilizzare ADB deve essere nel gruppo plugdev. Se viene visualizzato un messaggio di errore che indica che non sei in il gruppo plugdev, aggiungiti utilizzando il seguente comando:

     sudo usermod -aG plugdev $LOGNAME
     

     I gruppi vengono aggiornati solo al momento dell'accesso, quindi devi disconnetterti per la modifica abbia effetto. Quando esegui di nuovo l'accesso, puoi utilizzare id per verifica di essere nel gruppo plugdev.

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

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

Connetti al tuo dispositivo tramite USB

Dopo aver configurato e collegato il dispositivo tramite USB, fai clic su Esegui. in Android Studio per creare ed eseguire l'app sul dispositivo.

Puoi anche utilizzare adb per impartire comandi, come segue:

• Verifica che il dispositivo sia connesso eseguendo il comando adb devices dalla directory android_sdk/platform-tools/. Se connesso, il dispositivo sarà elencato.
• Esegui un 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 della tua 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 fisicamente la connessione del dispositivo tramite USB e la presenza di problemi comuni di connessione USB, come l'installazione dei 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 in ogni rete.
2. Assicurati che sul dispositivo sia installato Android 11 o versioni successive. Per ulteriori informazioni informazioni, consulta la sezione Controllare e aggiorna il tuo Android dell'audiodescrizione.
3. Assicurati di avere installato la versione più recente di Android Studio. Scaricala qui.
4. Sulla workstation, esegui l'aggiornamento all'ultima versione Strumenti della piattaforma SDK.

Per connetterti al tuo dispositivo, procedi nel seguente modo:

1. Apri Android Studio e seleziona Accoppia dispositivi tramite Wi-Fi dall'esecuzione. del menu di configurazione.

   

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

   

2. Attiva sviluppatore opzioni sul tuo dispositivo.
3. Attiva il debug su più di Wi-Fi sul tuo dispositivo.

   

4. Tocca Debug wireless e accoppia il tuo dispositivo:
   .
   1. Per accoppiare il dispositivo con un codice QR, seleziona Accoppia 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 dalla finestra di dialogo Accoppia nuovi dispositivi tramite Wi-Fi. Sul tuo dispositivo, seleziona Accoppia con codice di accoppiamento. Un file a sei cifre del codice sorgente. Quando il dispositivo viene visualizzato nella Nella finestra Accoppia dispositivi tramite Wi-Fi, inserisci le sei cifre mostrato sul dispositivo e seleziona Accoppia .

      

5. Dopo l'accoppiamento, puoi tentare di implementare l'app sul dispositivo.

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

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

Mirroring dispositivo

Puoi eseguire il mirroring del tuo dispositivo fisico nella finestra Dispositivi in esecuzione di Android Studio. Grazie allo streaming del display del dispositivo direttamente su Android Studio, puoi usano lo stesso IDE di Studio per eseguire azioni comuni come l'avvio di app e interagire con loro, ruotare lo schermo, piegare e aprire lo smartphone e regolare il volume.

Il mirroring del dispositivo è sempre disponibile quando ci sono dispositivi connessi al computer con il debug USB o wireless attivato. Puoi avviare e interrompere mirroring utilizzando la finestra Dispositivi in esecuzione o la Gestione dispositivi (Visualizza > Finestre strumenti > Gestione dispositivi). Puoi anche specificare quando il dispositivo il mirroring sia attivato nelle impostazioni. (Impostazioni > Strumenti > Mirroring dispositivo).

Reindirizza l'audio

Quando utilizzi il mirroring del dispositivo, puoi reindirizzare l'audio dai dispositivi connessi dispositivi fisici agli altoparlanti del computer o alle cuffie. Con audio il reindirizzamento, mantieni le cuffie collegate al computer e ascolta entrambi il computer e lo smartphone connesso senza doversi riconnettere manualmente dispositivo e poi un altro. Per attivare il reindirizzamento audio, vai su File (Android Studio su macOS) > Impostazioni > Strumenti > Mirroring 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 in alto.

Problemi noti

Alcuni dispositivi potrebbero non essere in grado di codificare a una velocità in bit sufficiente per supportare il mirroring del dispositivo. In questi casi, potresti visualizzare un errore nella Dispositivi in esecuzione e log simili a quelli riportati di seguito.

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ò avviarsi automaticamente il mirroring del dispositivo per qualsiasi dispositivo connesso e accoppiato. Ciò potrebbe causare informativa per i dispositivi connessi con il comando adb tcpip perché le informazioni e i comandi di mirroring vengono trasmessi su un ambiente canale. Inoltre, Android Studio utilizza un canale non criptato per comunicare con il server adb, quindi il mirroring delle informazioni può essere intercettato da altri utenti sul computer host.

Risolvere i problemi di connessione del dispositivo

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

Risolvere i problemi relativi all'Assistente connessione

L'Assistente di connessione fornisce istruzioni dettagliate per aiutarti a configurare e utilizzare un dispositivo tramite la connessione ADB.

Per avviare l'assistente, scegli Strumenti > Risolvi i problemi relativi alle connessioni dei dispositivi.

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

• Connetti il dispositivo tramite USB: per prima cosa viene richiesto dall'Assistente di connessione. di collegare il dispositivo tramite USB e fornisce un dispositivo USB per la nuova scansione pulsante da cui puoi avviare una nuova ricerca dei dispositivi connessi.
• Attiva il debug USB: l'Assistente di connessione ti dirà quindi come Attiva il debug USB nelle opzioni sviluppatore sul dispositivo.
• Riavvia il server ADB: se non trovi ancora il tuo dispositivo nella dei dispositivi disponibili, utilizza il pulsante Riavvia server ADB l'ultima pagina dell'Assistente connessione. Il riavvio del server ADB causa anche ADB per cercare di nuovo i dispositivi. Se ancora non trovi il tuo dispositivo nell'elenco dei dispositivi disponibili, prova i passaggi per la risoluzione dei problemi descritti nella sezione seguente.

Risolvere i problemi di connessione USB

Se l'Assistente connessione non rileva il tuo dispositivo tramite USB, prova procedi nel seguente modo per risolvere il problema:

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:

1. Apri Gestione dispositivi.
2. Se non lo hai già fatto, crea una nuova durata di visualizzazione media. ne hai uno.
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 la versione più recente Strumenti della piattaforma SDK e riprova.
   • Se l'emulatore si avvia correttamente, controlla il cavo USB come descritto nella sezione che segue.

Controlla il cavo USB

Per verificare se il problema è causato da un cavo USB difettoso, segui la procedura descritta in questa sezione.

Se hai un altro cavo USB:

1. Collega il dispositivo usando il cavo secondario.
2. Controlla se ora l'Assistente connessione è 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 la dispositivo verifica se il dispositivo è configurato per lo sviluppo come descritto nella sezione che segue.

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

1. Collega il dispositivo secondario al computer.

2. Se l'Assistente connessione riesce a rilevare il dispositivo secondario, supponiamo che le riguarda il dispositivo principale. verifica se il dispositivo è configurato per lo sviluppo.

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

Controllare se il dispositivo è configurato per lo sviluppo

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

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

Risolvere i problemi di connessione wireless

Se hai difficoltà a connetterti al tuo dispositivo in modalità wireless, prova a procedi nel seguente modo per risolvere il problema:

Controlla se la workstation e il dispositivo soddisfano i prerequisiti

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

• La workstation e il dispositivo sono connessi alla stessa rete wireless.
• Sul tuo dispositivo sia installato Android 11 o versioni successive. Per ulteriori informazioni, vedi Controlla e aggiorna il tuo Android dell'audiodescrizione.
• Hai l'ultima versione di Android Studio. Puoi scaricare dalla pagina principale di Android Studio.
• Hai l'ultima versione SDK Platform Tools sulla 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 come risolverle:

• Il Wi-Fi non si connette: alcune reti Wi-Fi, ad esempio il Wi-Fi aziendale. potrebbero bloccare le connessioni p2p e non consentirti di connetterti tramite Wi-Fi. Prova a connetterti tramite un cavo o un'altra rete Wi-Fi.
• A volte l'ADB tramite Wi-Fi si disattiva automaticamente. Ciò può verificarsi se la il dispositivo cambia rete Wi-Fi o si disconnette dalla rete.

Token di sicurezza RSA

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