Gestione dei dispositivi virtuali con android Gestione dispositivi

Questo articolo spiega come usare Android Device Manager per creare e configurare dispositivi virtuali Android (AVD) che emulano i dispositivi fisici Android. È possibile usare questi dispositivi virtuali per eseguire e testare l'app anche senza un dispositivo fisico. Per altre informazioni sui dispositivi virtuali Android, vedere Creare e gestire dispositivi virtuali in developer.android.com.

Importante

Abilitare l'accelerazione hardware per i dispositivi Android. Per altre informazioni, vedere Accelerazione hardware per le prestazioni dell'emulatore.

Android Device Manager su Windows

Usare il Gestione dispositivi Android per creare e configurare un avD (Android Virtual Devices) eseguito nell'emulatore Android. Ogni AVD è una configurazione dell'emulatore che simula un dispositivo Android fisico. In questo modo è possibile eseguire e sottoporre a test l'applicazione in varie configurazioni che simulano dispositivi Android fisici diversi.

Screenshot of the Android Device Manager in the Devices tab.

Requisiti

Per usare il Gestione dispositivi Android, sono necessari gli elementi seguenti:

  • Visual Studio 2022: sono supportate le edizioni Community, Professional ed Enterprise.

  • Livello 30 o versione successiva dell'API Android SDK. Assicurarsi di installare Android SDK nel percorso predefinito se non è già installato: C:\Programmi (x86)\Android\android-sdk.

  • È necessario installare i pacchetti seguenti:

    • Android SDK Tools 5.0 o versione successiva
    • Android SDK Platform-Tools 31.0.3 o versione successiva
    • Android SDK Build-Tools 30.0.2 o versione successiva
    • Emulatore Android 30.8.4 o versione successiva

    Questi pacchetti devono essere visualizzati con lo stato Installato come illustrato nello screenshot seguente:

    Installing Android SDK Tools.

Quando si installa il carico di lavoro Sviluppo di app multipiattaforma .NET in Visual Studio, tutto viene installato automaticamente. Per altre informazioni sulla configurazione di .NET MAUI con Visual Studio, vedere Creare la prima app.

Aprire Gestione dispositivi

Aprire il Gestione dispositivi Android in Visual Studio dal menu Strumenti premendo Strumenti > Android > Gestione dispositivi:

Launching the Device manager from the Tools menu.

Schermata principale

Quando si esegue il Gestione dispositivi Android, viene visualizzata una schermata che visualizza tutti i dispositivi virtuali attualmente configurati. Per ogni dispositivo virtuale vengono visualizzati i parametri Nome, Sistema operativo (versione di Android), Processore, Memoria e la Risoluzione dello schermo:

Quando si fa clic su un dispositivo nell'elenco, a destra del nome viene visualizzato il pulsante Avvia. Premere il pulsante Start per avviare l'emulatore con questo dispositivo virtuale. Se l'emulatore è in esecuzione con il dispositivo virtuale selezionato, il pulsante Start passa a un pulsante Arresta che è possibile usare per arrestare l'emulatore.

Creare un nuovo dispositivo

Per creare un nuovo dispositivo, premere il pulsante Nuovo :

New button for creating a new device.

Viene visualizzata la finestra Nuovo dispositivo . Per configurare il dispositivo, seguire questa procedura:

  1. Assegnare un nuovo nome al dispositivo. Nell'esempio seguente il nuovo dispositivo è denominato Pixel 3a - API 31.

    New Device screen of the Device Manager.

  2. Selezionare un dispositivo fisico da emulare selezionando un dispositivo nella casella Dispositivo di base.

  3. Selezionare un tipo di processore per questo dispositivo virtuale con la casella Processore .

    È consigliabile scegliere x86_64 e abilitare l'accelerazione hardware.

  4. Selezionare la versione android (livello API) con la casella Sistema operativo .

    Se si seleziona un livello API Android che non è ancora stato installato, il Gestione dispositivi visualizzerà Un nuovo dispositivo verrà scaricato nella parte inferiore della schermata. I file necessari verranno scaricati e installati durante la creazione del nuovo dispositivo virtuale.

  5. Se vuoi includere le API di Google Play Services nel tuo dispositivo virtuale, seleziona l'opzione API Google. Per includere l'app Google Play Store nel dispositivo virtuale, selezionare l'opzione Google Play Store

    Nota

    Le immagini di Google Play Store sono disponibili solo per alcuni tipi di dispositivi di base, ad esempio Pixel, Pixel 2, Pixel 3 e Nexus 5. Questo è indicato dal testo (+ Store) nel nome dell'immagine.

  6. Utilizzare l'elenco delle proprietà per modificare alcune delle proprietà modificate più di frequente. Per apportare modifiche alle proprietà, vedere Modifica delle proprietà del dispositivo virtuale Android.

  7. Aggiungere eventuali proprietà aggiuntive che è necessario impostare in modo esplicito con la casella Aggiungi proprietà nella parte inferiore della finestra:

    Add Property pull-down menu.

    È anche possibile definire una proprietà personalizzata selezionando Personalizzato....

  8. Premere il pulsante Crea per creare il nuovo dispositivo:

    Create button.

    È possibile che venga visualizzata una schermata di accettazione della licenza quando si crea il dispositivo. Selezionare Accetta se si accettano le condizioni di licenza.

  9. Android Device Manager aggiunge il nuovo dispositivo all'elenco dei dispositivi virtuali installati, visualizzando un indicatore di stato Creating (Creazione in corso) durante la creazione del dispositivo:

    Creation progress Indicator.

  10. Al termine del processo di creazione, il nuovo dispositivo viene visualizzato nell'elenco dei dispositivi virtuali installati con un pulsante Start , pronto per l'avvio

Modificare il dispositivo

Per modificare un dispositivo virtuale esistente, selezionare il dispositivo e quindi premere il pulsante Modifica :

Edit button for modifying a device.

Premendo Modifica viene visualizzata la finestra Editor dispositivi per il dispositivo virtuale selezionato.

Nella finestra Editor dispositivi sono elencate le proprietà del dispositivo virtuale nella colonna Proprietà , con i valori corrispondenti di ogni proprietà nella colonna Valore . Quando si seleziona una proprietà, sul lato destro viene visualizzata una descrizione dettagliata di tale proprietà.

Per modificare una proprietà, modificarne il valore nella colonna Valore. Ad esempio, nello screenshot seguente la hw.lcd.density proprietà viene modificata in 240:

Device Editing example.

Dopo aver apportato le modifiche di configurazione necessarie, premere il pulsante Salva . Per altre informazioni sulla modifica delle proprietà del dispositivo virtuale, vedere Modifica delle proprietà del dispositivo virtuale Android.

Opzioni aggiuntive

Opzioni aggiuntive per l'uso dei dispositivi sono disponibili dal menu a discesa Opzioni aggiuntive (...) :

Location of additional options menu.

Il menu delle opzioni aggiuntive contiene le voci seguenti:

  • Duplica e modifica : duplica il dispositivo attualmente selezionato e lo apre nella schermata Nuovo dispositivo con un nuovo nome simile al dispositivo esistente. Ad esempio, selezionando Pixel 3a - API 31 e premendo Duplica e Modifica viene aggiunto un contatore al nome: Pixel 3a - API 31 (1).

  • Iniziare con Impostazioni predefinite factory: avvia il dispositivo con un avvio a freddo.

  • Iniziare con i log del kernel: avvia l'emulatore e apre la directory dei log del kernel.

  • Scarica immagine di sistema: scarica l'immagine del sistema operativo Android per il dispositivo, se non è già scaricata.

  • Reveal in Explorer : apre Esplora risorse e passa alla cartella che contiene i file per il dispositivo virtuale.

  • Riparazione : avvia una riparazione nel dispositivo.

  • Ripristino delle impostazioni predefinite: ripristina le impostazioni predefinite del dispositivo selezionato, cancellando le modifiche apportate all'utente allo stato interno del dispositivo durante l'esecuzione. Questa azione cancella anche lo snapshot di avvio rapido corrente, se esistente. Questa modifica non modifica le modifiche apportate al dispositivo virtuale durante la creazione e la modifica. Verrà visualizzata una finestra di dialogo con il promemoria che questa reimpostazione non può essere annullata. Premere Ripristino impostazioni predefinite per confermare la reimpostazione.

  • Elimina : elimina definitivamente il dispositivo virtuale selezionato. Un messaggio ricorda che l'eliminazione di un dispositivo non può essere annullata. Premere Elimina se si è certi di voler eliminare il dispositivo.

Risoluzione dei problemi

Le sezioni seguenti descrivono come diagnosticare e risolvere i problemi che possono verificarsi quando si usa Android Device Manager per configurare i dispositivi virtuali.

Versione errata di Android SDK Tools

Se sono installati gli strumenti Android SDK non corretti, installati, è possibile che venga visualizzata questa finestra di dialogo di errore all'avvio:

Screenshot shows the Android SDK instance error dialog box.

Se viene visualizzata la finestra di dialogo di errore, premere Open SDK Manager per aprire Android SDK Manager. In Android SDK Manager passare alla scheda Strumenti e installare i pacchetti seguenti:

  • Strumenti da riga di comando di Android SDK 5.0 o versione successiva
  • Android SDK Platform-Tools 31.0.3 o versione successiva
  • Android SDK Build-Tools 30.0.3 o versione successiva

Lo snapshot disabilita la connessione Wi-Fi in Android Oreo

Se è stato configurato un AVD per Android Oreo con accesso Wi-Fi simulato, riavviare l'AVD dopo che uno snapshot potrebbe causare la disabilitazione dell'accesso Wi-Fi.

Per risolvere il problema:

  1. Aprire il Gestione dispositivi Android.

  2. Selezionare l'AVD in Android Device Manager.

  3. Scegliere Reveal in Explorer dal menu Opzioni aggiuntive (...) .

  4. Passare alla cartella snapshot > default_boot .

  5. Eliminare il file snapshot.pb:

    Location of the snapshot.pb file.

  6. Riavviare l'AVD.

Dopo aver apportato queste modifiche, l'AVD verrà riavviato in uno stato che consente di nuovo il funzionamento dell'accesso Wi-Fi.