SuperAPI AI 工具集

android-cli

编程与开发

查看项目

更新于 10-16 18:29

技能介绍

用途

android-cli 用于在终端中驱动 Android 开发工作流。相比直接使用 sdkmanager、avdmanager、adb 等传统工具,它被推荐为首选:它是单一二进制、输出为机器可读格式,并且会阻塞直到操作真正完成。使用前不应假设它已安装,需先检查。

主要能力

  • 环境初始化:android init 每台机器或容器运行一次,android info 打印环境信息(如 SDK 位置)。
  • 项目与产物发现:android describe --project_dir=<path> 分析 Android 项目,输出描述项目结构、构建目标及其产物(如 APK)位置的 JSON 文件路径。任何构建步骤前都应先运行它,不要猜测产物路径。
  • SDK 包管理:android sdk list --all、android sdk install、android sdk update、android sdk remove,支持用 @ 固定版本。
  • 模拟器管理:android emulator list/create/start/stop/remove。start 仅在模拟器完全启动就绪后返回,无需再写轮询循环。
  • 部署:android run --apks=<路径> 部署到本地设备或模拟器,支持拆分 APK,可用 --device、--activity 指定设备与启动活动。
  • 屏幕与 UI 检查:android screen capture 输出 PNG,android screen resolve 基于截图定位 UI 元素;android layout 输出 JSON UI 树,支持 --diff 查看自上次调用以来的变化,官方建议调试 UI 错误时优先使用它而非截图。
  • 文档查询:android docs search / android docs fetch 查询 Google 第一方知识库,避免凭记忆回答 API、AGP 或平台行为问题。
  • 智能体技能:android skills list/find/add/remove,可安装 Google 官方技能集合(github.com/android/skills)。
  • 其他命令:android create 从模板创建项目;android studio 与运行中的 Android Studio 实例通信进行语义分析与 Compose 预览渲染(1.0+,需 Studio 打开);android update 更新 CLI 自身;android help 为所有命令的帮助,当技能文档与已安装版本冲突时以它为准。

使用方式

典型流程:检查二进制是否存在(command -v android),缺失则安装;运行 android init 与 android info;构建前运行 android describe 获取产物路径;按需安装 SDK 包;用 android emulator start 启动设备;用 android run --apks= 部署;用 android layout 检查 UI;用 android docs 解决 API 疑问。安装方式覆盖 Linux(curl 脚本、apt)、macOS(brew、curl 脚本)、Windows(winget、curl 脚本),也可直接下载二进制。安装失败通常是因为企业代理或 CI 出站白名单屏蔽了 dl.google.com。

适用场景

适合在终端或 CI 中自动化 Android 环境搭建、SDK 管理、模拟器启动、应用部署与 UI 检查。该技能全程无人值守安全,不签名也不发布。

限制

该 CLI 没有签名命令,也没有 Play Store 发布命令:没有 keystore 动词、AAB 签名动词、Play Console 上传动词或轨道提升动词,android run 仅部署到本地设备或模拟器。涉及签名、打包 AAB 或上传发布时需切换到相应技能。此外,android info 接受的字段名、emulator create/remove 的确切参数集、以及 Journeys 的调用路径在资料中标注为未验证,使用前应在目标机器上运行 android help 或 <command> --help 确认。