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にも依存している必要があります。

これらのパッケージに依存するには、アプリのpubspec.yamlファイルに次のdev_dependenciesを追加します。

  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)の2つの方法でコンパイルできます。

開発コンパイラは、増分更新をサポートし、Asynchronous Module Definition (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コンパイラを使用して、アプリの本番バージョンを作成します。開発JavaScriptコンパイラでコンパイルするには、--no-releaseを追加します。--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パッケージランナーに直接渡します。テストパッケージランナーのすべてのコマンドラインオプションを表示するには、次のコマンドを使用します。

$ dart test -h

webdevオプションの完全なリストについては、webdev --helpを実行するか、webdevパッケージを参照してください。

次のページも参照してください。

• build_runner: build_runnerとその組み込みコマンドを紹介し、詳細情報を指摘します。
• build_web_compilers: dart2js_argsを使用してコンパイラオプションを指定する例を使用して、ビルド構成に関する情報を提供します。

特に明記されていない限り、このサイトのドキュメントは Dart 3.5.3 を反映しています。ページの最終更新日は 2024-09-16 です。 ソースを表示または問題を報告。