Condividi tramite


Configurare il dispositivo Android per il debug

Anche se l'emulatore Android è un ottimo modo per sviluppare e testare rapidamente l'app, è consigliabile testare le app in un dispositivo Android reale. Per l'esecuzione in un dispositivo, è necessario abilitare la modalità sviluppatore nel dispositivo e connetterla al computer. Per ulteriori informazioni, vedere Eseguire le app su un dispositivo hardware sul sito developer.android.com.

Importante

I passaggi descritti in questo articolo vengono scritti in modo generico per lavorare sul maggior numero possibile di dispositivi. Se non riesci a trovare queste impostazioni nel dispositivo, consulta la documentazione del produttore del dispositivo.

Abilitare la modalità sviluppatore nel dispositivo

Un dispositivo deve abilitare la modalità sviluppatore per distribuire e testare un'app Android. La modalità sviluppatore è abilitata seguendo questa procedura:

  1. Vai alla schermata Impostazioni .
  2. Selezionare Informazioni sul telefono.
  3. Tocca numero di build sette volte fino a Ora sei uno sviluppatore! è visibile.

A seconda dell'interfaccia utente in cui è in esecuzione il dispositivo, l'opzione Informazioni sul telefono potrebbe trovarsi in una posizione diversa. Consultare la documentazione del dispositivo se non riesci a trovare Informazioni sul telefono.

schermata delle Opzioni sviluppatore su Android.

Abilitare il debug USB

Dopo aver abilitato la modalità sviluppatore nel dispositivo, abilitare il debug USB seguendo questa procedura:

  1. Vai alla schermata Impostazioni.
  2. Selezionare Opzioni sviluppatore.
  3. Attivare l'opzione debug USB.

A seconda dell'interfaccia utente in cui è in esecuzione il dispositivo, l'opzione debug USB potrebbe trovarsi in una posizione diversa. Consultare la documentazione del dispositivo se non è possibile trovare debug USB.

Connettere il dispositivo al computer

Il passaggio finale consiste nel connettere il dispositivo al computer. Il modo più semplice e affidabile consiste nel farlo tramite USB.

Se non l'hai usato per il debug prima, riceverai un prompt per fidarti del computer sul tuo dispositivo. È anche possibile controllare Consenti sempre da questo computer di evitare di richiedere questa richiesta ogni volta che si connette il dispositivo.

richiesta di attendibilità Android dal computer per l'uso del debug USB.

Se il computer non riconosce il dispositivo quando è collegato, provare a installare un driver per il dispositivo. Consultare la documentazione di supporto del produttore del dispositivo. È anche possibile provare a installare Google USB Driver tramite Android SDK Manager:

Android SKD Manager con il driver di dispositivo USB di Google selezionato.

Abilitare il debug Wi-Fi

È possibile eseguire il debug di un dispositivo Android tramite Wi-Fi, senza mantenere fisicamente connesso il dispositivo al computer. Questa tecnica richiede più sforzo, ma può essere utile quando il dispositivo è troppo lontano dal computer per rimanere costantemente collegato tramite un cavo.

Connessione tramite Wi-Fi

Per impostazione predefinita, Android Debug Bridge (adb) è configurato per comunicare con un dispositivo Android tramite USB. È possibile riconfigurarla per l'uso di TCP/IP anziché USB. A tale scopo, sia il dispositivo che il computer devono trovarsi nella stessa rete Wi-Fi.

Nota

Il driver USB di Google è necessario per eseguire adb debug in Windows con dispositivi Google. Per ulteriori informazioni, vedi Ottieni il driver USB di Google su developer.android.com. I driver Windows per tutti gli altri dispositivi vengono forniti dal rispettivo produttore hardware. Per altre informazioni, vedere Installare i driver USB OEM su developer.android.com.

Abilitare prima di tutto il debug wireless nel dispositivo Android:

  1. Seguire la procedura descritta nella sezione abilitare la modalità sviluppatore nel dispositivo.
  2. Seguire i passaggi nella sezione Abilitare il debug USB.
  3. Passare alla schermata di Impostazioni.
  4. Selezionare Opzioni sviluppatore.
  5. Attiva l'opzione debugger wireless.

A seconda dell'interfaccia utente su cui è in esecuzione il dispositivo, l'opzione debug wireless può trovarsi in una posizione diversa. Consultare la documentazione del dispositivo se non riesci a trovare debugging wireless.

Successivamente, usare adb per connettersi al dispositivo, prima tramite una connessione USB:

  1. Determinare l'indirizzo IP del dispositivo Android. Un modo per scoprire l'indirizzo IP consiste nell'esaminare Impostazioni > Rete & Internet > Wi-Fi, quindi toccare la rete Wi-Fi a cui il dispositivo è connesso e quindi toccare Avanzate. Verrà aperto un elenco a discesa che mostra le informazioni sulla connessione di rete, simile a quanto illustrato nello screenshot seguente:

    schermata di stato di Android con indirizzo IP.

    In alcune versioni di Android l'indirizzo IP non verrà elencato, ma è disponibile in Impostazioni > Informazioni sullo stato del telefono >.

  2. In Visual Studio aprire il prompt dei comandi adb selezionando l'opzione di menu Tools>Android>Android Adb Command Prompt....

  3. Nel prompt dei comandi usare il comando adb tcpip per indicare al dispositivo di ascoltare le connessioni TCP/IP sulla porta 5555.

    adb tcpip 5555
    
  4. Scollegare il cavo USB dal dispositivo.

  5. Connettersi all'indirizzo IP del dispositivo con la porta 5555:

    adb connect 192.168.1.28:5555
    

    Al termine di questo comando, il dispositivo Android è connesso al computer tramite Wi-Fi.

    Al termine del debug tramite WiFi, è possibile ripristinare la modalità USB di ADB con il comando seguente:

    adb usb
    

    Per visualizzare i dispositivi connessi al computer, usare il comando adb devices:

    adb devices
    

Configurare le opzioni per sviluppatori nel dispositivo

L'app Impostazioni in Android include una schermata denominata opzioni per sviluppatori in cui è possibile configurare i comportamenti di sistema che consentono di profilare ed eseguire il debug delle prestazioni dell'app. Per altre informazioni, vedere Configurare le opzioni per sviluppatori su dispositivi in developer.android.com.

Eseguire il debug di un'app in un dispositivo Android

Per eseguire il debug di un'app in un dispositivo Android:

  1. Collegare il dispositivo al computer e selezionarlo come destinazione di debug in Visual Studio o Visual Studio Code.
  2. Esegui l'app.

Per informazioni sulla selezione di una destinazione di debug in Visual Studio, vedere Compilare la prima app. Per informazioni sulla selezione di una destinazione di debug in Visual Studio Code, vedere Compilare la prima app.