avdmanager

avdmanager 是一个命令行工具,可以用于从命令行创建和管理 Android 虚拟设备 (AVD)。借助 AVD,您可以定义要在 Android 模拟器中模拟的 Android 手机、Wear OS 手表或 Android TV 设备的特性。

如果您使用的是 Android Studio,则无需使用此工具,而是可以从 IDE 中创建和管理 AVD

avdmanager 工具包含在 Android SDK 命令行工具软件包中(位于 android_sdk/cmdline-tools/version/bin/avdmanager)。

语法

如需使用 avdmanager,请使用以下语法:

avdmanager [global options] command [command options]

全局选项

表 1. avdmanager 的全局选项列表。

全局选项 说明
-s | --silent 静默模式:仅输出错误。
-h | --help 使用帮助。
-v | --verbose 详细模式:输出错误、警告和参考性消息。
--clear cache 清除 SDK 管理器代码库清单缓存。

命令和命令选项

表 2. avdmanager 的命令和选项列表。

命令和选项 说明
create avd -n name -k "sdk_id" [-c {path|size}] [-f] [-p path]

创建新的 AVD。您必须为该 AVD 提供 name,并使用加引号的 sdk_id 指定要用于该 AVD 的 SDK 软件包的 ID。例如,以下命令会使用 x86 系统映像(API 级别 25)创建名为 test 的 AVD:

avdmanager create avd -n test -k "system-images;android-25;google_apis;x86"
下面介绍了其他选项的用法:
  • -c {path|size}:此 AVD 的 SD 卡映像的路径,或要为此 AVD 创建的新 SD 卡映像的大小(以 KB 或 MB 为单位,分别以 KM 表示)。例如,-c path/to/sdcard/-c 1000M
  • -f:强制创建 AVD。如果您需要使用同名的新 AVD 覆盖现有的 AVD,请使用此选项。
  • -p path:用于从中创建此 AVD 的文件的目录所在位置的路径。如果您未指定路径,则系统会在 ~/.android/avd/ 中创建 AVD。
delete avd -n name 删除 AVD。您必须使用 name 指定该 AVD。
move avd -n name [-p path] [-r new-name] 移动或重命名 AVD。您必须使用 name 指定该 AVD。下面介绍了其他选项的用法:
  • -p path:用于接收此 AVD 的文件的目录所在位置的绝对路径。如果您不添加此参数,则系统不会移动 AVD。如果您想在原位重命名 AVD,则可以选择不添加此参数。
  • -r new-name:要重命名的 AVD 的新名称。
list [target|device|avd] [-c] 列出所有可用的目标、设备定义或 AVD。如果您未指定 targetdeviceavd,则 avdmanager 会列出全部三项。添加 -c 参数可以接收适合脚本的简洁输出。将全部三个选项一起列出时,-c 参数不可用。