Emulator über Befehlszeile starten

Der Inhalt der Datenpartition, der im emulierten System als data/ angezeigt wird. Wenn Sie ein neues AVD erstellen oder die Option -wipe-data verwenden, um das AVD auf die Werkseinstellungen zurückzusetzen, kopiert der Emulator die Datei userdata.img im Systemverzeichnis, um diese Datei zu erstellen.

Jede virtuelle Geräteinstanz verwendet ein beschreibbares Nutzerdaten-Image zum Speichern von nutzer- und sitzungsspezifischen Daten. So werden beispielsweise die Daten, Einstellungen, Datenbanken und Dateien der installierten Apps eines bestimmten Nutzers in dem Bild gespeichert. Jeder Nutzer hat ein anderes ANDROID_SDK_HOME-Verzeichnis, in dem die Datenverzeichnisse für die von diesem Nutzer erstellten AVDs gespeichert werden. Jedes AVD hat eine einzelne userdata-qemu.img-Datei.

Optional: Ein SD-Kartenpartitionsimage, mit dem Sie eine SD-Karte auf einem virtuellen Gerät simulieren können. Sie können eine SD-Karten-Image-Datei im AVD Manager oder mit dem Tool mksdcard erstellen. Die Datei wird auf Ihrem Entwicklercomputer gespeichert und muss beim Start geladen werden.

Wenn Sie ein AVD im AVD Manager definieren, können Sie eine automatisch verwaltete SD-Kartendatei oder eine Datei verwenden, die Sie mit dem mksdcard-Tool erstellt haben. Sie können die sdcard.img-Datei, die einem AVD zugeordnet ist, im AVD Manager aufrufen. Mit der Option -sdcard wird die im AVD angegebene SD-Kartendatei überschrieben. Hinweis: Diese SD-Kartenoption funktioniert nicht auf Macs mit Apple Silicon.

Sie können eine simulierte SD-Karte durchsuchen, Dateien darauf senden, Dateien kopieren und entfernen, indem Sie die Emulator-Benutzeroberfläche oder das adb-Dienstprogramm verwenden, während das virtuelle Gerät ausgeführt wird. Sie können eine simulierte SD-Karte nicht aus einem laufenden virtuellen Gerät entfernen.

Wenn Sie Dateien in die SD-Kartendatei kopieren möchten, bevor Sie sie laden, hängen Sie die Imagedatei als Loop-Gerät ein und kopieren Sie dann die Dateien. Alternativ können Sie ein Dienstprogramm wie das mtools-Paket verwenden, um die Dateien direkt in das Image zu kopieren.

Der Emulator behandelt die Datei als Bytepool, daher spielt das SD-Kartenformat keine Rolle.

Die Option -wipe-data hat keine Auswirkungen auf diese Datei. Wenn Sie die Datei löschen möchten, löschen Sie sie und erstellen Sie sie dann mit dem AVD Manager oder dem Tool mksdcard neu. Wenn Sie die Größe der Datei ändern, wird die Datei ebenfalls gelöscht und eine neue Datei erstellt.

Legt den Emulationsmodus für eine nach hinten oder vorne gerichtete Kamera fest. Dadurch werden alle Kameraeinstellungen im AVD überschrieben.

mode kann einer der folgenden Werte sein:

• emulated – Der Emulator simuliert eine Kamera in der Software.
• environment: Der Emulator verwendet eine virtuelle Szene, die in der Umgebungskonfigurationsdatei des AVD definiert ist.
• webcamn: Der Emulator verwendet eine Webcam, die mit Ihrem Entwicklungscomputer verbunden ist und durch eine Nummer angegeben wird. Eine Liste der Webcams finden Sie unter der Option -webcam-list. Beispiel: webcam0
• imagefile:filename: Der Emulator verwendet eine Bilddatei für die Kameraausgabe.
• videofile:filename: Der Emulator verwendet ein Video für die Kameraausgabe.
• image360:filename: Der Emulator verwendet ein equirektanguläres Panoramabild für die Kameraausgabe. Verfügbar ab Version 36.6.4.
• none – Deaktiviert die Kamera im virtuellen Gerät.

Beispiel:

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'

Im Beispiel ist das erste webcam0 der Name, den Sie in der Befehlszeile verwenden. Das zweite webcam0 ist der Name, der vom Betriebssystem auf dem Entwicklercomputer verwendet wird. Der zweite Name variiert je nach Betriebssystem.

Ab SDK Tools 25.2.4 ist der AVD-Name erforderlich.

Gibt die Größe des physischen RAM an, von 1.536 bis 8.192 MB. Beispiel:

emulator @Pixel8_API_34 -memory 2048

Mit diesem Wert wird die AVD-Einstellung überschrieben.

Gibt den Dateinamen und den Pfad zu einer SD-Kartenpartitions-Image-Datei an. Beispiel:

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

Wenn die Datei nicht gefunden wird, wird der Emulator trotzdem gestartet, aber ohne SD-Karte. Der Befehl gibt die Warnung No SD Card Image (Kein SD-Karten-Image) zurück.

Wenn Sie diese Option nicht angeben, wird standardmäßig sdcard.img im Datenverzeichnis verwendet, sofern im AVD nichts anderes angegeben ist. Weitere Informationen zu emulierten SD-Karten finden Sie unter AVD-Datenverzeichnis.

Löscht Nutzerdaten und kopiert Daten aus der ursprünglichen Datendatei. Mit dieser Option werden die Daten für das virtuelle Gerät gelöscht und es wird in den Zustand zurückversetzt, in dem es sich bei der ersten Definition befand. Alle installierten Apps und Einstellungen werden entfernt. Beispiel:

emulator @Pixel8_API_34 -wipe-data

Standardmäßig ist die Nutzerdatendatei userdata-qemu.img und die Datei mit den Startdaten userdata.img. Beide Dateien befinden sich im Datenverzeichnis. Die Option -wipe-data hat keine Auswirkungen auf die Datei sdcard.img. Weitere Informationen zu Nutzerdaten finden Sie im Abschnitt Standardverzeichnisse und ‑dateien.

Aktiviert oder deaktiviert die Anzeige von Debug-Meldungen für ein oder mehrere Tags. Trennen Sie mehrere Tags durch ein Leerzeichen, Komma oder eine Spalte. Beispiel:

$ emulator @Pixel8_API_34 -debug init,metrics

Wenn Sie ein Tag deaktivieren möchten, setzen Sie ein Minuszeichen (-) davor. Mit der folgenden Option werden beispielsweise alle Debugging-Meldungen angezeigt, mit Ausnahme der Meldungen zu Netzwerksockets und Messwerten:

-debug all,-socket,-metrics

Eine Liste der Tags und Beschreibungen finden Sie unter der Option -help-debug-tags. Beispiel:

emulator -help-debug-tags

Sie können die Standard-Debug-Tags in der Umgebungsvariable ANDROID_VERBOSE definieren. Definieren Sie die Tags, die Sie verwenden möchten, in einer durch Kommas getrennten Liste. Hier ist ein Beispiel für die Angabe der Tags socket und gles:

ANDROID_VERBOSE=socket,gles

Das entspricht der Verwendung von:

-debug-socket -debug-gles

oder

-debug socket,gles

Aktiviert einen bestimmten Debug-Nachrichtentyp. Verwenden Sie das no-Formular, um einen Debug-Nachrichtentyp zu deaktivieren. Beispiel:

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

Eine Liste der Tags erhalten Sie mit dem Befehl emulator -help-debug-tags.

Ermöglicht die Anzeige von Logcat-Nachrichten für ein oder mehrere Tags und schreibt sie in das Terminalfenster. Mit dem folgenden Befehl werden beispielsweise Fehlermeldungen von allen Komponenten aktiviert:

emulator @Pixel8_API_34 -logcat *:e

logtags verwendet dasselbe Format wie der Befehl adb logcat logtags. Weitere Informationen finden Sie unter adb logcat -help. Dies ist eine Liste mit durch Leerzeichen oder Kommas getrennten Logfiltern im Format componentName:logLevel. componentName ist entweder ein Platzhaltersternchen (*) oder ein Komponentenname wie ActivityManager, SystemServer, InputManager oder WindowManager.

logLevel ist einer der folgenden Werte:

• v – ausführlich
• d – Debugging
• i – informativ
• w – Warnungs-Logebene
• e – Fehler
• s – lautlos

Im folgenden Beispiel werden GSM-Komponentenmeldungen auf der Logebene „Informative“ angezeigt:

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

Wenn Sie die Option -logcat nicht in der Befehlszeile angeben, sucht der Emulator nach der Umgebungsvariable ANDROID_LOG_TAGS. Wenn ANDROID_LOG_TAGS mit einem gültigen logtags-Wert definiert ist und nicht leer ist, verwendet der Emulator diesen Wert, um die Logcat-Ausgabe standardmäßig im Terminal zu aktivieren. Sie können dieselben oder andere Log-Nachrichten auch über adb an das Terminal umleiten.

Weitere Informationen zu Logcat und adb finden Sie unter Logcat-Befehlszeilentool, Logs mit Logcat ansehen und schreiben, Log-Klasse und adb-Befehle ausführen.

Zeigt Kernel-Debug-Meldungen im Terminalfenster an. Beispiel:

emulator @Pixel8_API_34 -show-kernel

Mit dieser Option können Sie unter anderem prüfen, ob der Bootvorgang ordnungsgemäß funktioniert.

Gibt Initialisierungsnachrichten des Emulators im Terminalfenster aus. Beispiel:

emulator @Pixel8_API_34 -verbose

Hier wird angezeigt, welche Dateien und Einstellungen tatsächlich ausgewählt sind, wenn ein in einem AVD definiertes virtuelles Gerät gestartet wird. Diese Option entspricht der Angabe von -debug-init.

Verwendet die angegebenen DNS-Server. servers ist eine durch Kommas getrennte Liste mit bis zu vier DNS-Servernamen oder IP-Adressen. Beispiel:

emulator @Pixel8_API_34 -dns-server 192.0.2.0,
192.0.2.255

Standardmäßig versucht der Emulator, die von Ihnen verwendeten DNS-Server zu erkennen, und richtet spezielle Aliase im emulierten Firewall-Netzwerk ein, damit das Android-System direkt eine Verbindung zu den Servern herstellen kann. Mit der Option -dns-server können Sie eine andere Liste von DNS-Servern angeben.

Stellt alle TCP-Verbindungen über einen angegebenen HTTP-/HTTPS-Proxy her. Wenn Ihr Emulator über einen Proxyserver auf das Internet zugreifen muss, können Sie diese Option oder die Umgebungsvariable http_proxy verwenden, um die entsprechende Weiterleitung einzurichten. Beispiel:

emulator @Pixel8_API_34 -http-proxy myserver:1981

proxy kann einer der folgenden Werte sein:

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

Das Präfix http:// kann weggelassen werden.

Wenn diese Option nicht angegeben wird, sucht der Emulator nach der Umgebungsvariablen http_proxy und verwendet automatisch jeden Wert, der dem Format proxy entspricht. Weitere Informationen finden Sie unter Emulator mit einem Proxy verwenden.

Hinweis:Wenn Sie mehrere Emulatoren ausführen, sollte dieses Flag beim ersten Start festgelegt werden.

Legt die Emulation der Netzwerklatenz auf einen der folgenden delay-Werte in Millisekunden fest:

• gsm – GSM/CSD (min. 150, max. 550).
• hscsd – HSCSD (min. 80, max. 400).
• gprs – GPRS (min. 35, max. 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: Keine Latenz, der Standardwert (min. 0, max. 0).
• num: Gibt die genaue Latenz an.
• min:max: Gibt einzelne minimale und maximale Latenzen an.

Beispiel:

emulator @Pixel8_API_34 -netdelay gsm

Der Emulator unterstützt sowohl die Netzwerkdrosselung als auch höhere Verbindungslatenzen. Sie können sie entweder über die Skin-Konfiguration oder mit den Optionen ‑netspeed und -netdelay definieren.

Hinweis:Diese Einstellung gilt für Ethernet und Mobilfunk.

Deaktiviert die Netzwerkdrosselung. Beispiel:

emulator @Pixel8_API_34 -netfast

Diese Option entspricht der Angabe von -netspeed full -netdelay none. Dies sind die Standardwerte für diese Optionen.

Hinweis:Diese Einstellung gilt für Ethernet und Mobilfunk.

Legt die Emulation der Netzwerkgeschwindigkeit fest. Gibt die maximale Upload- und Downloadgeschwindigkeit im Netzwerk mit einem der folgenden speed-Werte in kbit/s an:

• gsm – GSM/CSD (Upstream: 14,4 kbit/s, Downstream: 14,4 kbit/s).
• hscsd – HSCSD (Upstream: 14,4 kbit/s, Downstream: 57,6 kbit/s).
• gprs – GPRS (Upstream: 28,8 kbit/s, Downstream: 57,6 kbit/s).
• edge – EDGE/EGPRS (up: 473,6, down: 473,6).
• umts – UMTS/3G (up: 384.0, down: 384.0).
• hsdpa – HSDPA (Up: 5760,0, Down: 13.980,0).
• lte – LTE (Upload: 58.000, Download: 173.000)
• evdo – EVDO (Up: 75.000, Down: 280.000).
• full – Kein Limit, die Standardeinstellung (oben: 0,0, unten: 0,0).
• num: Gibt sowohl die Upload- als auch die Downloadgeschwindigkeit an.
• up:down: Gibt die einzelnen Upload- und Downloadgeschwindigkeiten an.

Beispiel:

emulator @Pixel8_API_34 -netspeed edge

Der Emulator unterstützt sowohl die Netzwerkdrosselung als auch höhere Verbindungslatenzen. Sie können sie entweder über die Skin-Konfiguration oder mit den Optionen ‑netspeed und -netdelay definieren.

Hinweis:Diese Einstellung gilt für Ethernet und Mobilfunk.

Übergibt zusätzliche Argumente an den Netzwerk-Simulator (netsim). arguments ist eine durch Leerzeichen getrennte Liste von Flags.

So aktivieren Sie beispielsweise die Paketerfassung und leiten das Logging zu stderr um:

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

Weitere Informationen finden Sie unter Erweiterte Netzwerkfunktionen des Emulators.

Legt die TCP-Portnummer fest, die für die Konsole und adb verwendet wird. Beispiel:

emulator @Pixel8_API_34 -port 5556

Der Standardwert ist 5554 für die erste virtuelle Geräteinstanz, die auf Ihrem Computer ausgeführt wird. Ein virtuelles Gerät belegt normalerweise ein Paar benachbarter Ports: einen Konsolenport und einen adb-Port. Die Konsole des ersten virtuellen Geräts, das auf einem bestimmten Computer ausgeführt wird, verwendet den Konsolenport 5554 und den adb-Port 5555. Bei nachfolgenden Instanzen werden Portnummern verwendet, die um zwei erhöht werden. Beispiele: 5556/5557, 5558/5559 usw. Der Bereich liegt zwischen 5554 und 5682, was 64 gleichzeitige virtuelle Geräte ermöglicht.

Die Portzuweisungen sind oft dieselben wie bei der Angabe von -ports port,{port + 1}. {port + 1} muss kostenlos sein und ist für adb reserviert. Wenn einer der Konsolen- oder adb-Anschlüsse bereits verwendet wird, wird der Emulator nicht gestartet.

Die Option ‑port gibt an, welche Ports und Seriennummer das virtuelle Gerät verwendet, und warnt, wenn es Probleme mit den von Ihnen angegebenen Werten gibt. In der Emulator-Benutzeroberfläche sehen Sie die Konsolenportnummer in der Titelleiste. Die adb-Portnummer finden Sie unter Hilfe > Über.

Wenn der port-Wert ungerade ist und im Bereich von 5554 bis 5584 liegt, wird das virtuelle Gerät zwar gestartet, ist aber nicht sichtbar, wenn Sie den Befehl adb devices verwenden und adb server nach dem Emulator gestartet wird. Wir empfehlen daher, eine gerade Konsolenportnummer zu verwenden.

Legt die TCP-Ports fest, die für die Konsole und adb verwendet werden. Beispiel:

emulator @Pixel8_API_34 -ports 5556,5559

Der gültige Portbereich liegt zwischen 5554 und 5682, sodass 64 gleichzeitige virtuelle Geräte möglich sind. Mit der Option -ports wird angegeben, welche Ports und Seriennummer die Emulatorinstanz verwendet. Außerdem werden Sie gewarnt, wenn es Probleme mit den von Ihnen angegebenen Werten gibt.

Wir empfehlen, nach Möglichkeit stattdessen die Option -port zu verwenden. Die Option -ports ist für Netzwerkkonfigurationen verfügbar, die spezielle Einstellungen erfordern.

Weitere Informationen zum Festlegen von Konsolen- und adb-Ports finden Sie unter der Option -port.

Erfasst Netzwerkpakete und speichert sie in einer Datei. Beispiel:

emulator @Pixel8_API_34 -tcpdump /path/dumpfile.cap

Mit dieser Option können Sie alle Netzwerkpakete erfassen, die über das virtuelle Ethernet-LAN des Emulators gesendet werden. Anschließend können Sie den Traffic mit einem Tool wie Wireshark analysieren.

Mit dieser Option werden alle Ethernet-Pakete erfasst und nicht nur TCP-Verbindungen.

Konfiguriert die Beschleunigung der Emulator-VM. Beispiel:

emulator @Pixel8_API_34 -accel auto

Die beschleunigte Emulation funktioniert nur für x86- und x86_64-System-Images. Unter Linux wird KVM verwendet. Unter Windows und Mac ist eine Intel-CPU und ein Intel HAXM-Treiber erforderlich. Diese Option wird ignoriert, wenn Sie kein x86- oder x86_64-Gerät emulieren.

Gültige Werte für mode sind:

• auto: Ermittelt automatisch, ob die Beschleunigung unterstützt wird, und verwendet sie, wenn möglich (Standard).
• off: Deaktiviert die Beschleunigung vollständig. Dies ist in erster Linie für das Debugging nützlich.
• on: Erzwingt die Beschleunigung. Wenn KVM oder HAXM nicht installiert oder nicht nutzbar ist, wird der Emulator nicht gestartet und es wird eine Fehlermeldung ausgegeben.

Weitere Informationen finden Sie unter Hardwarebeschleunigung für den Android-Emulator konfigurieren.

Prüft, ob ein erforderlicher Hypervisor für die Beschleunigung von Emulator-VMs installiert ist (HAXM oder KVM). Beispiel:

emulator -accel-check

Weitere Informationen finden Sie unter Prüfen, ob ein Hypervisor installiert ist.

Gibt die Emulator-Engine an:

• auto: Wählt automatisch eine Engine aus (Standard).
• classic: Verwendet die ältere QEMU 1-Engine (eingestellt).
• qemu2: Verwendet die neuere QEMU 2-Engine.

Beispiel:

emulator @Pixel8_API_34 -engine auto

Bei der automatischen Erkennung sollte der Wert ausgewählt werden, der die beste Leistung beim Emulieren eines bestimmten AVD bietet. Verwenden Sie die Option -engine nur zu Debugging- und Vergleichszwecken.

Wählt den GPU-Emulationsmodus aus. Beispiel:

emulator @Pixel8_API_34 -gpu swiftshader_indirect

Weitere Informationen finden Sie unter Grafikbeschleunigung konfigurieren.

Deaktiviert die Beschleunigung von Emulator-VMs bei Verwendung eines x86- oder x86_64-System-Images. Sie ist nur für das Debugging nützlich und entspricht der Angabe von -accel off. Beispiel:

emulator @Pixel8_API_34 -no-accel

Weitere Informationen finden Sie unter Hardwarebeschleunigung für den Android-Emulator konfigurieren.

Deaktiviert erweiterte JNI-Prüfungen (Java Native Interface) in der Android Dalvik- oder ART-Laufzeit. Beispiel:

emulator @Pixel8_API_34 -nojni

Wenn Sie ein virtuelles Gerät starten, sind erweiterte JNI-Prüfungen standardmäßig aktiviert. Weitere Informationen finden Sie unter JNI-Tipps.

Legt das Sicherheitsmodul Security-Enhanced Linux (SELinux) auf einem Linux-Betriebssystem auf den Modus disabled oder permissive fest. Beispiel:

me-linux$ emulator @Pixel8_API_34 -selinux permissive

Standardmäßig befindet sich SELinux im enforcing-Modus. Das bedeutet, dass die Sicherheitsrichtlinie erzwungen wird. Im Modus permissive wird die SELinux-Richtlinie geladen, aber nicht erzwungen. Bei dieser Option werden nur Richtlinienverstöße protokolliert. Im disabled-Modus wird die Kernelunterstützung für SELinux deaktiviert.

Legt die Zeitzone für das virtuelle Gerät auf timezone anstelle der Hostzeitzone fest. Beispiel:

emulator @Pixel8_API_34 -timezone Europe/Paris

Standardmäßig verwendet der Emulator die Zeitzone Ihres Entwicklungscomputers. Verwenden Sie diese Option, um eine andere Zeitzone anzugeben oder wenn die automatische Erkennung nicht richtig funktioniert. Der Wert timezone muss im zoneinfo-Format angegeben werden, also area/location oder area/subarea/location. Beispiel:

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

Die angegebene Zeitzone muss sich in der zoneinfo-Datenbank befinden.

Zeigt die Emulatorversionsnummer an. Beispiel:

emulator @Pixel8_API_34 -version

Oder

emulator -version

Deaktiviert die Bootanimation beim Start des Emulators, um das Booten zu beschleunigen. Beispiel:

emulator @Pixel8_API_34 -no-boot-anim

Auf langsameren Computern kann diese Option die Bootsequenz deutlich beschleunigen.

Legt den emulierten Touchscreen-Modus fest. Beispiel:

emulator @Pixel8_API_34 -screen no-touch

mode kann einer der folgenden Werte sein:

• touch: Emuliert einen Touchscreen (Standard).
• multi-touch: Emuliert einen Multi-Touch-Screen.
• no-touch – Deaktiviert die Emulation von Touch- und Multi-Touch-Screens.

Ermöglicht das Bootcharting mit einem Zeitlimit in Sekunden. Einige Android-System-Images haben ein modifiziertes Init-System, das eine Bootcharting-Funktion enthält. Mit dieser Option können Sie dem System einen Bootcharting-Zeitraum übergeben. Wenn in Ihrem Init-System kein Bootcharting aktiviert ist, hat die Option keine Auswirkungen. Diese Option ist in erster Linie für Plattformentwickler und nicht für externe App-Entwickler nützlich.

Beispiel:

emulator @Pixel8_API_34 -bootchart 120

Gibt eine Cache-Partitions-Image-Datei an. Gibt einen Dateinamen und einen absoluten Pfad oder einen Pfad relativ zum Datenverzeichnis an, um eine persistente Cache-Datei einzurichten. Wenn die Datei nicht vorhanden ist, wird sie vom Emulator als leere Datei erstellt.

Beispiel:

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

Wenn Sie diese Option nicht verwenden, wird standardmäßig eine temporäre Datei mit dem Namen cache.img erstellt. Weitere Informationen finden Sie unter AVD-Datenverzeichnis.

Legt die Größe der Cachepartition in MB fest.

Beispiel:

emulator @Pixel8_API_34 -cache-size 1000

Wenn Sie diese Option nicht angeben, beträgt der Standardwert 66 MB. Normalerweise benötigen die meisten App-Entwickler diese Option nicht, es sei denn, sie müssen sehr große Dateien herunterladen, die größer als der Standardcache sind. Weitere Informationen zur Cache-Datei finden Sie unter AVD-Datenverzeichnis.

Legt die Image-Datei für die Nutzerdatenpartition fest. Gibt einen Dateinamen und einen absoluten Pfad oder einen Pfad relativ zum Arbeitsverzeichnis an, um eine persistente Nutzerdatendatei einzurichten. Wenn die Datei nicht vorhanden ist, erstellt der Emulator ein Image aus der Standarddatei userdata.img, speichert es unter dem von Ihnen angegebenen Dateinamen und speichert die Nutzerdaten beim Herunterfahren darin.

Beispiel:

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

Wenn Sie diese Option nicht verwenden, wird standardmäßig eine Datei mit dem Namen userdata-qemu.img erstellt. Weitere Informationen zur Nutzerdatendatei finden Sie unter AVD-Datenverzeichnis.

Gibt ein Datenverzeichnis mit einem absoluten Pfad an. Weitere Informationen finden Sie unter AVD-Datenverzeichnis.

Beispiel:

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

Verwendet den 32-Bit-Emulator auf 64-Bit-Plattformen. Gelegentlich ist diese Option für Tests oder das Debugging nützlich. So gab es beispielsweise ein Problem, bei dem der Emulator manchmal nicht unter 64-Bit-Windows ausgeführt wurde, aber unter 32-Bit-Windows. Diese Option war hilfreich, um Vergleiche zur Fehlerbehebung durchzuführen. Beispiel:

emulator @Pixel8_API_34 -force-32bit

Hier erhalten Sie Hilfe zu Laufwerk-Images. Diese Option enthält Informationen, die sowohl für App- als auch für Plattformentwickler relevant sind. Beispiel:

emulator -help-disk-images

Ruft Hilfe zu den Spezifikationen für das Zeichen device ab. Für einige Emulatoroptionen ist ein device-Parameter erforderlich. Beispiel:

emulator -help-char-devices

Hier erhalten Sie Hilfe zu Laufwerk-Images, die für App-Entwickler relevant sind. Mit dieser Option werden Informationen darüber abgerufen, wo sich die Bilddateien für ein AVD befinden, das mit den SDK-Tools erstellt wurde. Beispiel:

emulator -help-sdk-images

Hier erhalten Plattformentwickler Hilfe zu Laufwerk-Images. Beispiel:

emulator -help-build-images

Gibt die ursprüngliche Version der Datenpartition an. Nach dem Löschen der Nutzerdaten kopiert der Emulator den Inhalt der angegebenen Datei in die Nutzerdaten (standardmäßig die Datei userdata-qemu.img), anstatt die Standarddatei userdata.img als erste Version zu verwenden. Gibt den Dateinamen und einen absoluten Pfad oder einen Pfad relativ zum Arbeitsverzeichnis an.

Beispiel:

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

Wenn Sie keinen Pfad angeben, wird die Datei im Systemverzeichnis abgelegt. Weitere Informationen finden Sie unter AVD-Systemverzeichnis.

Verwendet einen bestimmten emulierten Kernel. Wenn Sie keinen Pfad angeben, sucht der Emulator im Systemverzeichnis. Mit der Option ‑show‑kernel können Sie Kernel-Debug-Meldungen aufrufen.

Beispiel:

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

Wenn Sie diese Option nicht angeben, ist der Standardwert kernel-ranchu. Weitere Informationen finden Sie unter AVD-Systemverzeichnis.

Deaktiviert die Audio-Unterstützung für dieses virtuelle Gerät. Einige Linux- und Windows-Computer haben fehlerhafte Audiotreiber, die verschiedene Symptome verursachen, z. B. das Starten des Emulators verhindern. Verwenden Sie in diesem Fall diese Option, um das Problem zu beheben. Alternativ können Sie die Umgebungsvariable QEMU_AUDIO_DRV verwenden, um das Audio-Backend zu ändern.

Beispiel:

emulator @Pixel8_API_34 -noaudio

Startet den Emulator ohne Cachepartition. Wenn Sie diese Option nicht verwenden, wird standardmäßig eine temporäre Datei mit dem Namen cache.img erstellt. Diese Option ist nur für Plattformentwickler verfügbar. Weitere Informationen finden Sie unter AVD-Datenverzeichnis.

Beispiel:

emulator @Pixel8_API_34 -nocache

Verhindert sowohl das automatische Laden als auch das automatische Speichern. Der Emulator führt eine vollständige Bootsequenz aus und verliert seinen Status, wenn er geschlossen wird. Dadurch wird die Option -snapshot überschrieben.

Beispiel:

emulator @Pixel8_API_34 -no-snapshot

Verhindert, dass der Emulator den AVD-Status aus dem Snapshot-Speicher lädt. Führt einen vollständigen Neustart durch.

Beispiel:

emulator @Pixel8_API_34 -no-snapshot-load

Verhindert, dass der Emulator den AVD-Status beim Beenden im Snapshot-Speicher speichert. Das bedeutet, dass alle Änderungen verloren gehen.

Beispiel:

emulator @Pixel8_API_34 -no-snapshot-save

Die AVD-Uhrzeit wird beim Wiederherstellen eines Snapshots nicht sofort korrigiert. Diese Option kann beim Testen nützlich sein, da sie einen plötzlichen Zeitsprung verhindert. Zeitaktualisierungen werden weiterhin etwa alle 15 Sekunden an den AVD gesendet.

Beispiel:

emulator @Pixel8_API_34 -no-snapshot-update-time

Startet den Emulator, ohne eine Datei zum Speichern oder Laden von Status-Snapshots einzubinden. Dadurch wird ein vollständiger Bootvorgang erzwungen und die Funktion für Status-Snapshots deaktiviert. Diese Option überschreibt die Optionen -snapstorage und -snapshot.

Beispiel:

emulator @Pixel8_API_34 -no-snapstorage

Deaktiviert die grafische Fensteranzeige im Emulator. Diese Option ist nützlich, wenn der Emulator auf Servern ohne Display ausgeführt wird. Sie können über adb oder die Console auf den Emulator zugreifen. Beispiel:

emulator @Pixel8_API_34 -no-window

Gibt die Größe der Systemdatenpartition in MB an. Beispiel:

emulator @Pixel8_API_34 -partition-size 1024

Legt beim Starten eine Android-Systemeigenschaft im Emulator fest. name muss ein Property-Name mit dem Label qemu_prop sein, der maximal 32 Zeichen lang ist und keine Leerzeichen enthält. value muss ein String mit maximal 92 Zeichen sein. Ein Beispiel finden Sie in der Datei property_contexts. Sie können mehrere ‑prop-Optionen in einer Befehlszeile angeben. Diese Option kann bei der Fehlerbehebung hilfreich sein. Beispiel:

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

Zeigt die Hilfe für -qemu an. Beispiel:

emulator -qemu -h

Gibt ein Ramdisk-Boot-Image an. Gibt den Dateinamen und einen absoluten Pfad oder einen Pfad relativ zum Arbeitsverzeichnis an.

Beispiel:

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

Wenn Sie diese Option nicht verwenden, wird standardmäßig die Datei ramdisk.img im Systemverzeichnis verwendet. Weitere Informationen finden Sie unter AVD-Systemverzeichnis.

Meldet den Konsolenport an einen Remote-Drittanbieter, bevor die Emulation gestartet wird. Das kann für ein automatisiertes Testscript nützlich sein. socket muss eines der folgenden Formate haben:

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

Weitere Informationen finden Sie unter -help-report-console Hilfe zu bestimmten Optionen.

Erstellt eine Root-Shell-Konsole im aktuellen Terminal. Diese Option unterscheidet sich in folgenden Punkten vom Befehl adb shell:

• Dadurch wird eine Root-Shell erstellt, mit der Sie viele Teile des Systems ändern können.
• Das funktioniert auch, wenn die adb daemon im emulierten System defekt ist.
• Drücken Sie Strg + C (oder Befehl + C unter macOS), um den Emulator anstelle der Shell zu beenden.

Beispiel:

emulator @Pixel8_API_34 -shell

Gibt den Namen eines Snapshots in einer Snapshot-Speicherdatei für automatische Start- und Speichervorgänge an.

Anstatt eine vollständige Bootsequenz auszuführen, kann der Emulator die Ausführung aus einem früheren Status-Snapshot fortsetzen, was in der Regel deutlich schneller geht. Wenn Sie diese Option angeben, lädt der Emulator den Snapshot mit diesem Namen aus dem Snapshot-Image und speichert ihn beim Beenden unter demselben Namen.

Wenn Sie diese Option nicht verwenden, wird standardmäßig eine vollständige Bootsequenz ausgeführt. Wenn der angegebene Snapshot nicht vorhanden ist, führt der Emulator stattdessen eine vollständige Bootsequenz und einen Speichervorgang aus.

Informationen zum Angeben einer Snapshot-Speicherdatei und der Standarddatei finden Sie unter der Option -snapstorage.

emulator @Pixel8_API_34 -snapshot snapshot2

Denken Sie daran, dass beim Laden eines Snapshots alle Inhalte des Systems, Nutzerdaten und Bilder auf der SD-Karte mit den Inhalten überschrieben werden, die zum Zeitpunkt der Erstellung des Snapshots vorhanden waren. Wenn Sie diese Informationen nicht in einem anderen Snapshot speichern, gehen alle Änderungen seitdem verloren.

Sie können auch über die Emulator-Konsole mit dem Befehl avd snapshot save name einen Snapshot erstellen. Weitere Informationen finden Sie unter Emulator-Konsolenbefehle senden.

Zeigt eine Liste der verfügbaren Snapshots an. Mit diesem Befehl wird eine Tabelle mit Snapshots ausgegeben, die in der Snapshot-Speicherdatei gespeichert sind, mit der der Emulator gestartet wurde. Anschließend wird das Programm beendet. Wenn Sie auch -snapstorage file angeben, wird mit diesem Befehl eine Tabelle der in der Datei gespeicherten Snapshots ausgegeben.

Beispiel:

emulator @Pixel8_API_34 -snapshot-list -snapstorage
   ~/.android/avd/Pixel8_API_34.avd/snapshots-test.img

Sie können die Spaltenwerte „ID“ und „TAG“ in der Ausgabe als Argumente für die Option -snapshot verwenden.

Gibt eine Repository-Datei an, die alle Status-Snapshots enthält. Alle während der Ausführung erstellten Snapshots werden in dieser Datei gespeichert. Nur Snapshots in dieser Datei können während der Ausführung des Emulators wiederhergestellt werden.

Beispiel:

emulator @Pixel8_API_34 -snapstorage
   ~/.android/avd/Pixel8_API_34.avd/snapshots-test.img

Wenn Sie diese Option nicht angeben, wird standardmäßig snapshots.img im Datenverzeichnis verwendet. Wenn die angegebene Datei nicht vorhanden ist, wird der Emulator gestartet, aber ohne Unterstützung für das Speichern oder Laden von Status-Snapshots.

Gibt ein Systemverzeichnis mit einem absoluten Pfad an. Weitere Informationen finden Sie unter AVD-Systemverzeichnis. Beispiel:

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

Gibt eine anfängliche Systemdatei an. Gibt den Dateinamen und einen absoluten Pfad oder einen Pfad relativ zum Arbeitsverzeichnis an.

Beispiel:

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

Wenn Sie diese Option nicht verwenden, wird standardmäßig die Datei system.img im Systemverzeichnis verwendet. Weitere Informationen finden Sie unter AVD-Systemverzeichnis.

Mit dieser Option können Sie ein beschreibbares System-Image während der Emulationssitzung verwenden. Anleitung:

1. Starten Sie ein virtuelles Gerät mit der Option -writable-system.
2. Geben Sie den Befehl adb remount in einem Befehlsterminal ein, um den Emulator anzuweisen, system/ als Lese-/Schreibzugriff neu zu mounten. Standardmäßig wird es schreibgeschützt bereitgestellt.

Wenn Sie dieses Flag verwenden, wird eine temporäre Kopie des System-Images erstellt, die sehr groß sein kann (bis zu mehreren Hundert MB). Sie wird jedoch gelöscht, wenn der Emulator beendet wird.