用途
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 确认。