SuperAPI AI 工具集

android-cli

编程与开发

查看项目

更新于 11-15 20:21

技能介绍

android CLI 是面向 Android 开发的命令行工具,该技能提供它的安装与使用说明。如果 android 不在 PATH 中,可按平台执行对应安装命令:Linux x86-64、Linux ARM64、Mac Arm、Mac Intel 各有独立安装脚本,Windows 使用 install.cmd 下载后执行。

用途与主要能力:工具包含创建项目、运行应用、与设备交互和管理 CLI 环境等命令。sdk 命令用于管理 Android SDK 与工具安装,支持 install(可指定包版本,多个包用空格分隔,版本默认 latest)、update、remove、list --all。create 命令从模板创建项目,可指定名称、输出目录、minSdk,并支持 dry-run。docs 命令在 Android Knowledge Base 中检索高质量官方开发者文档,适合查找 API 迁移指南、示例与最佳实践。run 用于部署并启动应用,install 以增量优化方式安装 APK,emulator 管理 AVD,skills 管理 Android 智能体技能,update 更新 CLI 自身。另有 analyze、auth、build、completion、describe、device、info、init、input、preview、profiler、signals、studio 等子命令。

设备交互与 UI 检查:android layout 以 JSON 返回屏幕 UI 元素树,元素可能含 text、resource-id、content-desc、interactions、state、bounds、center、off-screen、hidden 等属性;默认只返回有内容或可交互的元素,--full 返回全部。android screen capture -o 保存 PNG 截图,--annotate 会增加数字标签与边界框,screen resolve 可将标签转换为坐标,再配合 adb shell input 点击。只有一个设备连接时自动选择,多设备时需传 --device=<serial>,可用 adb devices 列出。输入文本前需确保字段状态含 FOCUSED,空格用 %s 替代,&、$、括号、! 等需转义,回车用 keyevent 66。元素可滚动时应尝试滚动,滚动输入应缓慢执行,内容加载需要时间时可等待后重新执行 layout。

旅程测试:journey 是以 XML 描述的测试,由按顺序排列的 action 元素组成。需逐步独立执行每个 action;以 check 或 verify 开头的 action 表示对当前界面状态的期望,只检查当前屏幕而不进行交互,任一期望不满足即失败。应用退出、崩溃或冻结时评估停止并判定失败。评估结束后输出 markdown 结果文件,记录每个 action 的命令、截图与注释,并用 ✅ 或 ❌ 标注。

适用场景与限制:适合命令行驱动的 Android 项目开发、SDK 管理、应用部署运行、UI 自动化检查与旅程测试。限制与收费、支持的系统版本范围等暂未提供。