avdmanager

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

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

Das avdmanager-Tool ist im Paket mit den Befehlszeilentools des Android SDK unter android_sdk/cmdline-tools/version/bin/avdmanager enthalten.

Syntax

Nutzen 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 ausgedruckt.
-h | --help Hilfe zur Nutzung.
-v | --verbose Ausführlicher Modus: Fehler, Warnungen und Informationsmeldungen werden gedruckt.
--clear cache Leeren Sie den Manifest-Cache des SDK Manager-Repositorys.

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]

Erstellen Sie ein neues AVD. Du musst eine name für das AVD angeben und die ID des SDK-Pakets, das für das AVD verwendet werden soll, mithilfe von sdk_id in Anführungszeichen angeben. Mit dem folgenden Befehl wird beispielsweise ein AVD mit dem Namen test mithilfe des x86-System-Images für API-Level 25 erstellt:

avdmanager create avd -n test -k "system-images;android-25;google_apis;x86"
Im Folgenden werden die Verwendungen der 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 erstellt werden soll, in KB oder MB, angegeben durch K oder M. Beispiel: -c path/to/sdcard/ oder -c 1000M.
  • -f: Erzwingt die Erstellung des AVD. Verwenden Sie diese Option, wenn Sie eine vorhandene AVD durch eine neue AVD mit demselben Namen überschreiben müssen.
  • -p path: Pfad zum Speicherort, an dem das Verzeichnis für die AVD-Dateien erstellt wird. Wenn Sie keinen Pfad angeben, wird das AVD in ~/.android/avd/ erstellt.
delete avd -n name Löschen Sie ein AVD. 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 Verwendungen der anderen Optionen beschrieben:
  • -p path: Der absolute Pfad zum Speicherort, an dem das Verzeichnis erstellt werden soll, in das die AVD-Dateien verschoben werden sollen. Wenn Sie dieses Argument nicht angeben, wird das AVD nicht verschoben. Sie können sich dafür entscheiden, dieses Argument nicht einzuschließen, wenn Sie das vorhandene AVD umbenennen möchten.
  • -r new-name: Der neue Name des AVD, das umbenannt wird.
list [target|device|avd] [-c] Geben Sie alle verfügbaren Ziele, Gerätedefinitionen oder AVDs an. Wenn Sie target, device oder avd nicht angeben, werden mit avdmanager alle drei aufgelistet. Geben Sie das Argument -c an, um eine kompakte Ausgabe zu erhalten, die sich für Skripts eignet. Das Argument -c ist nicht verfügbar, wenn alle drei Optionen zusammen aufgelistet werden.