docs
docs copied to clipboard
dotnet
Conflicting statements regarding which MSBuild/VS versions are supported by 8.0 SDKs
Describe the issue or suggestion
From what I could find there are at least three places that state the minimum MSBuild/VS versions supported by each feature band of the .NET SDK.
- The dedicated documentation page
- The .NET download page inlcudes "Visual Studio support" for each SDK
- One of the .NET 8 breaking changes announcement announces changes to the rules.
All of these places disagree on what is compatible and what isn't. Below are the compatible MSBuild/VS version according to each.
| SDK Version | Documentation page | Download page (as of release 8.0.8) | Breaking changes |
|---|---|---|---|
| 8.0.1xx | 17.7 | 17.8 | 17.7 |
| 8.0.2xx | 17.8 | N/A | 17.8 |
| 8.0.3xx | 17.8 | 17.10 | 17.8 |
| 8.0.4xx | 17.8 | 17.11 | 17.9 |
After "falling in the trap" of believing the documentation page and getting a really poor error message from VS 17.8 with SDK 8.0.400, I believe that the information on the breaking changes page is the one that is correct. but I don't really know.
These version support tables should be unified to contain the correct information in all places.
The download page is listing the version of VS that we ship in. It might be worth changing the wording there to make that more clear. This matches the second column in the documentation page that was linked.
The documentation page captures our intent. However, NuGet took an upgraded dependency that forced us to upgrade our minimum VS version to 17.9 in 8.0.4xx. I didn't update the documentation page but rather got NuGet to fix that upgrade and we're in the process of resolving this so that the November release will again allow for 17.8. We'll need to fix the breaking changes page at that time.
Note that even though we allow 8.0.4xx to be used with 17.8, we cannot guarantee that everything will work. The CodeStyle analyzer for example will not work in that configuration unless you set an additional property BuildWithNetFrameworkHostedCompiler set to true which is not well known. That property is on by default in net9 fwiw.
https://github.com/dotnet/sdk/pull/43995 will fix the min version
@marcpopMSFT Regarding the download page: I was looking at these two pieces of information:
The Included in value seems pretty clear to me as to what it means. Are you saying that Visual Studio support is also supposed to be the version it is included in? If so, what is the reason for having what seems to be the same information twice?
Ahh, the Included in section doesn't exist for the 8.0.10 release and I didn't expand the page. I think those basically mean the same thing though I'd need someone more familiar with the intent on the download page to comment. @gewarren do you know why Included in isn't there for 8.0.10 and do you know what the intent was for that versus the VS support node?
Tagging @rbhanda since this data is driven from the releases.json files on dotnet/core. Rahul, did we miss any VS tagging for the latest runtime release? I'd imagine that one of those versions is included in VS.
I think there's still an outstanding question about the difference between Included in and Visual Studio support.
Closing this issue as fixed. Please open a new issue if there's something else that should be changed.