Android CLI 概览

Android CLI 是一种命令行界面，可让您使用任意选择的工具更高效地为 Android 进行 build。它可标准化面向智能体工作流的核心开发能力，并提供官方工具、技能和知识的入口点，让您能够更高效地进行开发。它还可以简化 CI、维护和任何其他脚本化自动化流程，以应对 Android 开发日益分散的特性。

例如，代理或脚本可以使用 CLI 执行以下任务：

  • 自动设置环境和 Android SDK
  • 基于模板搭建新项目基架
  • 直接从终端管理虚拟设备、安装 APK，以及检查实时设备屏幕和界面层次结构
  • 连接到正在运行的 Android Studio 实例，以进行语义代码分析、Compose 预览渲染和依赖项版本查找
  • 通过历程测试应用

Android CLI 还可让您的代理访问 Android skills 和专业的 Android 知识库，以帮助确保您的项目应用 Android 推荐的模式和最佳实践。

如需全面了解 Android CLI 命令和选项，请参阅 Android CLI 命令参考文档。

安装 Android CLI

如需安装 Android CLI，请按以下步骤操作：

  1. 下载 Android CLI。

  2. 为确保您使用的是最新版本，请更新 Android CLI：

    android update

如需检查 Android CLI 是否已安装在您的机器上，请运行 which android 或 command -v android：如果返回路径，则表示已安装。

为代理设置

为了帮助代理了解和使用 Android CLI，请运行 android init 以安装 android-cli 技能。

收集的数据

Android CLI 会收集有关该工具基本使用情况的数据。以下是我们收集的数据：

  • android 命令和子命令（例如 android run 和 android create）的调用。
  • 所用非位置实参或选项的名称，例如 --sdk 或 --version。
  • 与 Android CLI 管理的一组固定的预定义系统选项对应的位置实参和标志值。例如，我们会收集模拟器模板名称（如 medium_phone 和 large_desktop）以及代理名称（如 GEMINI、CLAUDE 或 CODEX）。
  • 堆栈轨迹和异常消息，其中身份信息会在收集前进行匿名化处理，以帮助确保隐私。

以下是我们不会收集的一些数据示例：

  • 我们不会在运行命令时收集 CLI 的响应。
  • 我们不会收集传递给 CLI 的用户创建的输入内容或外部标识符，例如特定的 Maven 坐标、本地文件路径或自定义项目名称。例如，如果执行命令 android create --name=com.company.internal.app，我们会记录 android create 是使用 --name 实参执行的，但不会存储值 com.company.internal.app。

如需停用数据收集，请在通过 Android CLI 运行命令时使用 --no-metrics 标志。

反馈和问题

如果您遇到任何问题或想提供反馈，请报告 bug。

已知问题

  • 适用于 Windows 的 android emulator 命令目前已停用。
  • 目前不支持从 Windows PowerShell 下载 Android CLI。

配置 Android CLI

创建一个 .androidrc 文件，以便在每次调用 Android CLI 时自动应用标志和选项。将文件保存到以下位置，具体取决于您的操作系统：

  • macOS 和 Linux：~/.androidrc
  • Windows：%USERPROFILE%\.androidrc

添加要自动应用于文件的标志，每行一个。

例如，如需让 Android CLI 每次都默认使用特定的 Android SDK，请向您的文件中添加 --sdk 标志：

--sdk=<path-to-sdk>

全局选项

这些是可选标志，可与其他 Android CLI 命令搭配使用。

-h, --help

用法： android <command> -h

说明：显示相应工具或特定命令的帮助手册。

示例：

  • android -h
  • android create -h

--sdk

用法： android --sdk=<path-to-sdk> <command>

说明：您要用于后续命令的 Android SDK 的路径。您可以使用 --sdk 设置暂时替换默认 Android SDK，而不必每次想切换时都更改全局环境变量。如需查看您默认使用的 Android SDK，请运行 android info。

示例： android --sdk=<path/to/sdk> sdk list

-v, --verbose

用法： android -v <command>

说明：启用详细输出。指定多个 -v 选项可提高详细程度（例如 -v、-vv 或 -vvv）。

-V, --version

用法： android -V

说明：打印版本信息并退出。

命令

如需全面了解 Android CLI 命令和选项，请参阅 Android CLI 命令参考文档。