L'SDK Android include un emulatore di dispositivo Android, un dispositivo virtuale che viene eseguito sul computer. L'emulatore Android ti consente di sviluppare e testare app per Android senza utilizzare un dispositivo fisico.
Questa pagina descrive le funzionalità della riga di comando che puoi utilizzare con Android Emulator. Per informazioni sull'utilizzo della UI di Android Emulator, consulta Eseguire app su Android Emulator.
Avvia l'emulatore
Utilizza il comando emulator per avviare l'emulatore, in alternativa a eseguire il progetto o avviarlo tramite AVD Manager.
Ecco la sintassi di base della riga di comando per avviare un dispositivo virtuale da un prompt del terminale:
emulator -avd avd_name [ {-option [value]} … ]
Oppure
emulator @avd_name [ {-option [value]} … ]
Ad esempio, se avvii l'emulatore da Android Studio in esecuzione su un Mac, la riga di comando predefinita sarà simile alla seguente:
/Users/janedoe/Library/Android/sdk/emulator/emulator -avd Pixel8_API_34 -netdelay none -netspeed full -qt-hide-window -grpc-use-token -idle-grpc-timeout
Tieni presente che gli argomenti -qt-hide-window -grpc-use-token -idle-grpc-timeout vengono utilizzati solo per eseguire la finestra dell'emulatore in Android Studio. Se vuoi eseguire l'emulatore nella propria finestra, non devi utilizzare questi parametri aggiuntivi.
Puoi specificare le opzioni di avvio quando avvii l'emulatore, ma non dopo l'avvio.
Per un elenco dei nomi degli AVD, inserisci questo comando:
emulator -list-avds
Utilizza questa opzione per visualizzare un elenco di nomi AVD dalla directory principale di Android.
Puoi sostituire la home directory predefinita impostando la variabile di ambiente ANDROID_SDK_HOME che specifica la radice della directory specifica dell'utente in cui vengono archiviati tutti i contenuti di configurazione e AVD.
Puoi impostare la variabile di ambiente nella finestra del terminale prima di avviare un dispositivo virtuale o tramite le impostazioni utente nel sistema operativo. Ad esempio, nel file .bashrc su Linux.
Per arrestare l'emulatore Android, chiudi la finestra dell'emulatore.
Installare un'app
Oltre a installare un'app tramite Android Studio o l'interfaccia utente
dell'emulatore, puoi installare l'app su un dispositivo virtuale utilizzando l'utilità adb.
Per utilizzare adb per installare, eseguire e testare la tua app,
segui questi passaggi generali:
- Crea e pacchettizza la tua app in un APK, come descritto in Crea ed esegui la tua app.
- Avvia l'emulatore dalla riga di comando, come descritto nella sezione precedente, utilizzando le opzioni di avvio necessarie.
- Installa l'app utilizzando
adb. - Esegui e testa l'app sull'emulatore.
Mentre l'emulatore è in esecuzione, puoi utilizzare la console dell'emulatore per eseguire i comandi in base alle esigenze.
Per disinstallare un'app, procedi come faresti su un dispositivo Android.
Il dispositivo virtuale conserva l'app e i relativi dati di stato nei riavvii
in una partizione del disco dei dati utente (userdata-qemu.img). Per cancellare questi
dati, avvia l'emulatore con l'opzione -wipe-data o cancella i
dati in AVD Manager. Per saperne di più sulla partizione dei dati utente e su altro spazio di archiviazione, consulta la sezione seguente.
Nota:l'utilità adb considera il dispositivo virtuale come
un dispositivo fisico reale. Per questo motivo, potresti dover utilizzare il flag -d con alcuni comandi adb comuni, ad esempio install. Il flag -d ti consente di specificare quale dei vari
dispositivi connessi utilizzare come destinazione di un comando. Se non specifichi
-d, l'emulatore ha come target il primo dispositivo dell'elenco.
Informazioni su directory e file predefiniti
L'emulatore utilizza file associati, di cui le directory di sistema e dei dati AVD sono le più importanti. È utile comprendere la struttura di directory e i file dell'emulatore quando si specificano le opzioni della riga di comando, anche se in genere non è necessario modificare le directory o i file predefiniti.
L'emulatore Android utilizza l'hypervisor (QEMU).
Directory di sistema AVD
La directory di sistema contiene le immagini di sistema Android utilizzate dall'emulatore per simulare il sistema operativo. Questa directory contiene file di sola lettura specifici della piattaforma condivisi da tutti gli AVD dello stesso tipo, inclusi il livello API, l'architettura della CPU e la variante di Android. Le posizioni predefinite sono le seguenti:
- macOS e Linux -
~/Library/Android/sdk/system-images/android-apiLevel/variant/arch/ - Windows -
C:\Users\user\Library\Android\sdk\system-images\android-apiLevel\variant\arch\
Dove:
apiLevelè un livello API numerico o una lettera per le versioni di anteprima. Ad esempio,android-Vindica l'anteprima di Android VanillaIceCream. Al momento del rilascio, è diventato il livello API 35, indicato daandroid-35.variantè un nome corrispondente a funzionalità specifiche implementate dall'immagine di sistema. Ad esempio,google_apisoandroid-wear.archè l'architettura CPU di destinazione. Ad esempio,x86.
Utilizza l'opzione -sysdir per specificare una directory di sistema diversa per
l'AVD.
L'emulatore legge i seguenti file dalla directory di sistema:
Tabella 1. File della directory di sistema letti dall'emulatore Android
| File | Descrizione | Opzione per specificare un file diverso |
|---|---|---|
kernel-qemu o kernel-ranchu
|
L'immagine del kernel binario per l'AVD. kernel-ranchu si basa sull'emulatore QEMU.
|
-kernel
|
ramdisk.img
|
L'immagine della partizione di avvio. Si tratta di un sottoinsieme di system.img
caricato inizialmente dal kernel prima che venga montata l'immagine di sistema. In genere
contiene solo alcuni binari e script di inizializzazione.
|
-ramdisk
|
system.img
|
La versione iniziale di sola lettura dell'immagine di sistema. Nello specifico, la partizione contenente le librerie di sistema e i dati corrispondenti al livello API e alla variante. | -system
|
userdata.img
|
La versione iniziale della partizione di dati, che viene visualizzata come
data/ nel sistema emulato e contiene tutti i dati scrivibili per
l'AVD. L'emulatore utilizza questo file quando crei un nuovo AVD o utilizzi l'opzione
‑wipe-data. Per maggiori informazioni, consulta la
descrizione del file userdata-qemu.img nella sezione seguente.
|
-initdata
-init-data
|
Directory dei dati AVD
La directory dei dati AVD, chiamata anche directory dei contenuti, è specifica per una singola istanza AVD e contiene tutti i dati modificabili per l'AVD.
La posizione predefinita è la seguente, dove name è il nome dell'AVD:
- macOS e Linux -
~/.android/avd/name.avd/ - Windows 10 e versioni successive -
C:\Users\user\.android\name.avd\
Utilizza l'opzione -datadir per specificare una directory di dati AVD diversa.
La tabella seguente elenca i file più importanti contenuti in questa directory:
Tabella 2. File importanti nella directory dei dati AVD
| File | Descrizione | Opzione per specificare un file diverso |
|---|---|---|
userdata-qemu.img
|
I contenuti della partizione di dati, che vengono visualizzati come
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, le impostazioni, i database e i file delle app installate di un utente unico. Ogni utente ha una
directory |
-data
|
cache.img
|
L'immagine della partizione della cache, che viene visualizzata come cache/ nel
sistema emulato. È vuoto quando crei un AVD o utilizzi l'opzione
-wipe-data. Contiene i file di download temporanei e viene compilato dalla gestione dei download e a volte dal sistema. Ad esempio, il browser lo utilizza per memorizzare nella cache le pagine web e le immagini scaricate durante l'esecuzione dell'emulatore. Quando spegni il dispositivo virtuale, il file viene eliminato. Puoi
rendere persistente il file utilizzando l'opzione -cache.
|
-cache
|
sdcard.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
Quando definisci un AVD in AVD Manager, puoi scegliere
di utilizzare un file della scheda SD gestito automaticamente o un file creato con
lo strumento
Puoi sfogliare, inviare, copiare e rimuovere file da una scheda SD simulata utilizzando l'interfaccia utente dell'emulatore o l'utilità
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 L'emulatore considera il file come un pool di byte, quindi il formato della scheda SD non ha importanza.
L'opzione |
-sdcard
|
Elenca le directory e i file utilizzati dall'emulatore
Puoi scoprire dove si trovano i file in due modi:
- Utilizza l'opzione
-verboseo-debug initquando avvii l'emulatore dalla riga di comando. Esamina l'output. - Utilizza il comando
emulator-help-optionper elencare una directory predefinita. Ad esempio:emulator -help-datadir
Use '-datadir <dir>' to specify a directory where writable image files will be searched. On this system, the default directory is: /Users/me/.android See '-help-disk-images' for more information about disk image files.
Opzioni di avvio della riga di comando
Questa sezione elenca le opzioni che puoi fornire nella riga di comando quando avvii l'emulatore.
Nota:Android Emulator è in continua fase di sviluppo per renderlo più affidabile. Per lo stato dei problemi segnalati in relazione a varie opzioni della riga di comando e per segnalare bug, consulta Android Issue Tracker.
Opzioni più usate
La tabella seguente elenca le opzioni di avvio della riga di comando che potresti utilizzare più spesso:
Tabella 3. Opzioni della riga di comando usate di frequente
| Opzione della riga di comando | Descrizione |
|---|---|
| Avvio rapido | |
-no-snapshot-load
|
Esegue un riavvio a freddo e salva lo stato dell'emulatore all'uscita. |
-no-snapshot-save
|
Esegue un avvio rapido, se possibile, ma non salva lo stato dell'emulatore all'uscita. |
-no-snapshot
|
Disattiva completamente la funzionalità Avvio rapido e non carica né salva lo stato dell'emulatore. |
| Hardware del dispositivo | |
-camera-back mode-camera-front mode
|
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.
Ad esempio: emulator @Pixel8_API_34 -camera-back webcam0 |
-webcam-list
|
Elenca le webcam sul computer di sviluppo disponibili per l'emulazione. Ad esempio: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 A partire da SDK Tools 25.2.4, il nome dell'AVD è obbligatorio. |
| Immagini disco e memoria | |
-memory size
|
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. |
-sdcard filepath
|
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 No SD Card Image.
Se non specifichi questa opzione, il valore predefinito è |
-wipe-data
|
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
era stato definito inizialmente. Tutte le app e le impostazioni installate vengono rimosse. Ad esempio:
emulator @Pixel8_API_34 -wipe-data
Per impostazione predefinita, il file di dati utente è |
| Debug | |
-debug tags
|
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, l'opzione seguente mostra tutti i messaggi di debug, ad eccezione di quelli relativi ai socket di rete e alle metriche:
Per un elenco di tag e descrizioni, utilizza l'opzione
emulator -help-debug-tags
Puoi definire i tag di debug predefiniti nella variabile di ambiente
ANDROID_VERBOSE=socket,gles È equivalente a utilizzare:
o
|
-debug-tag-debug-no-tag
|
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 |
-logcat logtags
|
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
L'esempio seguente mostra i messaggi dei componenti GSM a livello di log informativo:
emulator @Pixel8_API_34 -logcat '*:s GSM:i'
Se non fornisci l'opzione Per saperne di più su Logcat e |
-show-kernel
|
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. |
-verbose
|
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
|
| Rete | |
-dns-server servers
|
Utilizza i server DNS specificati. servers è un elenco separato da virgole di un massimo di quattro nomi di server DNS o indirizzi IP. Ad esempio:
emulator @Pixel8_API_34 -dns-server 192.0.2.0,
Per impostazione predefinita, l'emulatore tenta di rilevare i server DNS che stai utilizzando e configura
alias speciali nella rete firewall emulata per consentire al sistema Android
di connettersi direttamente ai server. Utilizza l'opzione |
-http-proxy proxy
|
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
Il prefisso
Se questa opzione non viene fornita, l'emulatore cerca la variabile di ambiente |
-netdelay delay
|
Imposta l'emulazione della latenza di rete su uno dei seguenti valori
Ad esempio: emulator @Pixel8_API_34 -netdelay gsm
L'emulatore supporta la limitazione della rete e latenze di connessione più elevate.
Puoi definirlo tramite la configurazione della skin o con le opzioni
|
-netfast
|
Disattiva la limitazione della rete. Ad esempio:
emulator @Pixel8_API_34 -netfast
Questa opzione equivale a specificare |
-netspeed speed
|
Imposta l'emulazione della velocità di rete. Specifica le velocità massime di caricamento e
download della rete con uno dei seguenti valori
Ad esempio: emulator @Pixel8_API_34 -netspeed edge
L'emulatore supporta la limitazione della rete e latenze di connessione più elevate.
Puoi definirlo tramite la configurazione della skin o con le opzioni
|
-port port
|
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 sulla
tua macchina. Un dispositivo virtuale occupa normalmente una coppia di porte adiacenti: una
porta della console e una porta
Le assegnazioni delle porte sono spesso le stesse della specifica di L'opzione
Tieni presente che se il valore |
-ports
|
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
Ti consigliamo di utilizzare l'opzione
Per saperne di più sull'impostazione delle porte della console e di |
-tcpdump filepath
|
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. |
| Sistema | |
-accel mode
|
Configura l'accelerazione della VM dell'emulatore. Ad esempio:
emulator @Pixel8_API_34 -accel auto L'emulazione accelerata funziona solo per le immagini di sistema x86 e x86_64. Su Linux, si basa su KVM. Su Windows e Mac, si basa su una CPU Intel e sul driver Intel HAXM. Questa opzione viene ignorata se non emuli un dispositivo x86 o x86_64.
I valori validi per
Per saperne di più, vedi Configurare l'accelerazione hardware per l'emulatore Android. |
-accel-check
|
Controlla se è installato un hypervisor richiesto per l'accelerazione della VM dell'emulatore (HAXM o KVM). Ad esempio:
emulator -accel-check Per saperne di più, vedi Controllare se è installato un hypervisor. |
-engine engine
|
Specifica il motore dell'emulatore:
Ad esempio:
emulator @Pixel8_API_34 -engine auto
Il rilevamento automatico deve scegliere il valore che offre il rendimento migliore quando
emula un AVD specifico. Utilizza l'opzione |
-gpu mode
|
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. |
-no-accel
|
Disattiva l'accelerazione della VM dell'emulatore quando si utilizza un'immagine di sistema x86 o x86_64. È utile solo per il debug ed è uguale a specificare -accel
off. Ad esempio:
emulator @Pixel8_API_34 -no-accel Per saperne di più, vedi Configurare l'accelerazione hardware per l'emulatore Android. |
-nojni
-no-jni
|
Disabilita i controlli JNI (Java Native Interface) estesi nel runtime Android Dalvik
o ART. Ad esempio:
emulator @Pixel8_API_34 -nojni Quando avvii un dispositivo virtuale, i controlli JNI estesi sono attivi per impostazione predefinita. Per maggiori informazioni, consulta i suggerimenti JNI. |
-selinux {disabled|permissive}
|
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à |
-timezone timezone
|
Imposta il fuso orario per il dispositivo virtuale su
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
Il fuso orario specificato deve essere presente nel database zoneinfo. |
-version
|
Mostra il numero di versione dell'emulatore. Ad esempio:
emulator @Pixel8_API_34 -version Oppure
emulator -version |
| Interfaccia utente | |
-no-boot-anim
|
Disattiva l'animazione di 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. |
-screen mode
|
Imposta la modalità touch screen emulata. Ad esempio:
emulator @Pixel8_API_34 -screen no-touch
|
Opzioni avanzate
Le opzioni di avvio da riga di comando nella tabella seguente sono disponibili, ma non vengono utilizzate di frequente dallo sviluppatore di app medio.
Nelle descrizioni, la directory di lavoro è la directory corrente nel terminale in cui inserisci i comandi. Per informazioni sulla directory di sistema e sulla directory dei dati dell'AVD e sui file archiviati al loro interno, consulta la sezione relativa a directory e file predefiniti.
Alcune di queste opzioni sono adatte agli sviluppatori di app esterni, mentre altre vengono utilizzate principalmente dagli sviluppatori di piattaforme. Gli sviluppatori di app creano app per Android e le eseguono su AVD specifici. Gli sviluppatori di piattaforme lavorano sul sistema Android e lo eseguono all'interno dell'emulatore senza AVD precreato.
Tabella 4. Opzioni avanzate della riga di comando
| Opzione avanzata | Breve descrizione |
|---|---|
-bootchart timeout
|
Attiva 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. Con questa opzione, puoi passare un periodo di timeout di bootcharting al sistema. 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 |
-cache filepath
|
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-size size
|
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 la sezione Directory dati AVD. |
-data filepath
|
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 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 |
-datadir dir
|
Specifica una directory di dati utilizzando un percorso assoluto. Per ulteriori informazioni, consulta la pagina Directory dei dati AVD. Ad esempio: emulator @Pixel8_API_34 -datadir ~/.android/avd/Pixel8_API_34.avd/mytest |
-force-32bit
|
Utilizza l'emulatore a 32 bit su piattaforme a 64 bit. A volte questa opzione è utile per i test o il debug. Ad esempio, si è verificato un problema per cui l'emulatore a volte non veniva eseguito su Windows a 64 bit, ma su Windows a 32 bit sì. Questa opzione è stata utile per eseguire confronti per eseguire il debug del problema. Ecco un esempio: emulator @Pixel8_API_34 -force-32bit |
-help-disk-images
|
Ricevi assistenza sulle immagini disco. Questa opzione fornisce informazioni pertinenti sia per gli sviluppatori di app sia per quelli di piattaforme. Ad esempio: emulator -help-disk-images |
-help-char-devices
|
Ricevi assistenza sulle specifiche del carattere emulator -help-char-devices |
-help-sdk-images
|
Riceve 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 |
-help-build-images
|
Riceve assistenza sulle immagini disco pertinenti per gli sviluppatori di piattaforme. Ad esempio: emulator -help-build-images |
-initdata filepath-init-data
filepath
|
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 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 la pagina Directory di sistema AVD. |
-kernel filepath
|
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 è |
-noaudio
-no-audio
|
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 Ad esempio: emulator @Pixel8_API_34 -noaudio |
-nocache
-no-cache
|
Avvia l'emulatore senza una partizione della cache. Se non utilizzi questa
opzione, il valore predefinito è un file temporaneo denominato Ad esempio: emulator @Pixel8_API_34 -nocache |
-no-snapshot
|
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 Ad esempio: emulator @Pixel8_API_34 -no-snapshot |
-no-snapshot-load
|
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 |
-no-snapshot-save
|
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 |
-no-snapshot-update-time
|
Non tenta di correggere immediatamente l'ora dell'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 |
-no-snapstorage
|
Avvia l'emulatore senza montare un file per archiviare o caricare snapshot dello stato, forzando un avvio completo e disattivando la funzionalità di snapshot dello stato. Questa opzione esegue l'override delle opzioni Ad esempio: emulator @Pixel8_API_34 -no-snapstorage |
-no-window
|
Disattiva la visualizzazione grafica delle finestre nell'emulatore. Questa opzione è utile
quando l'emulatore viene eseguito su server senza display. Puoi accedere all'emulatore tramite
emulator @Pixel8_API_34 -no-window |
-partition-size size
|
Specifica le dimensioni della partizione dei dati di sistema in MB. Ad esempio: emulator @Pixel8_API_34 -partition-size 1024 |
-prop name=value
|
Imposta una proprietà di sistema Android nell'emulatore all'avvio.
emulator @Pixel8_API_34 -prop qemu.name=value -prop qemu.abc=xyz |
-qemu args
|
Passa argomenti al software di emulazione QEMU. Quando utilizzi questa opzione, assicurati che sia l'ultima specificata, poiché tutte le opzioni successive vengono interpretate come opzioni specifiche di QEMU. Questa opzione è piuttosto avanzata e deve essere utilizzata solo dagli sviluppatori che hanno molta familiarità con QEMU e l'emulazione di Android. |
-qemu -h
|
Visualizza la guida di emulator -qemu -h |
-ramdisk filepath
|
Specifica un'immagine di avvio ramdisk. Specifica il nome del 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 |
-report-console socket
|
Comunica la porta della console a una terza parte remota prima di avviare
l'emulazione. Può essere utile per uno script di test automatizzato.
Per ulteriori informazioni, utilizza l'opzione |
-shell
|
Crea una console shell root nel terminale corrente. Questa opzione si differenzia dal
comando
Ad esempio: emulator @Pixel8_API_34 -shell |
-snapshot name
|
Specifica il nome di uno snapshot all'interno di un file di archiviazione degli snapshot per le operazioni di avvio e salvataggio automatiche. Anziché eseguire una sequenza di avvio completa, l'emulatore può riprendere l'esecuzione da uno snapshot di stato precedente, che di solito è molto più veloce. Quando fornisci questa opzione, l'emulatore carica lo snapshot con quel nome dall'immagine dello snapshot e lo salva di nuovo con lo stesso nome all'uscita. Se non utilizzi questa opzione, la sequenza di avvio predefinita è una sequenza di avvio completa. Se lo snapshot specificato non esiste, l'emulatore esegue una sequenza di avvio completa ed esegue un'operazione di salvataggio. Consulta l'opzione 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'istantanea diversa, tutte le modifiche apportate da allora andranno perse. Puoi anche creare uno snapshot dalla console dell'emulatore utilizzando il comando
|
-snapshot-list
|
Visualizza un elenco degli snapshot disponibili. Questo comando stampa una tabella di snapshot
memorizzati nel file di archiviazione degli snapshot con cui è stato avviato l'emulatore, poi esce. Se specifichi anche Ad esempio: emulator @Pixel8_API_34 -snapshot-list -snapstorage ~/.android/avd/Pixel8_API_34.avd/snapshots-test.img Puoi utilizzare i valori delle colonne ID e TAG nell'output
come argomenti per l'opzione |
-snapstorage filepath
|
Specifica un file del repository che contiene tutti gli snapshot dello stato. Tutti gli snapshot creati durante l'esecuzione vengono salvati in questo file. Solo gli snapshot in questo file possono essere ripristinati durante l'esecuzione dell'emulatore. Ad esempio: emulator @Pixel8_API_34 -snapstorage ~/.android/avd/Pixel8_API_34.avd/snapshots-test.img Se non specifichi questa opzione, il valore predefinito è |
-sysdir dir
|
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 |
-system filepath
|
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 |
-writable-system
|
Utilizza questa opzione per disporre di un'immagine di sistema scrivibile durante la sessione di emulazione. Per farlo:
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. |
Opzioni obsolete
Le seguenti opzioni della riga di comando sono obsolete:
-audio-in-audio-out-charmap-code-profile-cpu-delay-dpi-device-dynamic_skin-enable-kvm-gps-image-keyset-help-keys-help-keyset-file-nand-limits-noskin-no-skin-onion-onion-alpha-onion-rotation-radio-ranchu-raw-keys-scale-shared-net-id-shell-serial-skin-skindir-trace-useaudio
Ricevere assistenza sulle opzioni a riga di comando
Questa sezione descrive come ottenere assistenza sulle opzioni della riga di comando. Fornisce informazioni più approfondite sulle opzioni della riga di comando dell'emulatore di uso comune disponibili all'avvio dell'emulatore.
Elenco di tutte le opzioni dell'emulatore
Per stampare un elenco di tutte le opzioni dell'emulatore, inclusa una breve descrizione, inserisci il seguente comando:
emulator -help
Ricevere assistenza dettagliata per un'opzione specifica
Per stampare la guida per un'opzione di avvio specifica, inserisci il seguente comando:
emulator -help-option
Ad esempio:
emulator -help-netspeed
Queste informazioni sono più dettagliate rispetto alla descrizione fornita dall'opzione
-help.
Ricevi assistenza dettagliata per tutte le opzioni
Per ricevere assistenza dettagliata per tutte le opzioni dell'emulatore, inserisci il seguente comando:
emulator -help-all
Elenca le variabili di ambiente dell'emulatore
Per ottenere un elenco delle variabili di ambiente dell'emulatore, inserisci questo comando:
emulator -help-environment
Puoi impostare le variabili di ambiente nella finestra del terminale prima di avviare un
dispositivo virtuale oppure puoi impostarle tramite le impostazioni utente nel sistema
operativo. Ad esempio, impostalo nel file .bashrc su Linux.
Elenco tag di debug
Per stampare un elenco di tag per le opzioni -debug, inserisci questo comando:
emulator -help-debug-tags
Le opzioni -debug ti consentono di attivare o disattivare i messaggi di debug di
componenti specifici dell'emulatore, come specificato dai tag.