Das Android SDK enthält einen Android-Geräteemulator, also ein virtuelles Gerät. das auf Ihrem Computer ausgeführt wird. Mit dem Android-Emulator können Sie Android-Apps ohne physisches Gerät
Auf dieser Seite werden Befehlszeilenfunktionen beschrieben, die Sie mit dem Android-Emulator Informationen zur Verwendung der Benutzeroberfläche des Android-Emulators finden Sie unter Apps im Android-Emulator ausführen
Emulator starten
Verwenden Sie den Befehl emulator, um den Emulator zu starten.
Ihr Projekt auszuführen oder
über den AVD Manager starten.
Hier sehen Sie die grundlegende Befehlszeilensyntax zum Starten eines virtuellen Geräts von einem 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, wird die Standardeinstellung sieht die Befehlszeile 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 ANDROID_SDK_HOME festlegen
die den Stamm des Objekts
nutzerspezifisches Verzeichnis, in dem alle Konfigurations- und AVD-Inhalte gespeichert sind.
Sie können die Umgebungsvariable im Terminalfenster festlegen, bevor Sie eine
virtuelles Gerät oder über die Nutzereinstellungen im
System. Zum Beispiel in der Datei .bashrc unter Linux.
Schließen Sie das Emulatorfenster, um den Android-Emulator zu beenden.
App installieren
Neben der Installation einer App über Android Studio oder den Emulator
UI haben, können Sie Ihre App mit dem adb-Dienstprogramm auf einem virtuellen Gerät installieren.
So verwenden Sie adb, um Ihre App zu installieren, auszuführen und zu testen:
führen Sie die folgenden allgemeinen Schritte aus:
- Erstellen Sie Ihre App und verpacken Sie sie in einem APK, wie unter Build erstellen und ausführen App.
- Starten Sie den Emulator wie oben beschrieben über die Befehlszeile unter Verwendung der 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 den Emulator Konsole, um bei Bedarf Befehle auszuführen.
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) Löschen
starten Sie den Emulator mit der Option -wipe-data oder löschen Sie die
Daten im AVD-Manager. Weitere Informationen zu den Nutzerdaten
Partition und anderen Speicher finden Sie im folgenden Abschnitt.
Hinweis:Das Dienstprogramm adb betrachtet das virtuelle Gerät als
physisches Gerät. Aus diesem Grund müssen Sie möglicherweise die Methode
Das Flag -d mit einigen gängigen adb-Befehlen, z. B.
install Mit dem Flag -d können Sie angeben, welches von mehreren
verbundener Geräte, die als Ziel für einen Befehl verwendet werden sollen. Wenn Sie keine
-d hat der Emulator ein Targeting auf das erste Gerät in der Liste.
Standardverzeichnisse und -dateien
Der Emulator verwendet verknüpfte Dateien, von denen das AVD-System und die Datenverzeichnisse sind am wichtigsten. Es ist hilfreich, die Struktur des Emulator-Verzeichnisses wenn Sie Befehlszeilenoptionen angeben, obwohl Sie normalerweise keine die Standardverzeichnisse oder -dateien ändern.
Der Android-Emulator verwendet den Hypervisor (QEMU).
AVD-Systemverzeichnis
Das Systemverzeichnis enthält die vom Emulator verwendeten Android-System-Images um das Betriebssystem zu simulieren. Dieses Verzeichnis enthält plattformspezifische, schreibgeschützte Dateien für alle AVDs desselben Typs, 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. Beispielsweise gibtandroid-Vdie Android- Vorschau von VanillaIceCream. Nach der Veröffentlichung wurde es API-Level 35, das vonandroid-35variantist ein Name, der bestimmten Elementen entspricht. System-Image implementiert wird. Beispiel:google_apisoderandroid-wear.archist die Ziel-CPU-Architektur. Beispiel:x86
Mit der Option -sysdir können Sie ein anderes Systemverzeichnis für
der AVD.
Der Emulator liest die folgenden Dateien aus dem Systemverzeichnis:
Tabelle 1 Systemverzeichnisdateien, die von Android gelesen werden Emulator
| 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 wurden,
bevor das System-Image bereitgestellt wird. Es
enthält in der Regel nur einige Binärdateien und Initialisierungsskripte.
|
-ramdisk
|
system.img
|
Die schreibgeschützte, erste Version des System-Images. Konkret bedeutet das Partition mit den Systembibliotheken und Daten für das API-Level und Variante. | -system
|
userdata.img
|
Die ursprüngliche Version der Datenpartition, die als
data/ im emulierten System und enthält alle beschreibbaren Daten für den
AVD. Der Emulator verwendet diese Datei, wenn Sie eine neue AVD erstellen oder die Methode
Option ‑wipe-data. Weitere Informationen finden Sie in der
im folgenden Abschnitt eine Beschreibung für userdata-qemu.img-Datei an.
|
-initdata
-init-data
|
AVD-Datenverzeichnis
Das AVD-Datenverzeichnis, auch Inhaltsverzeichnis genannt, ist spezifisch für nur eine AVD-Instanz erstellen und alle änderbaren Daten für das AVD enthalten.
Der Standardspeicherort ist der folgende, wobei name der Wert für
AVD-Name:
- 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, wie
Jede VM-Instanz verwendet ein beschreibbares Nutzerdaten-Image, um den Nutzer und
sitzungsspezifische Daten. Beispielsweise wird das Image verwendet, um die
installierten App-Daten, Einstellungen, Datenbanken und Dateien. Jeder Nutzer hat ein
in ein anderes |
-data
|
cache.img
|
Das Cache-Partitions-Image, das als cache/ im
emuliert. Es ist leer, wenn Sie zum ersten Mal eine AVD erstellen oder das
Option -wipe-data. Es speichert temporäre Download-Dateien und
die vom Download-Manager und manchmal
vom System ausgefüllt wurden. Beispiel: Der Parameter
verwendet der Browser sie, 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
speichern Sie die Datei mit der Option -cache.
|
-cache
|
sdcard.img
|
(Optional) Ein Partitions-Image für die SD-Karte, mit dem ein SD-Karte simuliert werden kann
auf einem virtuellen Gerät. Du kannst eine Bilddatei von der SD-Karte im AVD erstellen:
Administrator oder über
Wenn Sie ein AVD im AVD Manager definieren, können Sie
eine automatisch verwaltete SD-Kartendatei oder eine selbst erstellte Datei
das
Sie können auf simulierten SD-Karten nach Dateien suchen, Dateien senden sowie Dateien von einer simulierten SD-Karte kopieren und entfernen
über die Benutzeroberfläche des Emulators oder den
Stellen Sie das Image bereit, um Dateien vor dem Laden auf die SD-Kartendatei zu kopieren.
Datei als Endgerät speichern und dann die Dateien kopieren. Sie können auch ein Dienstprogramm wie die
Der Emulator behandelt die Datei als einen Pool von Byte, sodass das SD-Kartenformat ist wichtig.
Die Option |
-sdcard
|
Vom Emulator verwendete Verzeichnisse und Dateien auflisten
Sie haben zwei Möglichkeiten, herauszufinden, wo sich Dateien befinden:
- Verwenden Sie die Methode
-verbose- oder-debug init-Option, wenn Sie den Emulator über die Befehlszeile. Sehen Sie sich die Ausgabe an. - Verwenden Sie den Befehl
emulator-help-option, um ein Standardverzeichnis. 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 in der Befehlszeile angeben können, wenn Sie den Emulator.
Hinweis: Der Android-Emulator wird ständig weiterentwickelt, um zuverlässiger machen. Status der Probleme, die bei verschiedenen Befehlszeilenoptionen gemeldet wurden 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 überschrieben.
in der AVD.
Beispiel: emulator @Pixel8_API_34 -camera-back webcam0 |
-webcam-list
|
Listet die Webcams auf Ihrem Entwicklungscomputer auf, die zur Emulation zur Verfügung stehen. Für
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. Für
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, wird der Standardwert |
-wipe-data
|
Löscht Nutzerdaten und kopiert Daten aus der ursprünglichen Datendatei. Diese Option
löscht die Daten für das virtuelle Gerät und setzt sie in den Zustand zurück, in dem sie
wann sie definiert wurde. Alle installierten Apps und Einstellungen werden entfernt. Beispiel:
emulator @Pixel8_API_34 -wipe-data
Standardmäßig ist die Datei mit den Nutzerdaten |
| 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. Beispiel: werden alle Debug-Meldungen angezeigt, mit Ausnahme derjenigen, die sich auf Netzwerk-Sockets beziehen. und Messwerte:
Verwende
emulator -help-debug-tags
Sie können die Standard-Debug-Tags in der
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-Meldungstyp 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 Schreibvorgänge
im Terminalfenster. Der folgende Befehl ermöglicht beispielsweise
Nachrichten von allen Komponenten:
emulator @Pixel8_API_34 -logcat *:e
Im folgenden Beispiel werden GSM-Komponentenmeldungen am Log-Ebene:
emulator @Pixel8_API_34 -logcat '*:s GSM:i'
Wenn Sie die Option Weitere Informationen
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. Für
Beispiel:
emulator @Pixel8_API_34 -verbose
Es wird angezeigt, welche Dateien und Einstellungen tatsächlich ausgewählt werden, wenn ein
virtuelles Gerät, das in einem AVD definiert ist. Diese Option entspricht der Angabe
|
| Netzwerk | |
-dns-server servers
|
Verwendet die angegebenen DNS-Server. servers ist ein
kommagetrennte Liste von bis zu vier DNS-Servernamen oder IP-Adressen Für
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 legt die
im emulierten Firewall-Netzwerk spezielle Aliasse einrichten, damit das Android-System
eine direkte Verbindung zu den Servern. Verwenden Sie die Option |
-http-proxy proxy
|
Stellt alle TCP-Verbindungen über einen angegebenen HTTP-/HTTPS-Proxy her. Wenn Ihr
muss der Emulator über einen Proxyserver auf das Internet zugreifen.
oder die Umgebungsvariable http_proxy, um die
angemessene Weiterleitung. Beispiel:
emulator @Pixel8_API_34 -http-proxy myserver:1981
Die
Das Präfix
Wird diese Option nicht angegeben, sucht der Emulator nach dem |
-netdelay delay
|
Legt die Netzwerklatenzemulation auf einen der folgenden Werte fest
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 dem
Optionen für |
-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 den maximalen Netzwerk-Upload und
die Downloadgeschwindigkeit 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 dem
Optionen für |
-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 ist 5.554 für die erste VM-Instanz, die auf der
Ihren Computer. Ein virtuelles Gerät belegt normalerweise ein Paar benachbarter Ports:
Console-Port und
Die Portzuweisungen entsprechen oft der Angabe von Die Option
Wenn der Wert |
-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 virtuelle
Geräte. 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 die virtuelles Ethernet-LAN des Emulators. Danach können Sie ein Tool wie Wireshark um den Traffic zu analysieren. Beachten Sie, dass diese Option alle Ethernet-Pakete erfasst und nicht auf TCP beschränkt ist. Verbindungen. |
| 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 auf KVM. Unter Windows und Mac sind dafür eine Intel-CPU und Intel HAXM 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 Konfigurieren Hardwarebeschleunigung für den Android-Emulator |
-accel-check
|
Prüft, ob ein erforderlicher Hypervisor für die Emulator-VM-Beschleunigung 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 wählt den Wert aus, der die beste Leistung bietet, wenn
eine bestimmte AVD emulieren. 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 bei Verwendung eines x86- oder x86_64-Systems
Bild. 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 Konfigurieren Hardwarebeschleunigung für den Android-Emulator |
-nojni
-no-jni
|
Deaktiviert erweiterte JNI-Prüfungen (Java Native Interface) in 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. Für Weitere Informationen finden Sie unter JNI Tipps |
-selinux {disabled|permissive}
|
Legt das sicherheitsverbesserte Linux fest (SELinux)
Sicherheitsmodul unter Linux in den Modus disabled oder permissive versetzt
System. Beispiel:
me-linux$ emulator @Pixel8_API_34 -selinux permissive
Standardmäßig befindet sich SELinux im |
-timezone timezone
|
Zeitzone für das virtuelle Gerät festlegen auf
emulator @Pixel8_API_34 -timezone Europe/Paris
Standardmäßig verwendet der Emulator die Zeitzone Ihres Entwicklungscomputers. Verwenden Sie
können Sie eine andere Zeitzone festlegen oder falls die automatische Erkennung
nicht ordnungsgemäß 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 häufig verwendet durchschnittliche App-Entwickler.
Laut der Beschreibung ist das Arbeitsverzeichnis das aktuelle Verzeichnis in dem Terminal, in dem Sie Befehle eingeben. Informationen zum AVD Systemverzeichnis und Datenverzeichnis sowie die gespeicherten Dateien Informationen dazu finden Sie im Abschnitt zu Standardverzeichnissen und Dateien.
Einige dieser Optionen sind für externe App-Entwickler geeignet, hauptsächlich von Plattformentwicklern verwendet werden. App-Entwickler erstellen Android-Apps und führen sie auf bestimmten AVDs aus. Plattformentwickler arbeiten an das 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. Bestimmtes Android-System Images haben ein modifiziertes Init-System, das eine Bootcharting-Einrichtung integriert. Sie können eine Zeitüberschreitung beim Bootcharting an das System. Wenn Ihr Init-System Bootcharting nicht aktiviert ist, bewirkt die Option nichts. Diese Option ist in erster Linie für Plattform- 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. Stellt einen Dateinamen und eine absolute Pfad oder Pfad relativ zum Datenverzeichnis, um einen nichtflüchtigen Cache einzurichten -Datei. 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, wird standardmäßig eine temporäre Datei namens
|
-cache-size size
|
Legt die Größe der Cachepartition in MB fest. Beispiel: emulator @Pixel8_API_34 -cache-size 1000 Wenn Sie keine diese Option angeben. Der Standardwert ist 66 MB. Die meisten App-Entwickler brauchen diese Option normalerweise nicht, es sei denn, sie müssen sehr große Dateien herunterladen, die größer als die Standardeinstellungen sind Cache gespeichert werden. Weitere Informationen zum Cache -Datei finden Sie unter AVD-Datenverzeichnis. |
-data filepath
|
Legt die Bilddatei der Nutzerdatenpartition fest. Stellt einen Dateinamen und ein
absoluten Pfad oder einen relativ zum Arbeitsverzeichnis
relativen Pfad zum Einrichten eines
persistente Datei mit Nutzerdaten. Falls die Datei nicht vorhanden ist, erstellt der Emulator
Bild 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 Siehe 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 die zum Testen oder Debugging nützlich sind. Beispielsweise gab es ein Problem, dass der Emulator funktionierte manchmal nicht unter 64-Bit-Windows, während 32-Bit verwendet wurde. Dieses um Vergleiche anzustellen und das Problem zu beheben. Hier ist ein Beispiel: emulator @Pixel8_API_34 -force-32bit |
-help-disk-images
|
Hier erhalten Sie Hilfe zu Laufwerk-Images. Diese Option liefert Informationen, die für App- und Plattform-Entwickler. 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. Mit dieser Option wird Informationen zum Speicherort der Bilddateien für ein mit dem SDK-Tools. Beispiel: emulator -help-sdk-images |
-help-build-images
|
Hier erhalten Sie 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
Nutzerdaten kopiert der Emulator den Inhalt der angegebenen Datei an den Nutzer
(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, im Systemverzeichnis nach. Verwenden Sie die Methode‑show‑kernel-Option zum Ansehen von Kernel-Debug-Nachrichten.
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 verfügen über fehlerhafte Audiotreiber, die unterschiedliche Symptome verursachen, wie z. B.
wodurch der Emulator nicht gestartet wird. In diesem Fall können Sie mit dieser Option
um das Problem zu lösen. Alternativ können Sie die Beispiel: emulator @Pixel8_API_34 -noaudio |
-nocache
-no-cache
|
Startet den Emulator ohne Cache-Partition. Wenn Sie diese
auswählen, ist die Standardeinstellung eine temporäre Datei mit dem Namen Beispiel: emulator @Pixel8_API_34 -nocache |
-no-snapshot
|
Unterbricht sowohl den automatischen Ladevorgang als auch den Speichervorgang, wodurch der Emulator
um eine vollständige Startsequenz auszuführen und beim Schließen ihren Status zu verlieren. 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 Startvorgang aus. Beispiel: emulator @Pixel8_API_34 -no-snapshot-load |
-no-snapshot-save
|
Verhindert, dass der Emulator den AVD-Status in der Snapshot-Speicherung speichert beenden, 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 des Status bereitzustellen
Snapshots, die einen vollständigen Start erzwingen und die Snapshot-Funktion des Status deaktivieren. Dieses
überschreibt die Option 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 Anzeige ausgeführt wird. Auf den Emulator können Sie ü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. Wenn Sie diese Option verwenden, angegeben, da alle nachfolgenden Optionen als QEMU-spezifisch interpretiert werden Optionen. Diese Option ist sehr fortgeschritten und sollte nur von Entwicklern verwendet werden, die sind mit QEMU und Android-Emulation sehr vertraut. |
-qemu -h
|
Zeigt die Hilfe zu emulator -qemu -h |
-ramdisk filepath
|
Gibt ein Ramdisk-Boot-Image an. Gibt den Dateinamen und einen absoluten Pfad an oder einen Pfad relativ zum Arbeitsverzeichnis. 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,
Standardmäßig befindet sich die Datei |
-report-console socket
|
Meldet den Konsolenport vor dem Start einem externen Drittanbieter
Emulation verwenden. Sie kann für automatisierte Testskripts nützlich sein.
Weitere Informationen erhalten Sie, wenn Sie die Option |
-shell
|
Erstellt eine Root-Shell-Konsole auf dem aktuellen Terminal. Diese Option unterscheidet sich von der
Beispiel: emulator @Pixel8_API_34 -shell |
-snapshot name
|
Gibt den Namen eines Snapshots in einer Snapshot-Speicherdatei für automatische um Vorgänge zu starten und zu speichern. Anstatt eine vollständige Startsequenz auszuführen, Emulator die Ausführung von einem früheren Snapshot aus fortsetzen können. in der Regel deutlich schneller. Wenn Sie diese Option angeben, lädt den Snapshot dieses Namens aus dem Snapshot-Image und speichert ihn wieder unter demselben Namen. Wenn Sie diese Option nicht verwenden, ist die Standardeinstellung eine vollständige Startsequenz ausführen. Wenn der angegebene Snapshot nicht vorhanden ist, wird der führt stattdessen eine vollständige Startsequenz aus gespeichert. Unter der Option emulator @Pixel8_API_34 -snapshot snapshot2 Beim Laden eines Snapshots Der gesamte Systeminhalt, die Benutzerdaten und die Bilder auf der SD-Karte werden überschrieben. mit den Inhalten, die zum Zeitpunkt der Momentaufnahme vorhanden waren. Es sei denn, Sie speichern Informationen in einem anderen Snapshot speichern, gehen alle Änderungen seitdem verloren. Sie können einen Snapshot auch über die Emulatorkonsole erstellen, indem Sie den
|
-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, in der der Emulator gestartet wurde.
und sie wird beendet. Wenn Sie Beispiel: emulator @Pixel8_API_34 -snapshot-list -snapstorage ~/.android/avd/Pixel8_API_34.avd/snapshots-test.img Sie können die Werte der Spalte „ID“ und „TAG“ in der Ausgabe verwenden.
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 erstellte Snapshots. 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 der Standardwert |
-sysdir dir
|
Gibt ein Systemverzeichnis mit einem absoluten Pfad an. Weitere Informationen Siehe 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 an oder einen Pfad relativ zum Arbeitsverzeichnis. 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,
Standardmäßig befindet sich die Datei |
-use-system-libs
|
Unter Linux wird die 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 die sehr groß sein (bis zu mehreren hundert MB), aber beim Emulator gelöscht wird. Exits. |
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. Es ausführlichere Informationen zu häufig verwendeten Befehlszeilenoptionen für den Emulator, die beim Starten des Emulators verfügbar sind.
Alle Emulator-Optionen auflisten
Um eine Liste aller Emulatoroptionen einschließlich einer kurzen Beschreibung zu drucken, geben Sie folgenden Befehl:
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 des
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 eine
virtuelles Gerät oder Sie legen dies in den Nutzereinstellungen im
System. 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 kannst du Debug-Meldungen für folgende Elemente aktivieren oder deaktivieren:
Emulatorkomponenten angeben, wie in den Tags angegeben.