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 benötigen.
Auf dieser Seite werden Befehlszeilenfunktionen beschrieben, die Sie mit dem Android-Emulator verwenden können. Informationen zur Verwendung der Android-Emulator-UI finden Sie unter Apps im Android-Emulator ausführen.
Emulator starten
Verwenden Sie den Befehl emulator, um den Emulator zu starten. Alternativ können Sie auch Ihr Projekt ausführen oder den AVD Manager starten.
Hier ist die grundlegende Befehlszeilensyntax zum Starten eines virtuellen Geräts über eine Terminal-Eingabeaufforderung:
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 beim Starten des Emulators festlegen, aber nicht nach dem Start.
Geben Sie den folgenden Befehl ein, um eine Liste der AVD-Namen aufzurufen:
emulator -list-avds
Mit dieser Option können Sie eine Liste der AVD-Namen aus Ihrem Android-Basisverzeichnis aufrufen.
Sie können das Standard-Basisverzeichnis ü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 sind.
Sie können die Umgebungsvariable im Terminalfenster festlegen, bevor Sie ein virtuelles Gerät starten, oder über die Nutzereinstellungen im Betriebssystem. Zum Beispiel in der Datei .bashrc unter Linux.
Schließen Sie das Emulatorfenster, um den Android-Emulator zu beenden.
App installieren
Du kannst deine App nicht nur über Android Studio oder die Emulator-UI installieren, sondern auch mit dem adb-Dienstprogramm auf einem virtuellen Gerät installieren.
Gehen Sie so vor, um adb zum Installieren, Ausführen und Testen Ihrer Anwendung zu verwenden:
- Erstelle deine App und verpacke sie in einem APK, wie unter App erstellen und ausführen beschrieben.
- Starten Sie den Emulator wie im vorherigen Abschnitt beschrieben über die Befehlszeile und verwenden Sie dabei die 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 die Emulator-Konsole verwenden, um nach Bedarf Befehle auszugeben.
Gehen Sie bei der Deinstallation einer App wie bei einem Android-Gerät vor.
Das virtuelle Gerät behält die App und ihre Statusdaten bei Neustarts in einer Laufwerkspartition für Nutzerdaten (userdata-qemu.img) bei. Starten Sie den Emulator mit der Option -wipe-data oder löschen Sie die Daten im AVD Manager, um diese Daten zu löschen. Weitere Informationen zur Nutzerdatenpartition und anderen Speicher finden Sie im folgenden Abschnitt.
Hinweis:Das Dienstprogramm adb betrachtet das virtuelle Gerät als tatsächliches physisches Gerät. Daher müssen Sie das Flag -d möglicherweise mit einigen gängigen adb-Befehlen wie install verwenden. Mit dem Flag -d können Sie angeben, welches von mehreren verbundenen Geräten als Ziel für einen Befehl verwendet werden soll. Wenn Sie -d nicht angeben, wird der Emulator auf das erste Gerät in der Liste ausgerichtet.
Standardverzeichnisse und -dateien
Der Emulator verwendet verknüpfte Dateien, von denen das AVD-System und die Datenverzeichnisse am wichtigsten sind. Es ist hilfreich, die Verzeichnisstruktur und die Dateien des Emulators zu verstehen, wenn Sie Befehlszeilenoptionen festlegen. 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, mit denen der Emulator das Betriebssystem simuliert. Dieses Verzeichnis enthält plattformspezifische, schreibgeschützte Dateien, die von allen AVDs desselben Typs freigegeben werden, einschließlich API-Ebene, 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-Vgibt beispielsweise die Android VanillaIceCream-Vorschau an. Nach der Veröffentlichung wurde sie in das API-Level 35 (bezeichnet durchandroid-35) übernommen.variantist ein Name, der bestimmten Funktionen entspricht, die vom System-Image 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 die AVD angeben.
Der Emulator liest die folgenden Dateien aus dem Systemverzeichnis:
Tabelle 1 Systemverzeichnisdateien, 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 Bootpartitions-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, anfängliche Version des System-Images. Insbesondere die Partition mit den Systembibliotheken und Daten, die dem API-Level und der API-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 Beschreibung der Datei userdata-qemu.img im folgenden Abschnitt.
|
-initdata
-init-data
|
AVD-Datenverzeichnis
Das AVD-Datenverzeichnis, auch Inhaltsverzeichnis genannt, ist für eine einzelne AVD-Instanz spezifisch und enthält alle änderbaren Daten für das 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 in diesem Verzeichnis enthaltenen Dateien aufgeführt:
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 VM-Instanz verwendet ein beschreibbares Nutzerdaten-Image, um nutzer- und sitzungsspezifische Daten zu speichern. Das Image wird beispielsweise verwendet, um die installierten Anwendungsdaten, Einstellungen, Datenbanken und Dateien eines einzelnen Nutzers zu speichern. Jeder Nutzer hat ein anderes |
-data
|
cache.img
|
Das Cache-Partitions-Image, das im emulierten System als cache/ angezeigt wird. Es ist leer, wenn Sie zum ersten Mal ein AVD erstellen oder die Option -wipe-data verwenden. Er speichert temporäre Downloaddateien und wird vom Download-Manager und manchmal vom System gefüllt. Der Browser verwendet ihn beispielsweise, um heruntergeladene Webseiten und Bilder im Cache 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 dauerhaft speichern.
|
-cache
|
sdcard.img
|
(Optional) Ein SD-Karten-Partitions-Image, mit dem Sie eine SD-Karte auf einem virtuellen Gerät simulieren können. Sie können eine Bilddatei von SD-Karten im AVD-Manager oder mit dem Tool
Wenn Sie ein AVD im AVD Manager definieren, können Sie entweder eine automatisch verwaltete SD-Kartendatei oder eine Datei verwenden, die Sie mit dem
Mit der Emulator-Benutzeroberfläche oder dem
Wenn Sie Dateien vor dem Laden in die SD-Kartendatei kopieren möchten, stellen Sie die Bilddatei als Schleifengerät bereit und kopieren Sie dann die Dateien. Alternativ können Sie ein Dienstprogramm wie das Paket Der Emulator behandelt die Datei als einen Pool von Byte, sodass das Format der SD-Karte keine Rolle spielt.
Die Option |
-sdcard
|
Vom Emulator verwendete Verzeichnisse und Dateien auflisten
Sie haben zwei Möglichkeiten, herauszufinden, wo sich Dateien befinden:
- 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.
Startoptionen der Befehlszeile
In diesem Abschnitt werden Optionen aufgeführt, die Sie beim Starten des Emulators in der Befehlszeile angeben können.
Hinweis: Der Android-Emulator wird ständig weiterentwickelt, um ihn zuverlässiger zu machen. Den Status der Probleme, die mit verschiedenen Befehlszeilenoptionen gemeldet werden, und Informationen zum Melden von Fehlern finden Sie in der Android Issue Tracker.
Häufig verwendete Optionen
In der folgenden Tabelle sind Startoptionen für die Befehlszeile aufgeführt, die Sie möglicherweise häufiger verwenden:
Tabelle 3 Häufig verwendete Befehlszeilenoptionen
| Befehlszeilenoption | Beschreibung |
|---|---|
| Schneller Start | |
-no-snapshot-load
|
Führt einen Kaltstart durch und speichert den Emulatorstatus beim Beenden. |
-no-snapshot-save
|
Führt einen schnellen Start aus, falls möglich, speichert den Emulatorstatus beim Beenden jedoch nicht. |
-no-snapshot
|
Deaktiviert die Quick Boot-Funktion 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 vorne oder hinten 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 zur Emulation zur Verfügung stehen. 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 der erste Ab SDK Tools 25.2.4 ist der AVD-Name erforderlich. |
| Laufwerk-Images und Arbeitsspeicher | |
-memory size
|
Gibt die physische RAM-Größe von 1.536 bis 8.192 MB an. Beispiel: emulator @Pixel8_API_34 -memory 2048 Dieser Wert überschreibt die AVD-Einstellung. |
-sdcard filepath
|
Gibt den Dateinamen und den Pfad zu einer Image-Datei für die SD-Karten-Partition an. Beispiel:
emulator @Pixel8_API_34 -sdcard C:/sd/sdcard.img Wenn die Datei nicht gefunden wird, wird der Emulator zwar gestartet, jedoch ohne SD-Karte. Der Befehl gibt die Warnung Kein SD-Karten-Image zurück.
Wenn Sie diese Option nicht angeben, ist die Standardeinstellung |
-wipe-data
|
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 der Zustand wie bei der ersten Definition wird wiederhergestellt. Alle installierten Apps und Einstellungen werden entfernt. Beispiel:
emulator @Pixel8_API_34 -wipe-data
Standardmäßig ist die Nutzerdatendatei |
| Fehler beheben | |
-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 Spalte. Beispiel:
$ emulator @Pixel8_API_34 -debug init,metrics Um ein Tag zu deaktivieren, setzen Sie einen Bindestrich (-) davor. Mit der folgenden Option werden beispielsweise alle Debug-Meldungen angezeigt, mit Ausnahme der Nachrichten, die sich auf Netzwerk-Sockets und Messwerte beziehen:
Verwenden Sie die Option
emulator -help-debug-tags
Sie können die Standard-Debug-Tags in der Umgebungsvariable
ANDROID_VERBOSE=socket,gles Dies entspricht der Verwendung von:
oder
|
-debug-tag-debug-no-tag
|
Aktiviert einen bestimmten Debug-Meldungstyp. 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
|
Aktiviert die Anzeige von Logcat-Nachrichten für ein oder mehrere Tags und schreibt sie in das Terminalfenster. Der folgende Befehl aktiviert beispielsweise Fehlermeldungen von allen Komponenten:
emulator @Pixel8_API_34 -logcat *:e
Im folgenden Beispiel werden Nachrichten von GSM-Komponenten auf der Informationslogebene 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 Mit dieser Option können Sie beispielsweise prüfen, ob der Bootvorgang ordnungsgemäß funktioniert. |
-verbose
|
Gibt die Initialisierungsmeldungen des Emulators im Terminalfenster aus. Beispiel:
emulator @Pixel8_API_34 -verbose
Es wird angezeigt, welche Dateien und Einstellungen tatsächlich ausgewählt werden, wenn ein virtuelles Gerät gestartet wird, das in einem AVD definiert ist. Diese Option entspricht der Angabe von |
| Netzwerk | |
-dns-server servers
|
Verwendet die angegebenen DNS-Server. servers ist eine durch Kommas getrennte Liste von bis zu vier DNS-Servernamen oder IP-Adressen. Beispiel: emulator @Pixel8_API_34 -dns-server 192.0.2.0,
Standardmäßig versucht der Emulator, die von Ihnen verwendeten DNS-Server zu erkennen, und richtet spezielle Aliasse im emulierten Firewallnetzwerk ein, damit das Android-System eine direkte Verbindung zu den Servern herstellen kann. Mit der Option |
-http-proxy proxy
|
Stellt alle TCP-Verbindungen über einen angegebenen HTTP-/HTTPS-Proxy her. Wenn der 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 ist, sucht der Emulator nach der Umgebungsvariable |
-netdelay delay
|
Legt die Netzwerklatenzemulation auf einen der folgenden
Beispiel: emulator @Pixel8_API_34 -netdelay gsm
Der Emulator unterstützt Netzwerkdrosselung und höhere Verbindungslatenzen.
Sie können ihn 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 des Netzwerks mit einem der folgenden
Beispiel: emulator @Pixel8_API_34 -netspeed edge
Der Emulator unterstützt Netzwerkdrosselung und höhere Verbindungslatenzen.
Sie können ihn entweder über die Skin-Konfiguration oder mit den Optionen |
-port port
|
Legt die TCP-Portnummer fest, die für die Console und adb verwendet wird. Beispiel:
emulator @Pixel8_API_34 -port 5556
Der Standardwert für die erste VM-Instanz, die auf Ihrer Maschine ausgeführt wird, ist 5.554. Ein virtuelles Gerät belegt normalerweise ein Paar benachbarter Ports: einen Konsolenport und einen
Die Portzuweisungen entsprechen oft der Angabe von Die Option
Wenn der Wert für |
-ports
|
Legt die TCP-Ports fest, die für die Console und adb verwendet werden. Beispiel:
emulator @Pixel8_API_34 -ports 5556,5559
Der gültige Portbereich liegt zwischen 5.554 und 5.682, sodass 64 virtuelle Geräte gleichzeitig möglich sind. Die Option
Wir empfehlen, nach Möglichkeit die Option
Weitere Informationen zum Festlegen der Konsolen- und |
-tcpdump filepath
|
Erfasst Netzwerkpakete und speichert sie in einer Datei. Beispiel:
emulator @Pixel8_API_34 -tcpdump /path/dumpfile.cap Verwenden Sie diese Option, um mit der Erfassung aller Netzwerkpakete zu beginnen, die über das virtuelle Ethernet-LAN des Emulators gesendet werden. Anschließend können Sie den Traffic mit einem Tool wie Wireshark analysieren. Beachten Sie, dass diese Option alle Ethernet-Pakete erfasst und nicht auf TCP-Verbindungen beschränkt ist. |
| System | |
-accel mode
|
Konfiguriert die VM-Beschleunigung des Emulators. Beispiel:
emulator @Pixel8_API_34 -accel auto Die beschleunigte Emulation funktioniert nur für x86- und x86_64-System-Images. Unter Linux basiert es auf KVM. Unter Windows und Mac wird dafür eine Intel-CPU und ein Intel HAXM-Treiber verwendet. 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 Emulator-VM-Beschleunigung installiert ist (HAXM oder KVM). Beispiel:
emulator -accel-check Weitere Informationen finden Sie unter Prüfen, ob ein Hypervisor installiert ist. |
-engine engine
|
Gibt das Emulator-Modul an:
Beispiel:
emulator @Pixel8_API_34 -engine auto
Die automatische Erkennung sollte den Wert auswählen, der bei der Emulation eines bestimmten AVD die beste Leistung bietet. Verwenden Sie die Option |
-gpu mode
|
Wählt den GPU-Emulationsmodus aus. Beispiel:
emulator @Pixel8_API_34 -gpu swiftshader_indirect Weitere Informationen findest du unter Grafikbeschleunigung konfigurieren. |
-no-accel
|
Deaktiviert die Emulator-VM-Beschleunigung, wenn ein x86- oder x86_64-System-Image verwendet wird. Sie ist nur für die Fehlerbehebung 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 für Security-Enhanced Linux (SELinux) unter 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 |
-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 Entwicklungscomputers. Verwenden Sie diese Option, um eine andere Zeitzone anzugeben oder wenn die automatische Erkennung nicht richtig funktioniert. Der Wert
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 Startanimation beim Start des Emulators für einen schnelleren Start
Beispiel:
emulator @Pixel8_API_34 -no-boot-anim Auf langsamen Computern kann diese Option den Startvorgang erheblich beschleunigen. |
-screen mode
|
Legt den emulierten Touchscreen-Modus fest. Beispiel:
emulator @Pixel8_API_34 -screen no-touch
|
Erweiterte Optionen
Die Startoptionen der Befehlszeile in der folgenden Tabelle sind verfügbar, werden aber nicht von einem durchschnittlichen Anwendungsentwickler häufig verwendet.
In den Beschreibungen ist das Arbeitsverzeichnis das aktuelle Verzeichnis in dem Terminal, in das Sie Befehle eingeben. Informationen zum AVD-Systemverzeichnis und -datenverzeichnis sowie zu den darin gespeicherten Dateien finden Sie im Abschnitt zu Standardverzeichnissen und Dateien.
Einige dieser Optionen sind für externe App-Entwickler geeignet, 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 ohne vorab erstelltes AVD im Emulator aus.
Tabelle 4 Erweiterte Befehlszeilenoptionen
| Fortgeschrittene Option | Kurzbeschreibung |
|---|---|
-bootchart timeout
|
Aktiviert Bootcharting mit einem Zeitlimit in Sekunden. Einige Android-System-Images haben ein modifiziertes Init-System, das eine Bootcharting-Funktion integriert. Mit dieser Option können Sie ein Bootcharting-Zeitlimit an das System übergeben. Wenn Bootcharting in Ihrem Init-System nicht aktiviert ist, geschieht nichts. Diese Option ist in erster Linie für Plattformentwickler nützlich, nicht für externe App-Entwickler. Beispiel: emulator @Pixel8_API_34 -bootchart 120 |
-cache filepath
|
Gibt eine Cache-Partitions-Image-Datei an. Stellt einen Dateinamen und einen absoluten Pfad bzw. einen Pfad relativ zum Datenverzeichnis bereit, um eine persistente Cache-Datei einzurichten. Wenn die Datei nicht vorhanden ist, erstellt der Emulator sie als leere Datei. Beispiel: emulator @Pixel8_API_34 -cache ~/.android/avd/Pixel8_API_34.avd/cache_persistent.img Wenn Sie diese Option nicht verwenden, ist die Standardeinstellung eine temporäre Datei mit dem Namen |
-cache-size size
|
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 die Standardeinstellung 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 Standard-Cache sind. Weitere Informationen zur Cache-Datei finden Sie im AVD-Datenverzeichnis. |
-data filepath
|
Legt die Bilddatei der Nutzerdatenpartition fest. Gibt einen Dateinamen und einen absoluten Pfad bzw. 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, ist die Standardeinstellung eine Datei mit dem Namen |
-datadir dir
|
Gibt ein Datenverzeichnis mit einem absoluten Pfad an. Weitere Informationen finden Sie im 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 zum Testen oder Debuggen nützlich. Beispielsweise trat ein Problem auf, dass der Emulator unter 64-Bit-Windows manchmal nicht ausgeführt wurde, aber 32-Bit. Diese Option war für Vergleiche hilfreich, um das Problem zu beheben. Hier ein Beispiel: emulator @Pixel8_API_34 -force-32bit |
-help-disk-images
|
Hier erhalten Sie Hilfe zu Laufwerk-Images. Diese Option bietet Informationen, die sowohl für App- als auch für Plattformentwickler relevant sind. Beispiel: emulator -help-disk-images |
-help-char-devices
|
Hier erhalten Sie Hilfe zu den Spezifikationen für die emulator -help-char-devices |
-help-sdk-images
|
Hier erhalten Sie Hilfe zu Laufwerk-Images, die für App-Entwickler relevant sind. Diese Option ruft Informationen dazu ab, wo sich die Bilddateien für ein mit den SDK-Tools erstelltes AVD befinden. Beispiel: emulator -help-sdk-images |
-help-build-images
|
Erhält Hilfe zu Laufwerk-Images, die für Plattformentwickler relevant sind. Beispiel: emulator -help-build-images |
-initdata filepath-init-data
filepath
|
Gibt die anfängliche Version der Datenpartition an. Nach dem Löschen von 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 abgelegt. Weitere Informationen finden Sie im AVD-Systemverzeichnis. |
-kernel filepath
|
Verwendet einen bestimmten emulierten Kernel. Wenn Sie keinen Pfad angeben, sucht der Emulator im Systemverzeichnis. Verwenden Sie die Option‑show‑kernel, um Kernel-Debug-Meldungen anzusehen.
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 der Standardwert |
-noaudio
-no-audio
|
Deaktiviert die Audiounterstützung für dieses virtuelle Gerät. Einige Linux- und Windows-Computer haben fehlerhafte Audiotreiber, die unterschiedliche Symptome verursachen, z. B. das Starten des Emulators. 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 Cache-Partition. Wenn Sie diese Option nicht verwenden, ist die Standardeinstellung eine temporäre Datei mit dem Namen Beispiel: emulator @Pixel8_API_34 -nocache |
-no-snapshot
|
Unterbricht sowohl den automatischen Lade- als auch den Speichervorgang, wodurch der Emulator eine vollständige Startsequenz ausführt und seinen Status verliert, wenn er geschlossen wird. 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 Startvorgang aus. Beispiel: emulator @Pixel8_API_34 -no-snapshot-load |
-no-snapshot-save
|
Verhindert, dass der AVD-Status beim Beenden in der Snapshot-Speicherung gespeichert wird, sodass alle Änderungen verloren gehen. Beispiel: emulator @Pixel8_API_34 -no-snapshot-save |
-no-snapshot-update-time
|
Es wird nicht versucht, die AVD-Uhrzeit sofort nach der Snapshot-Wiederherstellung zu korrigieren. Diese Option kann beim Testen nützlich sein, da dadurch ein plötzlicher Zeitsprung vermieden wird. Die AVD wird weiterhin etwa alle 15 Sekunden aktualisiert. Beispiel: emulator @Pixel8_API_34 -no-snapshot-update-time |
-no-snapstorage
|
Startet den Emulator, ohne eine Datei zum Speichern oder Laden von Status-Snapshots bereitzustellen, wodurch ein vollständiger Start erzwungen und die Status-Snapshot-Funktion deaktiviert wird. 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 ausgeführt wird, die nicht angezeigt werden. 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 eine Android-Systemeigenschaft im Emulator fest.
emulator @Pixel8_API_34 -prop qemu.name=value -prop qemu.abc=xyz |
-qemu args
|
Übergibt Argumente an die QEMU-Emulatorsoftware. Achten Sie bei Verwendung dieser Option darauf, dass es die letzte angegebene Option ist, da alle nachfolgenden Optionen als QEMU-spezifische Optionen interpretiert werden. Diese Option ist sehr fortgeschritten und sollte nur von Entwicklern verwendet werden, die sehr mit QEMU und der Android-Emulation vertraut sind. |
-qemu -h
|
Zeigt die Hilfe zu 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 einem Remote-Drittanbieter, bevor die Emulation gestartet wird. Sie kann für automatisierte Testskripts nützlich sein.
Für
Für weitere Informationen verwenden Sie die Option |
-shell
|
Erstellt eine Root-Shell-Konsole auf dem aktuellen Terminal. Diese Option unterscheidet sich in den 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 Startsequenz auszuführen, kann der Emulator die Ausführung von einem früheren Snapshot des Status fortsetzen, was normalerweise deutlich schneller ist. Wenn Sie diese Option angeben, lädt der Emulator den Snapshot dieses Namens aus dem Snapshot-Image und speichert ihn beim Beenden unter demselben Namen. Wenn Sie diese Option nicht verwenden, wird standardmäßig eine vollständige Startsequenz verwendet. Wenn der angegebene Snapshot nicht vorhanden ist, führt der Emulator stattdessen eine vollständige Startsequenz und einen Speichervorgang aus. Weitere 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, der Nutzerdaten und der Images auf der SD-Karte mit dem Inhalt überschrieben werden, der zum Zeitpunkt des Snapshots vorhanden war. Wenn Sie diese Informationen nicht in einem anderen Snapshot speichern, gehen alle seit diesem Zeitpunkt vorgenommenen Änderungen verloren. Sie können einen Snapshot auch über die Emulatorkonsole mit dem Befehl |
-snapshot-list
|
Zeigt eine Liste der verfügbaren Snapshots an. Dieser Befehl gibt eine Tabelle mit Snapshots aus, die in der Snapshot-Speicherdatei gespeichert sind, mit der der Emulator gestartet wurde, und wird dann 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 Werte der Spalten „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 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, ist der Standardwert |
-sysdir dir
|
Gibt ein Systemverzeichnis mit einem absoluten Pfad an. Weitere Informationen finden Sie im 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 |
-use-system-libs
|
Verwenden Sie unter Linux das System Beispiel: me-linux$ emulator @Pixel8_API_34 -use-system-libs |
-writable-system
|
Verwenden Sie diese Option, um während der Emulationssitzung ein beschreibbares System-Image zu haben. Gehen Sie dazu so vor:
Mit diesem Flag wird eine temporäre Kopie des System-Images erstellt. Diese kann sehr groß sein (mehrere hundert MB), aber sie wird gelöscht, wenn der Emulator beendet wird. |
Eingestellte Optionen
Die folgenden Befehlszeilenoptionen wurden eingestellt:
-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
In diesem Abschnitt wird beschrieben, wie Sie Hilfe zu den Befehlszeilenoptionen erhalten. Sie enthält ausführlichere Informationen zu den Befehlszeilenoptionen des gängigen Emulators, die beim Starten des Emulators verfügbar sind.
Alle Emulator-Optionen auflisten
Geben Sie den folgenden Befehl ein, um eine Liste aller Emulatoroptionen einschließlich einer kurzen Beschreibung auszugeben:
emulator -help
Detaillierte Hilfe zu einer bestimmten Option erhalten
Geben Sie den folgenden Befehl ein, um Hilfe für eine bestimmte Startoption zu drucken:
emulator -help-option
Beispiel:
emulator -help-netspeed
Diese Hilfe ist ausführlicher als die Beschreibung der Option -help.
Detaillierte Hilfe für alle Optionen
Geben Sie den folgenden Befehl ein, um detaillierte 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 aufzurufen:
emulator -help-environment
Sie können Umgebungsvariablen im Terminalfenster festlegen, bevor Sie ein virtuelles Gerät starten, oder über Ihre Nutzereinstellungen im Betriebssystem. Du kannst sie beispielsweise unter Linux in der Datei .bashrc festlegen.
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 Optionen für -debug können Sie Debug-Meldungen von bestimmten Emulatorkomponenten aktivieren oder deaktivieren, wie von den Tags angegeben.