Contents

build_runner

build_runner软件包提供了通用命令,用于生成文件以及可选地测试生成的文件或同时提供源文件和生成的文件. 阅读此页面以获得使用build_runner的概述,并带有指向您可以找到更多信息的链接. 有关对特定软件包使用build_runner的详细信息,请参阅该软件包的文档.

build_runner命令可与构建器一起使用,这些构建 是使用Dart构建系统从输入文件生成输出文件的软件包. 例如, json_serializableBuilt_value_generator包定义了生成Dart代码的构建器.

尽管Dart构建系统是反射(存在性能问题)和宏(Dart的编译器不支持)和宏的很好的替代方案,但是它不仅可以读写Dart代码,还可以做更多的事情. 例如, sass_builder包实现,其产生的助洗剂.css从文件.scss.sass文件.

Setting up build_runner

要使用build_runner,增加开发依赖build_runner应用程式的pubspec:

  dev_dependencies:
    # ···
    build_runner: ^1.0.0
    build_test: ^0.10.3

取决于build_test是可选的; 如果要测试代码,请执行此操作.

在更改pubspec.yaml之后,照常运行pub getpub upgrade

$ pub get

Using built-in commands

如何使用build_runner命令取决于您使用的是Dart SDK还是Flutter SDK. 以下是使用build_runner build命令的示例:

$ # From a directory that contains a pubspec.yaml file:
$ pub run build_runner build  # Dart SDK
$ flutter pub run build_runner build  # Flutter SDK

build_runner软件包包括以下命令:

build
执行一次性构建.
serve
运行开发服务器. 您可以使用具有方便的默认行为的webdev serve而不是直接使用此命令.
test
Runs tests.
watch
启动构建服务器,该服务器监视输入文件的编辑. 通过执行增量重建来响应更改.

More information

如果您正在处理特定于Web的代码,请参见webdev页面.

有关使用build_runner的详细信息,请参见以下内容:

by  ICOPY.SITE