[Breaking change]: .NET SDK 7.0.200 and newer will require 17.4 MSBuild and Visual Studio

[marcpopMSFT]

Description

Per prior guidance on the minimum VS version that an SDK will load in, 7.0.200 will be updated to require 17.4 or newer version of Visual Studio. The change has been merged into the SDK repo and should be in daily installable builds by end of the week. It will ship starting in the January preview of 7.0.200 and GA in February.

.NET SDK, MSBuild, and Visual Studio versioning - .NET Core | Microsoft Learn

Version

.NET 7

Previous behavior

7.0.100 will load into 17.3 when targeting 6.0 and lower runtime versions.

New behavior

7.0.200 will require using Visual Studio/MSBuild 17.4 or newer

Type of breaking change

• Binary incompatible: Existing binaries may encounter a breaking change in behavior, such as failure to load/execute or different run-time behavior.
• Source incompatible: Source code may encounter a breaking change in behavior when targeting the new runtime/component/SDK, such as compile errors or different run-time behavior.

Reason for change

We do this to enable .NET SDK partners to have a reliable minimum version of Visual Studio that they can expect to work against. We always wait one quarter before updating the requirement.

Recommended action

If you need to use 7.0.200, upgrade your Visual Studio version. Alternatively, you can use a global.json file to pin to an older 7.0.100 stand-alone SDK install.

Feature area

SDK

Affected APIs

No response

---

Associated WorkItem - 57956