Contents

webdev

本页说明如何使用webdev及其依赖的工具build_runner来构建,提供和测试Web应用程序. webdev软件包提供了webdev ,它包装了更通用的build_runner工具.

通常,您可以使用webdev而不是直接使用build_runner . 大多数Web应用程序开发人员唯一一次运行build_runner是进行测试.

Setup

获取webdev的最简单方法是全局安装它,以便它可以在您的PATH中. 在使用webdev之前,您的Web应用程序必须依赖于build_runner和build_web_compilers软件包.

Installing and updating webdev

使用pub 全局安装 webdev

$ pub global activate webdev

Use the same command to update webdev. We recommend updating webdev whenever you update your Dart SDK or when webdev commands unexpectedly fail.

Depending on build_* packages

要使用webdev或(在Web应用程序上下文中) build_runner ,您必须位于依赖于build_runnerbuild_web_compilers软件包的软件包的根目录中. 如果要测试应用程序,则它还必须依赖于build_test .

要依赖这些软件包,请将以下dev依赖项添加到应用程序的pubspec.yaml文件中:

  dev_dependencies:
    # ···
    build_runner: ^1.0.0
    build_test: ^0.10.2
    build_web_compilers: ^0.4.0

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

$ pub get

Using webdev and build_runner commands

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

webdev serve
运行开发服务器,该服务器持续构建Web应用程序.
webdev build
构建Web应用程序的可部署版本.
build_runner test
运行测试.

您可以使用构建配置文件来自定义构建. 有关详细信息,请参见build_web_compilers软件包.

webdev serve

要启动开发服务器,该服务器为您的应用提供服务并监视源代码更改,请使用以下命令:

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

默认情况下, webdev serve使用dartdevc编译您的应用程序,并在localhost:8080处提供该应用程序:

$ webdev serve  # uses dartdevc

最早的dartdevc构建速度最慢. 之后,资产被缓存在磁盘上,增量构建速度更快.

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

$ webdev serve --debug  # enables Dart DevTools

要使用dart2js而不是dartdevc,请添加--release标志:

$ webdev serve --release  # uses dart2js

您可以指定不同的目录端口配置. 例如,以下命令将测试端口从默认(8081)更改为8083:

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

webdev build

使用以下命令来构建您的应用程序:

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

默认情况下, build命令使用dart2js Web编译器创建应用程序的生产版本. 添加--no-release以使用dartdevc进行编译. 使用--output选项,您可以控制编译哪些顶级项目文件夹以及将输出写入何处.

例如,以下命令使用dart2js将项目的顶级web文件夹编译到build目录中:

$ webdev build --output web:build

build_runner test

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

$ pub run build_runner test [build_runner options] -- -p <platform> [test options]

例如,以下是运行所有Chrome平台测试的方法:

$ pub run build_runner test -- -p chrome

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

$ pub run build_runner test -h

--参数后面的参数直接传递给测试包运行器 . 要查看测试包运行器的所有命令行选项,请使用以下命令:

$ pub run test -h

More information

有关webdev选项的完整列表,请运行webdev --help或查看webdev软件包.

另请参阅以下页面:

by  ICOPY.SITE