Das Android SDK enthält einen Android-Geräteemulator – ein virtuelles Gerät, das auf Ihrem Computer ausgeführt wird. Mit dem Android-Emulator können Sie Android-Apps entwickeln und testen, ohne ein physisches Gerät zu verwenden.
Auf dieser Seite werden Befehlszeilenfunktionen beschrieben, die Sie mit dem Android-Emulator verwenden können. Informationen zur Verwendung der Android Emulator-Benutzeroberfläche finden Sie unter Apps im Android Emulator ausführen.
Emulator starten
Verwenden Sie den Befehl emulator, um den Emulator zu starten. Das ist eine Alternative zum Ausführen des Projekts oder zum Starten über den AVD Manager.
Hier ist die grundlegende Befehlszeilensyntax zum Starten eines virtuellen Geräts über eine Terminalaufforderung:
emulator -avd avd_name [ {-option [value]} … ]
Oder
emulator @avd_name [ {-option [value]} … ]
Wenn Sie den Emulator beispielsweise in Android Studio auf einem Mac starten, sieht die Standardbefehlszeile in etwa so aus:
/Users/janedoe/Library/Android/sdk/emulator/emulator -avd Pixel8_API_34 -netdelay none -netspeed full -qt-hide-window -grpc-use-token -idle-grpc-timeout
Die Argumente -qt-hide-window -grpc-use-token -idle-grpc-timeout werden nur verwendet, um das Emulatorfenster in Android Studio auszuführen. Wenn Sie den Emulator in einem eigenen Fenster ausführen möchten, sollten Sie diese zusätzlichen Parameter nicht verwenden.
Sie können Startoptionen angeben, wenn Sie den Emulator starten, aber nicht, nachdem er gestartet wurde.
Geben Sie den folgenden Befehl ein, um eine Liste der AVD-Namen aufzurufen:
emulator -list-avds
Mit dieser Option wird eine Liste der AVD-Namen aus Ihrem Android-Home-Verzeichnis angezeigt.
Sie können das Standardbasisverzeichnis überschreiben, indem Sie die Umgebungsvariable ANDROID_SDK_HOME festlegen. Diese gibt das Stammverzeichnis des nutzerspezifischen Verzeichnisses an, in dem alle Konfigurations- und AVD-Inhalte gespeichert werden.
Sie können die Umgebungsvariable im Terminalfenster festlegen, bevor Sie ein virtuelles Gerät starten, oder über Ihre Nutzereinstellungen im Betriebssystem. Beispielsweise in der Datei .bashrc unter Linux.
Schließen Sie das Emulatorfenster, um den Android-Emulator zu beenden.
App installieren
Sie können Ihre App nicht nur über Android Studio oder die Emulator-Benutzeroberfläche installieren, sondern auch mit dem adb-Dienstprogramm auf einem virtuellen Gerät.
So installieren, führen und testen Sie Ihre App mit adb:
- Erstellen Sie ein APK für Ihre App, wie unter App erstellen und ausführen beschrieben.
- Starten Sie den Emulator über die Befehlszeile, wie im vorherigen Abschnitt beschrieben, und verwenden Sie dabei alle erforderlichen Startoptionen.
- Installieren Sie Ihre App mit
adb. - Führen Sie Ihre App im Emulator aus und testen Sie sie.
Während der Emulator ausgeführt wird, können Sie bei Bedarf Befehle über die Emulator-Konsole ausgeben.
So deinstallieren Sie eine App:
Das virtuelle Gerät behält die App und ihre Statusdaten über Neustarts hinweg in einer Partition für Nutzerdaten (userdata-qemu.img) bei. Wenn Sie diese Daten löschen möchten, starten Sie den Emulator mit der Option -wipe-data oder löschen Sie die Daten im AVD Manager. Weitere Informationen zur Partition für Nutzerdaten und zum anderen Speicher finden Sie im folgenden Abschnitt.
Hinweis:Das adb-Dienstprogramm betrachtet das virtuelle Gerät als physisches Gerät. Aus diesem Grund müssen Sie möglicherweise das Flag -d mit einigen gängigen adb-Befehlen wie install verwenden. Mit dem Flag -d können Sie angeben, welches der mehreren verbundenen Geräte als Ziel eines Befehls verwendet werden soll. Wenn Sie -d nicht angeben, wird der Emulator auf das erste Gerät in seiner Liste ausgerichtet.
Standardverzeichnisse und ‑dateien
Der Emulator verwendet zugehörige Dateien, von denen die System- und Datenverzeichnisse des AVD am wichtigsten sind. Es ist hilfreich, die Verzeichnisstruktur und die Dateien des Emulators zu kennen, wenn Sie Befehlszeilenoptionen angeben. Normalerweise müssen Sie die Standardverzeichnisse oder ‑dateien jedoch nicht ändern.
Der Android Emulator verwendet den Hypervisor QEMU.
AVD-Systemverzeichnis
Das Systemverzeichnis enthält die Android-System-Images, die der Emulator zum Simulieren des Betriebssystems verwendet. Dieses Verzeichnis enthält plattformspezifische, schreibgeschützte Dateien, die von allen AVDs desselben Typs gemeinsam genutzt werden, einschließlich API-Level, CPU-Architektur und Android-Variante. Die Standardspeicherorte sind:
- macOS und Linux:
~/Library/Android/sdk/system-images/android-apiLevel/variant/arch/ - Windows –
C:\Users\user\Library\Android\sdk\system-images\android-apiLevel\variant\arch\
Dabei gilt:
apiLevelist eine numerische API-Ebene oder ein Buchstabe für Vorabversionen.android-Vsteht beispielsweise für die Android-Version VanillaIceCream (Vorschau). Bei der Veröffentlichung wurde es auf API-Level 35 festgelegt, das durchandroid-35gekennzeichnet ist.variantist ein Name, der bestimmten Funktionen entspricht, die vom Systemimage implementiert werden. Beispiel:google_apisoderandroid-wear.archist die Ziel-CPU-Architektur. Beispiel:x86.
Mit der Option -sysdir können Sie ein anderes Systemverzeichnis für das AVD angeben.
Der Emulator liest die folgenden Dateien aus dem Systemverzeichnis:
Tabelle 1 Dateien im Systemverzeichnis, die vom Android-Emulator gelesen werden
| Datei | Beschreibung | Option zum Angeben einer anderen Datei |
|---|---|---|
kernel-qemu oder kernel-ranchu
|
Das binäre Kernel-Image für das AVD. kernel-ranchu basiert auf dem QEMU-Emulator.
|
-kernel
|
ramdisk.img
|
Das Boot-Partitions-Image. Dies ist eine Teilmenge von system.img, die vom Kernel geladen wird, bevor das System-Image bereitgestellt wird. Es enthält in der Regel nur wenige Binärdateien und Initialisierungsskripts.
|
-ramdisk
|
system.img
|
Die schreibgeschützte, ursprüngliche Version des System-Images. Insbesondere die Partition, die die Systembibliotheken und Daten enthält, die dem API-Level und der Variante entsprechen. | -system
|
userdata.img
|
Die ursprüngliche Version der Datenpartition, die im emulierten System als data/ angezeigt wird und alle beschreibbaren Daten für das AVD enthält. Der Emulator verwendet diese Datei, wenn Sie ein neues AVD erstellen oder die Option ‑wipe-data verwenden. Weitere Informationen finden Sie in der Dateibeschreibung für userdata-qemu.img im nächsten Abschnitt.
|
-initdata
-init-data
|
AVD-Datenverzeichnis
Das AVD-Datenverzeichnis, auch Inhaltsverzeichnis genannt, ist spezifisch für eine einzelne AVD-Instanz und enthält alle änderbaren Daten für die AVD.
Der Standardspeicherort ist der folgende, wobei name der AVD-Name ist:
- macOS und Linux:
~/.android/avd/name.avd/ - Windows 10 und höher –
C:\Users\user\.android\name.avd\
Mit der Option -datadir können Sie ein anderes AVD-Datenverzeichnis angeben.
In der folgenden Tabelle sind die wichtigsten Dateien aufgeführt, die in diesem Verzeichnis enthalten sind:
Tabelle 2 Wichtige Dateien im AVD-Datenverzeichnis
| Datei | Beschreibung | Option zum Angeben einer anderen Datei |
|---|---|---|
userdata-qemu.img
|
Der Inhalt der Datenpartition, der im emulierten System als
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 einer installierten App eines bestimmten Nutzers in dem Bild gespeichert. Jeder Nutzer hat ein anderes |
-data
|
cache.img
|
Das Cache-Partitions-Image, das im emulierten System als cache/ angezeigt wird. Sie ist leer, wenn Sie ein AVD zum ersten Mal erstellen oder die Option -wipe-data verwenden. Darin werden temporäre Download-Dateien gespeichert. Der Ordner wird vom Download-Manager und manchmal vom System gefüllt. Der Browser verwendet sie beispielsweise, um heruntergeladene Webseiten und Bilder zu speichern, während der Emulator ausgeführt wird. Wenn Sie das virtuelle Gerät ausschalten, wird die Datei gelöscht. Sie können die Datei mit der Option -cache beibehalten.
|
-cache
|
sdcard.img
|
Optional: Ein SD-Kartenpartitionsimage, mit dem Sie eine SD-Karte auf einem virtuellen Gerät simulieren können. Sie können eine SD-Karten-Imagedatei im AVD Manager oder mit dem Tool
Wenn Sie ein AVD im AVD Manager definieren, können Sie eine automatisch verwaltete SD-Kartendatei oder eine Datei verwenden, die Sie mit dem
Sie können Dateien auf einer simulierten SD-Karte suchen, Dateien darauf senden sowie Dateien kopieren und entfernen, indem Sie die Emulator-Benutzeroberfläche oder das
Wenn Sie Dateien in die SD-Karte kopieren möchten, bevor Sie sie laden, hängen Sie die Image-Datei als Loop-Gerät ein und kopieren Sie dann die Dateien. Alternativ können Sie ein Dienstprogramm wie das Der Emulator behandelt die Datei als Bytepool, daher spielt das SD-Kartenformat keine Rolle.
Die Option |
-sdcard
|
Vom Emulator verwendete Verzeichnisse und Dateien auflisten
Es gibt zwei Möglichkeiten, den Speicherort von Dateien herauszufinden:
- Verwenden Sie die Option
-verboseoder-debug init, wenn Sie den Emulator über die Befehlszeile starten. Sehen Sie sich die Ausgabe an. - Verwenden Sie den Befehl
emulator-help-option, um ein Standardverzeichnis aufzulisten. Beispiel: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.
Befehlszeilen-Startoptionen
In diesem Abschnitt werden Optionen aufgeführt, die Sie in der Befehlszeile angeben können, wenn Sie den Emulator starten.
Hinweis:Der Android-Emulator wird ständig weiterentwickelt, um ihn zuverlässiger zu machen. Informationen zum Status der Probleme, die für verschiedene Befehlszeilenoptionen gemeldet wurden, und zum Melden von Fehlern finden Sie im Android Issue Tracker.
Häufig verwendete Optionen
In der folgenden Tabelle sind Befehlszeilen-Startoptionen aufgeführt, die Sie möglicherweise häufiger verwenden:
Tabelle 3 Häufig verwendete Befehlszeilenoptionen
| Befehlszeilenoption | Beschreibung |
|---|---|
| Schnellstart | |
-no-snapshot-load
|
Führt einen Kaltstart durch und speichert den Emulatorstatus beim Beenden. |
-no-snapshot-save
|
Führt, sofern möglich, einen schnellen Start durch, speichert den Emulatorstatus beim Beenden jedoch nicht. |
-no-snapshot
|
Deaktiviert die Funktion „Schnellstart“ vollständig und lädt oder speichert den Emulatorstatus nicht. |
| Gerätehardware | |
-camera-back mode-camera-front mode
|
Legt den Emulationsmodus für eine nach hinten oder vorne gerichtete Kamera fest. Dadurch werden alle Kameraeinstellungen im AVD überschrieben.
Beispiel: emulator @Pixel8_API_34 -camera-back webcam0 |
-webcam-list
|
Listet die Webcams auf Ihrem Entwicklungscomputer auf, die für die Emulation verfügbar sind. Beispiel: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 Ab SDK Tools 25.2.4 ist der AVD-Name erforderlich. |
| Laufwerk-Images und Arbeitsspeicher | |
-memory size
|
Gibt die Größe des physischen RAM an, von 1.536 bis 8.192 MB. Beispiel: emulator @Pixel8_API_34 -memory 2048 Dieser Wert überschreibt die AVD-Einstellung. |
-sdcard filepath
|
Gibt den Dateinamen und den Pfad zu einer SD-Kartenpartitions-Bilddatei an. Dazu gehören beispielsweise:
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 |
-wipe-data
|
Nutzerdaten werden gelöscht und Daten aus der ursprünglichen Datendatei werden kopiert. 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 |
| Debuggen | |
-debug tags
|
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 Netzwerk-Sockets und Messwerten:
Eine Liste der Tags und Beschreibungen finden Sie unter der Option
emulator -help-debug-tags
Sie können die Standard-Debug-Tags in der Umgebungsvariable
ANDROID_VERBOSE=socket,gles Das entspricht der Verwendung von:
oder
|
-debug-tag-debug-no-tag
|
Aktiviert einen bestimmten Typ von Debugging-Meldungen. Verwenden Sie das Formular no, 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 |
-logcat logtags
|
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
Im folgenden Beispiel werden GSM-Komponentennachrichten auf der informativen Logebene angezeigt:
emulator @Pixel8_API_34 -logcat '*:s GSM:i'
Wenn Sie die Option Weitere Informationen zu Logcat und |
-show-kernel
|
Zeigt Kernel-Debug-Meldungen im Terminalfenster an. Beispiel:
emulator @Pixel8_API_34 -show-kernel Diese Option kann beispielsweise verwendet werden, um zu prüfen, ob der Bootvorgang ordnungsgemäß funktioniert. |
-verbose
|
Gibt Initialisierungsnachrichten des Emulators im Terminalfenster aus. Dazu gehören beispielsweise:
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 |
| Netzwerk | |
-dns-server servers
|
Verwendet die angegebenen DNS-Server. servers ist eine durch Kommas getrennte Liste mit bis zu vier DNS-Servernamen oder IP-Adressen. Dazu gehören beispielsweise:
emulator @Pixel8_API_34 -dns-server 192.0.2.0,
Standardmäßig versucht der Emulator, die verwendeten DNS-Server zu erkennen, und richtet spezielle Aliase im emulierten Firewallnetzwerk ein, damit das Android-System direkt eine Verbindung zu den Servern herstellen kann. Mit der Option |
-http-proxy proxy
|
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
Das Präfix
Wenn diese Option nicht angegeben wird, sucht der Emulator nach der Umgebungsvariable |
-netdelay delay
|
Legt die Emulation der Netzwerklatenz auf einen der folgenden
Beispiel: emulator @Pixel8_API_34 -netdelay gsm
Der Emulator unterstützt die Netzwerkdrosselung sowie höhere Verbindungslatenzen.
Sie können sie entweder über die Skin-Konfiguration oder mit den Optionen |
-netfast
|
Deaktiviert die Netzwerkdrosselung. Beispiel:
emulator @Pixel8_API_34 -netfast
Diese Option entspricht der Angabe von |
-netspeed speed
|
Legt die Emulation der Netzwerkgeschwindigkeit fest. Gibt die maximale Upload- und Downloadgeschwindigkeit im Netzwerk mit einem der folgenden
Beispiel: emulator @Pixel8_API_34 -netspeed edge
Der Emulator unterstützt die Netzwerkdrosselung sowie höhere Verbindungslatenzen.
Sie können sie entweder über die Skin-Konfiguration oder mit den Optionen |
-port port
|
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
Die Portzuweisungen sind oft dieselben wie bei der Angabe von Die Option
Wenn der |
-ports
|
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
Wir empfehlen, nach Möglichkeit stattdessen die Option
Weitere Informationen zum Festlegen von Konsolen- und |
-tcpdump filepath
|
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. |
| System | |
-accel mode
|
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
Weitere Informationen finden Sie unter Hardwarebeschleunigung für den Android-Emulator konfigurieren. |
-accel-check
|
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. |
-engine engine
|
Gibt die Emulator-Engine an:
Beispiel:
emulator @Pixel8_API_34 -engine auto
Bei der automatischen Erkennung sollte der Wert ausgewählt werden, der die beste Leistung bei der Emulation eines bestimmten AVD bietet. Verwenden Sie die Option |
-gpu mode
|
Wählt den GPU-Emulationsmodus aus. Beispiel:
emulator @Pixel8_API_34 -gpu swiftshader_indirect Weitere Informationen finden Sie unter Grafikbeschleunigung konfigurieren. |
-no-accel
|
Deaktiviert die Beschleunigung der Emulator-VM bei Verwendung eines x86- oder x86_64-Systemimages. 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. |
-nojni
-no-jni
|
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. |
-selinux {disabled|permissive}
|
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 ist SELinux im |
-timezone timezone
|
Legt die Zeitzone für das virtuelle Gerät auf emulator @Pixel8_API_34 -timezone Europe/Paris
Standardmäßig verwendet der Emulator die Zeitzone Ihres Entwicklercomputers. Verwenden Sie diese Option, um eine andere Zeitzone anzugeben oder wenn die automatische Erkennung nicht richtig funktioniert. Der Wert für
Die angegebene Zeitzone muss sich in der zoneinfo-Datenbank befinden. |
-version
|
Zeigt die Versionsnummer des Emulators an. Beispiel:
emulator @Pixel8_API_34 -version Oder
emulator -version |
| Benutzeroberfläche | |
-no-boot-anim
|
Deaktiviert die Bootanimation während des Emulatorstarts, um das Booten zu beschleunigen.
Beispiel:
emulator @Pixel8_API_34 -no-boot-anim Auf langsameren Computern kann diese Option die Bootsequenz erheblich beschleunigen. |
-screen mode
|
Legt den emulierten Touchscreenmodus fest. Beispiel:
emulator @Pixel8_API_34 -screen no-touch
|
Erweiterte Optionen
Die Befehlszeilen-Startoptionen in der folgenden Tabelle sind verfügbar, werden aber von durchschnittlichen App-Entwicklern nicht häufig verwendet.
In den Beschreibungen ist das Arbeitsverzeichnis das aktuelle Verzeichnis im Terminal, in dem Sie Befehle eingeben. Informationen zum AVD-Systemverzeichnis und -Datenverzeichnis sowie zu den darin gespeicherten Dateien finden Sie im Abschnitt Standardverzeichnisse und -dateien.
Einige dieser Optionen eignen sich für externe App-Entwickler, andere werden hauptsächlich von Plattformentwicklern verwendet. App-Entwickler erstellen Android-Apps und führen sie auf bestimmten AVDs aus. Plattformentwickler arbeiten am Android-System und führen es im Emulator ohne vorab erstelltes AVD aus.
Tabelle 4. Erweiterte Befehlszeilenoptionen
| Fortgeschrittene Option | Kurzbeschreibung |
|---|---|
-bootchart timeout
|
Aktiviert das Bootcharting mit einem Zeitlimit in Sekunden. Einige Android-System-Images haben ein modifiziertes Init-System, in das eine Bootcharting-Funktion integriert ist. Mit dieser Option können Sie dem System einen Bootcharting-Zeitüberschreitungszeitraum ü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 |
-cache filepath
|
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-size size
|
Legt die Größe der Cache-Partition in MB fest. Beispiel: emulator @Pixel8_API_34 -cache-size 1000 Wenn Sie diese Option nicht angeben, wird standardmäßig 66 MB verwendet. 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. |
-data filepath
|
Legt die Image-Datei für die Partition mit Nutzerdaten 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 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 |
-datadir dir
|
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 |
-force-32bit
|
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 schon. Diese Option war hilfreich, um Vergleiche zur Fehlerbehebung durchzuführen. Beispiel: emulator @Pixel8_API_34 -force-32bit |
-help-disk-images
|
Ruft Hilfe zu Laufwerk-Images ab. Diese Option enthält Informationen, die sowohl für App- als auch für Plattformentwickler relevant sind. Beispiel: emulator -help-disk-images |
-help-char-devices
|
Ruft Hilfe zu den Spezifikationen für das Zeichen emulator -help-char-devices |
-help-sdk-images
|
Hier erhalten App-Entwickler Hilfe zu Laufwerk-Images. Mit dieser Option werden Informationen dazu abgerufen, wo sich die Bilddateien für ein mit den SDK-Tools erstelltes AVD befinden. Beispiel: emulator -help-sdk-images |
-help-build-images
|
Hier erhalten Plattformentwickler Hilfe zu Laufwerks-Images. Beispiel: emulator -help-build-images |
-initdata filepath-init-data
filepath
|
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 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 platziert. Weitere Informationen finden Sie unter AVD-Systemverzeichnis. |
-kernel filepath
|
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, wird standardmäßig |
-noaudio
-no-audio
|
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 Beispiel: emulator @Pixel8_API_34 -noaudio |
-nocache
-no-cache
|
Startet den Emulator ohne Cachepartition. Wenn Sie diese Option nicht verwenden, wird standardmäßig eine temporäre Datei mit dem Namen Beispiel: emulator @Pixel8_API_34 -nocache |
-no-snapshot
|
Verhindert sowohl das automatische Laden als auch das automatische Speichern. Der Emulator führt beim Schließen eine vollständige Bootsequenz aus und verliert seinen Status. Sie überschreibt die Option Beispiel: emulator @Pixel8_API_34 -no-snapshot |
-no-snapshot-load
|
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 |
-no-snapshot-save
|
Verhindert, dass der Emulator den AVD-Status beim Beenden im Snapshot-Speicher speichert. Alle Änderungen gehen also verloren. Beispiel: emulator @Pixel8_API_34 -no-snapshot-save |
-no-snapshot-update-time
|
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 |
-no-snapstorage
|
Startet den Emulator, ohne eine Datei zum Speichern oder Laden von Status-Snapshots einzubinden. Dadurch wird ein vollständiger Bootvorgang erzwungen und die Status-Snapshot-Funktion deaktiviert. Diese Option überschreibt die Optionen Beispiel: emulator @Pixel8_API_34 -no-snapstorage |
-no-window
|
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 emulator @Pixel8_API_34 -no-window |
-partition-size size
|
Gibt die Größe der Systemdatenpartition in MB an. Beispiel: emulator @Pixel8_API_34 -partition-size 1024 |
-prop name=value
|
Legt beim Starten des Emulators eine Android-Systemeigenschaft fest.
emulator @Pixel8_API_34 -prop qemu.name=value -prop qemu.abc=xyz |
-qemu args
|
Übergibt Argumente an die QEMU-Emulatorsoftware. Achten Sie darauf, dass diese Option die letzte angegebene Option ist, da alle nachfolgenden Optionen als QEMU-spezifische Optionen interpretiert werden. Diese Option ist recht komplex und sollte nur von Entwicklern verwendet werden, die sehr gut mit QEMU und der Android-Emulation vertraut sind. |
-qemu -h
|
Zeigt die emulator -qemu -h |
-ramdisk filepath
|
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, ist die Standardeinstellung die Datei |
-report-console socket
|
Meldet den Konsolenport an einen Remote-Drittanbieter, bevor die Emulation gestartet wird. Das kann für ein automatisiertes Testskript nützlich sein.
Weitere Informationen finden Sie unter der Option |
-shell
|
Erstellt eine Root-Shell-Konsole im aktuellen Terminal. Diese Option unterscheidet sich in folgenden Punkten vom Befehl
Beispiel: emulator @Pixel8_API_34 -shell |
-snapshot name
|
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 aus und speichert den aktuellen Status. Informationen zum Angeben einer Snapshot-Speicherdatei und der Standarddatei finden Sie unter der Option emulator @Pixel8_API_34 -snapshot snapshot2 Denken Sie daran, dass beim Laden eines Snapshots alle Inhalte des Systems, Nutzerdaten und SD-Kartenbilder 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 |
-snapshot-list
|
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 Beispiel: emulator @Pixel8_API_34 -snapshot-list -snapstorage ~/.android/avd/Pixel8_API_34.avd/snapshots-test.img Sie können die Spaltenwerte für „ID“ und „TAG“ in der Ausgabe als Argumente für die Option |
-snapstorage filepath
|
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 Emulatorausführung 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 |
-sysdir dir
|
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 |
-system filepath
|
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, ist die Standardeinstellung die Datei |
-writable-system
|
Mit dieser Option können Sie ein beschreibbares System-Image während der Emulationssitzung verwenden. Gehen Sie dazu folgendermaßen vor:
Wenn Sie dieses Flag verwenden, wird eine temporäre Kopie des Systemabbilds erstellt, die sehr groß sein kann (bis zu mehreren Hundert MB). Sie wird jedoch gelöscht, wenn der Emulator beendet wird. |
Eingestellte Optionen
Die folgenden Befehlszeilenoptionen sind veraltet:
-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
Hilfe zu Befehlszeilenoptionen erhalten
In diesem Abschnitt wird beschrieben, wie Sie Hilfe zu den Befehlszeilenoptionen erhalten. Dort finden Sie ausführlichere Informationen zu den häufig verwendeten Befehlszeilenoptionen für den Emulator, die beim Starten des Emulators verfügbar sind.
Alle Emulatoroptionen auflisten
Geben Sie den folgenden Befehl ein, um eine Liste aller Emulatoroptionen mit einer kurzen Beschreibung auszugeben:
emulator -help
Detaillierte Hilfe zu einer bestimmten Option erhalten
Wenn Sie Hilfe zu einer bestimmten Startoption ausgeben möchten, geben Sie den folgenden Befehl ein:
emulator -help-option
Beispiel:
emulator -help-netspeed
Diese Hilfe ist detaillierter als die Beschreibung, die mit der Option -help bereitgestellt wird.
Detaillierte Hilfe für alle Optionen erhalten
Geben Sie den folgenden Befehl ein, um eine ausführliche Hilfe zu allen Emulatoroptionen zu erhalten:
emulator -help-all
Umgebungsvariablen des Emulators auflisten
Geben Sie den folgenden Befehl ein, um eine Liste der Umgebungsvariablen des Emulators abzurufen:
emulator -help-environment
Sie können Umgebungsvariablen im Terminalfenster festlegen, bevor Sie ein virtuelles Gerät starten, oder über Ihre Nutzereinstellungen im Betriebssystem. Legen Sie sie beispielsweise in Ihrer .bashrc-Datei unter Linux fest.
Debug-Tags auflisten
Geben Sie den folgenden Befehl ein, um eine Liste der Tags für die -debug-Optionen auszugeben:
emulator -help-debug-tags
Mit den -debug-Optionen können Sie Debugging-Meldungen von bestimmten Emulatorkomponenten aktivieren oder deaktivieren, wie durch die Tags angegeben.