From b03ef4fca287afa4b5d514ddaa3306b42dbfbd7f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jakub=20Jare=C5=A1?= Date: Thu, 21 Aug 2025 12:21:26 +0200 Subject: [PATCH 1/3] Add docs for tmi removal --- .../unit-testing-mstest-migration-from-tmi.md | 61 +++++++++++++++++++ 1 file changed, 61 insertions(+) create mode 100644 docs/core/testing/unit-testing-mstest-migration-from-tmi.md diff --git a/docs/core/testing/unit-testing-mstest-migration-from-tmi.md b/docs/core/testing/unit-testing-mstest-migration-from-tmi.md new file mode 100644 index 0000000000000..1dafeac0bbd75 --- /dev/null +++ b/docs/core/testing/unit-testing-mstest-migration-from-tmi.md @@ -0,0 +1,61 @@ +--- +title: MSTest migration from Legacy Test runner +description: Learn about migrating from Legacy test runner to latest MSTest. +author: nohwnd +ms.author: jajares +ms.date: 08/21/2025 +--- + +# MSTest legacy runner migration guide + +This guide assists users in upgrading their MSTest tests that rely on legacy test runner in Visual Studio and VSTest, to move to latest MSTest. + +### Who is impacted? + +Users who upgrade to VSTest 18.0.0 or newer and encounter error: + +```plaintext +MSTest v1 run was offloaded to legacy TestPlatform runner, this is typically caused by: +- using .testsettings file +- setting ForcedLegacyMode in your runsettings file +- running Web and Load test (WLT) +- running Coded UI Tests (CUIT) +- running manual tests +- running generic tests + +This runner was removed from the product and can no longer be used. +``` + +Version 18 of VSTest removed the ability to run MSTest v1 tests via the legacy runner (running MSTest v1 tests via VSTest remains unaffected.). The legacy runner, also called TMI, TPv0, QTAgent, was removed from VSTest and VisualStudio. + +### Solving the error + +The error can show up for multiple reasons, typically the reasons that are listed. + +#### Using .testsettings file + +Providing `.testsettings` file to the run will trigger this error. Test settings files are no longer supported in VSTest and you should replace them with `.runsettings` file. + +To migrate from testsettings to run settings you can use the TestSettings migrator tool that is shipped with VisualStudio 2022. See + +When moving away from testsettings, please also consider upgrading from MSTest v1 to latest MSTest following [this migration guide](unit-testing-mstest-migration-from-v1-to-v3.md). + +#### Setting ForcedLegacyMode in runsettings + +Inspect your runsettings file to see if `true` is set explicitly. This will force switching to the legacy MSTest runner. You need to remove this explicit setting. + +#### Running Web and Load test (WLT) + +Web and Load test workload and adapter was deprecated and removed. If you still have the need to run Web and Load tests, avoid upgrading from VSTest 17.x. + +#### Running Coded UI Tests (CUIT) + +Coded UI test workload and adapter was deprecated and removed. If you still have the need to run Coded UI tests, avoid upgrading from VSTest 17.x. + +#### Running manual tests + +Manual test test type was deprecated and removed. If you still have the need to manual tests, avoid upgrading from VSTest 17.x. + +#### Generic tests tests + +Generic test test type was deprecated and removed. If you still have the need to manual tests, avoid upgrading from VSTest 17.x. From a6a104c8906a7ef10eabe31ec9ff27bf559f3e36 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jakub=20Jare=C5=A1?= Date: Thu, 28 Aug 2025 10:21:19 +0200 Subject: [PATCH 2/3] Add to TOC --- docs/navigate/devops-testing/toc.yml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/navigate/devops-testing/toc.yml b/docs/navigate/devops-testing/toc.yml index 0221c6819b87b..7b07ab88687d4 100644 --- a/docs/navigate/devops-testing/toc.yml +++ b/docs/navigate/devops-testing/toc.yml @@ -75,6 +75,8 @@ items: href: ../../core/testing/unit-testing-mstest-migration-from-v1-to-v3.md - name: Migrate from MSTest v3 to MSTest v4 href: ../../core/testing/unit-testing-mstest-migration-v3-v4.md + - name: MSTest migration from Legacy Test runner + href: ../../core/testing/unit-testing-mstest-migration-from-tmi.md - name: Microsoft.Testing.Platform support (MSTest runner) href: ../../core/testing/unit-testing-mstest-runner-intro.md - name: Getting started From d711fda39ad5ddb99861152a7e92e514c1721cad Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jakub=20Jare=C5=A1?= Date: Thu, 28 Aug 2025 10:42:10 +0200 Subject: [PATCH 3/3] Add youssefs suggestions --- docs/core/testing/unit-testing-mstest-migration-from-tmi.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/core/testing/unit-testing-mstest-migration-from-tmi.md b/docs/core/testing/unit-testing-mstest-migration-from-tmi.md index 1dafeac0bbd75..9e6867517a3f9 100644 --- a/docs/core/testing/unit-testing-mstest-migration-from-tmi.md +++ b/docs/core/testing/unit-testing-mstest-migration-from-tmi.md @@ -26,7 +26,7 @@ MSTest v1 run was offloaded to legacy TestPlatform runner, this is typically cau This runner was removed from the product and can no longer be used. ``` -Version 18 of VSTest removed the ability to run MSTest v1 tests via the legacy runner (running MSTest v1 tests via VSTest remains unaffected.). The legacy runner, also called TMI, TPv0, QTAgent, was removed from VSTest and VisualStudio. +Version 18 of VSTest removed the ability to run MSTest v1 tests via the legacy runner (running MSTest v1 tests via VSTest remains unaffected.). The legacy runner, also called TMI, TPv0, QTAgent, was removed from VSTest and Visual Studio. ### Solving the error @@ -36,9 +36,9 @@ The error can show up for multiple reasons, typically the reasons that are liste Providing `.testsettings` file to the run will trigger this error. Test settings files are no longer supported in VSTest and you should replace them with `.runsettings` file. -To migrate from testsettings to run settings you can use the TestSettings migrator tool that is shipped with VisualStudio 2022. See +To migrate from testsettings to runsettings, you can use the TestSettings migrator tool that is shipped with Visual Studio 2022. For more information, see [Upgrade from .testsettings to .runsettings](https://learn.microsoft.com/visualstudio/test/migrate-testsettings-to-runsettings). -When moving away from testsettings, please also consider upgrading from MSTest v1 to latest MSTest following [this migration guide](unit-testing-mstest-migration-from-v1-to-v3.md). +When moving away from testsettings, consider upgrading from MSTest v1 to latest MSTest following [this migration guide](unit-testing-mstest-migration-from-v1-to-v3.md). #### Setting ForcedLegacyMode in runsettings