Skip to content

Breaking change doc: VSTest/Microsoft.NET.Test.SDK removes Newtonsoft.Json dependency (.NET 11)#53545

Merged
gewarren merged 4 commits intomainfrom
copilot/breaking-change-remove-newtonsoft-json
May 5, 2026
Merged

Breaking change doc: VSTest/Microsoft.NET.Test.SDK removes Newtonsoft.Json dependency (.NET 11)#53545
gewarren merged 4 commits intomainfrom
copilot/breaking-change-remove-newtonsoft-json

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented May 4, 2026

In .NET 11 Preview 4, the VSTest platform and Microsoft.NET.Test.SDK dropped Newtonsoft.Json in favor of System.Text.Json (.NET) and JSONite (.NET Framework). Test projects that relied on the transitive dependency—without an explicit PackageReference—now break at compile time or runtime.

Changes

  • New article docs/core/compatibility/sdk/11/vstest-removes-newtonsoft-json.md
    • Covers three failure modes: compile errors, runtime FileNotFoundException, and test extension load failures
    • Mitigation for each: add an explicit <PackageReference Include="Newtonsoft.Json" /> to the affected project
    • Lists all removed public APIs from Microsoft.VisualStudio.TestPlatform.CommunicationUtilities (the Newtonsoft.Json.Linq.JToken-based surface)
  • docs/core/compatibility/11.md — new row under SDK and MSBuild (Binary/source incompatible)
  • docs/core/compatibility/toc.yml — new TOC entry under .NET 11 → SDK and MSBuild

Internal previews

📄 File 🔗 Preview link
docs/core/compatibility/11.md Breaking changes in .NET 11
docs/core/compatibility/sdk/11/vstest-removes-newtonsoft-json.md VSTest removes dependency on Newtonsoft.Json
docs/core/compatibility/toc.yml docs/core/compatibility/toc

…y in .NET 11

Agent-Logs-Url: https://github.com/dotnet/docs/sessions/339e02d8-bbe0-4dec-99bf-af7f8430dd0b

Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
Copilot AI changed the title [WIP] Remove Newtonsoft.Json dependency from dotnet test Breaking change doc: VSTest/Microsoft.NET.Test.SDK removes Newtonsoft.Json dependency (.NET 11) May 4, 2026
Copilot AI requested a review from gewarren May 4, 2026 19:38
Comment thread docs/core/compatibility/sdk/11/vstest-removes-newtonsoft-json.md Outdated
@gewarren gewarren marked this pull request as ready for review May 4, 2026 20:22
@gewarren gewarren requested a review from a team as a code owner May 4, 2026 20:22
Copilot AI review requested due to automatic review settings May 4, 2026 20:22
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 adds a new .NET 11 breaking change article for the VSTest/Microsoft.NET.Test.SDK removal of the transitive Newtonsoft.Json dependency, and wires that article into the .NET 11 compatibility index and TOC.

Changes:

  • Add a new SDK breaking change article under docs/core/compatibility/sdk/11/.
  • Add the new article to the .NET 11 breaking changes index.
  • Add the new article to the compatibility TOC under SDK and MSBuild.

Reviewed changes

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

File Description
docs/core/compatibility/toc.yml Adds the new .NET 11 SDK breaking change page to the compatibility navigation.
docs/core/compatibility/sdk/11/vstest-removes-newtonsoft-json.md Documents the breaking change, affected scenarios, mitigations, and removed APIs.
docs/core/compatibility/11.md Adds the breaking change to the .NET 11 overview table.

Comment thread docs/core/compatibility/sdk/11/vstest-removes-newtonsoft-json.md
Comment thread docs/core/compatibility/sdk/11/vstest-removes-newtonsoft-json.md Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@gewarren gewarren requested a review from nohwnd May 4, 2026 20:35
Copy link
Copy Markdown
Member

@BillWagner BillWagner left a comment

Choose a reason for hiding this comment

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

This LGTM. Let's :shipit:

@gewarren gewarren merged commit c7918eb into main May 5, 2026
11 checks passed
@gewarren gewarren deleted the copilot/breaking-change-remove-newtonsoft-json branch May 5, 2026 17:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Breaking change]: dotnet test removes dependency on Newtonsoft.Json

5 participants