From 10209e8c9eca679c3d067acab26e95715fd138d8 Mon Sep 17 00:00:00 2001 From: Terje Sandstrom Date: Wed, 7 Jan 2026 19:03:27 +0100 Subject: [PATCH 1/7] Added release information for adapter version 6.1 --- .../Adapter-Engine-Compatibility.md | 1 + .../AdapterV4-Release-Notes.md | 68 +++++++++++++++++++ docs/articles/vs-test-adapter/Debugging.md | 7 +- .../vs-test-adapter/Supported-Frameworks.md | 3 +- .../vs-test-adapter/Tips-And-Tricks.md | 17 +++-- 5 files changed, 89 insertions(+), 7 deletions(-) diff --git a/docs/articles/vs-test-adapter/Adapter-Engine-Compatibility.md b/docs/articles/vs-test-adapter/Adapter-Engine-Compatibility.md index 5346998f8..b13166935 100644 --- a/docs/articles/vs-test-adapter/Adapter-Engine-Compatibility.md +++ b/docs/articles/vs-test-adapter/Adapter-Engine-Compatibility.md @@ -15,6 +15,7 @@ post. | Adapter version | Embedded engine version | | --------------- | ----------------------- | +| 6.1.0 | 3.22.0 | | 6.0.1 | 3.21.1 | | 6.0.0 | 3.21.0 | | 5.2.0 | 3.18.1 | diff --git a/docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md b/docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md index 007822c24..40e745796 100644 --- a/docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md +++ b/docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md @@ -7,6 +7,74 @@ uid: adapterreleasenotes # Adapter Release Notes +## NUnit3 Test Adapter for Visual Studio and Dotnet - Version 6.1.0 - January 7, 2026 + +This is a bug-fix release that addresses a series of issues related to assembly loading. +It also introduces several new settings. One of these, `UseDefaultAssemblyLoadContext`, is crucial for correct assembly loading and is now enabled by default by the adapter. + +The remaining settings are intended for development and diagnostics.`DebugEngine` enables debugging of the NUnit Engine, and `InternalTraceLevel` allows the engine’s internal trace level to be configured and is now passed through to the engine. + +### Bug fixes + +* [1393](https://github.com/nunit/nunit3-vs-adapter/issues/1393) System.IO.FileNotFoundException: Could not load file or assembly 'System.Text.Json, Version=10.0.0.0. +* [1391](https://github.com/nunit/nunit3-vs-adapter/issues/1391) NUnit3TestAdapter V6.0.1 doesn't work with Resharpers Unit Tests explorer. +* [1390](https://github.com/nunit/nunit3-vs-adapter/issues/1390) I am getting a System.InvalidCastException when updating from NUnit3TestAdapter Version=5.2.0 to 6.0.1. +* [1389](https://github.com/nunit/nunit3-vs-adapter/issues/1389) Double loading assemblys NUnit3TestAdapter 6.0.1 with Microsoft Testing Platform (MTP). Fixed by [PR 1395](https://github.com/nunit/nunit3-vs-adapter/pull/1395) +* [1375](https://github.com/nunit/nunit3-vs-adapter/issues/1375) New failures in dynamic code evaluation in v6. Fixed by [PR 1395](https://github.com/nunit/nunit3-vs-adapter/pull/1395) +* [1348](https://github.com/nunit/nunit3-vs-adapter/issues/1348) [MTP] AwesomeAssertions throws different NUnit.Framework.AssertionException than expected at runtime. + +### Breaking changes + +The 6.1 version of the adapter use the NUnit.Engine version 3.22.0. This version introduce a changed way of loading assemblies. +In order for the adapter to handle MTP (Microsoft test Platform) it need to use the default loading context, which the engine may not use. +The introduction of the `UseDefaultAssemblyLoadContext` ensures this work. +The current versions of Resharper and Rider (2025.3.1) however do not yet support the `UseDefaultAssemblyLoadContext`, and therefore the user **may** experience assembly loading issues. + +If you're not using Visual Studio test explorer, but only Rider og Resharper's, they will work if you don't install the adapter. + +### Acknowledgements + +We want to express our heartfelt gratitude to everyone who has contributed to this release +by reporting bugs, suggesting enhancements, and providing valuable feedback. +Your efforts help make NUnit better for the entire community. + +A special thank you to the following reporters for identifying issues: + + + + + + + + + + + + +
Artyom M.Christoph BerschGlenn WatsonMJB222398
Nathan BieremaSvetoslav Inkolov
+ +and to the commenters who engaged in discussions and offered further insights: + + + + + + + + + + + + + + + + + + + +
Artyom M.Bradford FisherCharliePooleChristoph Bersch
Manfred BrandsMJB222398Nathan Bieremanesc58
Svetoslav InkolovTerje SandstromYoussef Victor
+ ## NUnit3 Test Adapter for Visual Studio and Dotnet - Version 6.0.1 - December 20, 2025 This is a hotfix release for version 6.0.0 to handle issues related to loading assemblies. diff --git a/docs/articles/vs-test-adapter/Debugging.md b/docs/articles/vs-test-adapter/Debugging.md index 0c40587a6..46b84f54c 100644 --- a/docs/articles/vs-test-adapter/Debugging.md +++ b/docs/articles/vs-test-adapter/Debugging.md @@ -26,11 +26,14 @@ The symbols are: NUnit.DebugExecution NUnit.DebugDiscovery NUnit.Debug +NUnit.DebugEngine # (From version 6.1) ``` -The last setting is equal to setting both of the two above. +The `NUnit.Debug` is equal to setting both of the two above. -From command line, you can set these by adding +The `NUnit.DebugEngine` enables debugging of the embedded NUnit.Engine. + +From command line, you can set these by adding e.g. ```cmd dotnet test -- NUnit.DebugExecution=true diff --git a/docs/articles/vs-test-adapter/Supported-Frameworks.md b/docs/articles/vs-test-adapter/Supported-Frameworks.md index f16d03bc8..80d6c5694 100644 --- a/docs/articles/vs-test-adapter/Supported-Frameworks.md +++ b/docs/articles/vs-test-adapter/Supported-Frameworks.md @@ -22,7 +22,8 @@ The adapter is shipped with three different versions of the test framework. The which is used for .NET Framework based test projects. The second is the .NET version 6.0, which is used for .NET 6.0, and the third is .NET 8.0 which is used for .net 7.0, 8.0, 9.0, 10.0 and upwards. The different versions of the adapter supports different versions of the test framework. -The table above shows the supported versions. +The table above shows the supported versions.git sw - + Version 4.3.2 of the adapter will support future versions of .net, as long as there are no breaking changes. (Earlier versions have been blocking that based on the table above). diff --git a/docs/articles/vs-test-adapter/Tips-And-Tricks.md b/docs/articles/vs-test-adapter/Tips-And-Tricks.md index 29241ea16..abb33db92 100644 --- a/docs/articles/vs-test-adapter/Tips-And-Tricks.md +++ b/docs/articles/vs-test-adapter/Tips-And-Tricks.md @@ -42,12 +42,13 @@ Certain NUnit Test Adapter settings are configurable using a .runsettings file. | [DiscoveryMethod](#discoverymethod) | enum | How execution discovery is done, options are `Legacy` or `Current` | Current | | [AssemblySelectLimit](#assemblyselectlimit) | int | Number of tests accepted before filters are turned off | 2000 | | [NewOutputXmlFileForEachRun](#newoutputxmlfileforeachrun) | bool | Creates a new file for each test run | false | -| [IncludeStackTraceForSuites](#includestacktraceforsuites) | bool | Includes stack trace for failures in suites, like exceptions in OneTimeSetup and OneTimeTearDown | true | -| [IncludeStackTrace](#includestacktrace) | bool | Includes stack trace for all failures | true | -| [ExplicitMode](#explicitmode) | enum | Changes handling of explicit tests, options are `Strict`, `Relaxed` or `None` | Strict | +| [IncludeStackTraceForSuites](#includestacktraceforsuites) | bool | Includes stack trace for failures in suites, e.g.OneTimeSetup/OneTimeTearDown | true | +| [IncludeStackTrace](#includestacktrace) | bool | Includes stack trace for all failures | true | +| [ExplicitMode](#explicitmode) | enum | Changes handling of explicit tests, options are `Strict`, `Relaxed` or `None` | Strict | | [SkipExecutionWhenNoTests](#skipexecutionwhennotests) | bool | Skip execution if no tests are found | false | | [AllowParallelWithDebugger](#allowparallelwithdebugger) | bool | Allow parallel execution when debugger is attached | false | -| [ThrowOnEachFailureUnderDebugger](#throwoneachfailureunderdebugger) | bool | | false | +| [ThrowOnEachFailureUnderDebugger](#throwoneachfailureunderdebugger) | bool | | false | +| [UseDefaultAssemblyLoadContext](#usedefaultassemblyloadcontext) | bool | Force the engine to use Default Loading Context, otherwise engine decide | true | ### Visual Studio templates for runsettings @@ -399,6 +400,14 @@ is attached. The default is `false`. (From version 4.6, require NUnit from 4.2) +#### UseDefaultAssemblyLoadContext + +Controls how the NUnit.Engine (from version 3.22.0) does assembly loading. Default is `true`, and cause the engine to +load the assemblies into the default assembly loading context. This is mandatory for MTP. +If set to `false`, the engine will load assemblies based on its own algorithm, also taking isolation into account. + +(From version 6.1) + --- ### Some further information on directories From 8dcb3f19021f4124b7288562ee4fdf5a4c672c9a Mon Sep 17 00:00:00 2001 From: Terje Sandstrom Date: Wed, 7 Jan 2026 19:08:10 +0100 Subject: [PATCH 2/7] Fixed linting --- docs/articles/vs-test-adapter/Supported-Frameworks.md | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/docs/articles/vs-test-adapter/Supported-Frameworks.md b/docs/articles/vs-test-adapter/Supported-Frameworks.md index 80d6c5694..7d738ca46 100644 --- a/docs/articles/vs-test-adapter/Supported-Frameworks.md +++ b/docs/articles/vs-test-adapter/Supported-Frameworks.md @@ -18,12 +18,10 @@ The table below shows the supported adapter versions for a given framework versi |Net 7|4.3 - 5.X || |Net 8+|Works with 4.3.2 and upwards|| -The adapter is shipped with three different versions of the test framework. The first is the full framework version, -which is used for .NET Framework based test projects. The second is the .NET version 6.0, which is used for .NET -6.0, and the third is .NET 8.0 which is used for .net 7.0, 8.0, 9.0, 10.0 and upwards. +The adapter is shipped with two different versions of the test framework. The first is the full framework version, +which is used for .NET Framework based test projects. The second is the .NET (Core) version. The different versions of the adapter supports different versions of the test framework. -The table above shows the supported versions.git sw - - +The table above shows the supported versions. Version 4.3.2 of the adapter will support future versions of .net, as long as there are no breaking changes. (Earlier versions have been blocking that based on the table above). From e643a0bd23246433e391a426025ace90638e363d Mon Sep 17 00:00:00 2001 From: Terje Sandstrom Date: Wed, 7 Jan 2026 19:09:18 +0100 Subject: [PATCH 3/7] Update docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md b/docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md index 40e745796..4845034da 100644 --- a/docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md +++ b/docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md @@ -12,7 +12,7 @@ uid: adapterreleasenotes This is a bug-fix release that addresses a series of issues related to assembly loading. It also introduces several new settings. One of these, `UseDefaultAssemblyLoadContext`, is crucial for correct assembly loading and is now enabled by default by the adapter. -The remaining settings are intended for development and diagnostics.`DebugEngine` enables debugging of the NUnit Engine, and `InternalTraceLevel` allows the engine’s internal trace level to be configured and is now passed through to the engine. +The remaining settings are intended for development and diagnostics. `DebugEngine` enables debugging of the NUnit Engine, and `InternalTraceLevel` allows the engine’s internal trace level to be configured and is now passed through to the engine. ### Bug fixes From 81af582edf3ed04aeb975ad7763bc6201c98ceb6 Mon Sep 17 00:00:00 2001 From: Terje Sandstrom Date: Wed, 7 Jan 2026 19:09:34 +0100 Subject: [PATCH 4/7] Update docs/articles/vs-test-adapter/Tips-And-Tricks.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- docs/articles/vs-test-adapter/Tips-And-Tricks.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/articles/vs-test-adapter/Tips-And-Tricks.md b/docs/articles/vs-test-adapter/Tips-And-Tricks.md index abb33db92..4a06edfae 100644 --- a/docs/articles/vs-test-adapter/Tips-And-Tricks.md +++ b/docs/articles/vs-test-adapter/Tips-And-Tricks.md @@ -47,7 +47,7 @@ Certain NUnit Test Adapter settings are configurable using a .runsettings file. | [ExplicitMode](#explicitmode) | enum | Changes handling of explicit tests, options are `Strict`, `Relaxed` or `None` | Strict | | [SkipExecutionWhenNoTests](#skipexecutionwhennotests) | bool | Skip execution if no tests are found | false | | [AllowParallelWithDebugger](#allowparallelwithdebugger) | bool | Allow parallel execution when debugger is attached | false | -| [ThrowOnEachFailureUnderDebugger](#throwoneachfailureunderdebugger) | bool | | false | +| [ThrowOnEachFailureUnderDebugger](#throwoneachfailureunderdebugger) | bool | Throw on each failure when debugger is attached | false | | [UseDefaultAssemblyLoadContext](#usedefaultassemblyloadcontext) | bool | Force the engine to use Default Loading Context, otherwise engine decide | true | ### Visual Studio templates for runsettings From 9ae828bbb35218a940645c455f6f890b92294c09 Mon Sep 17 00:00:00 2001 From: Terje Sandstrom Date: Wed, 7 Jan 2026 19:09:42 +0100 Subject: [PATCH 5/7] Update docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md b/docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md index 4845034da..7e480e9d0 100644 --- a/docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md +++ b/docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md @@ -26,7 +26,7 @@ The remaining settings are intended for development and diagnostics. `DebugEngin ### Breaking changes The 6.1 version of the adapter use the NUnit.Engine version 3.22.0. This version introduce a changed way of loading assemblies. -In order for the adapter to handle MTP (Microsoft test Platform) it need to use the default loading context, which the engine may not use. +In order for the adapter to handle MTP (Microsoft test Platform) it needs to use the default loading context, which the engine may not use. The introduction of the `UseDefaultAssemblyLoadContext` ensures this work. The current versions of Resharper and Rider (2025.3.1) however do not yet support the `UseDefaultAssemblyLoadContext`, and therefore the user **may** experience assembly loading issues. From c8d282ced17aed0a7360e5e30af15d210f11f82e Mon Sep 17 00:00:00 2001 From: Terje Sandstrom Date: Wed, 7 Jan 2026 19:09:57 +0100 Subject: [PATCH 6/7] Update docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md b/docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md index 7e480e9d0..5c81edf72 100644 --- a/docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md +++ b/docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md @@ -30,7 +30,7 @@ In order for the adapter to handle MTP (Microsoft test Platform) it needs to use The introduction of the `UseDefaultAssemblyLoadContext` ensures this work. The current versions of Resharper and Rider (2025.3.1) however do not yet support the `UseDefaultAssemblyLoadContext`, and therefore the user **may** experience assembly loading issues. -If you're not using Visual Studio test explorer, but only Rider og Resharper's, they will work if you don't install the adapter. +If you're not using Visual Studio test explorer, but only Rider or Resharper's, they will work if you don't install the adapter. ### Acknowledgements From 80341cb425f3182c74715d8f5d146f80256a52ce Mon Sep 17 00:00:00 2001 From: Terje Sandstrom Date: Wed, 7 Jan 2026 19:10:21 +0100 Subject: [PATCH 7/7] Update docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md b/docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md index 5c81edf72..b90e83dd8 100644 --- a/docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md +++ b/docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md @@ -27,7 +27,7 @@ The remaining settings are intended for development and diagnostics. `DebugEngin The 6.1 version of the adapter use the NUnit.Engine version 3.22.0. This version introduce a changed way of loading assemblies. In order for the adapter to handle MTP (Microsoft test Platform) it needs to use the default loading context, which the engine may not use. -The introduction of the `UseDefaultAssemblyLoadContext` ensures this work. +The introduction of the `UseDefaultAssemblyLoadContext` ensures this works. The current versions of Resharper and Rider (2025.3.1) however do not yet support the `UseDefaultAssemblyLoadContext`, and therefore the user **may** experience assembly loading issues. If you're not using Visual Studio test explorer, but only Rider or Resharper's, they will work if you don't install the adapter.