ASP.NET Core Blazor 用のトリマーを構成する

この記事では、Blazor アプリを構築するときに、中間言語 (IL) リンカー (トリマー) を制御する方法について説明します。

Blazor WebAssembly では、発行された出力のサイズを縮小するために、中間言語 (IL) トリミングが実行されます。 既定では、トリミングはアプリの発行時に行われます。

トリミングは好ましくない効果を与える場合があります。 リフレクションを使用するアプリの場合、実行時にリフレクションに必要な型がトリマーでは判断できないことがしばしばあります。 リフレクションを使用するアプリをトリミングするには、アプリのコードと、アプリが依存するパッケージまたはフレームワークの両方で、リフレクションに必要な型をトリマーに通知する必要があります。 実行時にアプリの動的な動作に反応することもトリマーはできません。 展開後、トリミングされたアプリが確実に正しく機能するよう、発行された出力を開発中に頻繁にテストしてください。

トリマーを構成するには、.NET の基礎ドキュメントのトリミング オプションに関する記事を参照してください。次の項目に関するガイダンスが含まれています。

  • プロジェクト ファイルの <PublishTrimmed> プロパティを使用し、アプリ全体のトリミングを無効にします。
  • 使用されていない IL をトリマーによって破棄する積極度を制御します。
  • 特定のアセンブリのトリミングをトリマーに禁止します。
  • トリミング用の "ルート" アセンブリ。
  • プロジェクト ファイルで <SuppressTrimAnalysisWarnings> プロパティを false に設定することで、リフレクションされた型の警告を表示します。
  • シンボル トリミングとデバッガー サポートを制御します。
  • フレームワーク ライブラリ機能をトリミングするためのトリマー機能を設定します。

その他のリソース

Blazor WebAssembly では、発行された出力のサイズを縮小するために、中間言語 (IL) トリミングが実行されます。 既定では、トリミングはアプリの発行時に行われます。

トリミングは好ましくない効果を与える場合があります。 リフレクションを使用するアプリの場合、実行時にリフレクションに必要な型がトリマーでは判断できないことがしばしばあります。 リフレクションを使用するアプリをトリミングするには、アプリのコードと、アプリが依存するパッケージまたはフレームワークの両方で、リフレクションに必要な型をトリマーに通知する必要があります。 実行時にアプリの動的な動作に反応することもトリマーはできません。 展開後、トリミングされたアプリが確実に正しく機能するよう、発行された出力を開発中に頻繁にテストしてください。

トリマーを構成するには、.NET の基礎ドキュメントのトリミング オプションに関する記事を参照してください。次の項目に関するガイダンスが含まれています。

  • プロジェクト ファイルの <PublishTrimmed> プロパティを使用し、アプリ全体のトリミングを無効にします。
  • 使用されていない IL をトリマーによって破棄する積極度を制御します。
  • 特定のアセンブリのトリミングをトリマーに禁止します。
  • トリミング用の "ルート" アセンブリ。
  • プロジェクト ファイルで <SuppressTrimAnalysisWarnings> プロパティを false に設定することで、リフレクションされた型の警告を表示します。
  • シンボル トリミングとデバッガー サポートを制御します。
  • フレームワーク ライブラリ機能をトリミングするためのトリマー機能を設定します。

その他のリソース