build_runner

build_runner 套件提供了產生檔案的通用命令，包括測試產生的檔案或服務來源檔案和產生的檔案。本頁說明如何使用 build_runner。若要了解如何將 build_runner 與特定套件搭配使用，請參閱該套件的文件。

build_runner 命令與建置器搭配使用—建置器是使用 Dart 建置系統從輸入檔案產生輸出檔案的套件。例如，json_serializable 和 built_value_generator 套件定義了產生 Dart 程式碼的建置器。

雖然 Dart 建置系統是反射（具有效能問題）和巨集（Dart 編譯器不支援）的良好替代方案，但它不僅可以讀取和寫入 Dart 程式碼。例如，sass_builder 套件實作了一個建置器，可從 .scss 和 .sass 檔案產生 .css 檔案。

若要使用 build_runner，請將 build_runner 的 開發相依性新增至您應用程式的 pubspec

dev_dependencies:
  # ···
  build_runner: ^2.4.13
  build_test: ^2.2.2

相依於 build_test 是可選的；如果您要測試程式碼，請執行此動作。

和往常一樣，在 pubspec.yaml 變更後，執行 dart pub get 或 dart pub upgrade

$ dart pub get

以下是使用 build_runner build 命令的範例

$ # From a directory that contains a pubspec.yaml file:
$ dart run build_runner build

build_runner 套件包含下列命令

build

執行一次性建置。

serve

執行開發伺服器。您可以改用 webdev serve，其具有方便的預設行為，而不是直接使用此命令。

test

執行測試。

watch

啟動建置伺服器，該伺服器會監看輸入檔案的編輯。透過執行增量重建來回應變更。

如果您正在處理 Web 特定的程式碼，請參閱 webdev 頁面。

如需使用 build_runner 的詳細資訊，請參閱下列內容

• 需要您使用 build_runner 的套件的文件。這些套件通常具有 build 或 build_runner 的相依性。
• Build_runner 文件
  • build_runner 入門
  • 建置常見問題

除非另有說明，否則本網站上的文件反映了 Dart 3.6.0。頁面最後更新於 2024-12-11。 檢視原始碼 或 回報問題。