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  # 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 包。

另请参阅以下页面

除非另有说明，否则本网站上的文档反映了 Dart 3.7.1 版本。页面上次更新于 2024-12-11。查看源代码或报告问题。

设置