Skip to content

Document .NET 11 NU1703 warning for deprecated MonoAndroid package assets - #54108

Merged
gewarren merged 7 commits into
mainfrom
copilot/fix-nu1703-warning
Jun 15, 2026
Merged

Document .NET 11 NU1703 warning for deprecated MonoAndroid package assets#54108
gewarren merged 7 commits into
mainfrom
copilot/fix-nu1703-warning

Conversation

CopilotAI commented Jun 1, 2026

Copy link
Copy Markdown
Contributor

NuGet restore now emits NU1703 for Android projects that target .NET 11+ when package restore selects deprecated MonoAndroid assets, with behavior gated by SdkAnalysisLevel >= 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

    • Added docs/core/compatibility/sdk/11/nu1703-deprecated-monoandroid-framework.md.
    • Captures previous vs. new behavior, reason for change, recommended actions, and compatibility impact.
  • .NET 11 compatibility index

    • Updated docs/core/compatibility/11.md under SDK and MSBuild with a new NU1703 entry (Source incompatible).
  • Compatibility TOC

    • Updated docs/core/compatibility/toc.yml to include the new NU1703 article under .NET 11 > SDK and MSBuild.
  • Related SDK guidance

    • Updated docs/core/project-sdk/msbuild-props.md (SdkAnalysisLevel table) to point the NU1703 behavior to the new breaking-change article.
Package 'PackageName' 1.0.0 uses the deprecated MonoAndroid framework instead of 'net6.0-android' or later. Consider upgrading to a newer version of this package or contacting the package author.

Internal previews

📄 File🔗 Preview link
docs/core/compatibility/11.mdBreaking changes in .NET 11
docs/core/compatibility/sdk/11/nu1703-deprecated-monoandroid-framework.mdNU1703 warning for packages that use deprecated MonoAndroid framework assets
docs/core/compatibility/toc.ymldocs/core/compatibility/toc

CopilotAI review requested due to automatic review settings June 1, 2026 15:58
CopilotAI removed the request for review from CopilotJune 1, 2026 15:58
CopilotAI linked an issue Jun 1, 2026 that may be closed by this pull request
3 tasks
CopilotAI requested review from Copilot and removed request for CopilotJune 1, 2026 16:06
CopilotAI changed the title [WIP] Fix NU1703 warning for packages using deprecated MonoAndroid frameworkDocument .NET 11 NU1703 warning for deprecated MonoAndroid package assetsJun 1, 2026
CopilotAI requested a review from gewarrenJune 1, 2026 16:23
Comment threaddocs/core/compatibility/sdk/11/nu1703-deprecated-monoandroid-framework.md Outdated
Comment threaddocs/core/compatibility/sdk/11/nu1703-deprecated-monoandroid-framework.md Outdated
Comment threaddocs/core/compatibility/sdk/11/nu1703-deprecated-monoandroid-framework.md Outdated
Comment threaddocs/core/project-sdk/msbuild-props.md Outdated
Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
CopilotAI review requested due to automatic review settings June 1, 2026 16:32
@gewarren
gewarren marked this pull request as ready for review June 1, 2026 16:32
@gewarren
gewarren requested a review from a team as a code ownerJune 1, 2026 16:32
@gewarren
gewarren requested a review from sbomerJune 1, 2026 16:33

CopilotAI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

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.md updated 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.

FileDescription
docs/core/compatibility/sdk/11/nu1703-deprecated-monoandroid-framework.mdNew breaking-change article for NU1703 MonoAndroid deprecation.
docs/core/compatibility/11.mdAdds NU1703 entry to SDK and MSBuild table.
docs/core/compatibility/toc.ymlAdds TOC entry under .NET 11 > SDK and MSBuild.
docs/core/project-sdk/msbuild-props.mdRedirects NU1703 link in SdkAnalysisLevel table to the new article.

Comment threaddocs/core/project-sdk/msbuild-props.md Outdated

@wadepickettwadepickett left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Looks good overall. Approved. See my inline note on the line breaks. (minor item)

@adegeoadegeo left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

No request changes for you!

Comment threaddocs/core/compatibility/sdk/11/nu1703-deprecated-monoandroid-framework.md Outdated
Comment threaddocs/core/compatibility/sdk/11/nu1703-deprecated-monoandroid-framework.md Outdated
Comment threaddocs/core/compatibility/sdk/11/nu1703-deprecated-monoandroid-framework.md Outdated
Co-authored-by: Andy (Steve) De George <67293991+adegeo@users.noreply.github.com>
Co-authored-by: Wade Pickett <wpickett@microsoft.com>
@gewarren
gewarren enabled auto-merge (squash) June 10, 2026 20:37
@gewarren
gewarren merged commit 81e9c41 into mainJun 15, 2026
11 checks passed
@gewarren
gewarren deleted the copilot/fix-nu1703-warning branch June 15, 2026 19:23
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Breaking change]: NU1703 warning for packages using deprecated MonoAndroid framework

6 participants

@sbomer@wadepickett@gewarren@adegeo