用途
Android CLI 技能提供使用 android 命令行工具的说明,覆盖 Android 开发中的项目创建、配置、分析、部署、设备交互、SDK 管理、模拟器管理、UI 布局检查与文档检索等任务。资料说明,当你需要从命令行创建、配置或分析 Android 项目,与正在运行的 Android 设备交互、部署或截图,管理 Android SDK 组件、版本或虚拟设备,检查 UI 布局或运行 XML 指定的旅程测试时,可使用该技能。
主要能力
- 环境与诊断:android info 打印环境信息(如 SDK 位置);android init 初始化 Android CLI 所需环境(如 skills)。
- 项目创建与分析:android create 通过模板创建新项目,支持 --name、--output、--minSdk、--list 等参数;android describe 分析项目并输出描述性元数据(项目结构、构建目标及 APK 等产物路径的 JSON 文件路径)。
- SDK 管理:android sdk install 安装指定包及版本(可一次安装多个,版本默认最新);android sdk update 更新指定包或全部包;android sdk remove 移除包;android sdk list --all 列出已安装和可用的 SDK 包。
- 设备与运行:android run 部署 Android 应用,支持 --apks、--activity、--type、--device、--debug;android screen capture 将设备屏幕输出为 PNG;android screen resolve 以视觉方式定位目标 UI 元素。
- 模拟器管理:android emulator 提供 create、start、stop、list、remove 子命令,用于创建、启动、停止、列出和删除虚拟设备;start 会在模拟器完全启动并就绪后返回。
- UI 检查:android layout 返回应用布局树(JSON),支持 --device、--output、--pretty、--diff(仅返回自上次 ui-dump 以来变化的扁平元素列表)。资料指出,调试 UI 错误时这通常比截图更快。
- 文档检索:android docs search 与 android docs fetch 用于检索与获取 Android 开发者文档;资料称其搜索 Android Knowledge Base 中的权威高质量文档,适合查找 API 迁移指南、API 示例、最新 API 信息与最佳实践。
- 技能管理:android skills 提供 add、remove、list、find,用于管理 Android 的 antigravity agent skills。
- CLI 更新:android update 更新 Android CLI,支持 --url 指定下载地址。
使用方式
资料提供命令示例:android sdk install platforms/android-30@2 platforms/android-34;android create empty-activity --name="My App" --output=./my-app;android screen capture -o <file path>。帮助输出列出顶层命令:create、describe、docs、emulator、help、info、init、layout、run、screen、sdk、skills、update。
安装方面:若 android 不在 PATH 中,资料建议将平台安装器下载到私有临时目录,先检查内容,仅在用户确认来源和内容后运行;给出 Linux 示例(curl 下载 install.sh,sed 查看前 160 行,再 bash 执行),macOS 与 Windows 使用对应的 darwin_arm64/install.sh 或 windows_x86_64/install.cmd。资料明确提醒不要将可变网络安装脚本直接管道给 shell。
适用场景
从命令行创建 Android 项目;安装、更新或移除 SDK 包;创建和管理模拟器;部署 APK 并查看运行状态;截取设备屏幕;检查 UI 布局树以定位布局问题;检索 Android API 与最佳实践文档;管理 Android 相关技能;更新 CLI 自身。
限制
android CLI 必须已安装并位于 PATH 中,否则需先安装或按平台安装指引处理。设备、模拟器、SDK 与文档命令依赖本地 Android SDK 状态、网络访问和已连接硬件。生成的命令需视为环境敏感:运行前检查路径、包名、设备序列号以及安装/更新目标。资料未提供收费、价格、平台覆盖范围或性能效果相关说明。