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.12
    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.5.3。页面上次更新于 2024-09-16。查看源代码或报告问题。

设置