build_runner

build_runner(https://pub.dev/packages/build_runner) 包提供用于生成文件的通用命令，包括测试生成的和提供源文件和生成文件。本页解释如何使用 build_runner 。要了解如何在特定包中使用 build_runner ，请参阅该包的文档。

build_runner 命令与 构建器 配合使用——这些包使用 Dart 构建系统 从输入文件生成输出文件。例如， json_serializable 和 built_value_generator 包定义了生成 Dart 代码的构建器。

虽然 Dart 构建系统是反射（存在性能问题）和宏（Dart 的编译器不支持）的良好替代方案，但它不仅仅可以读取和写入 Dart 代码。例如， sass_builder 包实现了一个构建器，该构建器从 .scss 和 .sass 文件生成 .css 文件。

要使用 build_runner ，请在应用的 pubspec 中添加对 build_runner 的 开发依赖项 ：

dev_dependencies:
  # ···
  build_runner: ^2.4.13
  build_test: ^2.2.2

依赖于 build_test 是可选的；如果您要测试您的代码，则执行此操作。

像往常一样，在 pubspec.yaml 更改之后，运行 dart pub get 或 dart pub upgrade ：

$ dart pub get

以下是使用 build_runner build 命令的示例：

$ # 从包含 pubspec.yaml 文件的目录：
$ dart run build_runner build

build_runner 包包含以下命令：

build

执行一次性构建。

serve

运行开发服务器。 不要直接使用此命令， 您可以使用 webdev serve , 它具有方便的默认行为。

test

运行 测试。

watch

启动一个构建服务器，监视对输入文件的编辑。 通过执行增量重建来响应更改。

如果您正在处理特定于 Web 的代码， 请参阅 webdev 页面。

有关使用 build_runner 的详细信息，请参阅以下内容：

• 需要您使用 build_runner 的包的文档。 这些包通常依赖于 build 或 build_runner。
• build_runner 文档：
  • build_runner 入门
  • 构建常见问题解答

除非另有说明，否则本网站上的文档反映的是 Dart 3.6.0。页面最后更新于 2025-02-05。 查看源代码 或 报告问题.