Crea e gestisci dispositivi virtuali

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 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 > Virtuale Gestione dispositivi.

Apertura di Gestione dispositivi dalla schermata di benvenuto

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

Nuova finestra Gestione dispositivi

Dopo aver creato i tuoi dispositivi, potrai vedere un elenco di tutti i dispositivi nel riquadro Gestione dispositivi.

Elenco Gestione dispositivi

Se vuoi utilizzare dispositivi virtuali per eseguire i tuoi strumenti automatizzati in modo scalabile e autogestito, valuta la possibilità di utilizzare Gradle Managed Dispositivi.

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.

La finestra di dialogo Seleziona hardware

Una definizione di dispositivo etichettata con il logo Google Play nel La colonna Play Store include sia l'app Google Play Store che l'accesso a Google Play Services, inclusa una scheda Google Play nella La finestra di dialogo Controlli estesi che fornisce un comodo pulsante per l'aggiornamento 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.

Immagine di sistema
Finestra di dialogo

Nella scheda Consigliati sono elencate le immagini di sistema consigliate. La altre schede includono un elenco più completo. Il riquadro di destra descrive immagine di sistema selezionata.

Se vedi un'icona di download accanto a un'immagine di sistema, l'immagine non è attualmente installato sul tuo computer di sviluppo. Fai clic sull'icona per scaricare l'immagine di sistema. Devi essere connesso a internet per scaricare il sistema in formato Docker.

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. A tale scopo, potresti dover utilizzare un componente aggiuntivo per la durata di visualizzazione media. piattaforma; Ad esempio, il componente aggiuntivo delle API di Google contiene libreria.

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. Dopodiché puoi utilizzare 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 usare 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. Gestione dispositivi fornisce alcune skin predefinite. 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 sulle proprietà del profilo hardware e le proprietà di una durata di visualizzazione media per gli elenchi di funzionalità che puoi che definisci nella durata di visualizzazione media.

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 l'opzione Play Google 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. e poi fai clic su Avanti.

    Se non vedi il profilo hardware che ti interessa, puoi creazione oppure importare un profilo hardware, come descritto in in altre sezioni di questa pagina.

    Viene visualizzata la finestra Immagine di sistema.

  4. Seleziona l'immagine di sistema per un determinato livello API e 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. e fai clic su Fine.

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

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

  1. Da Scheda virtuale di in Gestione dispositivi, fai clic su Menu e seleziona Duplica.

    La sezione Verifica configurazione viene visualizzata la finestra di dialogo.

  2. Fai clic su Indietro se devi apportare modifiche al 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. per poterle aggiungere facilmente alle definizioni della durata di visualizzazione media. Se occorre definire un dispositivo diverso, creare un nuovo profilo hardware.

Puoi definire un nuovo profilo hardware dall'inizio o copiare un profilo hardware come punto di partenza. L'immagine precaricata I profili hardware non sono modificabili.

Per creare un nuovo profilo hardware dall'inizio:

  1. Nella sezione Seleziona hardware fai clic su New Hardware Profile (Nuovo profilo hardware).
  2. Nella finestra Configura profilo hardware, modifica proprietà del profilo hardware come necessaria.

    Finestra di dialogo Configura profilo hardware
  3. 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.

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

  1. Nella sezione 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 proprietà del profilo hardware come necessaria.
  3. Fai clic su Fine.
  4. 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.

Modifica durata di visualizzazione media 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 mostrare il valore AVD INI e File IMG su disco e fai clic su Menu e seleziona Mostra su 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 profilo e seleziona Modifica. Ora apporta le modifiche.
  • Per eliminare un profilo hardware, fai clic con il tasto destro del mouse e seleziona Elimina.

Eseguire e arrestare un emulatore e cancellare i dati

Dalla scheda Virtuale, puoi esegui queste operazioni su un emulatore:

  • Per eseguire un emulatore che utilizza una durata di visualizzazione media, 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.

Importazione ed esportazione di 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à della durata di visualizzazione media

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 della durata di visualizzazione media hanno priorità sulle proprietà del profilo hardware. le proprietà dell'emulatore che imposti mentre l'emulatore è in esecuzione sovrascriverle entrambi.

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 lettere 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 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 altro profilo hardware. nella finestra Seleziona hardware.
Immagine di sistema Fai clic su Cambia per selezionare un'immagine di sistema diversa da nella 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:

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

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 relative alla videocamera sono disponibili solo se una videocamera è supportata nell'hardware profilo. 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 comunicazioni mobili
  • HSCSD: dati interruttori di circuito ad alta velocità
  • GPRS: servizio radio pacchetti generico
  • EDGE: Tariffe dati migliorate per GSM Evolution
  • UMTS: sistema universale di telecomunicazioni mobile
  • HSDPA: accesso ai pacchetti downlink ad alta velocità
  • LTE:evoluzione a lungo termine
  • Completa (impostazione predefinita): trasferisci i dati velocemente come consente il computer.
Rete: latenza (avanzato) Seleziona un protocollo di rete per impostare il tempo necessario per la per trasferire un pacchetto di dati da un punto a un altro.
Prestazioni emulate: grafica

Seleziona come viene visualizzata la grafica nell'emulatore:

  • Hardware: utilizza la scheda grafica del computer per velocizzare il rendering.
  • Software: emula la grafica nel software, utile se vuoi problemi con il rendering della scheda grafica.
  • Automatico: lascia che sia l'emulatore a decidere l'opzione migliore in base a scheda grafica.
Prestazioni emulate: opzione di avvio (avanzata)

    Seleziona la modalità di avvio della durata di visualizzazione media:

  • Avvio a freddo:il dispositivo si accende ogni volta dalla dispositivo spento.
  • Avvio rapido:il dispositivo carica lo stato del dispositivo da una snapshot salvato.
Prestazioni emulate: CPU multi-core (avanzata) Seleziona il numero di core di processori sul computer che vuoi 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 dall'hardware produttore. L'aumento delle dimensioni richiede più risorse sul tuo 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 le dimensioni dello heap e seleziona unità, uno tra B (byte), KB (kilobyte), MB (megabyte), GB (gigabyte) TB (terabyte).
Memoria e spazio di archiviazione: memoria interna (avanzata) 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, vedi mksdcard e Dati sulla durata di visualizzazione media di Cloud Shell.

Frame dispositivo: attiva frame dispositivo Seleziona per abilitare un frame intorno alla finestra dell'emulatore che imita il un dispositivo reale.
Definizione di skin personalizzata (avanzata) Seleziona una skin che controlla l'aspetto del dispositivo quando viene visualizzato l'emulatore. L'indicazione di dimensioni troppo grandi per lo schermo la pelle può significare che lo schermo è tagliato, quindi non è possibile vedere schermo intero. Consulta le Crea un emulatore Skin per ulteriori informazioni.
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

È possibile specificare le seguenti proprietà per i profili hardware nella Finestra Configura profilo hardware. Proprietà di configurazione della durata di visualizzazione media eseguire l'override delle proprietà del profilo hardware e delle proprietà dell'emulatore impostate mentre l'emulatore è in esecuzione, sostituiscili entrambi.

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. Profilo hardware proprietà di configurazione

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 il file in cui si trova il profilo hardware viene ricavato dal profilo hardware nome.
Tipo di dispositivo

Seleziona una delle seguenti opzioni:

  • Smartphone/tablet
  • Wear OS
  • Android TV
  • Google TV
  • Dispositivo ChromeOS
  • Android Automotive
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 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 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 dispone di pulsanti di navigazione hardware. Deselezionala se questi pulsanti sono implementati solo nel 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 in caso contrario. Se selezioni questa opzione, la tastiera non viene visualizzata nella schermo. In entrambi i casi, puoi utilizzare la tastiera del computer per inviare le sequenze di tasti al un emulatore.
Input: stile di navigazione

Seleziona una delle seguenti opzioni:

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

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:

  • Verticale: orientato più in alto che in 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.

Fotocamere

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

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

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 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 una rotazione. In combinazione con un accelerometro, un giroscopio può fornire un supporto e un rilevamento dell'orientamento più fluido 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 dispone di hardware che rileva quando il dispositivo sia vicino al volto dell'utente durante una per disattivare l'immissione 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

Un emulatore Android è una raccolta di file che definiscono e gli elementi di controllo un emulatore. Se le definizioni di skin sono disponibili nelle impostazioni di visualizzazione di video, 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 configurazioni fisiche
  • 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 la configurazione della skin .
  2. Definisci l'aspetto visivo 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
                }
            }
        }
        ...
    }
    

  3. Aggiungi i file bitmap delle immagini del dispositivo alla stessa directory.
  4. Specificare ulteriori configurazioni di dispositivi specifiche per l'hardware in un sistema INI per le impostazioni del dispositivo, ad esempio hw.keyboard e hw.lcd.density.
  5. 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, vedi Android Emulator Skin File Specification nel codice sorgente degli strumenti.