本文首发于公众号"Android技术圈"
Android 团队刚发布了 Android CLI(预览版):你可以在终端里完成 Android 开发的关键闭环。
更重要的是,它不是"又一套命令行包装",而是为 Agent 工作流 做的:配套 Android skills 和 Android Knowledge Base,让模型少猜、少走弯路。
如果你在用 Claude Code、Codex、Gemini CLI 或各种内部 Agent,这套东西值得立刻试一遍。

是什么,解决了什么问题
Android CLI 是一个命令行入口,让你用任何工具更高效地构建 Android,并把"环境、模板、设备、部署、知识与技能"这些基础能力标准化。
以前很多自动化/Agent 流程会卡在两类问题上:
-
• 环境与 SDK 组件太碎:装错版本、装多了、路径混乱,Agent 还要花大量 token 去"摸索怎么装"
-
• 项目与设备链路太长:创建项目 → 配设备 → 装包运行 → 截图/定位控件 → 查官方文档,步骤多且容易跑偏
Android CLI 的思路是:把这些动作变成可编程、可组合 的命令,让 Agent "照着做"就行。
官方在内部实验里提到:在项目和环境搭建上,Android CLI 能让 LLM token 使用量下降 70%+,整体任务完成速度提升到 3 倍左右。
先记住这张命令地图
别被"CLI"吓到,它的常用面其实很小:建项目、装 SDK、管模拟器、跑包、拉文档、装技能。

如果你只想快速判断"它值不值得上",看两条就够:
-
•
android create:官方模板直接生成项目,避免 Agent 自己拼 Gradle、依赖和架构 -
•
android docs+android skills:让 Agent 能"按最新官方建议"做事,而不是凭训练记忆瞎写
5 分钟跑通:从零创建项目
你可以把下面这段当成最小闭环脚本:先保证 CLI 最新,再创建项目、安装需要的 SDK 组件,启动模拟器。

这里补几个命令细节(非常适合写进你的 Makefile 或 CI 脚本):
创建项目:先 dry-run 再落盘
- • 查看可用模板:
bash
android create list
- • 先模拟执行,看看会生成哪些文件(对 Agent 很友好):
bash
android create --dry-run --verbose empty-activity-agp-9
- • 真正创建项目:
bash
android create -o ./DemoApp empty-activity-agp-9
安装 SDK:只装"需要的那一点点"
Android CLI 提供 android sdk install,可以指定包名甚至版本/渠道(stable、beta、canary),减少"装一大坨 SDK"的不可控。
bash
android sdk install platforms/android-34 build-tools/34.0.0
想查看有哪些包可用/已装:
bash
android sdk list 'platforms/.*'
需要回退到旧版本也有 --force(适合在 CI 遇到回归时快速止血)。
为 Agent 做的"三件套"
Android CLI 的"杀手锏"不在于它能不能跑命令,而在于它把 Agent 最缺的三类能力补齐了:可执行的规范、可检索的最新知识、可操作的设备界面。

android init:把 android-cli 这本"说明书"装进 Agent
文档里明确说:为了帮助 Agent 理解并使用 Android CLI,可以执行:
bash
android init
它会安装 android-cli skill,让 Agent 知道"该用哪些命令完成哪些事情"。
你可以把它理解为:给 Agent 贴一张"操作手册",避免它临场发挥。
android skills:把常见 Android 工作流变成可触发的 SKILL.md
官方把 skills 定义成模块化的、Markdown 形式的指令集(SKILL.md),当你的提示词匹配 metadata 时可以自动触发。
而通过 CLI,你能直接查找/安装这些 skills:
bash
android skills list --long
android skills find 'performance'
android skills add --agent='gemini' edge-to-edge
如果你用的不是 Gemini,也没关系:skills 可以和你自己的技能库并存,目标是把"正确做法"变成可复用的任务规格。
android docs:让回答带上"最新官方依据",不是凭感觉
android docs 的工作方式是两步:
bash
android docs search 'How do I improve my app performance?'
android docs fetch kb://android/topic/performance/overview
这对团队特别关键:就算模型训练数据已经过期,它也能通过 Knowledge Base"校准"到最新推荐模式。
UI 自动化与可视化定位
很多人做端到端回归时会卡在"怎么让脚本点到对的控件"。Android CLI 给了两个很实用的命令:
-
•
android screen capture --annotate:截图并给 UI 元素打标签框 -
•
android screen resolve:把[#5](javascript:;)这种标签替换成真实坐标,方便脚本input tap x y
文档里的示例是这样:
bash
android screen resolve --screenshot=ui.png --string="input tap #5"
返回:
bash
input tap 500 1000
再配合 android layout --diff 导出布局树的变化,你就能把"黑盒点击"变成"有依据的定位"。
怎么把它放进工作流
如果你符合下面任意一个场景,Android CLI 的收益会很明显:
-
• 你有多端/多仓库/多团队协作,需要把 Android 开发流程脚本化、标准化
-
• 你在用任何 Agent 写 Android 代码,希望它少犯"过时写法/乱配 Gradle/装错 SDK"这类基础错误
-
• 你希望把"新项目骨架、设备启动、装包运行、基础 UI 回归、查文档"做成 CI 的固定步骤
一个很实用的落地方式是:
把 android update、android create、android sdk install、android emulator ...、android run 这条链路写进脚本,让任何人/任何 Agent 在新机器上都能"一键跑通"。
写在最后
Android CLI 的定位很清晰:它不是替代 Android Studio,而是让你在终端(尤其是 Agent/CI 环境)也能用官方方式把流程跑顺,然后再无缝切到 Android Studio 做精细化开发与调试。
你更想用它解决哪类问题:新项目模板、CI 环境搭建、模拟器与装包、还是 Agent 写代码的"规范化"?
留言告诉我,我可以把大家最关心的场景整理成一套可复制的脚本模板。