Crea e gestisci dispositivi virtuali

Un dispositivo virtuale (AVD) Android è una configurazione che definisce le caratteristiche di un telefono o tablet Android, Wear OS, Android TV o dispositivo con sistema operativo Automotive che vuoi simulare nell'emulatore Android. Gestione dispositivi è uno strumento che puoi avviare da Android Studio e che ti aiuta a creare e gestire la durata di visualizzazione media.

Per aprire la nuova versione di Gestione dispositivi, esegui una delle seguenti operazioni:

  • Nella schermata di benvenuto di Android Studio, seleziona Altre azioni > Virtual Device Manager.

Aprite Gestione dispositivi dalla
schermata di benvenuto

  • Dopo aver aperto un progetto, seleziona Visualizza > Strumenti Windows > Gestione dispositivi dalla barra del menu principale, quindi fai clic su Crea dispositivo.

Finestra Nuova gestione dispositivi

Se vuoi utilizzare dispositivi virtuali per eseguire i test automatici instrumentati in modo scalabile e autogestito, valuta l'utilizzo dei dispositivi gestiti Gradle.

Informazioni sulla durata di visualizzazione media

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

Ti consigliamo di creare una durata di visualizzazione media 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 spedito dalla fabbrica. In Gestione dispositivi sono precaricati alcuni profili hardware, ad esempio i dispositivi Pixel, che puoi definire o personalizzare in base alle tue esigenze.

La finestra di dialogo Seleziona hardware

Una definizione di dispositivo con il logo 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 finestra di dialogo Controlli estesi che offre un pratico pulsante per aggiornare Google Play Services sul dispositivo.

Anche i dispositivi con questo logo e un tipo di dispositivo "Telefono" sono conformi alla CTS e potrebbero utilizzare immagini di sistema che includono l'app Play Store.

Immagini di sistema

Un'immagine di sistema con l'etichetta API di Google include l'accesso a Google Play Services.

La finestra di dialogo Immagine di sistema

Nella scheda Consigliate sono elencate le immagini di sistema consigliate. Le altre schede includono un elenco più completo. Il riquadro a destra descrive l'immagine di sistema selezionata.

Se vedi un'icona di download accanto a un'immagine di sistema, l'immagine non è attualmente installata sulla tua macchina di sviluppo. Fai clic sull'icona per scaricare l'immagine di sistema. Devi avere una connessione a internet per poter scaricare le immagini di sistema.

Il livello API del dispositivo di destinazione è importante, perché l'app non viene eseguita su un'immagine di sistema con un livello API inferiore a quello richiesto dalla tua app, come specificato nell'attributo minSdk nel file manifest dell'app. Per saperne di più sulla relazione tra il livello API di sistema e minSdk, consulta Eseguire il controllo della versione dell'app.

Se la tua app dichiara un elemento <uses-library> nel file manifest, l'app richiede un'immagine di sistema che includa la libreria esterna. Per eseguire la tua app su un emulatore, crea un AVD che includa la libreria richiesta. A tale scopo, potrebbe essere necessario utilizzare un componente aggiuntivo per la piattaforma AVD; ad esempio, il componente aggiuntivo delle API di Google contiene la libreria di 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 rilascio, il che significa che non puoi ottenere privilegi elevati (root) con queste immagini.

Se hai bisogno di privilegi elevati (root) per facilitare la risoluzione dei 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:

  % 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
  %
  

Area di archiviazione

L'AVD ha un'area di archiviazione dedicata sulla macchina di sviluppo. Archivia 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 utente in modo che il dispositivo abbia gli stessi dati di quando fosse nuovo.

Pelle

Una skin emulatore consente di specificare l'aspetto di un dispositivo. Gestione dispositivi fornisce alcune skin predefinite. Puoi anche definire skin tue o utilizzare skin fornite da terze parti.

Funzionalità di visualizzazione in tempo reale e delle app

Assicurati che la definizione della durata di visualizzazione media includa le funzionalità del dispositivo da cui dipende la tua app. Consulta le sezioni sulle proprietà dei profili hardware e sulle proprietà AVD per gli elenchi delle funzionalità che puoi definire nelle AVD.

Crea una durata di visualizzazione media

Per creare una nuova durata di visualizzazione media:

  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 alla CTS e potrebbero utilizzare immagini di sistema che includono l'app Play Store.

  3. Seleziona un profilo hardware, quindi fai clic su Avanti.

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

    Viene visualizzata la finestra Immagine di sistema.

  4. Seleziona l'immagine di sistema per un determinato livello API, quindi fai clic su Avanti.
  5. Viene visualizzata la finestra Verifica configurazione.

  6. Modifica le proprietà della durata di visualizzazione media in base alle tue esigenze, quindi fai clic su Fine.

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

  7. La nuova durata di visualizzazione media viene visualizzata nella scheda Virtuale di Gestione dispositivi e nel menu del dispositivo di destinazione.

Per creare una durata di visualizzazione media iniziando con una copia:

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

    Viene visualizzata la finestra Verifica configurazione.

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

    La durata di visualizzazione media viene visualizzata nella scheda Virtuale di Gestione dispositivi.

Crea un profilo hardware

Gestione dispositivi fornisce profili hardware predefiniti per i dispositivi più comuni, così puoi aggiungerli facilmente alle definizioni della durata di visualizzazione media. Se devi definire un dispositivo diverso, puoi creare un nuovo profilo hardware.

Puoi definire un nuovo profilo hardware da zero o copiarne uno 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 tue esigenze.

    La finestra di dialogo Configura profilo hardware
  3. Fai clic su Fine.

    Il nuovo profilo hardware viene visualizzato nella finestra Seleziona hardware. Puoi creare una durata di visualizzazione media che utilizzi 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 tue esigenze.
  3. Fai clic su Fine.
  4. Il nuovo profilo hardware viene visualizzato nella finestra Seleziona hardware. Puoi creare una durata di visualizzazione media che utilizzi il profilo hardware facendo clic su Avanti o su Annulla per tornare alla scheda Virtuale o al menu del dispositivo di destinazione.

Modifica le durate di visualizzazione di lunga durata esistenti

Puoi eseguire le seguenti operazioni su una durata di visualizzazione media dalla scheda Virtuale del gestore dispositivi:

  • Per modificare una durata di visualizzazione media, fai clic su Modifica questa durata di visualizzazione media e apporta le modifiche.
  • Per eliminare una durata di visualizzazione media, fai clic su Menu e seleziona Elimina.
  • Per visualizzare su disco i file AVD INI e IMG associati, fai clic su Menu e seleziona Mostra su disco.
  • Per visualizzare i dettagli di configurazione della funzionalità AVD che puoi includere nelle segnalazioni di bug per il team di Android Studio, fai clic su Menu e seleziona Visualizza dettagli.

Modifica 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.

Esegui e interrompi un emulatore e cancella i dati

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

  • Per eseguire un emulatore che utilizza una durata di visualizzazione media, fai clic su Avvia .
  • Per interrompere l'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.

Importa ed esporta profili hardware

Nella 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 sul computer il file XML contenente la definizione.
  • Per esportare un profilo hardware, fai clic con il tasto destro del mouse sul profilo e seleziona Esporta. Specifica la località 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à che vuoi sostituire nel profilo hardware. Puoi specificare le seguenti proprietà per le configurazioni AVD nella finestra Verifica configurazione. Le proprietà con l'etichetta (Avanzate) vengono visualizzate solo se fai clic su Mostra impostazioni avanzate.

Le proprietà di configurazione AVD sostituiscono le proprietà del profilo hardware e le proprietà dell'emulatore impostate mentre l'emulatore è in esecuzione hanno la precedenza su entrambe.

Tabella 1. Proprietà di configurazione Durata di visualizzazione media

Proprietà AVD Descrizione
Nome durata di visualizzazione media Inserisci un nome per la durata di visualizzazione media. Il nome può contenere lettere maiuscole o minuscole, numeri, punti, trattini bassi, parentesi, trattini e spazi. Il nome del file in cui è memorizzata la configurazione AVD deriva dal nome della durata di visualizzazione media.
ID durata di visualizzazione (AVD) (avanzato) Visualizza l'ID della durata di visualizzazione media. L'ID della durata di visualizzazione media deriva dal nome della durata di visualizzazione media. Puoi utilizzare l'ID per fare riferimento alla durata di visualizzazione media dalla riga di comando.
Profilo hardware Fai clic su Cambia per selezionare un profilo hardware diverso dalla finestra Seleziona hardware.
Immagine di sistema Fai clic su Cambia per selezionare un'immagine di sistema diversa dalla finestra Immagine di sistema. Per scaricare una nuova immagine è necessaria una connessione a internet attiva.
Orientamento all'avvio

Seleziona un'opzione per l'orientamento iniziale dell'emulatore:

  • Verticale: orientato più alto che largo
  • Paesaggio:orientato più largo che alto

Un'opzione viene attivata solo se è supportata nel profilo hardware. Quando esegui la modalità AVD nell'emulatore, puoi modificare l'orientamento se nel profilo hardware sono supportati sia verticale che orizzontale.

Fotocamera (avanzata)

Seleziona un'opzione per tutte le videocamere attive. Le impostazioni Emulato e VirtualScene producono un'immagine generata dal software, mentre l'impostazione Webcam utilizza la webcam del computer di sviluppo per scattare una foto

Le opzioni della fotocamera sono disponibili solo se una fotocamera è supportata nel profilo hardware. Non sono disponibili per Wear OS, Android TV o Google TV.

Rete: velocità (avanzata)

Seleziona un protocollo di rete per determinare la velocità di trasferimento dei dati:

  • GSM: sistema globale per le comunicazioni mobili
  • HSCSD: dati a commutazione da circuito ad alta velocità
  • GPRS: servizio radio pacchetti generico
  • EDGE: tariffe dati migliorate per GSM Evolution
  • UMTS:sistema universale di telecomunicazioni per dispositivi mobili
  • HSDPA: accesso al pacchetto di downlink ad alta velocità
  • LTE: evoluzione a lungo termine
  • Completa (predefinita): trasferisci i dati alla velocità consentita dal computer.
Rete: latenza (avanzata) Seleziona un protocollo di rete per impostare il tempo necessario per il trasferimento di un pacchetto di dati da un punto a un altro punto.
Prestazioni emulate: grafica

Seleziona come visualizzare la grafica nell'emulatore:

  • Hardware: utilizza la scheda grafica del computer per un rendering più veloce.
  • Software: emula la grafica nel software. Questa funzionalità è utile se hai problemi con il rendering della scheda grafica.
  • Automatica: lascia che sia l'emulatore a decidere l'opzione migliore in base alla tua scheda grafica.
Prestazioni emulate: opzione di avvio (avanzata)

    Seleziona la modalità di avvio di AVD:

  • Avvio a freddo: il dispositivo si accende ogni volta dallo stato spento.
  • Avvio rapido:il dispositivo carica lo stato del dispositivo da uno snapshot salvato.
Prestazioni emulate: CPU multi-core (avanzata) Seleziona il numero di core del processore sul computer che vuoi utilizzare per l'emulatore. L'utilizzo di più core di processore velocizza l'emulatore.
Memoria e spazio di archiviazione: RAM (avanzata) Esegui l'override della quantità di RAM sul dispositivo impostata dal produttore dell'hardware. Se aumenti le dimensioni, vengono utilizzate più risorse sul computer, ma è possibile velocizzare il funzionamento dell'emulatore. Inserisci le dimensioni della RAM e seleziona le unità: B (byte), KB (kilobyte), MB (megabyte), GB (gigabyte) o TB (terabyte).
Memoria e spazio di archiviazione: heap VM (avanzato) Esegui l'override delle dimensioni heap della VM impostate dal produttore dell'hardware. Inserisci una dimensione heap e seleziona le unità, tra B (byte), KB (kilobyte), MB (megabyte), GB (gigabyte) o TB (terabyte).
Memoria e spazio di archiviazione: archiviazione interna (avanzata) Esegui l'override della quantità di spazio di memoria non rimovibile disponibile sul dispositivo impostata dal produttore dell'hardware. Inserisci una dimensione e seleziona le unità: B (byte), KB (kilobyte), MB (megabyte), GB (gigabyte) o TB (terabyte).
Memoria e spazio di archiviazione: scheda SD (avanzata)

Specifica la quantità di spazio di memoria rimovibile disponibile per archiviare i dati sul dispositivo.

Per utilizzare una scheda SD virtuale gestita da Android Studio, seleziona Gestita da Studio, inserisci una dimensione e seleziona le unità: una tra B (byte), KB (kilobyte), MB (megabyte), GB (gigabyte) o TB (terabyte). Per utilizzare la fotocamera è consigliabile avere una dimensione minima di 100 MB.

Per gestire lo spazio in un file, seleziona File esterno e fai clic su ... per specificare il file e la posizione.

Per maggiori informazioni, consulta mksdcard e directory dei dati AVD.

Frame dispositivo: attiva Frame dispositivo Scegli di attivare intorno alla finestra dell'emulatore una cornice che riproduca l'aspetto di un dispositivo reale.
Definizione di skin personalizzata (avanzata) Seleziona una skin che controlla l'aspetto del dispositivo quando viene visualizzato nell'emulatore. Se specifichi una dimensione dello schermo troppo grande per la skin, lo schermo potrebbe essere tagliato e non puoi vedere l'intero schermo. Per maggiori informazioni, consulta la sezione Creare una skin emulatore.
Tastiera: attiva l'immissione da tastiera (avanzata) Seleziona questa opzione per utilizzare la tastiera hardware per interagire con l'emulatore. Questa opzione è disattivata per Wear OS e Android TV.

Proprietà del profilo hardware

Puoi specificare le seguenti proprietà per i profili hardware nella finestra Configura profilo hardware. Le proprietà di configurazione AVD eseguono l'override delle proprietà del profilo hardware e le proprietà dell'emulatore impostate mentre l'emulatore è in esecuzione hanno la precedenza su entrambe.

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

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

Tabella 2. Le proprietà di configurazione del profilo hardware

Proprietà del profilo hardware Descrizione
Nome dispositivo Inserisci un nome per il profilo hardware. Il nome può contenere lettere maiuscole o minuscole, numeri, punti, trattini bassi, parentesi e spazi. Il nome del file in cui è memorizzato il profilo hardware deriva dal nome del profilo hardware.
Tipo di dispositivo

Seleziona una delle seguenti opzioni:

  • Telefono/tablet
  • Wear OS
  • Android TV
  • Google TV
  • Dispositivo ChromeOS
  • Android Automotive
Schermo: dimensioni schermo Specifica le dimensioni fisiche dello schermo in pollici, misurate in diagonale. Se le dimensioni sono maggiori di quelle dello schermo del computer, vengono ridotte al momento del lancio.
Schermo: risoluzione dello schermo Inserisci la larghezza e l'altezza in pixel per specificare il numero totale di pixel sullo schermo simulato.
Schermo: rotondo Seleziona questa opzione se il dispositivo ha uno schermo rotondo, ad esempio alcuni dispositivi Wear OS.
Memoria: RAM Inserisci le dimensioni RAM del dispositivo e seleziona le unità: B (byte), KB (kilobyte), MB (megabyte), GB (gigabyte) o TB (terabyte).
Ingresso: dispone di pulsanti hardware (Indietro/Home/Menu) Seleziona questa opzione se il dispositivo è dotato di pulsanti di navigazione hardware. Deseleziona questa opzione se questi pulsanti sono implementati solo nel software. Se selezioni questa opzione, i pulsanti non verranno visualizzati sullo schermo. In entrambi i casi, puoi utilizzare il riquadro laterale dell'emulatore per simulare la pressione dei pulsanti.
Ingresso: dispone di tastiera hardware Seleziona questa opzione se il tuo dispositivo ha una tastiera hardware. Deselezionala in caso contrario. Se selezioni questa opzione, sullo schermo non viene visualizzata una tastiera. In entrambi i casi, puoi utilizzare la tastiera del computer per inviare le sequenze di tasti all'emulatore.
Input: stile di navigazione

Seleziona una delle seguenti opzioni:

  • Nessuno:nessun controllo hardware. La navigazione avviene tramite software.
  • D-pad: supporto direzionale del pad.
  • Trackball
  • Ruota

Queste opzioni riguardano i controlli hardware sul dispositivo stesso. Tuttavia, gli eventi inviati al dispositivo da un controller esterno sono gli stessi.

Stati del dispositivo supportati

Seleziona una o entrambe le opzioni:

  • Verticale: orientato più alto che largo
  • Paesaggio:orientato più largo che alto

Devi selezionare almeno un'opzione. Se selezioni entrambe le opzioni, puoi passare da un orientamento all'altro nell'emulatore.

Videocamere

Per attivare la videocamera, seleziona una o entrambe le opzioni:

  • Fotocamera posteriore:l'obiettivo è rivolto verso l'esterno dell'utente.
  • Fotocamera anteriore:l'obiettivo rivolto verso l'utente.

Se la fotocamera è abilitata, puoi utilizzare la webcam della macchina di sviluppo o una foto fornita dall'emulatore per simulare di scattare una foto, in base alle opzioni selezionate nella configurazione AVD.

Sensori: accelerometro Seleziona questa opzione se il dispositivo ha hardware che ne determina l'orientamento.
Sensori: giroscopio Seleziona questa opzione se il dispositivo dispone di hardware che rileva la rotazione o la rotazione. In combinazione con un accelerometro, un giroscopio può fornire un rilevamento dell'orientamento più fluido e supportare un sistema di orientamento a sei assi.
Sensori: GPS Seleziona questa opzione se il dispositivo dispone di hardware che supporta il sistema di navigazione satellitare basato sul Global Positioning System (GPS).
Sensori: sensore di prossimità Seleziona questa opzione se il dispositivo dispone di hardware che rileva quando il dispositivo è vicino al volto dell'utente durante una telefonata per disattivare l'input dallo schermo.
Skin predefinita Seleziona una skin che controlla l'aspetto del dispositivo quando viene visualizzato nell'emulatore. Se specifichi una dimensione dello schermo troppo grande per la risoluzione, lo schermo potrebbe essere tagliato e non puoi vedere l'intero schermo. Per maggiori informazioni, consulta la sezione che segue sulla creazione di una skin emulatore.

Crea un'interfaccia emulatore

Un'interfaccia emulatore Android è una raccolta di file che definiscono gli elementi visivi e di controllo di uno schermo emulatore. Se le definizioni della skin disponibili nelle impostazioni della durata di visualizzazione media non soddisfano i tuoi requisiti, puoi creare la definizione personalizzata della skin e applicarla alla durata di visualizzazione media.

Ogni skin emulatore contiene:

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

Per creare e utilizzare un'interfaccia personalizzata:

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

    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 di dispositivi specifiche per l'hardware aggiuntive 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 di archivio come skin personalizzata.

Per informazioni più dettagliate sulla creazione di skin per gli emulatori, consulta la pagina Android Emulator Skin File Specification nel codice sorgente degli strumenti.