Add docs for tpv0 removal #48173
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| @@ -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: | ||||||||||||||||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||||||||||||||||
|
|
||||||||||||||||||||
| ```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 Visual Studio. | ||||||||||||||||||||
|
|
||||||||||||||||||||
| ### Solving the error | ||||||||||||||||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||||||||||||||||
|
|
||||||||||||||||||||
| The error can show up for multiple reasons, typically the reasons that are listed. | ||||||||||||||||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||||||||||||||||
|
|
||||||||||||||||||||
| #### Using .testsettings file | ||||||||||||||||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||||||||||||||||
|
|
||||||||||||||||||||
| 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. | ||||||||||||||||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||||||||||||||||
|
|
||||||||||||||||||||
| 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). | ||||||||||||||||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||||||||||||||||
|
|
||||||||||||||||||||
| 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 | ||||||||||||||||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||||||||||||||||
|
|
||||||||||||||||||||
| Inspect your runsettings file to see if `<ForcedLegacyMode>true</ForcedLegacyMode>` 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) | ||||||||||||||||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||||||||||||||||
|
|
||||||||||||||||||||
| 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. | ||||||||||||||||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||||||||||||||||
|
|
||||||||||||||||||||
| #### Running Coded UI Tests (CUIT) | ||||||||||||||||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||||||||||||||||
|
|
||||||||||||||||||||
| 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. | ||||||||||||||||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||||||||||||||||
|
|
||||||||||||||||||||
| #### Running manual tests | ||||||||||||||||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||||||||||||||||
|
|
||||||||||||||||||||
| Manual test test type was deprecated and removed. If you still have the need to manual tests, avoid upgrading from VSTest 17.x. | ||||||||||||||||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||||||||||||||||
|
|
||||||||||||||||||||
| #### Generic tests tests | ||||||||||||||||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||||||||||||||||
|
|
||||||||||||||||||||
| Generic test test type was deprecated and removed. If you still have the need to manual tests, avoid upgrading from VSTest 17.x. | ||||||||||||||||||||
|
There was a problem hiding this comment.
Suggested change
|
||||||||||||||||||||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.