Android CLI 專家
本技能提供使用 android CLI 工具的說明。此工具包含建立專案、執行應用程式、與裝置互動以及管理 CLI 環境的各種命令。
安裝
如果 android 工具不在路徑中，請安裝它。執行以下命令進行安裝：
Linux：curl -fsSL https://dl.google.com/android/cli/latest/linux_x86_64/install.sh | bash
Mac Arm：curl -fsSL https://dl.google.com/android/cli/latest/darwin_arm64/install.sh | bash
Mac Intel：curl -fsSL https://dl.google.com/android/cli/latest/darwin_x86_64/install.sh | bash
Windows：curl -fsSL https://dl.google.com/android/cli/latest/windows_x86_64/install.cmd -o "%TEMP%\i.cmd" && "%TEMP%\i.cmd"
SDK 管理
使用 sdk 命令管理 Android SDK 及工具的安裝。例如：
android sdk install <package>[@<version>]...：安裝特定套件。可指定多個套件，以空格分隔。<version>預設為最新版。例如：android sdk install platforms/android-30@2 platforms/android-34android sdk update [<pkg-name>]：將特定套件或所有套件更新至最新版本。android sdk remove <pkg-name>：從本機 SDK 中移除套件。android sdk list --all：列出已安裝與可用的 SDK 套件。
專案建立
使用 create 命令從範本建立專案。
例如：android create empty-activity --name="My App" --output=./my-app
與 Android 裝置互動
使用 android layout 命令以 JSON 格式檢查 Android 應用程式的 UI 版面。
使用 android screen 命令以視覺方式檢查 UI 並取得視覺區域的邊界座標。
重要： 使用 android layout 或 android screen 之前，您必須閱讀此參考文件：interact.md
參考文件 interact.md 包含正確與 Android 裝置互動的說明。請嚴格遵循其指示。
執行旅程測試
旅程測試涉及裝置互動；請使用 android layout 和 android screen 命令來評估旅程。
裝置互動的說明也同樣適用於此。
重要： 在評估旅程之前，您必須閱讀此參考文件：journeys.md 參考文件 journeys.md 包含正確評估 Android 旅程的說明。請嚴格遵循其指示。
文件搜尋
docs 命令可搜尋 Android 知識庫中權威且高品質的開發者文件。
提供幾個關鍵字後，此工具將回傳包含 Android API 或函式庫使用範例或指南的高品質文章。
使用此工具取得如何完成特定 Android 任務的額外資訊，或進一步了解 Android API、介面、函式庫或裝置。
請務必使用此工具獲取最新的 Android 概念資訊。典型的使用情境包括：
- 尋找 API 的遷移指南。
- 尋找 API 的範例。
- 尋找 Android API 的最新資訊。
- 尋找 Android 概念的最佳實踐。
執行 APK
使用 run 命令來執行 Android 應用程式。
管理模擬器
使用 android emulator 命令管理 Android 虛擬裝置 (AVD)。
擷取螢幕截圖
使用 android screen 命令擷取已連接 Android 裝置的目前螢幕畫面並輸出至檔案。
管理技能
使用 android skills 命令管理 Android 代理技能。
更新 CLI
使用 android update 命令更新 Android CLI。
android help 輸出
用法：android [-Vhv] [--sdk=PARAM] [COMMAND] -h, --help 顯示此命令的說明訊息 --sdk=PARAM Android SDK 的路徑 -v, --verbose 啟用詳細輸出以便除錯 -V, --version 列印版本資訊並結束 命令： completion 在目前使用者設定檔中為 Android CLI 安裝 Shell 自動補全設定 create 從可用的範本建立新的 Android 專案。允許指定專案名稱、輸出目錄、minSdk 及乾執行 describe 分析 Android 專案以產生描述性後設資料。此命令識別並輸出 JSON 檔案的路徑，這些檔案詳細描述專案結構，包括建置目標及其對應的輸出成品位置 (例如 APK)。此資訊使其他工具和命令能夠有效率地定位建置成品 docs Android 文件命令，用於搜尋和擷取官方知識庫的開發者文件 emulator 管理 Android 虛擬裝置 (AVD)。包含啟動、停止、列出及檢視模擬器詳細資訊的命令 help 顯示所有命令的說明 info 列印環境資訊，包括 SDK 位置、已連接裝置和設定變數。使用特定欄位來縮小輸出範圍 init 初始化 Android CLI 的環境。設定所需的設定、目錄和預設技能 install 將一個或多個 APK 安裝到已連接的裝置或模擬器，不啟動任何元件，並使用增量最佳化以實現比 adb 更快的部署 layout 傳回應用程式的版面樹 run 建置、部署並在已連接的裝置或模擬器上啟動 Android 應用程式 screen 檢視裝置的命令 sdk 管理 Android SDK 安裝。包含安裝、更新、移除和列出可用與已安裝 SDK 套件的命令 skills 管理 Android CLI 技能。包含安裝、移除、列表及依關鍵字搜尋技能的命令 studio Android Studio 命令 update 將 Android CLI 更新至最新版本
completion 用法：android completion [-h] [] 在目前使用者設定檔中為 Android CLI 安裝 Shell 自動補全設定
選項：
-h, --help 顯示此命令的說明訊息
android 選項：
--sdk=PARAM Android SDK 的路徑
-v, --verbose 啟用詳細輸出以便除錯
-V, --version 列印版本資訊並結束
位置參數：
<shell> 如果提供，則僅列印指定 Shell 的補全而不安裝。支援：bash、zsh
create 用法：android create [-h] [--application-id=PARAM] [--list] [--min-sdk=PARAM] [--name=PARAM] [--namespace=PARAM] [--output=PARAM] [] 從可用的範本建立新的 Android 專案。允許指定專案名稱、輸出目錄、minSdk 及乾執行
選項：
--application-id=PARAM 應用程式的應用程式 ID (例如 'com.example.myapp')
-h, --help 顯示此命令的說明訊息
--list 列出所有可用的範本
--min-sdk=PARAM 應用程式支援的 'minSdk' (預設由範本定義)
--name=PARAM 應用程式的名稱 (例如 'My Application')
--namespace=PARAM 資源的名稱空間和 Kotlin 原始碼檔案的套件名稱
-o, --output=PARAM 目標專案目錄路徑 (預設為 '.')
android 選項：
--sdk=PARAM Android SDK 的路徑
-v, --verbose 啟用詳細輸出以便除錯
-V, --version 列印版本資訊並結束
位置參數：
<template-name> 範本名稱
describe 用法：android describe [-h] [--project_dir=PARAM] 分析 Android 專案以產生描述性後設資料。此命令識別並輸出 JSON 檔案的路徑，這些檔案詳細描述專案結構，包括建置目標及其對應的輸出成品位置 (例如 APK)。此資訊使其他工具和命令能夠有效率地定位建置成品
選項：
-h, --help 顯示此命令的說明訊息
--project_dir=PARAM 要描述的專案目錄
android 選項：
--sdk=PARAM Android SDK 的路徑
-v, --verbose 啟用詳細輸出以便除錯
-V, --version 列印版本資訊並結束
docs 用法：android docs [-h] [COMMAND] Android 文件命令，用於搜尋和擷取官方知識庫的開發者文件
選項：
-h, --help 顯示此命令的說明訊息
android 選項：
--sdk=PARAM Android SDK 的路徑
-v, --verbose 啟用詳細輸出以便除錯
-V, --version 列印版本資訊並結束
命令：
fetch 從 URL (kb://...) 擷取 Android 文件文章
search 搜尋 Android 文件。將關鍵字以引號括起
emulator 用法：android emulator [-h] [COMMAND] 管理 Android 虛擬裝置 (AVD)。包含啟動、停止、列出及檢視模擬器詳細資訊的命令
選項：
-h, --help 顯示此命令的說明訊息
android 選項：
--sdk=PARAM Android SDK 的路徑
-v, --verbose 啟用詳細輸出以便除錯
-V, --version 列印版本資訊並結束
命令：
create 建立虛擬裝置
list 列出可用的虛擬裝置
remove 刪除虛擬裝置
start 啟動指定的虛擬裝置。此命令將在模擬器完全啟動並可啟用時回傳
stop 停止指定的虛擬裝置
help 用法：android help [-h] [COMMAND] 顯示所有命令的說明
選項：
-h, --help 顯示此命令的說明訊息
android 選項：
--sdk=PARAM Android SDK 的路徑
-v, --verbose 啟用詳細輸出以便除錯
-V, --version 列印版本資訊並結束
位置參數：
COMMAND 要顯示說明的命令
info 用法：android info [-h] [] 列印環境資訊，包括 SDK 位置、已連接裝置和設定變數。使用特定欄位來縮小輸出範圍
選項：
-h, --help 顯示此命令的說明訊息
android 選項：
--sdk=PARAM Android SDK 的路徑
-v, --verbose 啟用詳細輸出以便除錯
-V, --version 列印版本資訊並結束
位置參數：
<field> 要列印值的特定欄位。如果省略則列印所有
init 用法：android init [-h] 初始化 Android CLI 的環境。設定所需的設定、目錄和預設技能
選項：
-h, --help 顯示此命令的說明訊息
android 選項：
--sdk=PARAM Android SDK 的路徑
-v, --verbose 啟用詳細輸出以便除錯
-V, --version 列印版本資訊並結束
install 用法：android install [-h] [--apks=PARAM] [--device=PARAM] [--install-options=PARAM] [--use-delta-install] 將一個或多個 APK 安裝到已連接的裝置或模擬器，不啟動任何元件，並使用增量最佳化以實現比 adb 更快的部署
選項：
--apks=PARAM APK 路徑，以逗號分隔
--device=PARAM 裝置序號
-h, --help 顯示此命令的說明訊息
--install-options=PARAM 傳遞給套件管理器安裝的額外選項/旗標 (例如 -g、-d)
--use-delta-install 使用快速增量安裝 (僅傳輸修改過的程式碼和資源以加速增量更新；預設：true)
android 選項：
--sdk=PARAM Android SDK 的路徑
-v, --verbose 啟用詳細輸出以便除錯
-V, --version 列印版本資訊並結束