Skip to content

Document NETSDK1195 #35655

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.

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

Merged
merged 4 commits into from
Jun 6, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
1 change: 1 addition & 0 deletions docs/core/tools/sdk-errors/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -339,3 +339,4 @@ This is a complete list of the errors that you might get from the .NET SDK while
|NETSDK1190|To use '{0}' in solution projects, you must set the environment variable '{1}' (to true). This will increase the time to complete the operation.|
|NETSDK1191|A runtime identifier for the property '{0}' couldn't be inferred. Specify a rid explicitly.|
|NETSDK1192|Targeting .NET 7.0 or higher in Visual Studio 2022 17.3 is not supported.|
|[NETSDK1195](netsdk1195.md)|Trimming, or code compatibility analysis for trimming, single-file deployment, or ahead-of-time compilation is not supported for the target framework. For more information, see <https://aka.ms/netsdk1195>|
18 changes: 18 additions & 0 deletions docs/core/tools/sdk-errors/netsdk1195.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
---
title: "NETSDK1195: Trimming, or code compatibility analysis for trimming, single-file deployment, or ahead-of-time compilation is not supported for the target framework."
description: How to resolve compatibility problems with features that rely on the ILLink pack.
ms.topic: error-reference
ms.date: 06/05/2023
f1_keywords:
- NETSDK1195
---
# NETSDK1195: Trimming, or code compatibility analysis for trimming, single-file deployment, or ahead-of-time compilation is not supported for the target framework.

NETSDK1195 indicates that you're using a feature of the SDK which is not available for the selected target framework. The following features depend on the ILLink pack, which is only available when targeting `netcoreapp3.0` and above:

- Trimming (via `PublishTrimmed` or `PublishAot`)
- Trim analysis (via `PublishTrimmed`, `PublishAot`, `IsTrimmable`, `IsAotCompatible`, or `EnableTrimAnalyzer`)
- Single-file analysis (via `PublishSingleFile` or `EnableSingleFileAnalyzer`)
- Ahead-of-time compilation analysis (via `PublishAot` or `EnableAotAnalyzer`)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This might give the false impression that AOT analysis will work on netcoreapp3.0 - maybe we should mention that this is only really supported on net7.0 and above.

Which leads me to another question: Maybe we should issue this warning when somebody targets net6.0 and sets PublishAot for example. Or maybe we should have a similar warning for AOT. It's basically the same story as for trimming and netstandard2.0. It won't do anything but it will provide false "hope" that the app doesn't have AOT incompatibilities.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is a separate error about the ILCompiler pack - if you try PublishAot on net6.0 it'll say:

error NETSDK1183: Ahead-of-time compilation is not supported for the target framework.

See dotnet/sdk#32943 which made this error more specific.


To resolve this error, either target a supported `TargetFramework`, or turn off the setting that requires the ILLink pack.
2 changes: 2 additions & 0 deletions docs/navigate/tools-diagnostics/toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -71,6 +71,8 @@ items:
href: ../../core/tools/sdk-errors/netsdk1174.md
- name: NETSDK1182
href: ../../core/tools/sdk-errors/netsdk1182.md
- name: NETSDK1195
href: ../../core/tools/sdk-errors/netsdk1195.md
- name: .NET CLI
items:
- name: Overview
Expand Down