过去，Android 开发几乎绕不开 Android Studio。现在，Google 推出了 Android CLI，把项目创建、文档搜索、模拟器管理、APK 部署、SDK 管理、UI 检查和 Android Studio 联动等能力，逐步带进了终端。这篇文章整理了日常高频命令，也顺便聊聊它对 AI 编程 Agent 的意义。
- 为什么需要 Android CLI
一直以来，Android 开发基本都围绕 Android Studio 展开：打开 IDE，点击 Build，启动模拟器；遇到问题去浏览器搜索文档，需要新的 SDK 时再打开 SDK Manager 安装。
但最近这两年，开发方式正在变化。随着 AI 快速发展，相比 GUI 工具，AI 更容易借助 CLI 完成复杂任务。于是，Google 推出了 Android CLI，把很多原本依赖 Android Studio 的能力带进了终端。
它不只是又一个命令行工具，而是逐渐成为开发者和 AI 编程 Agent 理解、构建、调试和自动化 Android 项目的统一入口。如果你正在使用 Gemini CLI、Claude Code、Cursor、Codex 或其他运行在终端中的 AI 编程工具，Android CLI 就值得关注。它能让 AI 以结构化方式接入 Android 开发流程，而不是只能读取代码、执行几条零散的 Shell 命令。
你可能会问：现在有 AI 了，还需要知道这些吗？
我的回答是：虽然 AI 执行 CLI 通常比我们更熟练、更少出错，但了解 CLI 工具如何操作，对理解项目的构建流程、依赖关系和调试方式仍然很重要。工具链的运作方式本身就是项目知识的一部分。你越清楚自己的项目是怎么跑起来的，就越能和 AI 更好地协作，而不是把所有事情都交给 AI，然后指望它不出错。很多时候，我们甚至需要反过来指导 AI 如何使用工具。
- 安装与初始化
安装本身并不复杂，参考下面的链接，使用 curl 命令即可：
curl -fsSL https://developer.android.com/tools/agents/android-cli/download | bash安装 Android CLI 后，先初始化当前环境：
android init这个命令会完成 Android CLI 的基本准备工作，同时安装供 AI Agent 使用的 Android CLI Skill。这样一来，支持 Skill 的 AI 编程工具就能知道 Android CLI 提供了哪些能力，以及应该如何调用这些命令。
图1 · Android CLI 初始化与 Skill 安装
- 创建项目、搜索文档与管理模拟器
创建 Android 项目
使用 Android CLI 创建项目很简单：
android create如果暂时不想真正创建文件，只是想看看这条命令会执行哪些操作，可以加上 --dry-run；需要查看当前支持的项目模板时，则执行 android create --list。
搜索 Android 官方文档
Android CLI 内置的文档搜索，是我比较喜欢的一项功能。以前遇到问题时，通常要打开浏览器、通过 Google 搜索资料；现在可以直接在终端中搜索：
android docs search "Compose Styles"
图2 · 终端内搜索 Android 官方文档
第一次运行时，工具会先下载知识库，之后就能找到相关文档。找到需要的文档后，再使用返回的 kb:// 地址获取内容：
android docs fetch kb://...开发者可以通过这种方式直接在终端中获取 Android 官方文档，AI Agent 也可以调用相同的命令。这意味着，AI 不必完全依赖模型中已有的 Android 知识，而是可以在执行任务时主动查询官方资料。当然，对开发者来说，在控制台里看文档就没有那么友好了：
图3 · 控制台查看 Android 官方文档
管理 Android 模拟器
需要启动模拟器时，不必每次都打开 Android Studio 的 Device Manager。常用命令包括：
# 查看可用模拟器 android emulator list # 创建模拟器 android emulator create # 启动指定模拟器 android emulator start medium_phone # 停止正在运行的模拟器 android emulator stop emulator-5554这些命令非常适合写入自动化脚本，也很适合没有图形界面的 CI 环境。
- 快速部署 APK 与管理 SDK
快速部署 APK
如果已经有了编译完成的 APK，可以直接通过 Android CLI 将它部署到设备：
android run --apks=app-debug.apk除此之外，还可以通过 device 指定目标设备，通过 activity 启动指定 Activity，通过 type=SERVICE 启动后台 Service，还可以一次部署多个拆分 APK。
管理 Android SDK
以前安装或更新 Android SDK，通常需要进入 Android Studio 的 SDK Manager。现在这些操作同样可以通过命令行完成：
# 查看 SDK 软件包 android sdk list # 安装软件包 android sdk install platforms/android-34 build-tools/34.0.0 # 更新软件包 android sdk update # 移除软件包 android sdk remove这样一来，整个 SDK 管理过程都可以写进脚本。对于自动化构建环境来说，这一点尤其有用：CI 不需要依赖开发者提前在图形界面中配置 SDK，而是可以在脚本里明确声明需要安装哪些组件。
- 截屏与检查当前界面结构
截屏
如果需要为文档或测试报告截取设备画面，可以执行：
android screen capture还可以让 Android CLI 自动标注画面中的 UI 元素：
android screen capture --annotate标注后的界面元素更容易被程序引用，也能帮助 AI Agent 理解屏幕上有哪些控件，以及它们大致位于什么位置。
检查当前界面结构
如果想查看当前页面的 UI 层级，可以使用：
# 查看当前界面层级 android layout # 格式化输出 android layout --pretty # 导出为 JSON 文件 android layout --output hierarchy.json这个功能可以用于 UI 问题排查、无障碍功能测试、自动化操作，也可以帮助 AI 理解当前界面。相比只提供一张截图，结构化的界面层级能向程序和 AI 提供更多信息。
- Android Skills：给 AI Agent 装上官方知识
Android CLI 中最值得关注的功能之一，是 Android Skills。Skill 可以为 AI Agent 提供与 Android 相关的知识和工作流程。
# 查看当前可用 Skill android skills list # 搜索 Skill android skills find performance # 安装 Skill android skills add # 安装或更新全部 Skill android skills add --all
图4 · 终端内查看 Android Skills
如果只依赖通用模型知识，AI 可能会使用过时的 API，也可能给出不符合 Android 当前最佳实践的实现。Android Skills 则可以向 Agent 提供更具体的 Android 开发指导，帮助它按照官方推荐的方式完成任务。
事实上，对现在的 Coding Agent 来说，使用最新技术确实可能是个小难点。我自己也在用 Codex 这样的 Agent 编码。之前在没有用 Skill 的情况下，Styles API 的适配并不理想。除非开发者自己先指出问题，Agent 才会去看 Styles API 的源码并修正；默认情况下的适配工作并不好。
- 与 Android Studio 连接
Android CLI 真正强大的地方，是它可以与正在运行的 Android Studio 直接通信。
# 检查连接状态 android studio check # 分析文件中的错误和警告 android studio analyze-file # 查找符号声明 android studio find-declaration # 在 Android Studio 中打开文件 android studio open-file # 渲染 Compose Preview android studio render-compose-preview # 查询依赖库版本 android studio version-lookup以前，这些操作通常需要开发者在 IDE 中手动完成。现在，它们可以通过命令调用，也就意味着脚本和 AI Agent 同样能够使用 Android Studio 的部分能力。
- 迈出第一步
如果刚开始使用 Android CLI，可以先尝试下面这些命令：
android docs search android emulator start android layout android run android studio check android studio find-usages android studio render-compose-preview android skills add先把这些命令跑一遍，你会更快理解 Android CLI 能做什么，也能逐渐找到适合自己项目的那套自动化组合。