Avvia l'emulatore dalla riga di comando

Il contenuto della partizione di dati, che viene visualizzato come data/ nel sistema emulato. Quando crei un nuovo AVD o quando utilizzi l'opzione -wipe-data per ripristinare le impostazioni predefinite di fabbrica dell'AVD, l'emulatore copia il file userdata.img nella directory di sistema per creare questo file.

Ogni istanza di dispositivo virtuale utilizza un'immagine di dati utente scrivibile per archiviare dati specifici dell'utente e della sessione. Ad esempio, utilizza l'immagine per archiviare i dati dell'app installata, le impostazioni, i database e i file di un utente unico. Ogni utente ha una directory ANDROID_SDK_HOME diversa che archivia le directory di dati per gli AVD creati da quell'utente. Ogni AVD ha un singolo file userdata-qemu.img.

(Facoltativo) Un'immagine della partizione della scheda SD che ti consente di simulare una scheda SD su un dispositivo virtuale. Puoi creare un file immagine della scheda SD in AVD Manager o utilizzando lo strumento mksdcard. Il file è archiviato sul computer di sviluppo e deve essere caricato all'avvio.

Quando definisci un AVD in Gestione AVD, puoi scegliere di utilizzare un file della scheda SD gestito automaticamente o un file creato con lo strumento mksdcard. Puoi visualizzare il file sdcard.img associato a un AVD in Gestione AVD. L'opzione -sdcard ignora il file della scheda SD specificato nell'AVD. Tieni presente che questa opzione per la scheda SD non funziona su Mac con Apple Silicon.

Puoi sfogliare, inviare, copiare e rimuovere file da una scheda SD simulata utilizzando la UI dell'emulatore o l'utilità adb mentre il dispositivo virtuale è in esecuzione. Non puoi rimuovere una scheda SD simulata da un dispositivo virtuale in esecuzione.

Per copiare i file nel file della scheda SD prima di caricarlo, monta il file immagine come dispositivo di loop e poi copia i file. In alternativa, utilizza un'utilità, ad esempio il pacchetto mtools, per copiare i file direttamente nell'immagine.

L'emulatore considera il file come un pool di byte, quindi il formato della scheda SD non ha importanza.

L'opzione -wipe-data non influisce su questo file. Se vuoi cancellare il file, eliminalo e ricrealo utilizzando Gestione AVD o lo strumento mksdcard. La modifica delle dimensioni del file elimina anche il file e ne crea uno nuovo.

Imposta la modalità di emulazione per una videocamera rivolta verso la parte posteriore o anteriore. Questa impostazione esegue l'override di qualsiasi impostazione della videocamera nell'AVD.

mode può essere uno dei seguenti valori:

• emulated: l'emulatore simula una videocamera nel software.
• environment: l'emulatore utilizza una scena virtuale definita nel file di configurazione dell'ambiente dell'AVD.
• webcamn - L'emulatore utilizza una webcam collegata al tuo computer di sviluppo, specificata dal numero. Per un elenco di webcam, utilizza l'opzione -webcam-list. Ad esempio: webcam0.
• imagefile:filename: l'emulatore utilizza un file immagine per l'output della fotocamera.
• videofile:filename: l'emulatore utilizza un video per l'output della videocamera.
• image360:filename: l'emulatore utilizza un'immagine panoramica equirettangolare per l'output della videocamera. Disponibile nella versione 36.6.4 e successive.
• none: disattiva la videocamera nel dispositivo virtuale.

Ad esempio:

emulator @Pixel8_API_34 -camera-back webcam0

emulator @Pixel8_API_34 -webcam-list
        List of web cameras connected to the computer:
        Camera 'webcam0' is connected to device 'webcam0'
        on channel 0 using pixel format 'UYVY'

Nell'esempio, il primo webcam0 è il nome che utilizzi nella riga di comando. Il secondo webcam0 è il nome utilizzato dal sistema operativo sul computer di sviluppo. Il secondo nome varia a seconda del sistema operativo.

A partire da Strumenti SDK 25.2.4, il nome dell'AVD è obbligatorio.

Specifica le dimensioni della RAM fisica, da 1536 a 8192 MB. Ad esempio:

emulator @Pixel8_API_34 -memory 2048

Questo valore sostituisce l'impostazione AVD.

Specifica il nome del file e il percorso di un file immagine della partizione della scheda SD. Ad esempio:

emulator @Pixel8_API_34 -sdcard C:/sd/sdcard.img

Se il file non viene trovato, l'emulatore viene comunque avviato, ma senza una scheda SD. Il comando restituisce un avviso Nessuna immagine della scheda SD.

Se non specifichi questa opzione, il valore predefinito è sdcard.img nella directory dei dati, a meno che l'AVD non specifichi un valore diverso. Per informazioni dettagliate sulle schede SD emulate, vedi Directory dei dati AVD.

Elimina i dati utente e copia i dati dal file di dati iniziale. Questa opzione cancella i dati del dispositivo virtuale e lo riporta allo stato in cui è stato definito inizialmente. Vengono rimosse tutte le app e le impostazioni installate. Ad esempio:

emulator @Pixel8_API_34 -wipe-data

Per impostazione predefinita, il file di dati utente è userdata-qemu.img e il file di dati iniziale è userdata.img. Entrambi i file si trovano nella directory dei dati. L'opzione -wipe-data non influisce sul file sdcard.img. Per saperne di più sui dati utente, consulta la sezione Informazioni su directory e file predefiniti.

Attiva o disattiva la visualizzazione dei messaggi di debug per uno o più tag. Separa più tag con uno spazio, una virgola o una colonna. Ad esempio:

$ emulator @Pixel8_API_34 -debug init,metrics

Per disattivare un tag, inserisci un trattino (-) davanti. Ad esempio, la seguente opzione mostra tutti i messaggi di debug, ad eccezione di quelli relativi ai socket di rete e alle metriche:

-debug all,-socket,-metrics

Per un elenco di tag e descrizioni, utilizza l'opzione -help-debug-tags. Ad esempio:

emulator -help-debug-tags

Attiva un tipo specifico di messaggio di debug. Utilizza il modulo no per disattivare un tipo di messaggio di debug. Ad esempio:

emulator @Pixel8_API_34 -debug-all -debug-no-metrics

Per un elenco di tag, utilizza il comando emulator -help-debug-tags.

Consente la visualizzazione dei messaggi Logcat per uno o più tag e li scrive nella finestra del terminale. Ad esempio, il seguente comando attiva i messaggi di errore di tutti i componenti:

emulator @Pixel8_API_34 -logcat *:e

logtags utilizza lo stesso formato del comando adb logcat logtags. Inserisci adb logcat -help per ulteriori informazioni. È un elenco di filtri dei log separati da spazi o virgole nel formato componentName:logLevel. componentName è un asterisco jolly (*) o un nome di componente, ad esempio ActivityManager, SystemServer, InputManager o WindowManager.

logLevel è uno di questi valori:

• v - verbose
• d - debug
• i - informativo
• w - warning log level
• e - errore
• s - silenzioso

L'esempio seguente mostra i messaggi dei componenti GSM a livello di log informativo:

emulator @Pixel8_API_34 -logcat '*:s GSM:i'

Puoi anche reindirizzare gli stessi messaggi di log o altri al terminale tramite adb.

Per saperne di più su Logcat e adb, consulta Strumento a riga di comando Logcat, Visualizzare e scrivere log con Logcat, classe Log ed Eseguire comandi adb.

Visualizza i messaggi di debug del kernel nella finestra del terminale. Ad esempio:

emulator @Pixel8_API_34 -show-kernel

Un utilizzo di questa opzione è verificare che la procedura di avvio funzioni correttamente.

Stampa i messaggi di inizializzazione dell'emulatore nella finestra del terminale. Ad esempio:

emulator @Pixel8_API_34 -verbose

Mostra i file e le impostazioni effettivamente selezionati all'avvio di un dispositivo virtuale definito in un AVD. Questa opzione equivale a specificare -debug-init.

Utilizza i server DNS specificati. servers è un elenco separato da virgole di un massimo di quattro nomi o indirizzi IP di server DNS. Ad esempio:

emulator @Pixel8_API_34 -dns-server 192.0.2.0,
192.0.2.255

Per impostazione predefinita, l'emulatore tenta di rilevare i server DNS che utilizzi e configura alias speciali nella rete firewall emulata per consentire al sistema Android di connettersi direttamente ai server. Utilizza l'opzione -dns-server per specificare un elenco diverso di server DNS.

Stabilisce tutte le connessioni TCP tramite un proxy HTTP/HTTPS specificato. Se l'emulatore deve accedere a internet tramite un server proxy, puoi utilizzare questa opzione o la variabile di ambiente http_proxy per configurare il reindirizzamento appropriato. Ad esempio:

emulator @Pixel8_API_34 -http-proxy myserver:1981

proxy può avere uno dei seguenti valori:

http://server:port
http://username:password@server:port

Il prefisso http:// può essere omesso.

Se questa opzione non viene fornita, l'emulatore cerca la variabile di ambiente http_proxy e utilizza automaticamente qualsiasi valore corrispondente al formato proxy. Per saperne di più, consulta Utilizzo dell'emulatore con un proxy.

Nota:quando esegui più emulatori, questo flag deve essere impostato al primo avvio.

Imposta l'emulazione della latenza di rete su uno dei seguenti valori delay in millisecondi:

• gsm - GSM/CSD (minimo 150, massimo 550).
• hscsd - HSCSD (min 80, max 400).
• gprs - GPRS (minimo 35, massimo 200).
• edge - EDGE/EGPRS (min 80, max 400).
• umts - UMTS/3G (min 35, max 200).
• hsdpa - HSDPA (min 0, max 0).
• lte - LTE (min 0, max 0).
• evdo - EVDO (min 0, max 0).
• none: nessuna latenza, valore predefinito (min. 0, max. 0).
• num: specifica la latenza esatta.
• min:max - Specifica le latenze minime e massime individuali.

Ad esempio:

emulator @Pixel8_API_34 -netdelay gsm

L'emulatore supporta la limitazione della larghezza di banda della rete e latenze di connessione più elevate. Puoi definirlo tramite la configurazione della skin o con le opzioni ‑netspeed e -netdelay.

Nota:questa impostazione si applica a Ethernet e rete cellulare.

Disattiva la limitazione della larghezza di banda della rete. Ad esempio:

emulator @Pixel8_API_34 -netfast

Questa opzione equivale a specificare -netspeed full -netdelay none. Questi sono i valori predefiniti per queste opzioni.

Nota:questa impostazione si applica a Ethernet e rete cellulare.

Imposta l'emulazione della velocità di rete. Specifica le velocità massime di caricamento e download della rete con uno dei seguenti valori speed in kbps:

• gsm - GSM/CSD (invio: 14,4, ricezione: 14,4).
• hscsd - HSCSD (invio: 14,4, ricezione: 57,6).
• gprs - GPRS (invio: 28,8, ricezione: 57,6).
• edge - EDGE/EGPRS (invio: 473,6, ricezione: 473,6).
• umts - UMTS/3G (invio: 384,0, ricezione: 384,0).
• hsdpa - HSDPA (up: 5760.0, down: 13,980.0).
• lte - LTE (invio: 58.000, ricezione: 173.000).
• evdo - EVDO (upload: 75.000, download: 280.000).
• full - Nessun limite, il valore predefinito (su: 0,0, giù: 0,0).
• num: specifica la velocità di caricamento e download.
• up:down: specifica le singole velocità di caricamento e download.

Ad esempio:

emulator @Pixel8_API_34 -netspeed edge

L'emulatore supporta la limitazione della larghezza di banda della rete e latenze di connessione più elevate. Puoi definirlo tramite la configurazione della skin o con le opzioni ‑netspeed e -netdelay.

Nota:questa impostazione si applica a Ethernet e rete cellulare.

Passa argomenti aggiuntivi al simulatore di rete (netsim). arguments è un elenco di flag separati da spazi.

Ad esempio, per abilitare l'acquisizione di pacchetti e reindirizzare la registrazione a stderr:

emulator @Pixel8_API_34 -netsim-args="--pcap --logtostderr"

Per saperne di più, consulta Funzionalità di rete avanzate dell'emulatore.

Imposta il numero di porta TCP utilizzato per la console e adb. Ad esempio:

emulator @Pixel8_API_34 -port 5556

Il valore predefinito è 5554 per la prima istanza del dispositivo virtuale in esecuzione sul tuo computer. Un dispositivo virtuale occupa normalmente una coppia di porte adiacenti: una porta della console e una porta adb. La console del primo dispositivo virtuale in esecuzione su una determinata macchina utilizza la porta della console 5554 e la porta adb 5555. Le istanze successive utilizzano numeri di porta che aumentano di due unità. Ad esempio, 5556/5557, 5558/5559 e così via. L'intervallo è compreso tra 5554 e 5682, consentendo 64 dispositivi virtuali contemporanei.

Le assegnazioni delle porte sono spesso le stesse della specifica di -ports port,{port + 1}. {port + 1} deve essere senza costi ed è riservato a adb. Se una delle porte della console o di adb è già in uso, l'emulatore non si avvierà.

L'opzione ‑port indica le porte e il numero di serie utilizzati dal dispositivo virtuale e avvisa se si verificano problemi con i valori forniti. Nell'interfaccia utente dell'emulatore, puoi visualizzare il numero di porta della console nel titolo della finestra e il numero di porta adb selezionando Guida > Informazioni.

Tieni presente che se il valore port non è pari e rientra nell'intervallo da 5554 a 5584, il dispositivo virtuale si avvierà ma non sarà visibile quando utilizzi il comando adb devices, se adb server viene avviato dopo l'emulatore. Per questo motivo, ti consigliamo di utilizzare un numero di porta della console pari.

Imposta le porte TCP utilizzate per la console e adb. Ad esempio:

emulator @Pixel8_API_34 -ports 5556,5559

L'intervallo di porte valido è compreso tra 5554 e 5682, il che consente di utilizzare 64 dispositivi virtuali contemporaneamente. L'opzione -ports indica le porte e il numero di serie utilizzati dall'istanza dell'emulatore e avvisa in caso di problemi con i valori forniti.

Ti consigliamo di utilizzare l'opzione -port, se possibile. L'opzione -ports è disponibile per le configurazioni di rete che richiedono impostazioni speciali.

Per saperne di più sull'impostazione delle porte della console e di adb, consulta l'opzione -port.

Acquisisce i pacchetti di rete e li memorizza in un file. Ad esempio:

emulator @Pixel8_API_34 -tcpdump /path/dumpfile.cap

Utilizza questa opzione per iniziare ad acquisire tutti i pacchetti di rete inviati tramite la LAN Ethernet virtuale dell'emulatore. Successivamente, puoi utilizzare uno strumento come Wireshark per analizzare il traffico.

Tieni presente che questa opzione acquisisce tutti i pacchetti Ethernet e non è limitata alle connessioni TCP.

Configura l'accelerazione della VM dell'emulatore. Ad esempio:

emulator @Pixel8_API_34 -accel auto

L'emulazione accelerata richiede un'immagine di sistema che corrisponda all'architettura della CPU host. Su Linux, si basa su KVM. Su Windows, si basa su Windows Hypervisor Platform (WHPX). Su macOS, si basa su Hypervisor.Framework (HVF).

I valori validi per mode sono:

• auto: determina automaticamente se l'accelerazione è supportata e la utilizza quando possibile (impostazione predefinita).
• off: disattiva l'accelerazione e utilizza l'emulazione software. Questa modalità non è supportata ed è molto lenta. Per utilizzarlo, imposta la variabile di ambiente ANDROID_I_WANT_MY_TCG su yes. In caso contrario, l'emulatore non si avvia e stampa un messaggio di errore.
• on: forza l'accelerazione. Se l'hypervisor non è installato o utilizzabile, l'emulatore non si avvia e stampa un messaggio di errore.

Per saperne di più, vedi Configurare l'accelerazione hardware per l'emulatore Android.

Verifica se è installato un hypervisor richiesto per l'accelerazione della VM dell'emulatore (KVM, WHPX o HVF). Ad esempio:

emulator -accel-check

Per saperne di più, consulta Verificare se è installato un hypervisor.

Seleziona la modalità di emulazione della GPU. Ad esempio:

emulator @Pixel8_API_34 -gpu swiftshader_indirect

Per saperne di più, consulta Configurare l'accelerazione grafica.

Imposta il modulo di sicurezza Security-Enhanced Linux (SELinux) sulla modalità disabled o permissive su un sistema operativo Linux. Ad esempio:

me-linux$ emulator @Pixel8_API_34 -selinux permissive

Per impostazione predefinita, SELinux è in modalità enforcing, il che significa che la policy di sicurezza è applicata. La modalità permissive carica la policy SELinux, ma non la applica. Questa opzione registra solo le violazioni delle norme. La modalità disabled disattiva il supporto del kernel per SELinux. Nei livelli API 23 e successivi, disabled è considerato permissive.

Imposta il fuso orario del dispositivo virtuale su timezone anziché sul fuso orario dell'host. Ad esempio:

emulator @Pixel8_API_34 -timezone Europe/Paris

Per impostazione predefinita, l'emulatore utilizza il fuso orario del computer di sviluppo. Utilizza questa opzione per specificare un fuso orario diverso o se il rilevamento automatico non funziona correttamente. Il valore timezone deve essere nel formato zoneinfo, ovvero area/location o area/subarea/location. Ad esempio:

• America/Los_Angeles
• Europe/Paris
• America/Argentina/Buenos_Aires

Il fuso orario specificato deve trovarsi nel database zoneinfo.

Mostra il numero di versione dell'emulatore. Ad esempio:

emulator @Pixel8_API_34 -version

O

emulator -version

Disattiva l'animazione all'avvio durante l'avvio dell'emulatore per un avvio più rapido. Ad esempio:

emulator @Pixel8_API_34 -no-boot-anim

Sui computer più lenti, questa opzione può accelerare notevolmente la sequenza di avvio.

Imposta la modalità touch screen emulata. Ad esempio:

emulator @Pixel8_API_34 -screen no-touch

mode può essere uno dei seguenti valori:

• touch: emula un touch screen (opzione predefinita).
• multi-touch: emula uno schermo multi-touch.
• no-touch - Disattiva l'emulazione del tocco e del multi-touch.

Abilita la creazione di grafici di avvio con un timeout in secondi. Alcune immagini di sistema Android hanno un sistema init modificato che integra una funzionalità di bootcharting. Puoi passare un periodo di timeout di bootcharting al sistema con questa opzione. Se il sistema init non ha attivato bootcharting, l'opzione non fa nulla. Questa opzione è utile principalmente agli sviluppatori di piattaforme, non agli sviluppatori di app esterni.

Ad esempio:

emulator @Pixel8_API_34 -bootchart 120

Specifica un file immagine della partizione della cache. Fornisce un nome file e un percorso assoluto o un percorso relativo alla directory dei dati per configurare un file di cache persistente. Se il file non esiste, l'emulatore lo crea come file vuoto.

Ad esempio:

emulator @Pixel8_API_34 -cache
   ~/.android/avd/Pixel8_API_34.avd/cache_persistent.img

Se non utilizzi questa opzione, il valore predefinito è un file temporaneo denominato cache.img. Per saperne di più, consulta la directory dei dati AVD.

Imposta le dimensioni della partizione della cache in MB.

Ad esempio:

emulator @Pixel8_API_34 -cache-size 1000

Se non specifichi questa opzione, il valore predefinito è 66 MB. In genere, la maggior parte degli sviluppatori di app non ha bisogno di questa opzione, a meno che non debba scaricare file molto grandi che superano la cache predefinita. Per ulteriori informazioni sul file della cache, consulta Directory dei dati AVD.

Imposta il file immagine della partizione dei dati utente. Fornisce un nome file e un percorso assoluto o un percorso relativo alla directory di lavoro per configurare un file di dati utente persistente. Se il file non esiste, l'emulatore crea un'immagine dal file userdata.img predefinito, la memorizza nel nome file specificato e salva i dati utente al suo interno all'arresto.

Ad esempio:

emulator @Pixel8_API_34 -data
   ~/.android/avd/Pixel8_API_34.avd/userdata-test.img

Se non utilizzi questa opzione, il valore predefinito è un file denominato userdata-qemu.img. Per saperne di più sul file di dati utente, consulta la directory dei dati AVD.

Specifica una directory di dati utilizzando un percorso assoluto. Per maggiori informazioni, vedi Directory dei dati AVD.

Ad esempio:

emulator @Pixel8_API_34 -datadir
   ~/.android/avd/Pixel8_API_34.avd/mytest

Ricevi assistenza per le immagini disco. Questa opzione fornisce informazioni pertinenti sia per gli sviluppatori di app sia per quelli di piattaforme. Ad esempio:

emulator -help-disk-images

Ricevi assistenza sulle specifiche del carattere device. Un parametro device è richiesto da alcune opzioni dell'emulatore. Ad esempio:

emulator -help-char-devices

Ricevi assistenza sulle immagini disco pertinenti per gli sviluppatori di app. Questa opzione recupera informazioni sulla posizione dei file immagine per un AVD creato con gli strumenti SDK. Ad esempio:

emulator -help-sdk-images

Riceve assistenza sulle immagini disco pertinenti per gli sviluppatori di piattaforme. Ad esempio:

emulator -help-build-images

Specifica la versione iniziale della partizione di dati. Dopo aver cancellato i dati utente, l'emulatore copia i contenuti del file specificato nei dati utente (per impostazione predefinita, il file userdata-qemu.img) anziché utilizzare il file userdata.img predefinito come versione iniziale. Specifica il nome file e un percorso assoluto o un percorso relativo alla directory di lavoro.

Ad esempio:

emulator @Pixel8_API_34 -initdata
   ~/Library/Android/sdk/system-images/android-34/
   google_apis/x86_64/userdata-test.img

Se non specifichi un percorso, il file viene inserito nella directory di sistema. Per ulteriori informazioni, consulta Directory di sistema AVD.

Utilizza un kernel emulato specifico. Se non specifichi un percorso, l'emulatore cerca nella directory di sistema. Utilizza l'opzione ‑show‑kernel per visualizzare i messaggi di debug del kernel.

Ad esempio:

emulator @Pixel8_API_34 -kernel
   ~/Library/Android/sdk/system-images/android-34/
   google_apis/x86_64/kernel-test.img -show-kernel

Se non specifichi questa opzione, il valore predefinito è kernel-ranchu. Per ulteriori informazioni, vedi Directory di sistema AVD.

Disattiva il supporto audio per questo dispositivo virtuale. Alcuni computer Linux e Windows hanno driver audio difettosi che causano sintomi diversi, ad esempio impediscono l'avvio dell'emulatore. In questo caso, utilizza questa opzione per risolvere il problema. In alternativa, puoi utilizzare la variabile di ambiente QEMU_AUDIO_DRV per modificare il backend audio.

Ad esempio:

emulator @Pixel8_API_34 -noaudio

Avvia l'emulatore senza una partizione della cache. Se non utilizzi questa opzione, il valore predefinito è un file temporaneo denominato cache.img. Questa opzione è riservata agli sviluppatori di piattaforme. Per maggiori informazioni, consulta la pagina Directory dei dati AVD.

Ad esempio:

emulator @Pixel8_API_34 -nocache

Inibisce le operazioni di caricamento e salvataggio automatici, facendo sì che l'emulatore esegua una sequenza di avvio completa e perda il suo stato quando viene chiuso. Esegue l'override dell'opzione -snapshot.

Ad esempio:

emulator @Pixel8_API_34 -no-snapshot

Impedisce all'emulatore di caricare lo stato dell'AVD dallo spazio di archiviazione degli snapshot. Esegue un avvio completo.

Ad esempio:

emulator @Pixel8_API_34 -no-snapshot-load

Impedisce all'emulatore di salvare lo stato dell'AVD nell'archivio snapshot all'uscita, il che significa che tutte le modifiche andranno perse.

Ad esempio:

emulator @Pixel8_API_34 -no-snapshot-save

Non tenta di correggere immediatamente l'ora dell'orologio AVD al ripristino dello snapshot. Questa opzione può essere utile durante i test, in quanto evita un salto temporale improvviso. Gli aggiornamenti dell'ora vengono comunque inviati all'AVD ogni 15 secondi circa.

Ad esempio:

emulator @Pixel8_API_34 -no-snapshot-update-time

Disattiva la visualizzazione grafica delle finestre nell'emulatore. Questa opzione è utile quando esegui l'emulatore su server senza display. Puoi accedere all'emulatore tramite adb o la console. Ad esempio:

emulator @Pixel8_API_34 -no-window

Specifica le dimensioni della partizione di dati di sistema in MB. Ad esempio:

emulator @Pixel8_API_34 -partition-size 1024

Imposta una proprietà di sistema Android nell'emulatore all'avvio. name deve essere un nome di proprietà etichettato come qemu_prop di massimo 32 caratteri, senza spazi, e value deve essere una stringa di massimo 92 caratteri. Per un esempio, consulta il <x0A>file property_contexts. Puoi specificare diverse opzioni ‑prop in una riga di comando. Questa opzione può essere utile per il debug. Ad esempio:

emulator @Pixel8_API_34 -prop qemu.name=value -prop qemu.abc=xyz

Visualizza la guida di -qemu. Ad esempio:

emulator -qemu -h

Specifica un'immagine di avvio ramdisk. Specifica il nome file e un percorso assoluto o un percorso relativo alla directory di lavoro.

Ad esempio:

emulator @Pixel8_API_34 -ramdisk
   ~/Library/Android/sdk/system-images/android-34/
   google_apis/x86_64/ramdisk-test.img

Se non utilizzi questa opzione, il valore predefinito è il file ramdisk.img nella directory di sistema. Per ulteriori informazioni, consulta Directory di sistema AVD.

Comunica la porta della console a una terza parte remota prima di avviare l'emulazione. Può essere utile per uno script di test automatizzato. socket deve utilizzare uno di questi formati:

• tcp:port[,server][,max=seconds][,ipv6]
• unix:port[,server][,max=seconds][,ipv6]

Per ulteriori informazioni, utilizza l'opzione -help-report-console come descritto nella sezione relativa all'aiuto per opzioni specifiche.

Crea una console shell root nel terminale corrente. Questa opzione si differenzia dal comando adb shell per i seguenti aspetti:

• Crea una shell root che ti consente di modificare molte parti del sistema.
• Funziona anche se il adb daemon nel sistema emulato è danneggiato.
• Premi Ctrl+C (o Comando-C su macOS) per arrestare l'emulatore anziché la shell.

Ad esempio:

emulator @Pixel8_API_34 -shell

Specifica il nome di uno snapshot per le operazioni di avvio e salvataggio automatici.

Anziché eseguire una sequenza di avvio completa, l'emulatore può riprendere l'esecuzione da uno snapshot di stato precedente, il che di solito è molto più veloce. Quando fornisci questa opzione, l'emulatore carica lo snapshot con quel nome e lo salva di nuovo con lo stesso nome all'uscita.

Se non utilizzi questa opzione, l'emulatore utilizza l'avvio rapido e carica lo snapshot default_boot, se esiste. Se lo snapshot specificato non esiste, l'emulatore esegue una sequenza di avvio completa e un'operazione di salvataggio.

emulator @Pixel8_API_34 -snapshot snapshot2

Ricorda che durante il caricamento di uno snapshot, tutti i contenuti del sistema, i dati utente e le immagini della scheda SD vengono sovrascritti con i contenuti che contenevano al momento della creazione dello snapshot. A meno che tu non salvi queste informazioni in un altro snapshot, le modifiche apportate da allora andranno perse.

Puoi anche creare uno snapshot dalla console dell'emulatore utilizzando il comando avd snapshot save name. Per saperne di più, consulta Inviare comandi alla console dell'emulatore.

Visualizza un elenco di snapshot disponibili per l'AVD, poi esce.

Ad esempio:

emulator @Pixel8_API_34 -snapshot-list

Puoi utilizzare i valori delle colonne ID e TAG nell'output come argomenti per l'opzione -snapshot.

Specifica una directory di sistema utilizzando un percorso assoluto. Per saperne di più, consulta Directory di sistema AVD. Ad esempio:

emulator @Pixel8_API_34 -sysdir
   ~/Library/Android/sdk/system-images/android-34/
   google_apis/x86_64/test

Specifica un file di sistema iniziale. Fornisce il nome file e un percorso assoluto o un percorso relativo alla directory di lavoro.

Ad esempio:

emulator @Pixel8_API_34 -system
   ~/Library/Android/sdk/system-images/android-34/
   google_apis/x86_64/system-test.img

Se non utilizzi questa opzione, il valore predefinito è il file system.img nella directory di sistema. Per ulteriori informazioni, consulta Directory di sistema AVD.

Utilizza questa opzione per avere un'immagine di sistema scrivibile durante la sessione di emulazione. Per farlo:

1. Avvia un dispositivo virtuale con l'opzione -writable-system.
2. Inserisci il comando adb remount da un terminale di comando per indicare all'emulatore di rimontare system/ come lettura/scrittura. Per impostazione predefinita, viene montato come sola lettura.

L'utilizzo di questo flag crea una copia temporanea dell'immagine di sistema che può essere molto grande, fino a diverse centinaia di MB, ma verrà eliminata all'uscita dell'emulatore.