Android CLI 概览

Android CLI 是一个命令行界面，可让您使用所选的任何工具更高效地构建 Android 应用。它针对智能体优先的工作流，对核心开发能力进行了标准化，为您提供了一个入口，让您能够获取所需的官方工具、技能和知识，从而更高效地进行开发。它还可以简化 CI、维护以及任何其他脚本化自动化操作，以适应 Android 开发日益分散的特性。

Android CLI 涵盖了整个开发生命周期，从创建项目并在设备上进行测试，到分析其性能并调查其在实际环境中的行为。例如，代理或脚本可以使用 CLI 执行以下任务：

• 自动设置环境和 Android SDK
• 基于模板搭建新项目基架
• 在已连接的设备或模拟器上构建、安装和运行应用
• 管理虚拟设备、在桌面窗口中镜像和控制已连接的设备，以及直接从终端检查实时设备屏幕和界面层次结构并与之交互
• 在您的机器上将 Jetpack Compose 预览渲染为图片，无需设备或 Android Studio
• 连接到正在运行的 Android Studio 实例，以进行语义代码分析、Compose 预览渲染和依赖项版本查找
• 通过历程测试您的应用
• 通过在已连接的设备或模拟器上记录系统跟踪记录和捕获堆转储来分析应用
• 分析 APK、app bundle 和库，以报告其大小、R8 缩减和优化指标，以及 Keep 规则警告
• 调查 Firebase Crashlytics 针对您的应用在实际运行中报告的崩溃、ANR 和非严重问题，包括 Crashlytics 在发生内存不足崩溃时收集的堆转储

Android CLI 还可让您的智能体访问 Android 技能和专门的 Android 知识库，以帮助确保您的项目应用 Android 推荐的模式和最佳实践。

如需查看 Android CLI 命令和选项的完整说明，请参阅 Android CLI 命令参考文档。

安装 Android CLI

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

1. 下载 Android CLI。

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

   android update
   

   提示： 定期运行 android update 以跟上最新功能。

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

为代理进行设置

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

Android skills

在 GitHub 上查看

Android CLI

如需安装 Android CLI 技能，请运行以下命令：

android init

收集的数据

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。

配置 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 命令参考文档。