Skip to content

Document .NET 10 SDK version requirements breaking change #48923

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.

Sign up for GitHub

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

Jump to bottom
Draft
wants to merge 2 commits into
base: main
Choose a base branch
from
Draft

Document .NET 10 SDK version requirements breaking change #48923

wants to merge 2 commits into from

Conversation

Copilot
Copy link
Contributor

@Copilot Copilot AI commented Oct 6, 2025 •
edited
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.

@Copilot 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 Copilot AI requested a review from gewarren October 6, 2025 19:30
Copilot finished work on behalf of gewarren October 6, 2025 19:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers

@gewarren gewarren Awaiting requested review from gewarren gewarren is a code owner

At least 1 approving review is required to merge this pull request.

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
2 participants
@Copilot @gewarren