Skip to content

Document .NET 10 SDK version requirements breaking change#48923

Merged
gewarren merged 5 commits intomainfrom
copilot/fix-684c4c82-e5a8-4c24-83ca-562fa40a323e
Oct 14, 2025
Merged

Document .NET 10 SDK version requirements breaking change#48923
gewarren merged 5 commits intomainfrom
copilot/fix-684c4c82-e5a8-4c24-83ca-562fa40a323e

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Oct 6, 2025 •
edited by github-actions bot
Loading

Summary

This PR documents the breaking change for .NET 10 SDK version requirements, addressing issue #494516.

Changes

New Breaking Change Documentation

Created comprehensive documentation at docs/core/compatibility/sdk/10.0/version-requirements.md that explains:

  • Visual Studio 17.14 is now required to load .NET 10.0.100 SDK (starting with RC 2)
  • Visual Studio 17.14 only supports targeting .NET 9 and earlier frameworks when using .NET 10 SDK
  • Visual Studio 18.0 (Visual Studio 2026) or later is required to target net10.0
  • Previous .NET 10 preview versions required Visual Studio 17.13, which has been updated to 17.14 for RC 2 and GA

Updated Index and Navigation

  • Added the breaking change entry to the SDK and MSBuild section in docs/core/compatibility/10.0.md
  • Added navigation entry to docs/core/compatibility/toc.yml for easy discovery

Updated Versioning Tables

Updated docs/core/porting/versioning-sdk-msbuild-vs.md with:

  1. Targeting and support rules table: Added .NET 10.0.100 row showing that the SDK ships with Visual Studio 18.0, requires minimum Visual Studio 17.14, and supports targeting up to net9.0 in the minimum version
  2. Preview versioning table: Added 10.0.100 RC 2 entry with Visual Studio 17.14 requirement
  3. Support notes: Added clarification that targeting net10.0 is officially supported in Visual Studio 18.0+ only

Impact

Developers using .NET 10 SDK will need to:

  • Upgrade to Visual Studio 17.14 or later to load the .NET 10.0.100 SDK (RC 2 and GA)
  • Upgrade to Visual Studio 18.0 (Visual Studio 2026) or later to target net10.0 in their projects

This follows the established pattern from previous .NET releases where new SDKs require updated Visual Studio versions to support new framework targets.

Fixes #494516

Original prompt

This section details on the original issue you should resolve

<issue_title>[Breaking change]: Version requirements for the .NET 10 SDK</issue_title>
<issue_description>### Description

See previous breaking changes: https://learn.microsoft.com/en-us/dotnet/core/compatibility/sdk/8.0/version-requirements

10.0.1xx will require 17.14 to load but only support targeting .NET 9 in that version.

To target net10.0, you must use version 18.0 or later

Version

.NET 10 RC 2

Previous behavior

The previous minimum for .NET 10 previews was 17.13 to allow time for release and more adoption of 17.14

New behavior

10.0.1xx-rc.2 will only load on 17.14 and 10.0.100 will warn if targeting net10.0 on 17.14.

Type of breaking change

  • Binary incompatible: Existing binaries might encounter a breaking change in behavior, such as failure to load or execute, and if so, require recompilation.
  • Source incompatible: When recompiled using the new SDK or component or to target the new runtime, existing source code might require source changes to compile successfully.
  • Behavioral change: Existing binaries might behave differently at run time.

Reason for change

Planned change

Recommended action

Upgrade to Visual Studio 2026

Feature area

SDK

Affected APIs

No response

Associated WorkItem - 494516</issue_description>

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

Fixes #48320

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Internal previews

📄 File 🔗 Preview link
docs/core/compatibility/10.0.md Breaking changes in .NET 10
docs/core/compatibility/sdk/10.0/version-requirements.md Version requirements for .NET 10 SDK
docs/core/compatibility/toc.yml docs/core/compatibility/toc
docs/core/porting/versioning-sdk-msbuild-vs.md .NET SDK, MSBuild, and Visual Studio versioning

@gewarren
Add .NET 10 SDK version requirements breaking change documentation
3dd287b 
Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
Copilot AI changed the title [WIP] [Breaking change]: Version requirements for the .NET 10 SDK Document .NET 10 SDK version requirements breaking change Oct 6, 2025
Copilot AI requested a review from gewarren October 6, 2025 19:30
@gewarren gewarren marked this pull request as ready for review October 8, 2025 23:33
@gewarren gewarren requested a review from a team as a code owner October 8, 2025 23:33
Copilot AI reviewed Oct 8, 2025
View reviewed changes
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

This PR documents the breaking change for .NET 10 SDK version requirements, specifically addressing the updated Visual Studio version requirements for RC 2 and GA releases. The breaking change establishes that Visual Studio 17.14 is now required to load the .NET 10.0.100 SDK, while targeting net10.0 requires Visual Studio 18.0 (Visual Studio 2026) or later.

  • Created comprehensive breaking change documentation explaining Visual Studio version requirements for .NET 10 SDK
  • Updated versioning tables and support documentation to reflect the new requirements
  • Added navigation entries to make the breaking change easily discoverable

Reviewed Changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.

File Description
docs/core/compatibility/sdk/10.0/version-requirements.md New breaking change documentation detailing Visual Studio version requirements for .NET 10 SDK
docs/core/compatibility/10.0.md Added entry for the version requirements breaking change to the main compatibility index
docs/core/compatibility/toc.yml Added navigation entry for the new breaking change documentation
docs/core/porting/versioning-sdk-msbuild-vs.md Updated versioning tables with .NET 10.0.100 requirements and added RC 2 preview entry

Comment thread docs/core/compatibility/sdk/10.0/version-requirements.md Outdated
Comment thread docs/core/compatibility/10.0.md Outdated
gewarren and others added 2 commits October 13, 2025 18:53
@gewarren
Apply suggestions from code review
ea1889e 
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@gewarren
Merge branch 'main' into copilot/fix-684c4c82-e5a8-4c24-83ca-562fa40a…
33ce91b 
…323e
@gewarren gewarren merged commit e4d5897 into main Oct 14, 2025
10 checks passed
@gewarren gewarren deleted the copilot/fix-684c4c82-e5a8-4c24-83ca-562fa40a323e branch October 14, 2025 17:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code review Copilot Copilot left review comments

@meaghanlewis meaghanlewis meaghanlewis approved these changes

@marcpopMSFT marcpopMSFT Awaiting requested review from marcpopMSFT

+1 more reviewer

@gewarren gewarren gewarren approved these changes

Reviewers whose approvals may not affect merge requirements

Assignees

@gewarren gewarren

Copilot code review Copilot

Labels

dotnet-fundamentals/svc

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

[Breaking change]: Version requirements for the .NET 10 SDK

4 participants

@meaghanlewis @gewarren