Un dispositivo virtuale Android (AVD) è una configurazione che definisce le caratteristiche di uno smartphone o tablet Android, di un dispositivo Wear OS, Android TV o Automotive OS che vuoi simulare nell'emulatore Android. Gestione dispositivi è uno strumento avviabile da Android Studio che ti aiuta a creare e gestire la durata di visualizzazione media.
Per aprire la nuova Gestione dispositivi, procedi in uno dei seguenti modi:
- Dalla schermata di benvenuto di Android Studio, seleziona Altre azioni > Gestione dispositivi virtuali.
- Dopo aver aperto un progetto, seleziona View > Tool Windows > Device Manager (Visualizza > Finestre strumenti > Gestione dispositivi) dalla barra del menu principale, quindi fai clic su + e quindi su Crea dispositivo virtuale.
Dopo aver creato i dispositivi, potrai vedere un elenco di tutti i dispositivi nel riquadro Gestione dispositivi.
Se vuoi utilizzare dispositivi virtuali per eseguire i test con strumenti automatizzati in modo scalabile e autogestito, valuta la possibilità di utilizzare Gradle Managed Devices.
Informazioni sulla durata di visualizzazione media
Una durata di visualizzazione media contiene profilo hardware, immagine di sistema, area di archiviazione, skin e altre proprietà.
Ti consigliamo di creare una durata di visualizzazione media per ogni immagine di sistema che la tua app potrebbe 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. In Gestione dispositivi sono precaricati determinati profili hardware, ad esempio i dispositivi Pixel, e puoi definire o personalizzare i profili in base alle tue esigenze.
Una definizione di dispositivo 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 finestra di dialogo Controlli estesi che fornisce un comodo pulsante per aggiornare Google Play Services sul dispositivo.
I dispositivi con questo logo e il tipo di dispositivo "Telefono" sono inoltre conformi alla direttiva CTS e potrebbero utilizzare immagini di sistema che includono l'app Play Store.
Immagini di sistema
Un'immagine di sistema con etichetta API di Google include l'accesso a Google Play Services.
Nella scheda Consigliati 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, significa che quell'immagine non è attualmente installata sul tuo computer di sviluppo. Fai clic sull'icona per scaricare l'immagine di sistema. Per scaricare le immagini di sistema devi avere una connessione 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 dalla tua app, come specificato nell'attributo
minSdk nel file manifest dell'app. Per maggiori
informazioni sulla relazione tra il livello API di sistema e
minSdk, consulta Eseguire la versione dell'app.
Se la tua app dichiara un
elemento
<uses-library> nel file manifest, l'app
richiede un'immagine di sistema che include la libreria esterna.
Per eseguire l'app su un emulatore, crea una durata di visualizzazione media che includa la libreria
richiesta. A tale scopo, potresti dover 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
La durata di visualizzazione media dispone di un'area di archiviazione dedicata sul computer di sviluppo. Archivia i dati utente del dispositivo, ad esempio 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 un dispositivo nuovo.
Pelle
Una skin dell'emulatore specifica l'aspetto di un dispositivo. Gestione dispositivi fornisce alcune skin predefinite. Puoi anche definire le tue impostazioni o utilizzare skin fornite da terze parti.
Durata di visualizzazione media e funzionalità dell'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à del profilo hardware e sulle proprietà di visualizzazione media per gli elenchi delle funzionalità che puoi definire nei tuoi dati di visualizzazione di pagina.
Crea una durata di visualizzazione media
Per creare una nuova durata di visualizzazione media:
- Apri Gestione dispositivi.
- 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.
- Seleziona un profilo hardware e poi fai clic su Avanti.
Se non vedi il profilo hardware che ti interessa, puoi creare o importare un profilo hardware, come descritto in altre sezioni di questa pagina.
Viene visualizzata la finestra Immagine di sistema.
- Seleziona l'immagine di sistema per un determinato livello API, quindi fai clic su Avanti.
- Modifica le proprietà di una durata di visualizzazione media come necessario, quindi fai clic su Fine.
Fai clic su Mostra impostazioni avanzate per visualizzare altre impostazioni, ad esempio la skin.
Viene visualizzata la finestra Verifica configurazione.
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:
- Dalla scheda
Virtuale di
Gestione dispositivi, fai clic su Menu
e seleziona Duplica.
Viene visualizzata la finestra Verifica configurazione.
- Fai clic su Indietro se devi apportare modifiche alle finestre Immagine di sistema o Seleziona hardware.
- 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 tue definizioni di durata di visualizzazione media. Se devi definire un dispositivo diverso, puoi creare un nuovo profilo hardware.
Puoi definire un nuovo profilo hardware dall'inizio oppure copiarne uno come punto di partenza. I profili hardware precaricati non sono modificabili.
Per creare un nuovo profilo hardware dall'inizio:
- Nella finestra Seleziona hardware, fai clic su Nuovo profilo hardware.
Nella finestra Configura profilo hardware, modifica le proprietà del profilo hardware in base alle tue esigenze.
- Fai clic su Fine.
Il tuo 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:
- 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.
- Nella finestra Configura profilo hardware, modifica le proprietà del profilo hardware in base alle tue esigenze.
- Fai clic su Fine.
Il tuo 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 durata di visualizzazione media esistenti
Su una durata di visualizzazione media, puoi eseguire le seguenti operazioni dalla scheda Virtuale di Gestione 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 i file AVD INI e IMG associati su disco, fai clic su Menu
e seleziona Mostra su disco.
- Per visualizzare i dettagli di configurazione della durata di visualizzazione media da
includere nelle segnalazioni di bug 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. Ora apporta le modifiche.
- Per eliminare un profilo hardware, fai clic con il tasto destro del mouse sul profilo e seleziona Elimina.
Eseguire e arrestare un emulatore e cancellare 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 Launch
. - Per interrompere un emulatore in esecuzione, fai clic su Menu
e seleziona Stop.
- Per cancellare i dati di un emulatore, fai clic su Menu
e seleziona Cancella dati.
Importazione ed esportazione di profili hardware
Nella finestra Seleziona hardware, puoi importare ed esportare i profili hardware nel seguente modo:
- 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 posizione in cui vuoi archiviare il file XML contenente la definizione.
Proprietà della durata di visualizzazione media
La configurazione della durata di visualizzazione media 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 Verify Configuration (Verifica configurazione). Le proprietà etichettate come (Avanzate) vengono visualizzate solo se fai clic su Mostra impostazioni avanzate.
Le proprietà di configurazione AVD eseguono l'override delle proprietà del profilo hardware e quelle dell'emulatore impostate mentre l'emulatore è in esecuzione le sostituiscono.
Tabella 1. Proprietà di configurazione della durata di visualizzazione media
| Proprietà della durata di visualizzazione media | 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 della durata di visualizzazione media deriva dal nome della durata di visualizzazione media. |
| ID durata di visualizzazione media (avanzato) | Visualizza l'ID durata di visualizzazione. 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 nella 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 Internet attiva. |
| Orientamento avvio | Seleziona un'opzione per l'orientamento iniziale dell'emulatore:
Un'opzione viene attivata soltanto se è supportata nel profilo hardware. Quando esegui la durata di visualizzazione media nell'emulatore, puoi modificare l'orientamento se nel profilo hardware sono supportati sia verticale che orizzontale. |
| Fotocamera (avanzata) | Seleziona un'opzione per le videocamere abilitate. Le impostazioni Emulated e VirtualScene producono un'immagine generata da software, mentre l'impostazione Webcam utilizza la webcam del computer di sviluppo per scattare una foto Le opzioni relative alla fotocamera sono disponibili solo se una videocamera è 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:
|
| Rete: latenza (avanzato) | Seleziona un protocollo di rete per impostare il tempo necessario al protocollo per trasferire un pacchetto di dati da un punto di accesso a un altro. |
| Prestazioni emulate: grafica | Seleziona come viene visualizzata la grafica nell'emulatore:
|
| Prestazioni emulate: opzione di avvio (avanzata) |
Seleziona la modalità di avvio della durata di visualizzazione media: |
| Prestazioni emulate: CPU multi-core (avanzata) | Seleziona il numero di core di processori sul computer che vuoi utilizzare per l'emulatore. L'utilizzo di più core di processori velocizza l'emulatore. |
| Memoria e spazio di archiviazione: RAM (avanzata) | Esegui l'override della quantità di RAM sul dispositivo impostata dal produttore dell'hardware. L'aumento delle dimensioni richiede più risorse sul computer, ma consente un funzionamento più rapido dell'emulatore. Inserisci una dimensione 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 una delle unità, ovvero B (byte), KB (kilobyte), MB (megabyte), GB (gigabyte) o TB (terabyte). |
| Memoria e spazio di archiviazione: memoria interna (avanzata) | Esegui l'override della quantità di spazio di memoria non rimovibile disponibile sul dispositivo impostato 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à: B (byte), KB (kilobyte), MB (megabyte), GB (gigabyte) o TB (terabyte). Per utilizzare la fotocamera, si consigliano almeno 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
|
| Frame dispositivo: attiva frame dispositivo | Seleziona questa opzione per abilitare un frame intorno alla finestra dell'emulatore che riproduce 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 viene specificata una dimensione dello schermo troppo grande per la pelle, lo schermo potrebbe essere tagliato e non sarà quindi possibile visualizzare l'intero schermo. Per ulteriori informazioni, consulta la sezione Creare un'interfaccia per emulatore. |
| Tastiera: attiva l'inserimento da tastiera (avanzato) | Seleziona questa opzione per usare 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 della funzionalità AVD eseguono l'override delle proprietà del profilo hardware e quelle dell'emulatore impostate mentre l'emulatore è in esecuzione le sostituiscono.
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à "Rotondo" è disponibile solo sui dispositivi Wear OS.
Tabella 2. 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 è archiviato il profilo hardware deriva dal nome del profilo hardware. |
| Tipo di dispositivo | Seleziona una delle seguenti opzioni:
|
| Schermo: dimensioni dello schermo | Specifica le dimensioni fisiche dello schermo in pollici, misurate in diagonale. Se le dimensioni sono superiori a quelle dello schermo del computer, le dimensioni verranno ridotte al momento del lancio. |
| Schermo: risoluzione dello schermo | Inserisci la larghezza e l'altezza in pixel per specificare il numero totale di pixel sulla schermata simulata. |
| Schermo: rotondo | Seleziona questa opzione se il dispositivo ha uno schermo rotondo, ad esempio alcuni dispositivi Wear OS. |
| Memoria: RAM | Inserisci le dimensioni della 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 dispone di pulsanti di navigazione hardware. Deselezionala se questi pulsanti sono implementati solo nel software. Se selezioni questa opzione, i pulsanti non vengono visualizzati sullo schermo. In entrambi i casi, puoi utilizzare il riquadro laterale dell'emulatore per simulare la pressione dei pulsanti. |
| Input: ha una tastiera hardware | Seleziona questa opzione se il tuo dispositivo ha una tastiera hardware. Deselezionala in caso contrario. Se selezioni questa opzione, la tastiera non viene visualizzata sullo schermo. 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:
Queste opzioni riguardano i controlli hardware del 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:
Devi selezionare almeno un'opzione. Se selezioni entrambe le opzioni, puoi passare da un orientamento all'altro nell'emulatore. |
| Videocamere | Per attivare la fotocamera, seleziona una o entrambe le opzioni:
Se la fotocamera è abilitata, puoi utilizzare la webcam del computer di sviluppo o una foto fornita dall'emulatore per simulare lo scatto di una foto, in base alle opzioni selezionate nella configurazione della durata di visualizzazione media. |
| Sensori: accelerometro | Seleziona questa opzione se il dispositivo dispone di hardware che lo consente di determinare il suo 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 basato su satellite 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 visualizzato nell'emulatore. Se viene specificata una dimensione dello schermo troppo grande per la risoluzione, lo schermo verrà tagliato e non sarà quindi possibile visualizzare l'intero schermo. Per saperne di più, consulta la sezione che segue sulla creazione di una skin dell'emulatore. |
Crea una skin dell'emulatore
Una skin dell'emulatore Android è una raccolta di file che definiscono gli elementi visivi e di controllo del display di un emulatore. Se le definizioni della skin disponibili nelle impostazioni della durata di visualizzazione media non soddisfano i tuoi requisiti, puoi creare una definizione di skin personalizzata e applicarla alla durata di visualizzazione media.
Ogni skin dell'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 una skin personalizzata:
- Crea una directory in cui salvare i file di configurazione della skin.
- 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 } } } ... } - Aggiungi i file bitmap delle immagini del dispositivo alla stessa directory.
- Specifica ulteriori configurazioni del dispositivo specifiche per l'hardware in un file INI per le impostazioni del dispositivo, ad esempio
hw.keyboardehw.lcd.density. - Archivia i file nella cartella Skin e seleziona il file di archivio come skin personalizzata.
Per informazioni più dettagliate sulla creazione di skin dell'emulatore, consulta la specifica del file di Android Emulator Skin nel codice sorgente degli strumenti.