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 指定編譯器選項的示例。