Skip to content

Add multi-targeting sections to trimming and AOT documentation #50076

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Copilot wants to merge 13 commits into
base: main
Choose a base branch
from
Open

Add multi-targeting sections to trimming and AOT documentation #50076

Changes from 6 commits
Commits
Show all changes
13 commits
Select commit Hold shift + click to select a range
70998cf
Initial plan
Copilot Nov 20, 2025
fc488dc
Add multi-targeting section to trimming documentation
Copilot Nov 20, 2025
760f715
Update ms.date metadata for document changes
Copilot Nov 20, 2025
14d335c
Simplify multi-targeting section per review feedback
Copilot Dec 2, 2025
8621761
Clarify multi-targeting recommendation to avoid TFM gaps
Copilot Dec 2, 2025
78f6612
Add multi-targeting note for IsAotCompatible
Copilot Dec 2, 2025
0777ac1
Move IsAotCompatible multi-targeting guidance to AOT docs
Copilot Dec 2, 2025
e033ba5
Update AOT docs and SDK errors to use net8.0 for AOT, net6.0 for trim…
Copilot Dec 2, 2025
c12765b
Recommend including latest .NET version for latest analyzer
Copilot Dec 4, 2025
a46728e
Use net10.0 as latest .NET version in examples
Copilot Dec 4, 2025
426364d
Apply suggestions from code review
sbomer Dec 10, 2025
603021d
Add Oxford commas to framework lists
Copilot Dec 10, 2025
2e62823
Break up long sentences for better readability
Copilot Dec 10, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 15 additions & 2 deletions docs/core/deploying/trimming/prepare-libraries-for-trimming.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Prepare .NET libraries for trimming
description: Learn how to prepare .NET libraries for trimming.
author: sbomer
ms.author: svbomer
ms.date: 06/12/2023
ms.date: 11/20/2025
---

# Prepare .NET libraries for trimming
Expand Down Expand Up @@ -37,7 +37,7 @@ Setting the MSBuild property `IsTrimmable` to `true` marks the assembly as "trim
* Is considered compatible with trimming.
* Shouldn't generate trim-related warnings when building. When used in a trimmed app, the assembly has its unused members trimmed in the final output.

The `IsTrimmable` property defaults to `true` when configuring a project as AOT-compatible with `<IsAotCompatible>true</IsAotCompatible>`. For more information, see [AOT-compatibility analyzers](../native-aot/index.md#aot-compatibility-analyzers).
The `IsTrimmable` property defaults to `true` when configuring a project as AOT-compatible with `<IsAotCompatible>true</IsAotCompatible>`. For more information, see [AOT-compatibility analyzers](../native-aot/index.md#aot-compatibility-analyzers). When using `IsAotCompatible` in a multi-targeted project, apply the same multi-targeting guidance as for `IsTrimmable` (see [Multi-targeting for trimming](#multi-targeting-for-trimming)).

To generate trim warnings without marking the project as trim-compatible, use `<EnableTrimAnalyzer>true</EnableTrimAnalyzer>` rather than `<IsTrimmable>true</IsTrimmable>`.

Expand Down Expand Up @@ -90,6 +90,19 @@ Follow the preceding pattern for multiple libraries. To see trim analysis warnin
* Even if there were no API changes.
* Introducing trim analysis warnings is a breaking change when the library is used with `PublishTrimmed`.

## Multi-targeting for trimming

When preparing libraries for trimming, if your library targets any framework earlier than `net6.0` (such as `netstandard2.0` or `net472`), you should also multi-target to `net6.0` to ensure that apps targeting `net6.0` or above get a version of your library that supports the trim analyzer. Use the `IsTargetFrameworkCompatible` MSBuild function to conditionally enable `IsTrimmable` for `net6.0` and above:

```xml
<PropertyGroup>
<TargetFrameworks>netstandard2.0;net6.0</TargetFrameworks>
<IsTrimmable Condition="$([MSBuild]::IsTargetFrameworkCompatible('$(TargetFramework)', 'net6.0'))">true</IsTrimmable>
</PropertyGroup>
```

For more information, see [Trimming may not be used with .NET Standard or .NET Framework](../../compatibility/sdk/8.0/trimming-unsupported-targetframework.md).

## Resolve trim warnings

The preceding steps produce warnings about code that might cause problems when used in a trimmed app. The following examples show the most common warnings with recommendations for fixing them.
Expand Down