Crea e gestisci dispositivi virtuali

Un dispositivo virtuale Android (AVD) è una configurazione che definisce le caratteristiche di uno smartphone, tablet, Wear OS, Android TV o dispositivo Automotive OS Android che vuoi simulare nell'emulatore Android. Gestione dispositivi è uno strumento che puoi avviare da Android Studio e che ti aiuta a creare e gestire gli AVD.

Per aprire il nuovo Gestore dispositivi, esegui una delle seguenti operazioni:

• Nella schermata di benvenuto di Android Studio, seleziona Altre azioni > Gestione dispositivi virtuali.

• Dopo aver aperto un progetto, seleziona Visualizza > Finestre degli strumenti > Gestione dispositivi dalla barra dei menu principale, poi fai clic sul segno + e poi su Crea dispositivo virtuale.

Dopo aver creato i dispositivi, potrai visualizzare un elenco di tutti i dispositivi nel riquadro del gestore dei dispositivi.

Se vuoi utilizzare dispositivi virtuali per eseguire i test automatici instrumentati in modo scalabile e autogestito, ti consigliamo di utilizzare i Dispositivi gestiti da Gradle.

Informazioni sulle AVD

Un AVD contiene un profilo hardware, un'immagine di sistema, un'area di archiviazione, una skin e altre proprietà.

Ti consigliamo di creare un AVD per ogni immagine di sistema che la tua app potrebbe potenzialmente supportare in base all'impostazione <uses-sdk> nel file manifest.

Profilo hardware

Il profilo hardware definisce le caratteristiche di un dispositivo come spedito dalla fabbrica. Il Gestore dispositivi è precompilato con determinati profili hardware, ad esempio i dispositivi Pixel, e puoi definire o personalizzare i profili hardware in base alle tue esigenze.

Una definizione del dispositivo etichettata con il logo di Google Play nella colonna Play Store include sia l'app Google Play Store sia l'accesso a Google Play Services, inclusa una scheda Google Play nella dialoga Controlli avanzati che fornisce un pratico pulsante per aggiornare Google Play Services sul dispositivo.

I dispositivi con questo logo e un tipo di dispositivo "Smartphone" sono inoltre conformi al CTS e potrebbero utilizzare immagini di sistema che includono l'app Play Store.

Immagini di sistema

Un'immagine di sistema etichettata con API di Google include l'accesso ai servizi di Google Play.

La scheda Consigliati elenca le immagini di sistema consigliate. Le altre schede includono un elenco più completo. Il riquadro a destra descrive l'immagine di sistema selezionata.

Se accanto a un'immagine di sistema è presente un'icona di download, significa che l'immagine non è attualmente installata sulla tua macchina di sviluppo. Fai clic sull'icona per scaricare l'immagine di sistema. Per scaricare le immagini di sistema, devi essere connesso a internet.

Il livello API del dispositivo di destinazione è importante perché la tua app non viene eseguita su un'immagine di sistema con un livello API inferiore a quello richiesto dall'app, come specificato nell'attributo minSdk nel file manifest dell'app. Per ulteriori informazioni sulla relazione tra il livello API di sistema e minSdk, consulta Eseguire il versionamento dell'app.

Se l'app dichiara un elemento <uses-library> nel file manifest, richiede un'immagine di sistema che includa la libreria esterna. Per eseguire l'app su un emulatore, crea un AVD che includa la libreria richiesta. Per farlo, potresti dover utilizzare un componente aggiuntivo per la piattaforma AVD. Ad esempio, il componente aggiuntivo API di Google contiene la libreria Google Maps.

Per garantire la sicurezza delle app e un'esperienza coerente con i dispositivi fisici, le immagini di sistema con il Google Play Store incluso sono firmate con una chiave di release, il che significa che non puoi ottenere privilegi elevati (root) con queste immagini.

Se hai bisogno di privilegi elevati (root) per risolvere i problemi relativi alle app, puoi utilizzare le immagini di sistema Android Open Source Project (AOSP) che non includono app o servizi Google. Quindi, puoi utilizzare i comandi adb root e adb unroot per passare dai privilegi normali a quelli elevati e viceversa:

  % adb shell
  emu64a:/ $
  emu64a:/ $ exit
  % adb root
  restarting adbd as root
  % adb shell
  emu64a:/ #
  emu64a:/ # exit
  % adb unroot
  restarting adbd as non root
  % adb shell
  emu64a:/ $
  emu64a:/ $ exit
  %
  

Spazio di archiviazione

L'AVD ha un'area di archiviazione dedicata sulla tua macchina di sviluppo. Memorizza i dati utente del dispositivo, come le app e le impostazioni installate, nonché una scheda SD emulata. Se necessario, puoi utilizzare Gestione dispositivi per cancellare i dati dell'utente in modo che il dispositivo abbia gli stessi dati di un dispositivo nuovo.

Pelle

Una skin dell'emulatore specifica l'aspetto di un dispositivo. Device Manager fornisce alcuni skin predefiniti. Puoi anche definire i tuoi o utilizzare skin forniti da terze parti.

Funzionalità AVD e app

Assicurati che la definizione dell'AVD includa le funzionalità del dispositivo su cui dipende la tua app. Consulta le sezioni sulle proprietà del profilo hardware e sulle proprietà AVD per gli elenchi delle funzionalità che puoi definire negli AVD.

Creare un AVD

Per creare un nuovo AVD:

1. Apri Gestione dispositivi.
2. Fai clic su Crea dispositivo.

   Viene visualizzata la finestra Seleziona hardware.

   

   Tieni presente che solo alcuni profili hardware includono il Play Store. Questi profili sono completamente conformi ai requisiti del CTS e potrebbero utilizzare immagini di sistema che includono l'app Play Store.

3. Seleziona un profilo hardware e poi fai clic su Avanti.

   Se non vedi il profilo hardware che ti interessa, puoi crearlo o importarlo, come descritto nelle altre sezioni di questa pagina.

   Viene visualizzata la finestra Immagine di sistema.

   
4. Seleziona l'immagine di sistema per un determinato livello API e poi fai clic su Avanti.

Viene visualizzata la finestra Verifica configurazione.


5. Modifica le proprietà AVD in base alle esigenze, poi fai clic su Fine.

   Fai clic su Mostra impostazioni avanzate per visualizzare altre impostazioni, ad esempio la skin.

Il nuovo AVD viene visualizzato nella scheda Virtuale di Gestore dispositivi e nel menu del dispositivo di destinazione.

Per creare un AVD partendo da una copia:

1. Nella scheda Virtuale di Gestione dispositivi, fai clic su Menu e seleziona Duplica.

   Viene visualizzata la finestra Verifica configurazione.

2. Fai clic su Precedente se devi apportare modifiche alle finestre Immagine di sistema o Seleziona hardware.
3. Apporta le modifiche necessarie e poi fai clic su Fine.

   L'AVD viene visualizzato nella scheda Virtuale di Gestore dispositivi.

Creare un profilo hardware

Device Manager fornisce profili hardware predefiniti per i dispositivi comuni, in modo da poterli aggiungere facilmente alle definizioni AVD. Se devi definire un dispositivo diverso, puoi creare un nuovo profilo hardware.

Puoi definire un nuovo profilo hardware da zero o copiare un profilo hardware come punto di partenza. I profili hardware precaricati non sono modificabili.

Per creare un nuovo profilo hardware dall'inizio:

1. Nella finestra Seleziona hardware, fai clic su Nuovo profilo hardware.

2. Nella finestra Configura profilo hardware, modifica le proprietà del profilo hardware in base alle esigenze.

   
3. Fai clic su Fine.

   Il nuovo profilo hardware viene visualizzato nella finestra Seleziona hardware. Puoi creare un AVD che utilizza il profilo hardware facendo clic su Avanti o su Annulla per tornare alla scheda Virtuale o al menu del dispositivo di destinazione.

Per creare un profilo hardware utilizzando una copia come punto di partenza:

1. Nella finestra Seleziona hardware, seleziona un profilo hardware e fai clic su Clona dispositivo oppure fai clic con il tasto destro del mouse su un profilo hardware e seleziona Clona.

2. Nella finestra Configura profilo hardware, modifica le proprietà del profilo hardware in base alle esigenze.
3. Fai clic su Fine.

Il nuovo profilo hardware viene visualizzato nella finestra Seleziona hardware. Puoi creare un AVD che utilizza il profilo hardware facendo clic su Avanti o su Annulla per tornare alla scheda Virtuale o al menu del dispositivo di destinazione.

Modificare gli AVD esistenti

Puoi eseguire le seguenti operazioni su un AVD dalla scheda Virtuale di Gestione dispositivi:

• Per modificare un AVD, fai clic su Modifica questo AVD e apporta le modifiche.
• Per eliminare un AVD, fai clic su Menu e seleziona Elimina.
• Per visualizzare i file INI e IMG AVD associati sul disco, fai clic su Menu e seleziona Mostra sul disco.
• Per visualizzare i dettagli di configurazione dell'AVD che puoi includere nei report di bug inviati al team di Android Studio, fai clic su Menu e seleziona Visualizza dettagli.

Modificare i profili hardware esistenti

Non puoi modificare o eliminare i profili hardware precaricati, ma puoi eseguire le seguenti operazioni su altri profili hardware dalla finestra Seleziona hardware:

• Per modificare un profilo hardware, selezionalo e fai clic su Modifica dispositivo. Puoi anche fare clic con il tasto destro del mouse su un profilo hardware e selezionare Modifica. Quindi, apporta le modifiche.
• Per eliminare un profilo hardware, fai clic con il tasto destro del mouse e seleziona Elimina.

Eseguire e interrompere un emulatore ed eliminare i dati

Dalla scheda Virtuale, puoi eseguire le seguenti operazioni su un emulatore:

• Per eseguire un emulatore che utilizza un AVD, fai clic su Avvia .
• Per interrompere un emulatore in esecuzione, fai clic su Menu e seleziona Interrompi.
• Per cancellare i dati di un emulatore, fai clic su Menu e seleziona Cancella dati.

Importare ed esportare i profili hardware

Dalla finestra Seleziona hardware, puoi importare ed esportare i profili hardware come segue:

• Per importare un profilo hardware, fai clic su Importa profili hardware e seleziona il file XML sul computer contenente la definizione.
• Per esportare un profilo hardware, fai clic con il tasto destro del mouse e seleziona Esporta. Specifica la posizione in cui vuoi archiviare il file XML contenente la definizione.

Proprietà AVD

La configurazione AVD specifica l'interazione tra il computer di sviluppo e l'emulatore, nonché le proprietà da sostituire nel profilo hardware. Puoi specificare le seguenti proprietà per le configurazioni AVD nella finestra Verifica configurazione. Le proprietà contrassegnate come (Avanzate) vengono visualizzate solo se fai clic su Mostra impostazioni avanzate.

Le proprietà di configurazione dell'AVD sostituiscono le proprietà del profilo hardware e le proprietà dell'emulatore impostate durante l'esecuzione dell'emulatore sostituiscono entrambe.

Tabella 1. Proprietà di configurazione AVD

Proprietà del profilo hardware

Puoi specificare le seguenti proprietà per i profili hardware nella finestra Configura profilo hardware. Le proprietà di configurazione AVD superano le proprietà del profilo hardware e le proprietà dell'emulatore impostate durante l'esecuzione dell'emulatore.

I profili hardware predefiniti inclusi in Gestione dispositivi non sono modificabili. Tuttavia, puoi copiare i profili e modificarli.

Alcune proprietà sono disattivate per alcuni tipi di dispositivi. Ad esempio, la proprietà "Round" è disponibile solo sui dispositivi Wear OS.

Tabella 2. Proprietà di configurazione del profilo hardware

Creare una skin dell'emulatore

Una skin dell'emulatore Android è una raccolta di file che definiscono gli elementi di controllo e visivi di un display dell'emulatore. Se le definizioni di skin disponibili nelle impostazioni dell'AVD non soddisfano i tuoi requisiti, puoi creare la tua definizione di skin personalizzata e poi applicarla all'AVD.

Ogni skin dell'emulatore contiene:

• Un file hardware.ini
• File di layout per orientamenti e configurazioni fisiche supportati
• File immagine per gli elementi di visualizzazione, come sfondo, tasti e pulsanti

Per creare e utilizzare una skin personalizzata:

1. Crea una directory in cui salvare i file di configurazione della skin.
2. Definisci l'aspetto della skin in un file di testo denominato layout. Questo file definisce molte caratteristiche della skin, come le dimensioni e gli asset immagine per pulsanti specifici. Ad esempio:

   parts {
       device {
           display {
               width   320
               height  480
               x       0
               y       0
           }
       }
   
       portrait {
           background {
               image background_port.png
           }
   
           buttons {
               power {
                   image  button_vertical.png
                   x 1229
                   y 616
               }
           }
       }
       ...
   }
   

3. Aggiungi i file bitmap delle immagini del dispositivo alla stessa directory.
4. Specifica configurazioni aggiuntive del dispositivo specifiche per l'hardware in un file INI per le impostazioni del dispositivo, ad esempio hw.keyboard e hw.lcd.density.
5. Archivia i file nella cartella della skin e seleziona il file dell'archivio come skin personalizzata.

Per informazioni più dettagliate sulla creazione di skin dell'emulatore, consulta la specifica del file della skin dell'emulatore Android nel codice sorgente degli strumenti.