Document .NET 10 breaking change: portable Windows RIDs required

[Copilot]

Update Windows deployment docs for .NET 10 RuntimeIdentifier change

All changes completed:

• [x] Research the .NET 10 RuntimeIdentifier breaking change
• [x] Identify affected documentation files
• [x] Add moniker ranges for .NET 10 content in publish-cli.md
• [x] Add moniker ranges for .NET 10 content in publish-unpackaged-cli.md
• [x] Update RuntimeIdentifier examples from win10-x64/win10-x86 to win-x64/win-x86 for .NET 10
• [x] Update table and command examples to use portable RIDs for .NET 10
• [x] Add note about the breaking change with reference links
• [x] Update ms.date metadata to reflect current date
• [x] Request code review - No issues found
• [x] Run CodeQL security check - No security issues (documentation changes only)
• [x] Address PR feedback - Updated to use generic "Visual Studio" instead of "VS 2022"

Breaking Change:

Starting with .NET 10, version-specific Windows RuntimeIdentifiers such as win10-x64 and win10-x86 are no longer recognized by the .NET SDK. The .NET SDK now requires portable Windows RIDs such as win-x64 and win-x86.

This causes build errors like NETSDK1083: The specified RuntimeIdentifier "win10-x64" is not recognized during restore or publish operations.

Files Updated:

• docs/windows/deployment/publish-cli.md - Added .NET 10 moniker sections with updated portable RIDs (win-x64/win-x86)
• docs/windows/deployment/publish-unpackaged-cli.md - Added .NET 10 moniker sections with updated portable RIDs (win-x64/win-x86)

Documentation Structure:

• Used moniker ranges to preserve .NET 9 and earlier content with win10-x64 RIDs
• Added separate .NET 10 sections with win-x64 portable RIDs
• Added IMPORTANT callout explaining the breaking change
• Included links to official Microsoft documentation for RID catalog and NETSDK1083 error
• Updated Visual Studio references to be version-agnostic

References:

• NETSDK1083 Error Documentation
• .NET Runtime Identifier (RID) catalog
• WindowsAppSDK Issue #3337

Fixes #3172

Original prompt

---

This section details on the original issue you should resolve

<issue_title>NET 10 MAUI WinUI: win10-x64 RuntimeIdentifier no longer supported</issue_title> <issue_description>### Type of issue

Outdated article

Description

Starting with .NET 10, version-specific Windows RuntimeIdentifiers such as win10-x64 and win10-x86 are no longer recognized by the .NET SDK when building MAUI / WinUI projects (net10.0-windows10.0.19041.0).

The .NET SDK now requires portable Windows RIDs such as win-x64 and win-x86, which is a breaking change compared to earlier .NET versions.

This behavior is not clearly documented in the .NET 10 MAUI / WinUI documentation, leading to build errors such as NETSDK1083 during restore or publish.

[Enter feedback here]

Page URL

https://learn.microsoft.com/en-us/dotnet/maui/windows/deployment/publish-cli?view=net-maui-10.0

Content source URL

https://github.com/dotnet/docs-maui/blob/main/docs/windows/deployment/publish-cli.md

Document Version Independent Id

d0d904f8-2ff9-df92-6399-dc2ac35310b7

Platform Id

41489e13-7b7f-563d-b444-793b41a9748a

Article author

@davidortinau

Metadata

• ID: d0d904f8-2ff9-df92-6399-dc2ac35310b7
• PlatformId: 41489e13-7b7f-563d-b444-793b41a9748a
• Service: dotnet-mobile
• Sub-service: dotnet-maui

Related Issues</issue_description>

<agent_instructions>Make sure to do online research to see if this is correct, link to a relevant place if you can</agent_instructions>

Comments on the Issue (you are @copilot in this section)

• Fixes dotnet/docs-maui#3172

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

---

Internal previews

📄 File	🔗 Preview link
docs/windows/deployment/publish-cli.md	docs/windows/deployment/publish-cli
docs/windows/deployment/publish-unpackaged-cli.md	docs/windows/deployment/publish-unpackaged-cli