トリミングのオプション
この記事で説明する MSBuild のプロパティと項目は、 トリミングされた自己完結型の展開の動作に影響します。 一部のオプションで示されている ILLink は、トリミングが実装されている、基になるツールの名前です。 基になるツールの詳細については、トリマーのドキュメントに関するページを参照してください。
PublishTrimmed を使用したトリミングは、.NET Core 3.0 で導入されました。 その他のオプションは、.NET 5 以降のバージョンで使用できます。
トリミングを有効にする
<PublishTrimmed>true</PublishTrimmed>発行時のトリミングを有効にします。 また、この設定により、トリムと互換性のない機能がオフになり、ビルド中に trim 分析 が有効になります。 .NET 8 以降のアプリでは、この設定により、構成バインドと要求デリゲート ソース ジェネレーターも有効になります。
Note
コマンド ラインからトリミングを有効に指定すると、デバッグ エクスペリエンスが異なり、最終製品で追加のバグが発生する可能性があります。
この設定をプロジェクト ファイルに配置して、設定が dotnet publish のみでなく、dotnet build 時にも適用されるようにします。
この設定により、既定ですべてのアセンブリのトリミングとトリミングが有効になります。 .NET 6 では、 [AssemblyMetadata("IsTrimmable", "True")] ( <IsTrimmable>true</IsTrimmable>を設定するプロジェクトで追加) によるトリミングをオプトインしたアセンブリのみが既定でトリミングされました。 <TrimMode>partial</TrimMode> を使用して前の動作に戻ることができます。
この設定によってトリミング互換の Roslyn アナライザーも有効になり、トリミングと互換性のない機能は無効になります。
トリミングの最小単位
トリミングの細分性を partial または full に設定するには、 TrimModeプロパティを使用します。 コンソール アプリ (および .NET 8 以降では Web SDK アプリ) の既定の設定は、full です。
<TrimMode>full</TrimMode>
トリミングをオプトインしたアセンブリのみをトリミングするには、プロパティを partial に設定します。
<TrimMode>partial</TrimMode>
トリミング モードを partial に変更した場合は、<TrimmableAssembly> MSBuild 項目を使用して個々のアセンブリのトリミングをオプトインできます。
<ItemGroup>
<TrimmableAssembly Include="MyAssembly" />
</ItemGroup>
これはアセンブリのビルド時に [AssemblyMetadata("IsTrimmable", "True")] を設定することと同じです。
ルート アセンブリ
アセンブリがトリミングされていない場合は、"rooted" と見なされます。つまり、アセンブリとその静的に認識されるすべての依存関係が保持されます。 追加のアセンブリは、名前によって "ルート化" できます ( .dll 拡張子は使用されません)。
<ItemGroup>
<TrimmerRootAssembly Include="MyAssembly" />
</ItemGroup>
ルート記述子
分析に対するルートを指定するもう 1 つの方法は、トリマーの記述子形式を使用する XML ファイルを使用することです。 これにより、アセンブリ全体ではなく、特定のメンバーをルートにすることができます。
<ItemGroup>
<TrimmerRootDescriptor Include="MyRoots.xml" />
</ItemGroup>
たとえば、 MyRoots.xml は、アプリケーションによって動的にアクセスされる特定のメソッドをルート化できます。
<linker>
<assembly fullname="MyAssembly">
<type fullname="MyAssembly.MyClass">
<method name="DynamicallyAccessedMethod" />
</type>
</assembly>
</linker>
分析の警告
<SuppressTrimAnalysisWarnings>false</SuppressTrimAnalysisWarnings>トリミング分析の警告を有効にします。
トリミングすると、静的に到達できない IL が削除されます。 リフレクションまたはその他のパターンを使用して動的な依存関係を作成するアプリは、トリミングによって破損する可能性があります。 そのようなパターンについて警告するには、<SuppressTrimAnalysisWarnings> を false に設定します。 この設定により、独自のコード、ライブラリ コード、フレームワーク コードなど、アプリ全体に関する警告が表示されます。
Roslyn アナライザー
.NET 6 以降で PublishTrimmed を設定すると、"制限された" 分析の警告セットを示す Roslyn アナライザーも有効になります。 また、アナライザーは、PublishTrimmed とは別に有効または無効にできます。
<EnableTrimAnalyzer>true</EnableTrimAnalyzer>トリム分析の警告のサブセットに対して Roslyn アナライザーを有効にします。
警告を表示しない
NoWarn、WarningsAsErrors、WarningsNotAsErrors、TreatWarningsAsErrors など、ツールチェーンによって適用される通常の MSBuild プロパティを使用して、個々の警告コードを抑制できます。 ILLink のエラーとしての警告動作を個別に制御する追加のオプションがあります。
<ILLinkTreatWarningsAsErrors>false</ILLinkTreatWarningsAsErrors>ILLink の警告をエラーとして扱いません。 これは、コンパイラの警告をエラーとしてグローバルに扱うときに、トリミング分析の警告をエラーに変えないようにする場合に役立ちます。
詳細な警告の表示
.NET 6 以降では、トリム分析によって、アセンブリの内部がトリムと互換性がないことを示す PackageReference からの警告が、アセンブリごとに最大で 1 つ生成されます。 すべてのアセンブリの個別の警告を表示することもできます。
<TrimmerSingleWarn>false</TrimmerSingleWarn>アセンブリごとに 1 つの警告に折りたたむのではなく、すべての詳細な警告を表示します。
シンボルの削除
通常、シンボルは、トリミングされたアセンブリと一致するようにトリミングされます。 すべてのシンボルを削除することもできます。
<TrimmerRemoveSymbols>true</TrimmerRemoveSymbols>埋め込み PDB や別の PDB ファイルなど、トリミングされたアプリケーションからシンボルを削除します。 これは、アプリケーションのコードと、シンボルに付属するすべての依存関係の両方に適用されます。
また、SDK では、DebuggerSupport プロパティを使用してデバッガーのサポートを無効にすることもできます。 デバッガーのサポートを無効にすると、トリミングによってシンボルが自動的に削除されます (TrimmerRemoveSymbols は既定で true になります)。
フレームワーク ライブラリの機能をトリミングする
フレームワーク ライブラリのいくつかの機能領域には、トリマー ディレクティブが付属しています。これにより、無効な機能のコードを削除できます。
| MSBuild のプロパティ | 説明 |
|---|---|
AutoreleasePoolSupport |
falseに設定すると、サポートされているプラットフォームでautorelease プールを作成するコードが削除されます。 false は .NET SDK の既定値です。 |
DebuggerSupport |
falseに設定すると、デバッグ エクスペリエンスを向上させるコードが削除されます。 この設定では、シンボルも削除されます。 |
EnableUnsafeBinaryFormatterSerialization |
falseに設定すると、BinaryFormatter シリアル化のサポートが削除されます。 詳細については、「BinaryFormatter シリアル化メソッドは廃止されていますIn-box BinaryFormatter の実装は削除され、常にスローされるを参照してください。 |
EnableUnsafeUTF7Encoding |
falseに設定すると、安全でない UTF-7 エンコード コードが削除されます。 詳細については、「UTF-7 コード パスが古い形式に」を参照してください。 |
EventSourceSupport |
falseに設定すると、EventSource 関連のコードとロジックが削除されます。 |
HttpActivityPropagationSupport |
falseに設定すると、System.Net.Httpの診断サポートに関連するコードが削除されます。 |
InvariantGlobalization |
trueに設定すると、グローバリゼーション固有のコードとデータが削除されます。 詳細については、「インバリアント モード」を参照してください。 |
MetadataUpdaterSupport |
falseに設定すると、ホット リロードに関連するメタデータ更新固有のロジックが削除されます。 |
MetricsSupport |
falseに設定すると、System.Diagnostics.Metricsインストルメンテーションのサポートが削除されます。 |
StackTraceSupport (.NET 8+) |
falseに設定すると、ランタイムによるスタック トレースの生成 (Environment.StackTraceやException.ToStringなど) のサポートが削除されます。 スタック トレース文字列から削除される情報の量は、他のデプロイ オプションによって異なります。 このオプションは、デバッガーによって生成されるスタック トレースには影響しません。 |
UseNativeHttpHandler |
trueに設定すると、Android および iOS 用の HttpMessageHandler の既定のプラットフォーム実装が使用され、マネージド実装が削除されます。 |
UseSystemResourceKeys |
trueに設定すると、System.* アセンブリの例外メッセージが削除されます。 System.* アセンブリから例外がスローされた場合、メッセージは完全なメッセージではなく、簡略化されたリソース ID になります。 |
XmlResolverIsNetworkingEnabledByDefault (.NET 8+) |
falseに設定すると、System.Xmlのファイル以外の URL を解決するためのサポートが削除されます。 ファイル システムの解決のみがサポートされています。 |
これらのプロパティを使用すると、関連するコードがトリミングされ、runtimeconfig ファイルを介して機能も無効になります。 対応する runtimeconfig オプションなど、これらのプロパティの詳細については、機能スイッチに関するページを参照してください。 一部の SDK には、これらのプロパティの既定値が設定されている場合があります。
トリミング時に無効になっているフレームワーク機能
次の機能は、静的に参照されないコードを必要とするため、トリミングと互換性がありません。 トリミングされたアプリでは、これらの機能は既定で無効になっています。
警告
これらの機能は、ご自身の責任において有効にしてください。 追加の作業を行わない場合、動的に参照されるコードを保持するために、トリミングされたアプリが破損する可能性があります。
<BuiltInComInteropSupport>組み込みの COM サポートは無効です。
<CustomResourceTypesSupport>カスタム リソースの種類の使用はサポートされていません。 カスタム リソースの種類にリフレクションを使用する ResourceManager コード パスはトリミングされます。
<EnableCppCLIHostActivation>C++/CLI ホストのアクティブ化は無効です。
<EnableUnsafeBinaryFormatterInDesigntimeLicenseContextSerialization>DesigntimeLicenseContextSerializer の
BinaryFormatterのシリアル化は無効です。<StartupHookSupport>DOTNET_STARTUP_HOOKSでMainする前のコードの実行はサポートされていません。 詳細については、スタートアップ フックのホストに関するページをご覧ください。
.NET