build_runner

build_runner 套件提供用於產生檔案的通用命令，包括測試產生的檔案或提供原始碼和產生的檔案。本頁說明如何使用 build_runner。若要瞭解如何搭配特定套件使用 build_runner，請參閱該套件的文件。

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

雖然 Dart 建置系統是反射 (有效能問題) 和巨集 (Dart 編譯器不支援) 的良好替代方案，但它不僅可以讀取和寫入 Dart 程式碼。例如，sass_builder 套件實作了一個 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 入門
  • Build 常見問題

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