Blazor: 静的な Web アセットの検証ロジックの更新

  • [アーティクル]

ASP.NET Core 3.1 と Blazor WebAssembly 3.2 の静的な Web アセットの競合の検証で問題が発生しました。 問題は次のとおりです。

  • ホストのアセットと、Razor クラスライブラリ (RCL) および Blazor WebAssembly アプリからのアセット間の適切な競合検出が阻止されました。
  • ほとんどの場合、Blazor WebAssembly アプリに影響します。既定では、RCL の静的な Web 資産は _content/$(PackageId) プレフィックス付きで提供されるためです。

導入されたバージョン

5.0

以前の動作

開発中、RCL の静的な Web アセットは、同じホスト パス上にあるホスト プロジェクトのアセットで警告なしでオーバーライドされる可能性があります。 /folder/file.txt で提供される静的な Web アセットを定義した RCL を考えてみましょう。 ホストによって wwwroot/folder/file.txt にファイルが配置された場合、RCL または Blazor WebAssembly アプリ上のファイルがこのサーバー上のファイルで警告なしでオーバーライドされます。

新しい動作

この問題が発生すると、ASP.NET Core によって正しく検出されます。 適切な操作を実行できるように、競合があることがユーザーに通知されます。

変更理由

静的 Web アセットは、プロジェクトの wwwroot ホスト上のファイルによってオーバーライド可能なものとは想定されていませんでした。 これらのファイルをオーバーライドできるようにすると、診断が困難なエラーが発生するおそれがあります。 結果として、発行されたアプリで未定義の動作変更が発生する可能性があります。

既定では、RCL ファイルがホスト上のファイルと競合する理由はありません。 RCL ファイルには _content/${PackageId} がプレフィックスとして付けられます。 Blazor WebAssembly ファイルはホストの URL 空間のルートに配置されるため、競合が起きやすくなります。 たとえば、Blazor WebAssembly アプリには favicon.ico ファイルが含まれており、これはホストもその wwwroot フォルダーに配置している場合があります。

競合のソースが RCL ファイルの場合、多くの場合、コードによってライブラリからプロジェクトの wwwroot フォルダーにアセットがコピーされていることを意味します。 ファイルをコピーするコードを記述することにより、静的な Web 資産の主な目的が損なわれます。 この目的は、新しいコンパイルをトリガーすることなくコンテンツが更新されるときに、ブラウザーで更新プログラムを取得するための基本となります。

この動作を維持し、ホスト上のファイルを維持することを選択できます。 これを行うには、カスタム MSBuild ターゲットを使用して静的 Web アセットの一覧からそのファイルを削除します。

ホスト プロジェクトのファイルではなく、RCL のファイルまたは Blazor WebAssembly アプリのファイルを使用するには、ホスト プロジェクトからそのファイルを削除します。

影響を受ける API

なし