Android CLI 1.0 正式稳定：命令行构建 Android 应用，AI Agent 直接接入

预计阅读时间：8 分钟

谷歌在今年的 Google I/O 上宣布 Android CLI 达到 1.0 稳定版本——这意味着你不再需要打开 Android Studio 的 GUI，就能完成从项目创建到构建签名的全流程。更值得关注的是，谷歌同时在 Android Studio 中开放了 AI Agent 集成接口，Claude Code、OpenAI Codex、谷歌自家的 Antigravity 和 Gemini 都能直接参与 Android 开发流程。命令行工具链 + AI Agent 的组合，正在把 Android 开发推向一个更自动化、更可编程的工作方式。

Android CLI 1.0 能做什么

Android CLI 把 Android Studio 里大部分 GUI 操作搬到了命令行。核心能力包括：

项目初始化与模板生成：一行命令创建新项目，指定 Kotlin/Java、Min SDK、构建变体等参数。
构建与签名：直接在终端执行 Gradle 构建、生成 APK/AAB，无需打开 IDE。
设备管理：列出连接设备、安装应用、抓取日志，全部在 shell 中完成。
依赖与模块操作：添加/移除模块、管理依赖，用命令替代手动编辑 build.gradle。

1.0 版本的标志是：这些命令的参数、输出格式、错误码都已固定，不再有破坏性变更。你可以放心写进 CI 脚本或 Makefile 里。

AI Agent 集成：Android Studio 变成 Agent 的"手脚"

谷歌宣布 Android Studio 将提供一系列工具，支持外部 AI Agent 接入。目前明确提到的 Agent 包括：

Agent	来源	接入方式
Claude Code	Anthropic	Android Studio 插件 + CLI 协作
Codex	OpenAI	Android Studio 插件
Antigravity	Google	内置，vibe-coding 工具
Gemini	Google	内置，代码补全与生成

这里的思路是：AI Agent 负责"思考"——理解需求、生成代码、规划修改范围；Android Studio 和 CLI 负责"执行"——实际写入文件、触发构建、在设备上运行验证。Agent 不再只是聊天窗口里的代码片段生成器，而是能直接操作项目文件和构建系统的参与者。

谷歌自家的 Antigravity 是一个 vibe-coding 工具，专门面向 Android。你用自然语言描述想要的应用，Antigravity 生成项目结构、布局文件、业务逻辑，然后通过 CLI 构建部署到设备上验证。

实操：用 Android CLI 从零构建一个项目

下面是一个完整可运行的流程，展示 Android CLI 1.0 的核心用法。前提是你已安装 Android SDK 并配置了环境变量。

安装与确认 CLI 版本

# 确认 Android CLI 已安装且版本为 1.0+
android --version

# 如果未安装，通过 sdkmanager 获取
sdkmanager --install "cmdline-tools;latest"

一行命令创建新项目

# 创建一个 Kotlin 项目，Min SDK 24，包名自定义
android create project \
  --name MyDemoApp \
  --package com.example.mydemo \
  --language kotlin \
  --min-sdk 24 \
  --target-sdk 34 \
  --template empty-activity \
  --output-dir ./MyDemoApp

cd MyDemoApp

这条命令会生成完整的 Gradle 项目结构，包含 MainActivity.kt、build.gradle.kts、AndroidManifest.xml 等，和 Android Studio 新建项目的结果一致。

构建并安装到设备

# 构建 debug APK
android build --variant debug

# 查看连接的设备
android devices

# 安装到指定设备（用设备 serial 指定）
android install --device emulator-5554 --apk app/build/outputs/apk/debug/app-debug.apk

# 启动应用
android run --device emulator-5554 --package com.example.mydemo

抓取运行日志

# 实时查看应用日志，按包名过滤
android log --filter com.example.mydemo --level debug

添加新模块

# 给项目添加一个 feature 模块
android add-module \
  --name feature-auth \
  --type dynamic-feature \
  --package com.example.mydemo.auth

以上命令在 1.0 版本中参数和输出均已稳定，适合写入自动化脚本。

AI Agent 协作的实操模式

CLI 稳定之后，AI Agent 的接入才有了可靠的基础——Agent 生成的代码需要被构建验证，CLI 提供了这个无 GUI 的验证通道。一个典型的协作流程：

# 1. 用 Antigravity 或 Claude Code 生成项目代码（伪命令，示意流程）
antigravity generate \
  --prompt "做一个带登录页和首页的 todo 应用，用 Material 3 组件" \
  --output-dir ./TodoApp

cd TodoApp

# 2. CLI 构建验证
android build --variant debug

# 3. 如果构建失败，把错误日志喂回 Agent 修复
android build --variant debug 2>&1 | tee build-errors.log
# Agent 读取 build-errors.log，自动修复代码

# 4. 构建成功后安装测试
android install --device emulator-5554 --apk app/build/outputs/apk/debug/app-debug.apk
android run --device emulator-5554 --package com.example.todoapp

关键点：CLI 让"生成 → 构建 → 反馈 → 修复"的循环可以完全在终端完成，不需要人手动在 IDE 里点按钮。这正是 Agent 能真正发挥作用的前提。

采纳建议与注意事项

什么时候值得切换到 CLI 为主的工作方式：

你的项目有大量自动化需求（CI/CD、批量构建多变体）
你习惯用 Neovim / VS Code 等非 Android Studio 编辑器写代码
你在探索 AI Agent 辅助开发，需要一个可编程的构建入口

目前需要注意的边界：

CLI 1.0 覆盖了构建和设备操作，但布局预览、性能分析等仍需 Android Studio GUI。
AI Agent 集成还在早期阶段，Antigravity 的生成质量需要你在真实项目上验证，不要直接用于生产代码而不审查。
CLI 命令的文档仍在完善，部分 --help 输出不够详细，遇到问题建议查官方 cmdline-tools 参考。

一个快速验证清单：

确认 android --version 输出 ≥ 1.0
用 android create project 创建一个空项目，确认构建通过
在模拟器上跑通 android install + android run
尝试把一条 CLI 命令写进你的 CI 脚本，观察稳定性

Android CLI 1.0 不是要取代 Android Studio，而是补上了命令行这个长期缺失的稳定入口。加上 AI Agent 集成的能力，Android 开发正在变成一个可以用脚本和 Agent 驱动的工程流程——这对重视自动化的团队来说，是一个值得马上尝试的变化。