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 文件中：

yaml  dev_dependencies:
    # ···
    build_runner: ^2.4.13
    build_test: ^2.2.2
    build_web_compilers: ^4.0.11

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

$ dart pub get

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

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

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

生产编译器会生成单个压缩的 JavaScript 文件。

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

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

要服务你的 Web 应用的开发版本，请运行以下命令。

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

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

$ webdev serve

第一次 webdev serve 编译速度较慢。第一次编译后，它会将资源缓存到磁盘上。这使得以后的构建编译速度更快。

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

$ webdev serve --debug  # 启用 Dart DevTools

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

$ webdev serve --release  # 使用生产编译器

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

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

$ webdev serve web test:8083 # 应用：8080；测试：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 包。

另请参阅以下页面：

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

设置