Un dispositivo virtuale Android è una configurazione che definisce le caratteristiche di uno smartphone o tablet Android, Wear OS, Android TV oppure il dispositivo Automotive OS che vuoi simulare nel 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 Gestione dispositivi, esegui una delle seguenti operazioni:
- Dalla schermata di benvenuto di Android Studio, seleziona Altre azioni > Virtuale Gestione dispositivi.
- Dopo aver aperto un progetto, seleziona Visualizza > Finestre degli strumenti > Gestione dispositivi dalla barra del menu principale, poi fai clic su + e infine su Crea Dispositivo virtuale.
Dopo aver creato i tuoi dispositivi, potrai vedere un elenco di tutti i dispositivi nel riquadro Gestione 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 sulla durata di visualizzazione media
Una durata di visualizzazione media 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 visualizzata nell'app
potrebbero potenzialmente supportare in base
<uses-sdk> nel file manifest.
Profilo hardware
Il profilo hardware definisce le caratteristiche di un dispositivo spedito dalla fabbrica. In Gestione dispositivi sono precaricate alcune profili hardware, come i dispositivi Pixel, e puoi definire o personalizzare profili hardware necessari.
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 finestra di dialogo Controlli avanzati che fornisce un pratico pulsante per aggiornare Google Play Services sul dispositivo.
Dispositivi con questo logo e di tipo "Telefono" anche Conforme alla CTS e potrebbe 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. servizi di terze parti.
Nella scheda Consigliati sono elencate le immagini di sistema consigliate. La 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 del sistema, devi essere connesso a internet.
Il livello API del dispositivo di destinazione è importante perché la tua app
non viene eseguito su un'immagine di sistema con un livello API inferiore a quello
richiesto dalla tua app, come specificato
minSdk nel file manifest dell'app. Per ulteriori informazioni
informazioni sulla relazione tra il livello API di sistema e
minSdk, vedi Eseguire la versione dell'app.
Se la tua app dichiara un
<uses-library> nel file manifest, l'app
richiede un'immagine di sistema che includa la libreria esterna.
Per eseguire l'app su un emulatore, crea una durata di visualizzazione media che includa i necessari
libreria. 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 che includono il Google Play Store siano firmate con una release , il che significa che non puoi ottenere privilegi elevati (root) con questi in formato Docker.
Se hai bisogno di privilegi elevati (root) per facilitare la risoluzione dei problemi relativi alle app,
puoi utilizzare 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
La durata di visualizzazione media dispone di un'area di archiviazione dedicata sul computer 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 le tue opzioni o utilizzare skin forniti 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 utilizzate dall'app attiva. Consulta le sezioni relative alle proprietà del profilo hardware e alle proprietà AVD per gli elenchi delle funzionalità che puoi definire negli AVD.
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 l'opzione Play Google Store. Questi profili sono completamente conformi al 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 crearlo o importarlo, come descritto nelle altre sezioni di questa pagina.
Viene visualizzata la finestra Immagine di sistema.
- Seleziona l'immagine di sistema per un determinato livello API e poi fai clic su Avanti.
- Modifica le proprietà della durata di visualizzazione media in base alle tue esigenze.
e 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 il menu del dispositivo di destinazione.
Per creare una durata di visualizzazione media iniziando con una copia:
- Nella scheda Virtuale di Gestione dispositivi, fai clic su Menu
e seleziona Duplica.
La sezione Verifica configurazione viene visualizzata la finestra di dialogo.
- Fai clic su Indietro se devi apportare modifiche al Immagine di sistema o Seleziona Hardware.
- Apporta le modifiche necessarie, poi fai clic su Fine.
L'AVD viene visualizzato nella scheda Virtuale di Gestore dispositivi.
Crea un profilo hardware
Gestione dispositivi fornisce profili hardware predefiniti per i dispositivi più comuni. per poterle aggiungere 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 dall'inizio o copiare un profilo hardware 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 proprietà del profilo hardware come necessaria.
- Fai clic su Fine.
Il tuo 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:
- 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 esigenze.
- Fai clic su Fine.
Il tuo nuovo profilo hardware viene visualizzato nella finestra Seleziona hardware. Puoi creare una durata di visualizzazione media che utilizza il profilo hardware facendo clic su Avanti o su Annulla per tornare indietro alla scheda Virtuale o al menu del dispositivo di destinazione.
Modificare gli AVD esistenti
Su una durata di visualizzazione media, puoi eseguire le seguenti operazioni dal menu Scheda Virtuale:
- Per modificare una durata di visualizzazione media, fai clic su Modifica questa durata di visualizzazione media.
e
apportare le modifiche. - Per eliminare una durata di visualizzazione media, 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 della durata
di visualizzazione media,
includi 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 nella 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 e seleziona Elimina.
Esegui e interrompi un emulatore ed elimina i dati
Dalla scheda Virtuale, puoi esegui queste 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 relativi a un emulatore, fai clic su Menu
e seleziona Cancella dati.
Importare ed esportare profili hardware
Nella finestra Seleziona hardware, puoi importare ed esportare profili hardware nel seguente modo:
- Per importare un profilo hardware, fai clic su Importa profili hardware e seleziona l'XML. sul tuo computer 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 File XML contenente la definizione.
Proprietà AVD
La configurazione della durata di visualizzazione media specifica l'interazione tra lo sviluppo computer e l'emulatore, nonché le proprietà che desideri sostituire nel profilo hardware. Puoi specificare le seguenti proprietà per la durata di visualizzazione media nella finestra Verifica configurazione. Le proprietà contrassegnate con l'etichetta (Avanzata) 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 della durata di visualizzazione media
| Proprietà della durata di visualizzazione media | Descrizione |
|---|---|
| Nome AVD | 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 che memorizza la configurazione dell'AVD è derivato dal nome dell'AVD. |
| ID durata di visualizzazione media (avanzato) | Visualizza l'ID AVD. 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 avvio | Seleziona un'opzione per l'orientamento iniziale dell'emulatore:
Un'opzione viene attivata soltanto se è supportata nel profilo hardware. Quando che esegue la durata di visualizzazione media nell'emulatore, puoi modificare l'orientamento dei due formati orizzontale e orizzontale sono supportati nel profilo hardware. |
| Fotocamera (avanzata) | Seleziona un'opzione per le videocamere abilitate. L'emulazione di Le impostazioni di VirtualScene producono un'immagine generata da software, mentre L'impostazione della webcam utilizza la webcam del computer di sviluppo per scattare una foto Le opzioni della videocamera 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 all'altro. |
| Prestazioni emulate: grafica | Seleziona come viene visualizzata la grafica nell'emulatore:
|
| Prestazioni emulate: opzione di avvio (avanzata) |
Seleziona la modalità di avvio dell'AVD: |
| Prestazioni emulate: CPU multi-core (avanzata) | Seleziona il numero di core del processore del computer che vuoi utilizzare per l'emulatore. L'utilizzo di più core del processore velocizza l'emulatore. |
| Memoria e spazio di archiviazione: RAM (avanzata) | Sostituisci la quantità di RAM sul dispositivo impostata dal produttore dell'hardware. L'aumento delle dimensioni utilizza più risorse sul computer, ma supporta un funzionamento più rapido dell'emulatore. Inserisci una dimensione RAM e seleziona unità, uno tra B (byte), KB (kilobyte), MB (megabyte), GB (gigabyte) TB (terabyte). |
| Memoria e spazio di archiviazione: heap VM (avanzato) | Esegui l'override delle dimensioni heap della VM impostate dall'hardware produttore. Inserisci una dimensione dell'heap e seleziona le unità, tra B (byte), KB (kilobyte), MB (megabyte), GB (gigabyte) o TB (terabyte). |
| Memoria e spazio di archiviazione: spazio di archiviazione interno (avanzato) | Sostituisci la quantità di spazio di memoria non rimovibile disponibile sul dispositivo impostato dal produttore dell'hardware. Inserisci una dimensione e seleziona unità, uno tra B (byte), KB (kilobyte), MB (megabyte), GB (gigabyte) 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 unità, uno tra B (byte), KB (kilobyte), MB (megabyte), GB (gigabyte) 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 il percorso. Per ulteriori informazioni, consulta
|
| Frame dispositivo: attiva frame dispositivo | Seleziona per abilitare un frame intorno alla finestra dell'emulatore che imita il un dispositivo reale. |
| Definizione personalizzata della pelle (avanzata) | Seleziona una skin che controlla l'aspetto del dispositivo quando viene visualizzato l'emulatore. Se specifichi una dimensione dello schermo troppo grande per la skin, lo schermo potrebbe essere tagliato e non potrai visualizzarlo completamente. Per ulteriori informazioni, consulta la sezione Creare una skin dell'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 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 modificare le copie.
Alcune proprietà sono disattivate per alcuni tipi di dispositivi. Ad esempio, la colonna "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 che memorizza il profilo hardware è derivato 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 più grandi di quelle dello schermo del computer, le dimensioni verranno ridotte nel avviare l'applicazione. |
| Schermo: risoluzione dello schermo | Inserisci una larghezza e un'altezza in pixel per specificare il numero totale di pixel sullo schermo simulato. |
| Schermo: tondo | Seleziona questa opzione se il dispositivo ha uno schermo rotondo, ad esempio Wear OS. |
| Memoria: RAM | Inserisci le dimensioni della RAM del dispositivo e seleziona le unità, una tra 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 tasti di navigazione hardware. Deselezionala se questi pulsanti sono implementati solo in software. Se 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. |
| Input: ha una tastiera hardware | Seleziona questa opzione se il tuo dispositivo ha una tastiera hardware. Deselezionala se non è così. Se selezioni questa opzione, la tastiera non viene visualizzata nella schermo. In entrambi i casi, puoi utilizzare la tastiera del computer per inviare sequenze di tasti all'emulatore. |
| Input: stile di navigazione | Seleziona una delle seguenti opzioni:
Queste opzioni sono per i controlli hardware sul dispositivo stesso. Tuttavia, gli eventi inviati al dispositivo da un controller esterno sono gli stessi. |
| Stati dei dispositivi supportati | Seleziona una o entrambe le opzioni:
Devi selezionare almeno un'opzione. Se selezioni entrambe le opzioni, puoi passare da un'orientazione all'altra nell'emulatore. |
| Fotocamere | Per attivare la fotocamera, seleziona una o entrambe le opzioni:
Se la videocamera è attiva, puoi usare quella del computer di sviluppo o una foto fornita dall'emulatore per simulare lo scatto di una foto, in base sulle opzioni selezionate nella configurazione della durata di visualizzazione media. |
| Sensori: accelerometro | Seleziona questa opzione se il dispositivo è dotato di hardware che lo aiuta a determinare il suo orientamento. |
| Sensori: giroscopio | Seleziona questa opzione se il dispositivo dispone di hardware che rileva la rotazione o una rotazione. In combinazione con un accelerometro, il 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 Sistema GPS di navigazione satellitare. |
| Sensori: sensore di prossimità | Seleziona questa opzione se il dispositivo è dotato 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. L'indicazione di dimensioni dello schermo troppo grandi per risoluzione può significare che lo schermo è tagliato, quindi non è possibile vedere schermo. Consulta la sezione che segue creazione di un emulatore pelle per ulteriori informazioni. |
Crea 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:
- Crea una directory in cui salvare la configurazione della skin .
- Definisci l'aspetto della skin in un file di testo denominato
layout. Questo file definisce molte caratteristiche della pelle, come dimensioni e 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 } } } ... } - Aggiungi i file bitmap delle immagini del dispositivo alla stessa directory.
- Specifica configurazioni aggiuntive 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 della skin dell'emulatore Android nel codice sorgente degli strumenti.