Android CLI 完整指南：更快速地构建、调试和自动化 Android 应用

Android 开发长期以来一直围绕 Android Studio 展开：

• 打开 IDE
• 点击 Build
• 启动模拟器
• 在浏览器里查文档
• 通过 SDK Manager 安装 SDK

但 Google 正在改变这一现状。

全新的 Android CLI 将许多这类能力直接带到了终端里。它不只是又一个命令行工具，而是正在成为开发者和 AI 编程助手理解、构建、调试和自动化 Android 项目的一个接口。

如果你正在使用 Gemini CLI、Claude Code、Cursor、Codex 或其他基于终端的 AI 编码助手，这个工具会特别有意思——它为 AI 提供了结构化访问 Android 开发工作流的能力。

在本文中，我们将介绍 Android CLI 是什么、最实用的命令，以及它为何有望成为每位 Android 开发者工具箱中不可或缺的一部分。

为什么 Android CLI 很重要

现代软件开发正越来越以终端为先。

开发者越来越多地在使用：

• Git
• Docker
• AI 编码助手
• CI/CD 流水线
• 远程开发
• SSH 会话

Android 开发过去一直相对落后，因为许多任务都离不开 Android Studio。

Android CLI 正在弥合这一差距。

无需在多个工具之间来回切换，你现在可以直接在终端里完成许多 Android 专属任务。

安装与初始化

安装 Android CLI 后，初始化你的环境：

android init

这会准备好 CLI，并安装供 AI 代理使用的 Android CLI skill。

创建新的 Android 项目

创建项目变得非常简单：

android create

你甚至可以预览将要执行的操作，而不真正创建文件：

android create --dry-run

想查看可用模板？

android create list

这比反复创建、删除项目来试模板要方便得多。

搜索 Android 文档

我最喜欢的功能之一是内置的文档搜索。

不用再打开浏览器、上 Google 搜索：

android docs search "Jetpack Compose Navigation"

找到文档后：

android docs fetch kb://...

这让开发者——以及 AI 代理——能够直接从终端获取官方 Android 文档。

管理 Android 模拟器

再也不用每次都打开 Device Manager 了。

列出可用模拟器：

android emulator list

创建一个：

android emulator create

启动它：

android emulator start medium_phone

停止它：

android emulator stop emulator-5554

非常适合自动化脚本和 CI 环境。

快速部署 APK

已经有 APK 了？

直接部署：

android run --apks=app-debug.apk

你还可以：

• 选择指定设备
• 启动特定 Activity
• 启动后台服务
• 部署多个 APK 分包

测试构建时，这能省下不少时间。

管理 SDK 包

无需在 SDK Manager 里点点点了。

列出包：

android sdk list

安装：

android sdk install

更新：

android sdk update

移除：

android sdk remove

所有操作都可以脚本化。

这对自动化构建环境尤其有用。

截屏

需要为文档准备截图？

android screen capture

更棒的是：

android screen capture --annotate

CLI 还能给 UI 元素做标注，便于程序化引用。

查看 UI 层级

想查看当前屏幕的层级？

android layout

格式化输出：

android layout --pretty

导出为 JSON：

android layout --output hierarchy.json

这对以下场景非常有用：

• UI 调试
• 无障碍测试
• 自动化
• AI 辅助的 UI 理解

Android Skills

最令人兴奋的功能或许是 Android Skills。

Skills 为 AI 代理提供 Android 特定的知识和工作流。

列出可用 skills：

android skills list

搜索：

android skills find performance

安装：

android skills add

更新全部：

android skills add --all

相比依赖通用的 AI 知识，Android Skills 能帮助代理遵循 Android 最佳实践。

与 Android Studio 集成

Android CLI 真正强大之处在于它能与正在运行的 Android Studio 实例直接通信。

检查连接：

android studio check

分析文件：

android studio analyze-file

查找声明：

android studio find-declaration

查找用法：

android studio find-usages

打开文件：

android studio open-file

渲染 Compose 预览：

android studio render-compose-preview

检查依赖版本：

android studio version-lookup

你不必再手动在 IDE 里导航，这些能力都可以程序化地调用。

为什么这件事对 AI 意义重大

最重要的不是这些命令本身。

而是它们所开启的可能性。

想象一下，你可以这样对 AI 助手说：

“找出这个 composable 被用到的所有地方。”

或者：

“渲染我的 Compose 预览。”

或者：

“在官方 Android 文档里搜索 Navigation Compose。”

或者：

“检查我的依赖是否过时。”

AI 助手不必再凭空猜测，而是可以通过 Android CLI 直接从你的项目和工具中获取结构化信息。

这意味着：

• 更少的幻觉
• 更丰富的上下文
• 更可靠的 Android 专属答案
• 更快的开发工作流

我最常用的命令

如果你刚开始使用，建议从下面这些命令入手：

• 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 的发展方向

Android CLI 看起来像是构建 Android 应用新方式的基础。

随着 AI 成为每位开发者工作流的一部分，工具需要暴露结构化能力，而不仅仅是文本。

Android CLI 正是这样做的。

它让开发者和 AI 代理能够通过定义明确的命令与 Android 项目交互，而不是仅仅依赖 IDE 操作。

我们正朝着一个 Android Studio、AI 助手和终端无缝协作的未来迈进。

总结

Android CLI 远不止是一个方便的小工具。

它是迈向 AI 原生 Android 开发的重要一步。

无论你是：

• 专业开发应用
• 尝试 AI 编码助手
• 自动化工作流
• 还是提升开发效率

它都值得你去探索。

终端正在成为 Android 开发的一等公民界面，而 Android CLI 正在引领这一转变。

参考资料

• Android CLI 命令参考与使用指南

原文链接：https://proandroiddev.com/the-complete-guide-to-android-cli-a-faster-way-to-build-debug-and-automate-android-apps-d23b8311b41a