avdmanager

avdmanager 是一項指令列工具,可讓您透過指令列建立及管理 Android 虛擬裝置 (AVD)。AVD 則可讓您定義要在 Android Emulator 中模擬的 Android 手機、Wear OS 智慧手錶或 Android TV 裝置的特性。

如果您使用的是 Android Studio,則不需要這項工具,可以改為透過 IDE 建立及管理 AVD

avdmanager 工具包含在 android_sdk/cmdline-tools/version/bin/avdmanager 的 Android SDK 指令列工具套件中。

語法

如要使用 avdmanager,請使用下列語法:

avdmanager [global options] command [command options]

全域選項

表 1. avdmanager 的全域選項清單。

全域選項 說明
-s | --silent 靜音模式:系統僅會輸出錯誤。
-h | --help 使用說明。
-v | --verbose 詳細模式:系統會輸出錯誤、警告和資訊訊息。
--clear cache 清除 SDK Manager 存放區資訊清單快取。

指令和指令選項

表 2. avdmanager 的指令和選項清單。

指令和選項 說明
create avd -n name -k "sdk_id" [-c {path|size}] [-f] [-p path]

建立新的 AVD。您必須提供name指定要用於 AVD 的 SDK 套件 ID,方法是使用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。如未指定 targetdeviceavdavdmanager 會將這三個選項全部列出。納入 -c 引數即可接收適用於指令碼的精簡輸出內容,但同時列出上述三個選項時,無法使用 -c 引數。