Google Android CLI 完全指南：Windows 下安装 Android CLI 与 Skills，让 Cursor Agent 开发效率提升 3 倍

wzj_what_why_how

673人浏览 · 2026-06-29 15:30:37

wzj_what_why_how · 2026-06-29 15:30:37 发布

Google Android CLI 与 Android Skills 完全指南（Windows 版）

一、前言：Google 为什么要重新推出 Android CLI？

2026 年 4 月，Google 正式发布 Android CLI（预览版），并在 5 月推出 1.0 稳定版。这不是传统的 sdkmanager / avdmanager 的简单包装，而是一套面向 Agent 优先（Agent-first） 工作流的全新终端工具链。

1.1 解决的核心痛点

痛点	传统方式	Android CLI 方案
AI 不知道 SDK 怎么装	让 Agent 猜路径、猜命令	`android sdk install` 标准化安装
项目脚手架不规范	手动复制模板或让 AI 自由发挥	`android create` 官方模板一键生成
文档过时	把大段文档粘贴进对话	`android docs search/fetch` 实时查知识库
Agent 不懂 Android 最佳实践	依赖训练数据（往往滞后）	Android Skills 按需注入领域知识
IDE 与终端割裂	Agent 在终端，分析在 IDE	`android studio` 桥接 Android Studio

Google 官方博客称，在 Agent 工作流中使用 Android CLI + Skills，可将开发效率提升约 3 倍（减少 Token 消耗、降低试错次数）。

1.2 三大组件关系

┌─────────────────────────────────────────────────────────┐
│                    你的 AI Agent                         │
│              （Cursor / Claude Code / Gemini 等）         │
└───────────────┬─────────────────────┬───────────────────┘
                │                     │
        读取 Skills              调用 CLI 命令
                │                     │
┌───────────────▼──────────┐  ┌───────▼──────────────────┐
│    Android Skills        │  │     Android CLI          │
│  （SKILL.md 指令包）      │  │  create / sdk / run ...  │
│  github.com/android/skills│  │  docs / studio / skills  │
└──────────────────────────┘  └───────┬──────────────────┘
                                      │
                              ┌───────▼──────────────────┐
                              │  Android Knowledge Base   │
                              │  （4800+ 官方文档索引）     │
                              └──────────────────────────┘

二、Android CLI 是什么？

Android CLI 是 Google 提供的命令行工具，命令为 android（注意：与旧版 ADT 时代的 android 工具同名但完全不同）。

2.1 核心能力一览

类别	命令	作用
环境	`android info`	查看 SDK 路径等环境信息
环境	`android update`	更新 CLI 自身
SDK	`android sdk install`	安装指定 SDK 组件
SDK	`android sdk list`	列出已安装/可用 SDK 包
项目	`android create`	从官方模板创建新项目
项目	`android describe`	分析项目结构，输出构建产物路径
设备	`android emulator`	创建/启动/停止虚拟设备
部署	`android run`	将 APK 部署到设备或模拟器
调试	`android layout`	获取当前 UI 布局树（JSON）
调试	`android screen capture`	截图
调试	`android screen resolve`	将 UI 标签转为屏幕坐标
文档	`android docs search`	搜索 Android 知识库
文档	`android docs fetch`	拉取 `kb://` 文档全文
Skills	`android init`	初始化 Agent 环境，安装基础 Skill
Skills	`android skills add/list/find/remove`	管理 Android Skills
IDE 桥接	`android studio check`	检测 Android Studio 连接状态
IDE 桥接	`android studio analyze-file`	用 IDE 引擎分析文件
IDE 桥接	`android studio find-declaration`	语义查找符号声明
IDE 桥接	`android studio find-usages`	查找符号引用
IDE 桥接	`android studio render-compose-preview`	渲染 Compose Preview
IDE 桥接	`android studio version-lookup`	查询依赖最新版本

2.2 与传统工具的关系

Android CLI 不是要完全替代以下工具，而是给 Agent 提供统一、可预测的入口：

sdkmanager → 逐步被 android sdk 替代
avdmanager → 部分被 android emulator 替代（Windows 上有限制，见下文）
./gradlew assembleDebug → 构建仍由 Gradle 负责，android run 只负责部署
Android Studio → 通过 android studio 子命令深度集成

三、Android Skills 是什么？

3.1 概念

Android Skills 是 Google 维护的一套 AI 优化指令包，遵循 Agent Skills 开放标准。每个 Skill 是一个目录，核心文件为 SKILL.md，可附带：

references/：详细技术文档、API 参考
scripts/：Agent 可执行的脚本
assets/：模板、Schema 等静态资源

Skill 的 YAML 头信息中的 description 字段决定 何时自动触发——当你的 Prompt 与描述匹配时，Agent 会自动加载该 Skill。

3.2 官方 Skill 目录（持续更新）

运行 android skills list --long 可获取最新完整列表。截至 2026 年，主要 Skill 包括：

Skill 名称	适用场景
`android-cli`	安装和使用 Android CLI 本身（必装基础 Skill）
`edge-to-edge`	Jetpack Compose 全面屏 / 系统栏 inset 适配
`navigation-3`	迁移到 Jetpack Navigation 3
`agp-9-upgrade`	Android Gradle Plugin 9 升级迁移
`xml-to-compose`	XML 布局迁移到 Compose
`r8-analyzer`	R8 混淆规则审计与打包优化
`camera1-to-camerax`	Camera1 迁移到 CameraX
`adaptive-ui`	自适应 UI 布局
`compose-styles`	Compose Styles API 与 UI 审计
`app-functions`	端侧 AI 功能（App Functions）集成
`testing-setup`	测试基础设施配置
`intent-security`	Intent 安全最佳实践
`verified-email`	邮箱验证实现
`wear-compose-m3`	Wear OS Material 3 组件

Google 的策略是：只覆盖 LLM 评估表现较弱的领域，而不是重复基础 Compose 语法。

3.3 Skill 存放位置（Cursor）

Cursor 会在启动时自动扫描以下目录：

路径	作用域
`~/.cursor/skills/`	用户级（全局）
`~/.agents/skills/`	用户级（全局）
项目内 `.cursor/skills/`	项目级（团队共享）
项目内 `.agents/skills/`	项目级（团队共享）

Windows 上 ~ 对应 %USERPROFILE%，例如：

C:\Users\你的用户名\.cursor\skills\android-cli\SKILL.md

通过 android skills add --agent=cursor 安装时，CLI 会自动写入 Cursor 的标准 Skills 目录。

四、环境准备（Windows）

4.1 硬件与系统要求

操作系统：Windows 10 / 11，64 位
磁盘空间：Android Studio + SDK + 模拟器约 15–25 GB；CLI 本身约 7 MB（首次运行会下载约 78 MB 运行时）
网络：安装 SDK 组件和 Skills 需要访问 Google 服务器

4.2 推荐预装软件

软件	是否必须	说明
Windows Terminal / PowerShell	推荐	更好的终端体验
winget	推荐	Windows 官方包管理器，安装 CLI 最简便
Android Studio	强烈推荐	构建、调试、`android studio` 桥接
Android Studio Quail（Preview）	可选	使用 `android studio` 子命令需 Canary 版本
Cursor	推荐	本文重点介绍的 AI Agent
JDK 17+	必须（开发时）	AGP 8+/9 要求
adb 可用	推荐	通常随 SDK Platform-Tools 安装

4.3 检查 winget 是否可用

以管理员身份打开 PowerShell，执行：

winget --version

若提示找不到命令，请先安装 App Installer 或升级 Windows 到较新版本。

五、安装 Android CLI（Windows）

官方文档：Download Android CLI

5.1 方式一：winget（推荐）

winget install -e --id Google.AndroidCLI

参数说明：

-e / --exact：精确匹配包 ID，避免装错同名第三方工具
包 ID 固定为 Google.AndroidCLI

安装完成后 关闭并重新打开 终端，使 PATH 生效。

5.2 方式二：官方 install.cmd 脚本

适用于无法使用 winget 的环境。在 CMD（非 PowerShell）中执行：

curl.exe -fsSL https://dl.google.com/android/cli/latest/windows_x86_64/install.cmd -o "%TEMP%\android-install.cmd"
"%TEMP%\android-install.cmd"

全局安装（所有用户，需管理员权限）：

curl.exe -fsSL https://dl.google.com/android/cli/latest/windows_x86_64/install_admin.cmd -o "%TEMP%\android-install.cmd"
"%TEMP%\android-install.cmd"

默认安装路径：C:\Program Files\Android\cli

已知问题：官方文档注明「Downloading Android CLI from Windows PowerShell isn’t currently supported」，因此 curl 安装脚本建议在 CMD 中运行，而非 PowerShell 直接管道执行。

5.3 方式三：直接下载二进制

从官方下载页获取 Windows x86_64 压缩包，手动解压并将目录加入系统 PATH。

5.4 验证安装

android --version

期望输出类似：

android 1.0.0

若提示「找不到命令」：

确认已重启终端
检查 PATH 是否包含 CLI 安装目录
在 PowerShell 中执行：Get-Command android

5.5 更新 CLI

android update

建议定期执行，以获取最新命令和 Skill 索引。

六、初始化与安装 Skills

6.1 第一步：运行 android init

android init

该命令会：

创建本地配置目录 %USERPROFILE%\.android-cli\
安装基础 Skill android-cli 到已检测到的 Agent 目录
配置 Shell 补全（若终端支持）

6.2 第二步：为 Cursor 显式安装 Skills

若你主要使用 Cursor，建议显式指定 Agent：

# 仅安装基础 android-cli Skill
android skills add --agent=cursor android-cli

# 安装指定 Skill（skill 名称为位置参数，不是 --skill=）
android skills add --agent=cursor edge-to-edge

# 安装全部官方 Skills（体积较大，按需选择）
android skills add --agent=cursor --all

语法注意：skills add 的 skill 名称是 位置参数，写在命令末尾，例如 android skills add --agent=cursor edge-to-edge。不支持 --skill=xxx 写法。

支持的 Agent 标识（--agent 参数）包括但不限于：

cursor、claude-code、gemini、codex、opencode、windsurf、cline、aider、github-copilot、antigravity、universal 等（共 37 个）。

常见错误：使用 --agent=claude 会失败，Claude Code 的正确标识是 claude-code。

6.3 第三步：安装到项目目录（团队共享）

若希望 Skill 随 Git 仓库共享给团队：

cd D:\your-android-project
android skills add --project=. r8-analyzer

这会在项目内创建 .cursor/skills/ 或 .agents/skills/ 目录（取决于 Agent 检测）。

6.4 验证 Skills 安装

# 列出所有 Skill 及安装状态
android skills list --long

# 按关键词搜索
android skills find "performance"

在 Cursor 中验证：

打开 Cursor Settings → Rules → Skills
应能看到 android-cli 等已安装 Skill
或在 Agent 对话中输入 / 搜索 Skill 名称

注意：Cursor 在启动时发现 Skills。安装后若未生效，请 重启 Cursor 或新开 Agent 会话。

七、Cursor 集成实战

7.1 Skill 如何被触发

自动触发：Agent 根据 SKILL.md 中的 description 判断是否相关。

示例 Prompt（会自动触发 edge-to-edge Skill）：

帮我把这个 Compose 页面的底部按钮适配全面屏，避免被导航栏遮挡

手动触发：

在 Agent 输入框输入 /edge-to-edge
或使用 @ 引用 Skill 作为上下文

7.2 推荐的最小 Skill 组合

针对日常 Android 开发 + AI 辅助，建议至少安装：

android skills add --agent=cursor android-cli
android skills add --agent=cursor edge-to-edge
android skills add --agent=cursor r8-analyzer
android skills add --agent=cursor agp-9-upgrade

若项目正在迁移 Compose / Navigation 3，按需追加：

android skills add --agent=cursor navigation-3
android skills add --agent=cursor migrate-xml-views-to-jetpack-compose

7.3 典型 Agent 工作流示例

示例 A：分析现有项目的 R8 配置

你对 Cursor 说：

用 android cli 分析当前项目的 R8 混淆配置，找出冗余 keep 规则

Agent 预期行为：

加载 r8-analyzer Skill
运行 android describe 了解项目结构
分析 proguard-rules.pro 等文件
给出可删除的 keep 规则建议

示例 B：查询最新官方文档

你对 Cursor 说：

查一下 Android 官方文档里 Navigation 3 多 back stack 怎么实现

Agent 预期行为：

android docs search "Navigation 3 multiple back stacks"
android docs fetch kb://android/guide/navigation/navigation-3/...

示例 C：创建新项目

android create list
android create empty-activity-agp-9 -o D:\Projects\MyApp --verbose

示例 D：部署到设备

# 先 Gradle 构建
.\gradlew assembleDebug

# 再 CLI 部署
android run --apks=app\build\outputs\apk\debug\app-debug.apk

八、常用命令详解

8.1 SDK 管理

# 安装 Platform 34 和 Build Tools
android sdk install platforms/android-34 build-tools/34.0.0

# 列出所有可用包
android sdk list --all

# 更新全部 SDK 组件
android sdk update

8.2 项目创建

# 查看可用模板
android create list

# 干跑（不真正创建文件）
android create --dry-run empty-activity-agp-9 -o D:\temp\demo

# 正式创建
android create empty-activity-agp-9 -o D:\Projects\DemoApp --name=DemoApp

默认模板为 empty-activity-agp-9（适配 AGP 9 的空 Activity 项目）。

8.3 文档查询（Knowledge Base）

两步流程：

# 第一步：搜索
android docs search "How to improve app startup performance"

# 第二步：用返回的 kb:// URL 拉取全文
android docs fetch kb://android/topic/performance/...

Knowledge Base 索引约 4808 篇文档，覆盖 Android、Firebase、Kotlin、Google Developers 等来源。

8.4 Android Studio 桥接（需 Quail Preview）

# 检查 IDE 连接
android studio check

# 分析 Kotlin 文件
android studio analyze-file app\src\main\java\com\example\MainActivity.kt

# 查找符号声明
android studio find-declaration --short HotelDetailScreen

# 渲染 Compose Preview
android studio render-compose-preview ^
  --output-image-file=preview.png ^
  --print-semantics ^
  app\src\main\java\com\example\ui\DetailScreen.kt ^
  HotelDetailScreenPreview

8.5 配置文件 .androidrc

在 %USERPROFILE%\.androidrc 中写入默认参数，每行一个：

--sdk=C:\Users\你的用户名\AppData\Local\Android\Sdk

九、Windows 平台特别说明

9.1 已知限制

限制	说明	替代方案
`android emulator` 在 Windows 上暂不可用	官方 Known Issues 明确标注	使用 Android Studio AVD Manager 管理模拟器
PowerShell 不支持 curl 管道安装	官方下载页限制	使用 winget 或 CMD 运行 install.cmd
`android studio` 需 Preview 版	Stable 渠道尚未暴露 CLI 桥接	安装 Android Studio Quail Canary

9.2 Windows 路径注意事项

SDK 默认路径：%LOCALAPPDATA%\Android\Sdk
CLI 配置：%USERPROFILE%\.android-cli\
Skills 路径：%USERPROFILE%\.cursor\skills\
在 PowerShell 中路径分隔符可用 \ 或 /
android run --apks= 支持相对路径，相对于当前工作目录

9.3 与 adb 配合

# 查看已连接设备
adb devices

# 指定设备部署
android run --apks=app-debug.apk --device=emulator-5554

十、完整安装清单（Copy-Paste 版）

以下命令假设你已安装 winget 和 Cursor，在 PowerShell 中按顺序执行：

# 1. 安装 Android CLI
winget install -e --id Google.AndroidCLI

# 2. 重启终端后验证
android --version

# 3. 更新到最新版
android update

# 4. 初始化 Agent 环境
android init

# 5. 为 Cursor 安装核心 Skills
android skills add --agent=cursor android-cli
android skills add --agent=cursor edge-to-edge
android skills add --agent=cursor r8-analyzer

# 6. 验证
android skills list --long
android info

然后 重启 Cursor，在 Agent 中尝试：

帮我检查一下 android cli 是否配置正确，并列出已安装的 skills

十一、故障排查

Q1：winget 安装报 msstore 证书错误

执行 winget install -e --id Google.AndroidCLI 时可能出现：

搜索源时失败: msstore
执行此命令时发生意外错误：
0x8a15005e : The server certificate did not match any of the expected values.

在工作源中找到以下包。
若要继续操作，请使用 --source 选项指定其中一个。
名称        ID                源
------------------------------------
Android CLI Google.AndroidCLI winget

原因：winget 默认会同时搜索 msstore（Microsoft Store）和 winget 两个源。上述报错表示 msstore 源 SSL 证书校验失败，常见诱因包括公司网络/代理/防火墙 HTTPS 拦截、系统时间不正确、msstore 源证书链异常。不代表 Android CLI 包本身有问题——终端提示已表明包在 winget 源中可用。

解决：指定 winget 源安装，跳过有问题的 msstore：

winget install -e --id Google.AndroidCLI --source winget

可选（避免后续 winget 命令重复报 msstore 错）：若不需要从 Microsoft Store 安装软件，可禁用 msstore 源：

winget source disable msstore

禁用后，可直接使用不带 --source 的安装命令。

Q2：`android` 命令找不到

重启终端 / 重启电脑
检查环境变量 PATH
重新运行 winget 安装（若遇 msstore 证书错误，见 Q1）

Q3：`Get-Command android` 能找到，但 `android --version` 无输出

Get-Command android 显示路径正常，但执行 android --version 无任何输出、直接退出，退出码常为 -1073741515（即 0xC0000135）。

原因：缺少 Microsoft Visual C++ Redistributable（Windows Universal C Runtime）。Android CLI 与 adb 等 Google 原生 Windows 工具一样，依赖该运行库；Get-Command 显示的 Version: 0.0.0.0 只是 exe 未嵌入文件版本信息，不代表 CLI 已能正常运行。

诊断：

android --version
Write-Host "exit: $LASTEXITCODE"   # 若输出 exit: -1073741515，即为此问题

检查是否已安装 VC++ 运行库：

Get-ItemProperty HKLM:\Software\Microsoft\Windows\CurrentVersion\Uninstall\* ,
  HKLM:\Software\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\* |
  Where-Object { $_.DisplayName -match 'Visual C\+\+.*Redistributable' } |
  Select-Object DisplayName, DisplayVersion

解决：安装 x64 版 Visual C++ 2015–2022 运行库（64 位 Windows 选 x64）：

winget install -e --id Microsoft.VCRedist.2015+.x64 --source winget

或从 Microsoft 官方下载页手动下载 vc_redist.x64.exe 安装。

安装完成后重启终端，再执行：

android --version

期望输出类似 android 1.0.15498356。

Q4：`android skills add` 报 Invalid agent

确认 Agent 标识拼写，如 cursor 而非 Cursor
Claude Code 用 claude-code，不是 claude
运行失败时 CLI 会打印完整 Agent 列表

Q4b：`Unknown option: '--skill=xxx'`

执行 android skills add --agent=cursor --skill=edge-to-edge 时出现：

Unknown option: '--skill=edge-to-edge'
Usage: android skills install [--all] [--agent=PARAM] [--project=PARAM] <skill>

原因：skill 名称是 位置参数 <skill>，不是 --skill= 选项。

正确写法：

# 安装单个 skill
android skills add --agent=cursor edge-to-edge

# 安装全部
android skills add --agent=cursor --all

# 安装到项目目录
android skills add --project=. r8-analyzer

安装前可用 android skills list 查看可用 skill 名称。

Q5：Cursor 看不到 Skill

确认 %USERPROFILE%\.cursor\skills\ 下存在对应目录
完全退出并重启 Cursor
在 Settings → Rules → Skills 中查看

Q6：自定义 Skill 被覆盖

官方提示：若修改了 Skill 内容，应 重命名 Skill，否则 android skills add 更新时会覆盖

Q7：`android` 提示 deprecated / 不支持 skills 子命令

执行 android skills add 时出现：

The "android" command is deprecated.
For manual SDK, AVD, and project management, please use Android Studio.
...
Invalid or unsupported command "skills add --agent=cursor"
Supported commands are:
android list target
android list avd
...

原因：PATH 中 旧版 SDK 的 tools\android.bat 排在 新版 Google Android CLI 之前。两者命令同名 android，但完全不同——旧版是 ADT 时代已废弃工具，新版才支持 skills、docs、sdk 等子命令。

Windows PATH 顺序：系统（Machine）变量先于用户（User）变量加载。若 SDK\tools 在 系统 PATH 中，仅把新 CLI 前置到 用户 PATH 无法解决冲突——旧版 android.bat 仍会先被命中。

诊断：

Get-Command android -All | Format-Table Name, Source -AutoSize

若第一个结果是 ...\Android\Sdk\tools\android.bat，即为此问题。

解决（任选其一，推荐方案 A 或 B）：

方案 A（推荐，无需管理员）：重命名已废弃的 android.bat，避免与新版 CLI 冲突：

Rename-Item "$env:LOCALAPPDATA\Android\Sdk\tools\android.bat" "android.bat.deprecated"

方案 B（需管理员）：从 系统 PATH 中移除 %LOCALAPPDATA%\Android\Sdk\tools（旧 android.bat 已废弃，SDK 管理请用 sdkmanager 或新 CLI 的 android sdk）。在「系统属性 → 环境变量 → 系统变量 → Path」中编辑，或以管理员 PowerShell 执行：

$toolsPath = "$env:LOCALAPPDATA\Android\Sdk\tools"
$machinePath = [Environment]::GetEnvironmentVariable('Path', 'Machine')
$parts = $machinePath -split ';' | Where-Object { $_ -and $_ -ne $toolsPath }
[Environment]::SetEnvironmentVariable('Path', ($parts -join ';'), 'Machine')

方案 C：确保 winget 新 CLI 目录在用户 PATH 中（作为补充，不能单独解决 Machine 优先问题）：

$wingetCli = "$env:LOCALAPPDATA\Microsoft\WinGet\Packages\Google.AndroidCLI_Microsoft.Winget.Source_8wekyb3d8bbwe"
# 若目录不在用户 PATH 中，追加进去

修改后 重启终端，验证：

Get-Command android | Select-Object Source
android --version   # 应输出 1.0.x，而非 deprecated 提示

临时绕过（不改 PATH 时，使用完整路径）：

& "$env:LOCALAPPDATA\Microsoft\WinGet\Packages\Google.AndroidCLI_Microsoft.Winget.Source_8wekyb3d8bbwe\android.exe" skills add --all --agent=cursor

Q8：`android init` 报 InvalidPathException / SDK 路径不对

执行 android init、android skills add、android info 等命令时出现：

java.nio.file.InvalidPathException: <elided>
    at com.android.cli.ui.Context.defaultSdkPath(Context.kt:36)

常见原因：ANDROID_HOME 被错误配置为 多个路径（类似 PATH 的写法），或末尾带 多余分号，例如：

C:\Users\xxx\AppData\Local\Android\Sdk;C:\Users\xxx\AppData\Local\Android\Sdk\platform-tools;
C:\Users\xxx\AppData\Local\Android\Sdk;

Android CLI 期望 ANDROID_HOME 是 单一的 SDK 根目录，不能包含分号或 platform-tools 子路径。

诊断：

Write-Host "Session ANDROID_HOME=$env:ANDROID_HOME"
Write-Host "User ANDROID_HOME=$([Environment]::GetEnvironmentVariable('ANDROID_HOME','User'))"
Write-Host "Machine ANDROID_HOME=$([Environment]::GetEnvironmentVariable('ANDROID_HOME','Machine'))"

若 Session 或 Machine 行的 ANDROID_HOME 含 ;，即为此问题。仅修正 User 级变量后，未重启的终端仍会沿用旧 Session 值。

解决：将 User 级 ANDROID_HOME 和 ANDROID_SDK_ROOT 都设为 SDK 根目录（不含 platform-tools）：

$sdk = "$env:LOCALAPPDATA\Android\Sdk"
[Environment]::SetEnvironmentVariable('ANDROID_HOME', $sdk, 'User')
[Environment]::SetEnvironmentVariable('ANDROID_SDK_ROOT', $sdk, 'User')

若 Machine 级也存在错误值，需 以管理员身份 修正，或在「系统属性 → 环境变量」中手动编辑。

platform-tools 应加入 PATH，而不是拼进 ANDROID_HOME。修改后必须重启终端，再执行：

android init
android skills add --all --agent=cursor

临时绕过：

$sdk = "$env:LOCALAPPDATA\Android\Sdk"
android --sdk=$sdk skills add --all --agent=cursor

或写入 %USERPROFILE%\.androidrc：

--sdk=C:\Users\你的用户名\AppData\Local\Android\Sdk

Q9：emulator 命令不可用

Windows 上请使用 Android Studio 的 AVD Manager 创建和启动模拟器，CLI 的 android emulator 子命令暂不支持 Windows。

十二、隐私与数据收集

Android CLI 会收集以下匿名使用数据（官方说明）：

命令及子命令调用次数（如 android run）
非用户输入的参数名（如 --sdk）
预定义选项值（如模板名 medium_phone）
匿名化后的异常堆栈

不会收集：CLI 输出内容、自定义项目名、本地文件路径、Maven 坐标等用户输入。

十三、与现有 Android 开发流程的结合

13.1 推荐工作流

┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│  Cursor Agent │────▶│ Android CLI  │────▶│ Gradle/ADB   │
│  + Skills     │     │ 标准化命令    │     │ 构建与部署    │
└──────────────┘     └──────────────┘     └──────────────┘
        │                                           │
        └───────────── android studio ──────────────┘
                      （IDE 深度分析）

日常编码：Cursor + Skills 自动遵循 Android 最佳实践
SDK/环境：android sdk 管理，Agent 无需猜测
构建：仍用 ./gradlew，CLI 不负责编译
部署测试：android run 快速装包
深度分析：android studio 调用 IDE 引擎
文档：android docs 替代手动查文档

13.2 适合引入团队的项目场景

AGP 9 升级迁移
XML → Compose 大规模重构
R8 打包体积与混淆优化
Edge-to-edge 全面屏适配
Navigation 2 → Navigation 3 迁移
Camera1 → CameraX 改造

十四、参考链接

资源	URL
Android CLI 总览	https://developer.android.com/tools/agents/android-cli
Android CLI 下载	https://developer.android.com/tools/agents/android-cli/download
Android CLI 发布说明	https://developer.android.com/tools/agents/android-cli/release-notes
Android Skills 总览	https://developer.android.com/tools/agents/android-skills
Android Skills GitHub	https://github.com/android/skills
官方博客	https://developer.android.com/blog/posts/android-cli-build-android-apps-3x-faster-using-any-agent
Agent Skills 开放标准	https://agentskills.io/home
Cursor Skills 文档	https://cursor.com/docs/skills
Android Studio 下载	https://developer.android.com/studio

十五、总结

Google 在 2026 年推出的 Android CLI + Android Skills + Knowledge Base，构成了面向 AI Agent 的 Android 开发新基建：

Android CLI：给 Agent 一双「标准化的手」，执行 SDK 管理、项目创建、部署、文档查询等操作
Android Skills：给 Agent 一颗「领域大脑」，在 AGP 升级、R8 优化、Navigation 3 等 LLM 薄弱领域提供权威指导
Knowledge Base：给 Agent 一座「实时图书馆」，避免依赖过时的训练数据

对于 Windows + Cursor 开发者，最小行动路径是：

winget install -e --id Google.AndroidCLI
android init
android skills add --agent=cursor android-cli

重启 Cursor 后即可开始 Agent 驱动的 Android 开发。随着官方 Skill 库持续扩充，建议每月执行一次 android update 和 android skills add --agent=cursor --all 保持同步。

本文基于 Google 官方文档与 Android CLI 1.0 整理，CLI 与 Skills 仍在快速迭代，请以官方文档为准。

龙虾开发者社区

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地，聚焦技能开发、插件实践与部署教程，为开发者提供可直接落地的方案、工具与交流平台，助力高效构建与落地 AI 应用

更多推荐

我用 NVIDIA SkillSpector 纯静态扫了一遍 GitHub 最火的 agent skills：能挖出多少注入？0 个

龙虾开发者社区

周榜换血九成，Agent Skills 星数翻倍

龙虾开发者社区

写给 TypeScript 工程师的 OpenClaw.NET 上手指南：用你熟悉的 TS 思维，跑起一个生产级 AI Agent

读代码层：TS 和 C# 本来就是「远房亲戚」——asyncawait??、接口、泛型、严格空检查，你的心智模型几乎无缝平移。真正要适应的只有两件事：类型是具名而非结构化的（多一句显式声明），以及 NativeAOT 下的「禁反射」约束。写扩展层：你甚至可以不怎么碰 C#——Node.js 插件桥意味着你的 TypeScript 插件就是一等公民，而且能在生产 aot 车道跑。内核给你 .NET

龙虾开发者社区

所有评论(0)

查看更多评论

wzj_what_why_how

@wzj_what_why_how

已为社区贡献1条内容

Google Android CLI 完全指南：Windows 下安装 Android CLI 与 Skills，让 Cursor Agent 开发效率提升 3 倍

wzj_what_why_how

Google Android CLI 与 Android Skills 完全指南（Windows 版）

一、前言：Google 为什么要重新推出 Android CLI？

1.1 解决的核心痛点

1.2 三大组件关系

二、Android CLI 是什么？

2.1 核心能力一览

2.2 与传统工具的关系

三、Android Skills 是什么？

3.1 概念

3.2 官方 Skill 目录（持续更新）

3.3 Skill 存放位置（Cursor）

四、环境准备（Windows）

4.1 硬件与系统要求

4.2 推荐预装软件

4.3 检查 winget 是否可用

五、安装 Android CLI（Windows）

5.1 方式一：winget（推荐）

5.2 方式二：官方 install.cmd 脚本

5.3 方式三：直接下载二进制

5.4 验证安装

5.5 更新 CLI

六、初始化与安装 Skills

6.1 第一步：运行 android init

6.2 第二步：为 Cursor 显式安装 Skills

6.3 第三步：安装到项目目录（团队共享）

6.4 验证 Skills 安装

七、Cursor 集成实战

7.1 Skill 如何被触发

7.2 推荐的最小 Skill 组合

7.3 典型 Agent 工作流示例

示例 A：分析现有项目的 R8 配置

示例 B：查询最新官方文档

示例 C：创建新项目

示例 D：部署到设备

八、常用命令详解

8.1 SDK 管理

8.2 项目创建

8.3 文档查询（Knowledge Base）

8.4 Android Studio 桥接（需 Quail Preview）

8.5 配置文件 .androidrc

九、Windows 平台特别说明

9.1 已知限制

9.2 Windows 路径注意事项

9.3 与 adb 配合

十、完整安装清单（Copy-Paste 版）

十一、故障排查

Q1：winget 安装报 msstore 证书错误

Q2：android 命令找不到

Q3：Get-Command android 能找到，但 android --version 无输出

Q4：android skills add 报 Invalid agent

Q4b：Unknown option: '--skill=xxx'

Q5：Cursor 看不到 Skill

Q6：自定义 Skill 被覆盖

Q7：android 提示 deprecated / 不支持 skills 子命令

Q8：android init 报 InvalidPathException / SDK 路径不对

Q9：emulator 命令不可用

十二、隐私与数据收集

十三、与现有 Android 开发流程的结合

13.1 推荐工作流

13.2 适合引入团队的项目场景

十四、参考链接

十五、总结

所有评论(0)

温馨提示：您尚未绑定手机号

wzj_what_why_how

Q2：`android` 命令找不到

Q3：`Get-Command android` 能找到，但 `android --version` 无输出

Q4：`android skills add` 报 Invalid agent

Q4b：`Unknown option: '--skill=xxx'`

Q7：`android` 提示 deprecated / 不支持 skills 子命令

Q8：`android init` 报 InvalidPathException / SDK 路径不对