webdev

本页解释了如何使用 webdev 编译您的应用以及使用 build_runner 测试您的应用。

按照这些说明开始使用 webdev。

在使用 webdev 之前，请将 build_runner 和 build_web_compilers 软件包的依赖项添加到您的应用中。build_runner 软件包为 webdev 添加了脚本能力。

dart pub add build_runner build_web_compilers --dev

使用 dart pub 为所有用户安装 webdev。

dart pub global activate webdev

使用相同的命令更新 webdev。当您更新 Dart SDK 或 webdev 命令出现无法解释的失败时，请更新 webdev。

要使用 webdev，您必须位于依赖于 build_runner 和 build_web_compilers 软件包的软件包的根目录中。如果您正在测试应用，它还必须依赖于 build_test。

要依赖这些软件包，请将以下开发依赖项（dev_dependencies）添加到应用的 pubspec.yaml 文件中

  dev_dependencies:
    # ···
    build_runner: ^2.4.15
    build_test: ^2.2.3
    build_web_compilers: ^4.1.5

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

dart pub get

此工具可以通过两种方式进行编译：一种使调试更容易（serve）和一种生成小巧快速的代码（build）。

开发编译器支持增量更新并生成异步模块定义 (AMD) 模块。使用webdev serve，您可以编辑 Dart 文件，在 Chrome 中刷新，并很快看到您的编辑效果。这种速度来自于编译更新的模块，而不是应用所需的所有软件包。

首次编译时间最长，因为它编译整个应用。在 serve 命令运行期间，后续构建应该编译得更快。

生产编译器生成一个单一的、经过压缩的 JavaScript 文件。

本节介绍如何使用以下命令

webdev serve

运行一个开发服务器，持续构建 JavaScript 应用。

webdev build

构建可部署的 JavaScript 应用版本。

build_runner test

运行测试。

您可以使用构建配置文件自定义您的构建。要了解更多关于构建配置文件的信息，请参阅 build_web_compilers 软件包。

要提供您的 Web 应用的开发版本，请运行以下命令。

$ webdev serve [--debug | --release] [ [<directory>[:<port>]] ... ]

此命令启动一个开发服务器，该服务器提供您的应用并监视源代码更改。默认情况下，此命令在 localhost:8080 提供应用。

webdev serve

首次运行 webdev serve 编译较慢。首次编译后，它会在磁盘上缓存资产。这使得后续构建编译更快。

要启用Dart DevTools，请添加 --debug 标志

webdev serve --debug  # enables Dart DevTools

要使用生产编译器而非开发编译器，请添加 --release 标志

webdev serve --release  # uses production compiler

您可以指定不同的目录-端口配置。

例如，以下命令将测试端口从默认值 (8081) 更改为 8083

webdev serve web test:8083 # App: 8080; tests: 8083

使用以下命令构建您的应用

$ webdev build [--no-release] --output [<dirname>:]<dirname>

默认情况下，build 命令使用生产 JavaScript 编译器创建应用的生产版本。添加 --no-release 以使用开发 JavaScript 编译器进行编译。使用 --output 选项控制 Dart 编译顶级项目文件夹并将输出写入何处。

以下命令展示了如何将项目的顶级 web 文件夹编译到 build 目录中。此命令默认使用生产 JavaScript 编译器。

webdev build --output web:build

使用 build_runner test 命令运行您的应用的组件测试

dart run build_runner test [build_runner options] -- -p <platform> [test options]

例如，这里是如何运行所有 Chrome 平台测试

dart run build_runner test -- -p chrome

要查看所有可用的 build_runner 选项，请使用 --help 或 -h 选项

dart run build_runner test -h

Dart 将空 -- 参数之后的参数直接传递给 test 软件包运行器。要查看 test 软件包运行器的所有命令行选项，请使用此命令

dart test -h

有关 webdev 选项的完整列表，请运行 webdev --help 或参阅 webdev 软件包。

另请参阅以下页面

• build_runner: 介绍 build_runner 及其内置命令，并提供更多信息链接。
• build_web_compilers: 包含有关配置构建的信息，并提供一个使用 dart2js_args 指定编译器选项的示例。