关于 android-cli
android-cli 是使用 `android` 命令行工具的技能，面向 Android 开发与测试任务。内容涵盖项目创建、SDK 和模拟器管理、运行应用、检查及操作设备界面、文档搜索和 journey 测试。
主要功能
- 01从模板创建项目
- 02安装、更新和移除 SDK 软件包
- 03运行应用并管理模拟器
- 04检查和操作设备界面
- 05搜索 Android 开发文档
- 06评估 XML journey 测试
适用场景
- 01从 Android 模板创建项目
- 02安装 SDK 软件包或更新 CLI
- 03检查应用屏幕并操作设备
- 04根据 journey 测试评估应用
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/android-cli确认已加载。
详细介绍
此技能提供使用 android CLI 工具的说明。该工具包含用于创建项目、运行应用、与设备交互以及管理 CLI 环境的各种命令。
安装
如果 android 工具不在 PATH 中，请安装它。运行以下命令进行安装：
- Linux x86-64：curl -fsSL https://dl.google.com/android/cli/latest/linux_x86_64/install.sh | bash
- Linux ARM64：curl -fsSL https://dl.google.com/android/cli/latest/linux_arm64/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 会以 JSON 格式导出 UI。android screen capture -o <file path> 会保存 PNG 文件。
连接的设备只有一个时，两者都会自动选择该设备；设备多于一个时，请传入 --device=<serial>（使用 adb devices 列出序列号）。
UI 导出
android layout 会返回屏幕上 UI 元素的 JSON 树。
每个 JSON 对象代表 Android 应用中的一个 UI 元素。可能包含以下属性：
text- 元素包含的任何文本resource-id- 用于引用该元素的 Android 资源 IDcontent-desc- 供无障碍工具使用的 UI 元素描述interactions- 该元素支持的用户交互集合。可能包含以下一项或多项：CHECKABLE、CLICKABLE、FOCUSABLE、SCROLLABLE、LONG-CLICKABLE、PASSWORDstate- 该元素所处状态的集合。可能包含以下一项或多项：CHECKED、FOCUSED、SELECTEDbounds- 元素边界矩形的屏幕坐标，格式为[min X,min Y][max X, max Y]center- 元素中心的屏幕坐标，格式为[x,y]off-screen- 如果为 true，则该元素位于 UI 层级中，但在屏幕边界之外；可能需要滚动才能查看。hidden- 如果为 true，则该元素位于 UI 层级中，但在屏幕上不可见或不可交互。
使用 layout 作为检查 Android 应用的主要方式。
默认情况下，layout 仅返回包含内容或可交互的元素：
text或content-desc属性非空的元素interactions或state非空的元素 要返回所有元素，请使用--full标志。
如果 layout 仍然失败，请使用 android screen capture --annotate 检查应用。
截图
android screen capture -o <file path>（或 --output=<file path>）会将当前设备屏幕保存为 PNG 文件，路径为 <file path>。
将 screen capture 作为查看 Android 应用的辅助方式：
- 了解屏幕图像中的内容
- 查看
WebView（网页内容不一定会出现在 ui dump 中） - 根据 UI 元素的外观查找元素
重要：执行任何其他操作之前，务必目视检查任何 android screen 命令返回的 PNG 图像。
带标注的截图
android screen capture --annotate -o <file path>（或 -a -o <file path>）
android screen resolve --screenshot <path> --string <string>
--annotate 命令会为 UI 元素添加数字标签和边界框。使用此命令查找无法在 layout 输出中定位的 UI 元素。
要在输入命令中引用这些标签，请使用 screen resolve 将标签转换为坐标：
android screen resolve --screenshot <file path> --string "#3" 会返回 <x coord of region 3> <y coord of region 3>
要节省操作轮次，可以组合 shell 命令：
adb shell input $(android screen resolve --screenshot screen.png --string "tap #34")
此命令会点击 screen.png 中的 #34 区域
输入
使用 adb shell input 与 Android 设备交互。
查看元素的 "interactions" 属性，了解该元素可执行的交互操作。
使用 UI 元素的 center 坐标或 bounds 坐标与其交互：
json { "key": -248568265, "class": "android.widget.Button", "bounds": "[138,9][167,38]", "center": "[152,23]" }
要点击此按钮，请执行 adb shell input tap 152 23。这会点击按钮中心。
{
"key": 12487234,
"class": "com.example.ui.ScrollableList",
"bounds": "[100,200][400,600]",
"center": "[250,400]"
}
要向下滚动此列表，请执行 adb shell input swipe 250 400 250 200 500。此操作会在 500 毫秒内从中心滑动到顶部。
文本输入
要输入文本，请确保输入框已获得焦点，然后执行 adb shell input text "<text>"。
- 空格（
%s）： 将空格替换为%s（Android 会忽略原始空格之后的文本）：adb shell input text "Hello%sworld"（输入"Hello world"）。 - 特殊字符： 转义 shell 元字符（
&、$、(、)、!）：adb shell input text "AT\&T"或adb shell input text 'Price:\$10'。 - 提交 / 回车：
adb shell input keyevent 66
Android 交互规则
- 输入文本前，始终确保输入框的
"state"列表中包含"FOCUSED"。 - 如果元素的
"interactions"列表中包含"SCROLLABLE"，查找缺失的 UI 元素时请尝试滚动该元素。 - 执行滚动输入时，始终缓慢滚动。
adb shell input swipe的第 5 个参数用于控制滚动时长。 - 内容可能需要一些时间才能加载；如果执行操作后
layout缺少信息，请等待几秒，然后再次执行layout，查看是否有变化。
运行 Journey 测试
Journey 测试涉及设备交互；使用 android layout 和 android screen 命令评估 Journey。设备交互相关说明在此同样适用。
Journey 是一种以 XML 指定的 Android 应用行为测试，由一系列 <action> 元素组成。例如：
xml <journey name="My Journey"> <description> 用于说明格式的示例 Journey </description> <actions> <action> 点按“Home”图标 </action> <action> 确认应用位于其 Home 屏幕 </action> </actions> </journey>
按照顺序逐项执行 <actions> 列表来评估 Journey。逐个评估每个 <action> 块。
如果 <actions> 列表中的所有元素均成功，则 Journey 成功。
Journey 是应用的测试用例。Journey XML 是事实依据；如果应用与 Journey 不一致，则表示应用测试失败。 此外，如果应用退出、崩溃或冻结，Journey 评估将停止，且 Journey 判定为失败。
重要——必须严格按照每个步骤的原文执行，并且独立于其他步骤！如果某个操作要求“点按第一个搜索结果”， 你必须找到搜索结果并点按第一个结果。即使你认为自己知道该操作的意图，也必须照做。
执行操作
某些 <action> 元素会指定要在正在运行的 Android 应用中执行的 UI 交互。执行交互，并确认应用
没有崩溃或出现意外行为。这是你对 <action> 应执行的唯一验证。
如果无法按指定方式执行交互，则 Journey 失败。
示例：
<action>点击红色按钮</action>
如果你确定 UI 中没有红色按钮，则 Journey 失败。
如果 <action> 的文本指定了一系列操作，应将其拆分为多个子操作并逐个评估：
示例：
<action>搜索苏打水，并将第一个结果添加到购物车</action>
应按以下方式评估：
<action>搜索苏打水</action> <action>将第一个结果添加到购物车</action>
如果 <action> 中包含非 UI 交互规范的内容，应告知用户该 Journey 格式错误并提前退出，
同时说明具体错误。
验证预期
以“check”或“verify”开头的 <action> 元素指定了对 Android 应用当前状态的预期。确定应用的当前
状态，并检查是否符合预期。
通过查看设备当前屏幕来确定应用的当前状态，不要与设备交互。
示例：
<action>检查屏幕上是否显示“Switch 2”</action>
这只需查看当前屏幕，无需滚动或进行交互。如果当前未显示“Switch 2”，则该操作失败。
如果未达到预期，则将 <action> 标记为失败，并结束 Journey 评估。单个 <action> 可以包含
多个预期。
示例：
<action>确认应用位于 Home 屏幕、Home 图标为蓝色，且已显示温度</action>
如果以下任一条件不成立，此 <action> 就会失败：
- 应用位于 Home 屏幕
- 存在 Home 图标，且该图标为蓝色
- 已显示温度
处理失败
运行 Journey 时，应将其作为测试进行评估。测试失败是可以接受的，而且通常是预期结果。正确报告失败是首要任务。
尽量减少调试和故障排除；假设工具每次显示的输出都是正确的。目标是确定 当前 Android 应用能否正确处理 Journey 中概述的当前步骤。有关错误修复、澄清或 其他改进的建议，应仅放在最后的 Journey 评估摘要中。
总结
评估整个操作流程后，输出一个描述结果的 Markdown（.md）文件。
文件格式如下：
# 操作流程：<操作流程名称>
## 结果
### 操作：点击蓝色按钮 ✅
- **命令**：
- `adb shell input swipe 490 200 500 500 500`
- `adb shell input tap 45 920`
- **评论**：操作流程步骤未说明需要滚动才能看到该按钮
### 操作：检查屏幕上是否显示“Switch 2” ✅
- **截图**：[switch_2_screenshot.png](path/to/screenshot)
- **评论**：已通过布局和视觉两种方式确认
### 操作：显示主屏幕 ❌
- **评论**：显示的是设置页面
### 操作：向下滑动以查看活动通知
文档搜索
docs 命令可在 Android 知识库中搜索权威、高质量的 Android 开发者文档。提供几个关键词后，此工具会返回包含示例或指南的高质量文章，介绍如何使用 Android API 或库。使用此工具可获取有关如何完成 Android 特定任务的更多信息，也可了解 Android API、界面、库或设备。
始终使用此工具获取最新的 Android 概念信息。常见的适用场景包括：
- 查找 API 迁移指南。
- 查找 API 示例。
- 查找最新的 Android API 信息。
- 查找 Android 概念的最佳实践。
运行 APK
使用 run 命令运行 Android 应用。
管理模拟器
使用 android emulator 命令管理 Android 虚拟设备（AVD）
管理技能
使用 android skills 命令管理 Android 的 Agent 技能。
更新 CLI
使用 android update 命令更新 Android CLI。
android help 输出
用法：android [-Vhv] [--sdk=PARAM] [COMMAND]
-h, --help 显示指定命令的帮助信息
--sdk=PARAM Android SDK 的路径
-v, --verbose 启用详细输出以便排查问题
-V, --version 打印版本信息并退出
命令：
analyze 分析指定位置的文件（AAB、APK、JAR、AAR），
并返回所有可用详细信息
auth 身份验证命令。登录和退出 Android CLI 的 Google 服务
build 构建 Android 构件
completion 在当前用户配置文件中安装 Android CLI 的 Shell 自动补全配置
create 使用可用模板创建新的 Android 项目。可以指定项目名称、输出目录、
`minSdk` 值，以及是否试运行
describe 分析 Android 项目以生成描述性元数据。此命令会识别并输出 JSON
文件的路径，这些文件详细描述项目结构，包括构建目标及其对应的
输出构件位置（例如 APK）。这些信息可帮助其他工具和命令高效地
定位构建构件
device 管理 Android 设备。在桌面窗口中镜像已连接的设备或模拟器，并管理
远程实体设备的预留
docs 从官方 Android 知识库中搜索并获取开发者文档
emulator 管理 Android 虚拟设备（AVD）。包括启动、停止、列出模拟器及查看
模拟器详细信息的命令
help 显示指定命令的帮助信息
info 打印环境信息，包括 SDK 位置和配置变量
init 初始化 Android CLI 环境。设置所需的配置、目录和默认技能
input 通过对 UI 元素执行手势和按键事件来与 Android 应用交互
install 在已连接的设备或模拟器上安装 Android 应用（一个或多个 APK），
不激活任何组件，并使用增量优化，比 `adb` 部署更快
layout 返回应用的布局树
preview 将 Jetpack Compose @Preview 函数渲染为 PNG 图像，并可选择导出组件树
JSON 文件。无需设备或 IDE 即可运行
profiler 对 Android 应用、游戏和设备进行性能分析
run 在已连接的设备或模拟器上部署并启动 Android 应用
screen 捕获并检查已连接的 Android 设备或模拟器的屏幕
sdk 管理 Android SDK 安装。包括安装、更新、移除以及列出可用和已安装
SDK 软件包的命令
signals 从 Crashlytics 查询应用稳定性和现场遥测数据
skills 管理 Android CLI 技能。包括安装、移除、列出技能以及按关键词搜索
技能的命令
studio 将 Android CLI 连接到正在运行的 Android Studio 实例，以分析文件、
查找声明和用法、渲染 Compose 预览以及查询库版本
update 将 Android CLI 更新到最新版本
analyze
用法：android analyze [-h] [--analysis=PARAM] [--format=PARAM] <path>
分析指定位置的文件（AAB、APK、JAR、AAR），并返回所有可用详细信息
选项：
--analysis=PARAM 要筛选输出的分析类别（basic、
optimization）。支持以逗号分隔多个值
（默认：all）
-f, --format=PARAM 输出格式：json、textproto。如果省略，
输出将采用便于阅读的格式
-h, --help 显示指定命令的帮助信息
android 选项：
--sdk=PARAM Android SDK 的路径
-v, --verbose 启用详细输出以便排查问题
-V, --version 显示版本信息并退出
位置参数：
<path> 要分析的目标文件路径（AAB、APK、JAR、AAR）
auth
用法：android auth [-h] [COMMAND]
身份验证命令。登录和退出 Android CLI 的 Google 服务
选项：
-h, --help 显示指定命令的帮助信息
android 选项：
--sdk=PARAM Android SDK 的路径
-v, --verbose 启用详细输出以便排查问题
-V, --version 显示版本信息并退出
命令：
login 登录 Android CLI 的 Google 服务
logout 退出 Android CLI 的 Google 服务
status 显示当前已登录的账号
build
用法：android build [-h] [<reference>] [-- <build_args>]
构建 Android 构件
选项：
-h, --help 显示指定命令的帮助信息
android 选项：
--sdk=PARAM Android SDK 的路径
-v, --verbose 启用详细输出以便排查问题
-V, --version 显示版本信息并退出
位置参数：
<reference> 构建引用（[system://][path]?[target]）
-- <build_args> 原样传递给构建系统的参数。使用
-- 将其与其他参数分隔
completion
用法：android completion [-h] [<shell>]
在当前用户配置中为 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] [--force] [--list]
[--min-sdk=PARAM] [--name=PARAM] [--namespace=PARAM]
[--output=PARAM] [<template-name>]
根据可用模板创建新的 Android 项目。你可以指定项目名称、输出目录、
`minSdk` 值，并执行试运行
Options:
--application-id=PARAM 应用的应用 ID，例如
`com.example.myapp`
--force 允许在非空目录中创建项目，并覆盖
现有文件
-h, --help 显示指定命令的帮助信息
--list 列出所有可用模板
--min-sdk=PARAM 应用支持的 `minSdk` 值
（默认值在模板中定义）
--name=PARAM 应用名称，例如 `My
Application`
--namespace=PARAM Kotlin 源文件的资源命名空间和包名
-o, --output=PARAM 目标项目目录路径
（默认值为 `.`）
android options:
--sdk=PARAM Android SDK 的路径
-v, --verbose 启用详细输出以便排查问题
-V, --version 打印版本信息并退出
Positional Parameters:
<template-name> 模板名称
describe
Usage: android describe [-h] [--project_dir=PARAM]
分析 Android 项目以生成描述性元数据。此命令会识别并输出 JSON 文件的
路径，这些文件详细说明项目结构，包括构建目标及其对应的输出构件位置
（例如 APK）。这些信息有助于其他工具和命令高效地定位构建构件
Options:
-h, --help 显示指定命令的帮助信息
--project_dir=PARAM 要描述的项目目录
android options:
--sdk=PARAM Android SDK 的路径
-v, --verbose 启用详细输出以便排查问题
-V, --version 打印版本信息并退出
device
Usage: android device [-h] [COMMAND]
管理 Android 设备。在桌面窗口中镜像已连接的设备或模拟器，并管理远程
物理设备预留
Options:
-h, --help 显示指定命令的帮助信息
android options:
--sdk=PARAM Android SDK 的路径
-v, --verbose 启用详细输出以便排查问题
-V, --version 打印版本信息并退出
Commands:
hub 启动桌面窗口，实时镜像屏幕并交互式控制已连接的 Android 设备或
模拟器
remote 管理远程物理设备。包括列出、预留、连接和管理远程设备预留的命令
docs
Usage: android docs [-h] [COMMAND]
从官方 Android 知识库搜索并获取开发者文档
Options:
-h, --help 显示指定命令的帮助信息
android options:
--sdk=PARAM Android SDK 的路径
-v, --verbose 启用详细输出以便排查问题
-V, --version 打印版本信息并退出
Commands:
fetch 从以 `kb://` 开头的 URL 获取 Android 文档文章
search 搜索 Android 文档。请将关键词用引号括起来
emulator
Usage: android emulator [-h] [COMMAND]
管理 Android 虚拟设备（AVD）。包含启动、停止、列出和查看模拟器详情的命令
Options:
-h, --help 显示指定命令的帮助信息
android options:
--sdk=PARAM Android SDK 的路径
-v, --verbose 启用详细输出以便排查问题
-V, --version 打印版本信息并退出
Commands:
create 创建虚拟设备
list 列出可用的虚拟设备
remove 删除虚拟设备
start 启动指定的虚拟设备。模拟器完全启动并准备就绪后，此命令才会返回
stop 停止指定的虚拟设备
help
Usage: android help [-h] [COMMAND]
显示指定命令的帮助信息
Options:
-h, --help 显示指定命令的帮助信息
android options:
--sdk=PARAM Android SDK 的路径
-v, --verbose 启用详细输出以便排查问题
-V, --version 打印版本信息并退出
Positional Parameters:
COMMAND 要查看帮助信息的命令
info
Usage: android info [-h] [<field>]
打印环境信息，包括 SDK 位置和配置变量
Options:
-h, --help 显示指定命令的帮助信息
android options:
--sdk=PARAM Android SDK 的路径
-v, --verbose 启用详细输出以便排查问题
-V, --version 打印版本信息并退出
Positional Parameters:
<field> 要打印其值的特定字段（sdk、version、launcher_version）。如果省略，则打印所有字段
init
Usage: android init [-h]
初始化 Android CLI 环境。设置所需的配置、目录和默认技能
Options:
-h, --help 显示指定命令的帮助信息
android options:
--sdk=PARAM Android SDK 的路径
-v, --verbose 启用详细输出以便排查问题
-V, --version 打印版本信息并退出
input
Usage: android input [-h] [--device=PARAM] [COMMAND]
通过在 UI 元素上执行手势和按键事件与 Android 应用交互
Options:
--device=PARAM 设备序列号或模拟器 ID（由
'adb devices' 报告）
-h, --help 显示指定命令的帮助信息
android 选项：
--sdk=PARAM Android SDK 的路径
-v, --verbose 启用详细输出以便排查问题
-V, --version 打印版本信息并退出
命令：
key 按下硬件按钮、导航键或 Android 键码
scroll 滚动容器元素，可选地持续滚动直到目标
元素出现
swipe 沿指定方向滑动与选择器匹配的 UI 元素
tap 点击与选择器匹配的 UI 元素
text 在与选择器匹配的 UI 元素中输入文本
install
用法：android install [-h] [--apks=PARAM] [--device=PARAM] [--install-options=PARAM]
[--use-delta-install] [<apks_or_reference>] [--
<build_args>]
在已连接的设备或模拟器上安装 Android 应用（一个或多个 APK），不会激活任何组件；
使用增量优化，比 `adb` 部署更快
选项：
--apks=PARAM APK 的路径，多个路径以逗号分隔
--device=PARAM 设备序列号
-h, --help 显示指定命令的帮助信息
--install-options=PARAM 传递给 package manager install 的其他选项或标志
（例如 `-g`、`-d`）
--use-delta-install 使用快速增量安装（通过仅传输已修改的代码和
资源来加快增量更新；默认值：`true`）
android 选项：
--sdk=PARAM Android SDK 的路径
-v, --verbose 启用详细输出以便
排查问题
-V, --version 打印版本信息并退出
位置参数：
<apks_or_reference> APK 文件路径或构建引用
([system://][path]?[target])
-- <build_args> 原样传递给构建系统的参数。
使用 -- 与其他参数分隔
layout
用法：android layout [-dhp] [--device=PARAM] [--flat] [--full] [--no-idle]
[--output=PARAM]
返回应用的布局树
选项：
--device=PARAM 设备序列号
-d, --diff 已弃用；无操作标志。将在未来版本中移除
--flat 返回扁平列表，而不是树
--full 返回完整的树，包括不可交互和隐藏元素
-h, --help 显示指定命令的帮助信息
--no-idle 获取布局时不等待布局进入空闲状态
-o, --output=PARAM 将布局写入指定的文件或目录。若未指定，则输出到标准输出
-p, --pretty 美化输出返回的 JSON
android options:
--sdk=PARAM Android SDK 的路径
-v, --verbose 启用详细输出以便排查问题
-V, --version 输出版本信息并退出
preview
Usage: android preview [-h] [COMMAND]
将 Jetpack Compose @Preview 函数渲染为 PNG 图像，并可选择导出组件树 JSON 文件。无需设备或 IDE 即可运行
Options:
-h, --help 显示指定命令的帮助信息
android options:
--sdk=PARAM Android SDK 的路径
-v, --verbose 启用详细输出以便排查问题
-V, --version 输出版本信息并退出
Commands:
list 列出目标中可用的 Jetpack Compose @Preview 函数
render 构建目标，并将其 Jetpack Compose @Preview 函数渲染为 PNG 图像，也可选择导出组件树 JSON 文件
profiler
Usage: android profiler [-h] [COMMAND]
对 Android 应用、游戏和设备进行性能分析
Options:
-h, --help 显示指定命令的帮助信息
android options:
--sdk=PARAM Android SDK 的路径
-v, --verbose 启用详细输出以便排查问题
-V, --version 输出版本信息并退出
Commands:
heapdump 捕获 Android JVM 堆转储快照（需要 API
29+）
session 管理任意类型的性能分析会话：列出会话、查询其状态或终止会话
systemtrace 系统跟踪工具。捕获 CPU 调度、线程片段、帧生命周期、GPU 计数器和 Vulkan
计时，并写入 Perfetto 跟踪文件
run
Usage: android run [-h] [--activity=PARAM] [--apks=PARAM] [--debug] [--device=PARAM]
[--install-options=PARAM] [--type=PARAM] [--use-delta-install]
[<apks_or_reference>] [-- <build_args>]
在已连接的设备或模拟器上部署并启动 Android 应用
Options:
--activity=PARAM Activity 名称
--apks=PARAM APK 的路径，以逗号分隔
--debug 以调试模式运行
--device=PARAM 设备序列号
-h, --help 显示指定命令的帮助信息
--install-options=PARAM 要传递给包管理器安装命令的其他选项或标志（例如，
`-g`、`-d`）
--type=PARAM 组件类型（`ACTIVITY`、
`WATCH_FACE`、`TILE`、`COMPLICATION`、
`DECLARATIVE_WATCH_FACE`、
`WEAR_WIDGET`）
--use-delta-install 使用快速增量安装（通过仅传输修改过的代码和资源来加快
增量更新；默认值：`true`）
android options:
--sdk=PARAM Android SDK 的路径
-v, --verbose 启用详细输出以便排查问题
-V, --version 打印版本信息并退出
位置参数：
<apks_or_reference> APK 文件路径或构建引用
([system://][path]?[target])
-- <build_args> 原样传递给构建系统的参数。
使用 -- 与其他参数分隔
screen
用法：android screen [-h] [COMMAND]
捕获并检查已连接 Android 设备或模拟器的屏幕
选项：
-h, --help 显示指定命令的帮助信息
android 选项：
--sdk=PARAM Android SDK 的路径
-v, --verbose 启用详细输出以便排查问题
-V, --version 打印版本信息并退出
命令：
capture 将设备屏幕输出为 PNG
resolve 以可视方式定位 UI 元素。将带注释的屏幕截图中标注的边界框坐标替换到字符串中，
把所有 `#N` 替换为标记为 `N` 的边界框中心坐标
sdk
用法：android sdk [-h] [--ignore-outdated-xmls] [--platform=PARAM]
[COMMAND]
管理 Android SDK 安装。包含安装、
更新、移除和列出可用及已安装 SDK 软件包的命令
选项：
-h, --help 显示指定命令的帮助信息
--ignore-outdated-xmls 安装或更新软件包时，不更新其他软件包的 XML 文件
--platform=PARAM 目标平台 `<os>_<arch>`（例如
`linux_x86_64`、`mac_arm64` 或
`windows_x86`）；默认为当前主机
android 选项：
--sdk=PARAM Android SDK 的路径
-v, --verbose 启用详细输出以便排查问题
-V, --version 打印版本信息并退出
命令：
install 安装 SDK 软件包
list 列出已安装和可用的 SDK 软件包
remove 从 SDK 中移除软件包
update 将一个或所有软件包更新到最新版本
signals
用法：android signals [-h] [COMMAND]
从 Crashlytics 查询应用稳定性和现场遥测数据
选项：
-h, --help 显示指定命令的帮助信息
android 选项：
--sdk=PARAM Android SDK 的路径
-v, --verbose 启用详细输出以便排查问题
-V, --version 打印版本信息并退出
命令：
context 列出可访问的 Crashlytics 项目和应用
crashes 列出、描述并分析现场报告的崩溃、ANR 和非致命问题
heaps 列出、描述并下载低内存事件期间收集的堆转储
skills
用法：android skills [-h] [COMMAND]
管理 Android CLI 技能。包括安装、移除、列出和按关键词
搜索技能的命令
选项：
-h, --help 显示指定命令的帮助信息
android 选项：
--sdk=PARAM Android SDK 的路径
-v, --verbose 启用详细输出以进行故障排查
-V, --version 打印版本信息并退出
命令：
add 按技能 ID 将特定技能安装到你的环境中
find 在仓库中搜索与关键词匹配的可用技能
list 列出已安装和可用的技能
remove 按技能 ID 移除已安装的技能
update 更新已安装的技能
studio
用法：android studio [-h] [COMMAND]
将 Android CLI 连接到正在运行的 Android Studio 实例，以分析
文件、查找声明和用法、渲染 Compose 预览，以及查询库版本
选项：
-h, --help 显示指定命令的帮助信息
android 选项：
--sdk=PARAM Android SDK 的路径
-v, --verbose 启用详细输出以进行故障排查
-V, --version 打印版本信息并退出
命令：
analyze-file 在 Android Studio 中分析文件
check 检查正在运行的 Android Studio 实例的状态
find-declaration 查找符号的声明
find-usages 查找符号的用法
open-file 在 Android Studio 中打开文件
render-compose-preview 在 Android Studio 中渲染 Compose 预览
version-lookup 查询 Maven 工件、Android 版本和 SDK
工具的最新可用版本
update
用法：android update [-h] [--url=PARAM]
将 Android CLI 更新到最新版本
选项：
-h, --help 显示指定命令的帮助信息
--url=PARAM 下载更新的 URL
android 选项：
--sdk=PARAM Android SDK 的路径
-v, --verbose 启用详细输出以进行故障排查
-V, --version 打印版本信息并退出