avdmanager

avdmanager ist ein Tool, mit dem Sie Android Virtual Devices (AVDs) über die Befehlszeile erstellen und verwalten können. Mit einem AVD können Sie die Merkmale eines Android-Smartphones, einer Wear OS-Smartwatch oder eines Android TV-Geräts definieren, das Sie im Android Emulator simulieren möchten.

Wenn Sie Android Studio verwenden, müssen Sie dieses Tool nicht verwenden, sondern können AVDs stattdessen über die IDE erstellen und verwalten.

Das Tool avdmanager ist im Paket „Android SDK Command-Line Tools“ enthalten unter android_sdk/cmdline-tools/version/bin/avdmanager.

Syntax

Verwenden Sie die folgende Syntax, um avdmanager zu verwenden:

avdmanager [global options] command [command options]

Globale Optionen

Tabelle 1. Liste der globalen Optionen für avdmanager.

Globale Option Beschreibung
-s | --silent Lautlos-Modus: Nur Fehler werden ausgegeben.
-h | --help Nutzungshilfe.
-v | --verbose Ausführlicher Modus: Fehler, Warnungen und Informationsmeldungen werden ausgegeben.
--clear cache Manifest-Cache des SDK Manager-Repositorys leeren.

Befehle und Befehlsoptionen

Tabelle 2. Liste der Befehle und Optionen für avdmanager.

Befehl und Optionen Beschreibung
create avd -n name -k "sdk_id" [-c {path|size}] [-f] [-p path]

Neues AVD erstellen. Sie müssen einen name für das AVD angeben und die ID des SDK-Pakets festlegen, das für das AVD verwendet werden soll. Verwenden Sie dazu sdk_id in Anführungszeichen. Mit dem folgenden Befehl wird beispielsweise ein AVD mit dem Namen test mit dem x86-System-Image für API-Level 25 erstellt:

avdmanager create avd -n test -k "system-images;android-25;google_apis;x86"
 Im Folgenden werden die Verwendungsmöglichkeiten für die anderen Optionen beschrieben:
  • -c {path|size}: Der Pfad zum SD Karten-Image für dieses AVD oder die Größe eines neuen SD-Karten-Images, das für dieses AVD in KB oder MB erstellt werden soll, angegeben mit K oder M. Beispiel: -c path/to/sdcard/ oder -c 1000M.
  • -f: Erstellung des AVD erzwingen. Verwenden Sie diese Option, wenn Sie ein vorhandenes AVD mit einem neuen AVD mit demselben Namen überschreiben müssen.
  • -p path: Pfad zum Speicherort, an dem das Verzeichnis für die Dateien dieses AVD erstellt wird. Wenn Sie keinen Pfad angeben, wird das AVD in ~/.android/avd/ erstellt.
delete avd -n name AVD löschen. Sie müssen das AVD mit name angeben.
move avd -n name [-p path] [-r new-name] AVD verschieben oder umbenennen. Sie müssen das AVD mit name angeben. Im Folgenden werden die Verwendungsmöglichkeiten für die anderen Optionen beschrieben:
  • -p path: Der absolute Pfad zum Speicherort, an dem das Verzeichnis erstellt werden soll, in das die Dateien dieses AVD verschoben werden. Wenn Sie dieses Argument nicht angeben, wird das AVD nicht verschoben. Sie können dieses Argument weglassen, wenn Sie das AVD an Ort und Stelle umbenennen möchten.
  • -r new-name: Der neue Name des AVD, das umbenannt wird.
list [target|device|avd] [-c] Alle verfügbaren Ziele, Gerätedefinitionen oder AVDs auflisten. Wenn Sie „target“, „device“ oder „avd“ nicht angeben, listet avdmanager alle drei auf. Fügen Sie das -c Argument hinzu, um eine kompakte Ausgabe zu erhalten, die für Skripts geeignet ist. Das -c Argument ist nicht verfügbar, wenn alle drei Optionen zusammen aufgelistet werden.