Document .NET 11 NU1703 warning for deprecated MonoAndroid package assets#54108
Open
Copilot wants to merge 5 commits into
Open
Document .NET 11 NU1703 warning for deprecated MonoAndroid package assets#54108Copilot wants to merge 5 commits into
Copilot wants to merge 5 commits into
Conversation
3 tasks
Copilot
AI
changed the title
[WIP] Fix NU1703 warning for packages using deprecated MonoAndroid framework
Document .NET 11 NU1703 warning for deprecated MonoAndroid package assets
Jun 1, 2026
gewarren
approved these changes
Jun 1, 2026
Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
Pull request overview
Documents a new .NET 11 breaking change: NuGet restore emits NU1703 when Android projects targeting .NET 11+ (with SdkAnalysisLevel >= 11.0.100) resolve deprecated MonoAndroid package assets. The new article is wired into the .NET 11 compatibility index, the compatibility TOC, and referenced from the SdkAnalysisLevel table in the SDK project properties doc.
Changes:
- New breaking-change article describing previous/new behavior, reason, recommended action, and opt-out via
SdkAnalysisLevel. - TOC and .NET 11 compatibility index entries added for the new article.
msbuild-props.mdupdated so the NU1703 row links to the new article instead of the generic NuGet error reference.
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
| docs/core/compatibility/sdk/11/nu1703-deprecated-monoandroid-framework.md | New breaking-change article for NU1703 MonoAndroid deprecation. |
| docs/core/compatibility/11.md | Adds NU1703 entry to SDK and MSBuild table. |
| docs/core/compatibility/toc.yml | Adds TOC entry under .NET 11 > SDK and MSBuild. |
| docs/core/project-sdk/msbuild-props.md | Redirects NU1703 link in SdkAnalysisLevel table to the new article. |
sbomer
reviewed
Jun 1, 2026
| | 10.0.300 | 'Restore' multi-targeting with duplicate target frameworks | Enables [multi-targeting with duplicate target frameworks](/nuget/consume-packages/package-references-in-project-files#multi-targeting-with-duplicate-frameworks) using `TargetFramework` alias. | | ||
| | 10.0.300 | `TargetFramework` character validation | Emits [NU1019](/nuget/reference/errors-and-warnings/nu1019) error for path separator characters (`/` or `\`) in a `TargetFramework` property, and [NU1019](/nuget/reference/errors-and-warnings/nu1019) warning for non-ASCII characters. | | ||
| | 11.0.100 | MonoAndroid framework deprecation warning | Emits [NU1703](/nuget/reference/errors-and-warnings/nu1703) warning when a package uses the deprecated `MonoAndroid` framework instead of a modern .NET target framework moniker. | | ||
| | 11.0.100 | MonoAndroid framework deprecation warning | Emits [NU1703](../compatibility/sdk/11/nu1703-deprecated-monoandroid-framework.md) warning when a package uses the deprecated `MonoAndroid` framework instead of a modern .NET target framework moniker. | |
Member
There was a problem hiding this comment.
There's already NuGet/docs.microsoft.com-nuget#3542 - do we need a new doc in dotnet/docs? Most of the other links here point to nuget docs.
Contributor
There was a problem hiding this comment.
Suggested change
| | 11.0.100 | MonoAndroid framework deprecation warning | Emits [NU1703](../compatibility/sdk/11/nu1703-deprecated-monoandroid-framework.md) warning when a package uses the deprecated `MonoAndroid` framework instead of a modern .NET target framework moniker. | | |
| | 11.0.100 | MonoAndroid framework deprecation warning | Emits [NU1703](/nuget/reference/errors-and-warnings/nu1703) warning when a package uses the deprecated `MonoAndroid` framework instead of a modern .NET target framework moniker. | |
Contributor
There was a problem hiding this comment.
I didn't notice that CCA changed the link. It should link out to the warning reference like it did previously.
The new doc in this repo is a breaking change reference, not a warning reference, so I think it is needed. Do you not normally document breaking changes for new NuGet warnings?
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
NuGet restore now emits NU1703 for Android projects that target .NET 11+ when package restore selects deprecated
MonoAndroidassets, with behavior gated bySdkAnalysisLevel >= 11.0.100. This PR adds the .NET 11 breaking-change documentation and links it from the relevant compatibility and SDK guidance surfaces.Breaking change article
docs/core/compatibility/sdk/11/nu1703-deprecated-monoandroid-framework.md..NET 11 compatibility index
docs/core/compatibility/11.mdunder SDK and MSBuild with a new NU1703 entry (Source incompatible).Compatibility TOC
docs/core/compatibility/toc.ymlto include the new NU1703 article under .NET 11 > SDK and MSBuild.Related SDK guidance
docs/core/project-sdk/msbuild-props.md(SdkAnalysisLeveltable) to point the NU1703 behavior to the new breaking-change article.Internal previews