Android CLI 专家

本技能提供关于如何使用 android CLI 工具的说明。该工具包含多种命令，用于创建项目、运行应用程序、与设备交互以及管理 CLI 环境。

SDK 管理

要管理 Android SDK 及相关工具的安装，请使用 sdk 命令。例如：

• android sdk install [@]...：安装指定的软件包。可一次指定多个软件包，以空格分隔。 默认为最新版本。例如：android sdk install platforms/android-30@2 platforms/android-34
• android sdk update []：将指定软件包或全部软件包更新至最新版本。
• android sdk remove ：从本地 SDK 中移除某个软件包。
• android sdk list --all：列出已安装及可用的 SDK 软件包。

项目创建

使用 create 命令基于模板创建项目。

例如：android create empty-activity --name="My App" --output=./my-app

与设备交互

有关与正在运行的设备交互的更多信息，请参见此处

运行 journey 测试

有关运行 journey 的更多信息，请参见此处

文档搜索

docs 命令可在 Android 知识库中搜索权威、高质量的 Android 开发者文档。 只需提供若干关键词，该工具即可返回包含示例或使用指南的优质文章，涵盖 Android API 或库的具体用法。 请使用此工具获取有关实现 Android 特定任务、Android API、API 表面（surfaces）、库或设备的更多详细信息。

请始终使用此工具获取有关 Android 概念的最新信息。典型适用场景包括：

• 查找 API 的迁移指南。
• 查找 API 的使用示例。
• 查找关于 Android API 的最新信息。
• 查找 Android 相关概念的最佳实践。

运行 APK

使用 run 命令运行 Android 应用程序。

管理模拟器

使用 android emulator 命令管理 Android 虚拟设备（AVD）。

截取屏幕截图

使用 android screenshot 命令捕获已连接 Android 设备当前屏幕的图像，并将其输出至文件。

管理技能

使用 android skills 命令管理 Android 平台的 antigravity agent 技能。

检查 UI 布局

使用 android layout 命令检查 Android 应用程序的 UI 布局。该命令以 JSON 格式返回应用程序的布局树。在调试 UI 错误时，这种方式通常比截取屏幕截图更高效。

更新 CLI

使用 android update 命令更新 Android CLI。

android help 输出

用法：android [-hV] [--sdk=PARAM] [COMMAND] -h, --help 显示此帮助信息并退出。 --sdk=PARAM Android SDK 的路径 -V, --version 打印版本信息并退出。 命令： create 创建新的 Android 项目 describe 分析 Android 项目以生成描述性元数据 docs Android 文档相关命令 emulator 模拟器相关命令 help 显示所有命令的帮助信息 info 打印环境信息（如 SDK 位置等） init 初始化 Android CLI 环境（例如技能） layout 返回应用程序的布局树 run 部署 Android 应用程序 screen 查看设备的命令 sdk 下载并列出 SDK 软件包 skills 管理技能 update 更新 Android CLI

create 用法：android create [-h] [--verbose] [--list] [--minSdk=api] --name=applicationName [-o=dest-path] [template-name] 创建新的 Android 项目 [template-name] 模板名称 -h, --help 显示此帮助信息并退出。 --minSdk=api 应用支持的最小 SDK 版本（默认由模板定义） --name=applicationName 应用名称（例如 “My Application”） -o, --output=dest-path 目标项目目录路径（默认为当前目录 “.”） --verbose 启用详细输出 --list 列出所有可用模板

describe 用法：android describe [-hV] [--project_dir=PARAM] 分析 Android 项目以生成描述性元数据。 该命令识别并输出 JSON 文件路径，这些文件详细描述了项目的结构，包括构建目标及其对应的输出产物位置（例如 APK）。该信息使其他工具和命令能够高效定位构建产物。 -h, --help 显示此帮助信息并退出。 --project_dir=PARAM 待分析的项目目录 -V, --version 打印版本信息并退出。

docs 用法：android docs [-h] [COMMAND] Android 文档相关命令 -h, --help 显示此帮助信息并退出。 命令： search 搜索 Android 文档 fetch 获取 Android 文档

emulator 用法：android emulator [-h] [COMMAND] 模拟器相关命令 -h, --help 显示此帮助信息并退出。 命令： create 创建虚拟设备 start 启动指定的虚拟设备。该命令将在模拟器完全启动并就绪后返回。 stop 停止指定的虚拟设备 list 列出所有可用的虚拟设备 remove 删除虚拟设备

help 用法：android help [COMMAND] 显示所有命令的帮助信息 [COMMAND] 要显示帮助信息的命令

info 用法：android info 打印环境信息（如 SDK 位置等） 要打印值的具体字段；若省略则打印全部字段

init 用法：android init 初始化 Android CLI 环境（例如技能）。

layout 用法：android layout [-dhp] [--device=PARAM] [-o=PARAM] 返回应用程序的布局树 -d, --diff 返回自上次调用 ui-dump 后发生变化的布局元素扁平列表 --device=PARAM 设备序列号 -h, --help 显示此帮助信息并退出。 -o, --output=PARAM 将布局树写入指定文件或目录；若省略，则输出至标准输出 -p, --pretty 美化格式化输出的 JSON

run 用法：android run [-h] [--debug] [--activity=PARAM] [--device=PARAM] [--type=PARAM] [--apks=PARAM[,PARAM...]]... 部署 Android 应用程序 --activity=PARAM Activity 名称 --apks=PARAM[,PARAM...] APK 文件路径 --debug 以调试模式运行 --device=PARAM 设备序列号 -h, --help 显示此帮助信息并退出。 --type=PARAM 组件类型（ACTIVITY、SERVICE 等）

screen 用法：android screen [-h] [COMMAND] 查看设备的命令 -h, --help 显示此帮助信息并退出。 命令： capture 将设备屏幕输出为 PNG 图像 resolve 以可视化方式定位 UI 元素

sdk 用法：android sdk [COMMAND] 下载并列出 SDK 软件包 命令： install 安装 SDK 软件包 update 将一个或全部软件包更新至最新版本 remove 从 SDK 中移除软件包 list 列出已安装及可用的 SDK 软件包

skills 用法：android skills [COMMAND] 管理技能 命令： add 安装技能 remove 移除技能 list 列出可用技能 find 按关键词查找技能

update 用法：android update [--url=PARAM] 更新 Android CLI --url=PARAM 用于下载更新的 URL