Lightbuild 概览

Lightbuild 是一种适用于 Android 项目的声明式 build 体验，可让您和您的智能体更轻松地读取和修改 build 配置。您可以在 YAML 文件中描述项目，然后使用 Android Studio Canary 或 Lightbuild CLI 构建项目。

Lightbuild 的运作方式

创建新项目时，您通常会使用 Android 官方支持和推荐的 build 配置语言 Kotlin DSL。Lightbuild 是一种实验性替代方案，它采用不同的方法。

Lightbuild 配置文件是声明式的：您无需编写可执行的构建逻辑，而是声明项目包含的内容以及应如何构建项目。Lightbuild 项目使用以下文件：

  • project.lightbuild.yaml：项目根目录中的一个文件，用于定义项目级设置，例如项目的模块、获取依赖项的代码库以及 Lightbuild 版本。
  • lightbuild.yaml：每个模块中用于定义模块类型、Android 设置、依赖项和测试的文件。
  • resolved.deps：由 Lightbuild 管理的每个模块中自动生成的文件，用于记录已解析的依赖项，从而避免在打开或构建时重新解析这些依赖项。请勿手动修改。

如需了解详情，请参阅 Lightbuild 项目结构和 Lightbuild 配置参考文档。

优势

Lightbuild 使用基于 YAML 的声明式配置文件，为 Agentic Workflows 和 Android Studio Canary 用户带来了多项优势：

  • 智能体友好型配置：Lightbuild 基于 YAML 的 build 配置文件和强大的命令行界面旨在让 AI 智能体更高效地解析 build 配置、了解项目布局和输出、更新依赖项以及修改模块，一切尽在您的掌控之中。
  • 内置于 Android Studio 中：Android Studio Canary 完全支持 Lightbuild 项目。Lightbuild 的声明式架构可加快项目打开速度，并且在配置更改后无需手动同步，让您能够专注于开发。
  • 命令行工作流：使用 Lightbuild CLI 从终端构建、测试和检查 Lightbuild 项目，或让 AI 智能体为您完成这些工作。此外，Lightbuild 项目与 Android CLI 及其强大的实用开发功能套件完全兼容。
  • 预解析的依赖项：Lightbuild 会主动解析依赖项，并将其记录在每个模块的 resolved.deps 文件中。通过将这些文件签入版本控制，您的项目可以完全绕过动态解析，从而更快地打开和构建。

Lightbuild 的使用方式

您可以单独或结合使用 Lightbuild 与 Android Studio Canary、Lightbuild CLI 和 Android CLI。下表针对常见任务推荐了相应工具：

您想做什么 推荐工具
创建 Lightbuild 项目 Android Studio Canary 或 Android CLI。如需了解详情，请参阅创建项目。
在 IDE 中编写代码，以及运行、测试和调试应用 Android Studio Canary
从命令行构建、测试和检查项目 Lightbuild CLI：运行 lightbuild build 和 lightbuild test。如需检查项目的结构和输出，请运行 lightbuild query。
让 AI 智能体构建、测试和修改您的项目 您首选的编码智能体，搭配 Lightbuild CLI 用于构建项目和分析项目结构，以及 Android CLI 用于与设备和模拟器交互。Lightbuild 新项目模板包含一个 AGENTS.md 文件，用于告知智能体如何使用该模板。

您可以使用 Android CLI 安装 Lightbuild CLI。如需设置环境并创建首个项目，请参阅 Lightbuild 使用入门。

报告问题

如果您发现 Lightbuild 存在 bug 或有相关反馈，请在 Google 问题跟踪器中提交问题。