Android

這項工具已不受支援。 請使用 Android Studio 來建立 AVD建立專案,並使用 sdkmanager 來查看及安裝 SDK 套件。

android 是位於 Android SDK tools/ 目錄中的指令列工具。android 的用途包括:

  • 建立、刪除及查看 Android 虛擬裝置 (AVD) (現已可透過 Android Studio 或 avdmanager 指令列執行這些作業)。
  • 建立及更新 Android 專案 (現已可透過 Android Studio 執行這些作業)。
  • 更新 Android SDK,包含新平台、外掛程式和說明文件 (現已可透過 sdkmanager 指令列工具執行這些作業)。

如果您使用的是 Android Studio,IDE 已整合 android 工具的功能,因此您不需要直接使用這項工具。

注意:以下選項的說明文件並未涵蓋完整內容,並可能有過時資訊。如需最新的選項清單,請執行 android --help

語法

android 的語法如下:

android [global options] action [action options]

全域選項

-s
靜音模式:僅列印錯誤。
-h
使用說明。
-v
詳細模式:列印錯誤、警告和重要訊息。

AVD 動作和選項

下表包含 AVD 的動作和選項:

動作 選項 說明 註解
avd 啟動 AVD Manager。
sdk 啟動 Android SDK Manager。
create avd -n <name> AVD 的名稱。 必要
-t <targetID> 系統映像檔的目標 ID;該系統映像檔會與新的 AVD 一起使用。如要取得可用目標清單,請使用 android list targets 必要
-c <path>|<size>[K|M] 要用於此 AVD 的 SD 卡映像檔路徑,或針對此 AVD 建立的新 SD 卡映像檔的大小。例如 -c path/to/sdcard-c 1000M
-f 強制建立 AVD。
-p <path> 這個 AVD 檔案的目錄將建立的位置路徑。
-s <name>|<width>-<height> 這個 AVD 所用的外觀,依名稱或尺寸識別。android 工具會在 -t <targetID> 引數所引用目標的 skins/ 目錄中,依名稱或尺寸找出相符的外觀。例如:-s HVGA-L
delete avd -n <name> 要刪除的 AVD 名稱。 必要
move avd -n <name> 要移動的 AVD 名稱。 必要
-p <path> 這個 AVD 檔案的目錄將建立的位置路徑。
-r <new-name> AVD 重新命名後的新名稱。
update avd -n <name> 要移動的 AVD 名稱。 必要

專案動作和選項

下表包含專案的動作和選項:

動作 選項 說明 註解
create project -n <name> 專案名稱。 必要
-t <targetID> 系統映像檔的目標 ID;該系統映像檔會與新的 AVD 一起使用。如要取得可用目標清單,請使用 android list targets 必要
-k <path>|<size>[K|M] 套件命名空間。 必要
-a 預設 Activity 類別的名稱。 必要
-p <path> 專案目錄的位置。 必要
update project -n <name> 要更新的專案名稱。
-p <path> 專案的位置路徑。 必要
-l <library path> 所新增 Android 程式庫的位置路徑 (相對於主要專案)。
-s <subprojects> 更新子資料夾中的任何專案,例如測試專案。
-t <targetID> 專案所設定的目標 ID
create test-project -n <name> 專案名稱。
-p <path> 專案的位置路徑。 必要
-m <main> 專案名稱。 必要
update test-project -p <path> 所測試專案的位置路徑 (相對於新專案)。 必要
-m <main> 所測試專案的主要類別。 必要
create lib-project -k <packageName> 程式庫專案的套件名稱。 必要
-p <path> 專案的位置路徑。 必要
-t <targetID> 程式庫專案的目標 ID。 必要
-n <name> 專案名稱。 必要
update lib-project -p <path> 專案的位置路徑。 必要
-l <libraryPath> 所新增 Android 程式庫的位置路徑 (相對於主要專案)。
-t <name> 程式庫專案的目標 ID。
create uitest-project -n <name> UI 測試專案名稱。
-t <name> UI 測試專案的目標 ID。 必要
-p <path> UI 測試專案的位置路徑。 必要

更新動作

update adb
更新 adb,以支援 SDK 外掛程式中宣告的 USB 裝置。
update sdk
更新 SDK,可透過建議安裝新平台 (如果有的話)。