此扩展提供与 VSTest 的兼容性层,允许使用 VSTest 实现的测试框架:
- 轻松使用 Microsoft.Testing.Platform (MTP) 进行运行,无需重大重写。
- 支持具有相同测试框架实现的 VSTest 和 MTP。
此扩展作为 Microsoft.Testing.Extensions.VSTestBridge NuGet 包的一部分提供。
与 VSTest 的兼容性
此扩展的主要目的是通过支持双模式为 VSTest 用户提供轻松流畅的升级体验,在双模式下启用新平台,同时提供兼容模式以允许常规工作流继续工作。
网桥会将基于 VSTest 的测试框架适配到 MTP。 它不会将 VsTestConsoleWrapper 变成原生 MTP 客户端,也不保证每个 MTP 框架都能通过 VSTest 运行。 现有 Microsoft.TestPlatform.TranslationLayer 集成仍需要 vstest.console以及兼容的 VSTest 适配器。
对于用于发现并运行 MTP 测试的新工具,请使用 MTP 服务器模式客户端。 有关其他集成选项,请参阅 以编程方式进行的测试发现和执行。
Runsettings 支持
通过此扩展,可提供 VSTest .runsettings 文件,但并非此文件中的所有选项都会被该平台选取。 下面介绍了支持和不支持的设置、配置选项和最常用的 VSTest 配置选项的替代项。
通过测试框架启用后,可使用 --settings <SETTINGS_FILE> 提供 .runsettings 文件。
RunConfiguration 元素
MTP 不支持以下 RunConfiguration 元素:
| Node | 说明 | 原因/解决方法 |
|---|---|---|
| MaxCpuCount | 此设置控制进程级别的并行度。 使用 0 启用最大进程级并行度。 | 将 MTP 与 MSBuild 一起使用时,此选项 将卸载到 MSBuild。 运行单个可执行文件时,此选项对 MTP 没有意义。 |
| ResultsDirectory | 在其中放置测试结果的目录。 该路径相对于包含 .runsettings 文件的目录。 | 使用--results-directory命令行选项设置结果目录。 有关 dotnet test 默认值和布局,请参阅 结果和构件。 |
| TargetFrameworkVersion | 此设置定义用于运行测试的框架版本或框架系列。 | 忽略该选项。
<TargetFramework> 或 <TargetFrameworks> MSBuild 属性确定应用程序的目标框架。 测试托管在最终应用程序中。 |
| TargetPlatform | 此设置定义用于运行测试的体系结构。 |
<RuntimeIdentifier> 确定托管测试的最终应用程序的体系结构。 |
| 将测试适配器错误视作警告 | 禁止测试适配器错误成为警告。 | MTP 仅允许从单个程序集运行一种类型的测试,并且加载测试框架或其他基础结构部分失败将成为不可跳过的错误,因为它表示无法发现或运行某些测试。 |
| 测试适配器路径 | TestAdapters 所在目录的一个或多个路径 | MTP 不使用测试适配器的概念,并且除非扩展是构建的一部分并且已在 Program.cs 中注册,否则不允许动态加载扩展。这些扩展可以通过构建目标自动注册,也可以手动注册。 |
| TestCaseFilter | 用于限制将运行的测试的筛选器。 | 从 v1.6 开始,现在此 runsettings 条目被支持。 在此版本之前,应改用 --filter 命令行选项。 |
| TestSessionTimeout | 当测试会话超过给定时间,允许用户终止测试会话。 | 没有替代选项。 |
| DotnetHostPath | 指定用于运行测试主机的 dotnet host 的自定义路径。 | MTP 不会对 dotnet 执行任何其他解析。 这完全取决于 dotnet 如何解析自身,这可以由 DOTNET_HOST_PATH 等环境变量来控制。 |
| 将无测试视为错误 | 如果未发现任何测试,则使用非零退出代码退出。 | 默认情况下,在测试应用程序中未发现或运行测试时,MTP 将出错。 可以使用 --minimum-expected-tests 命令行参数设置希望在程序集中找到的测试数量,该参数默认为 1。 |
DataCollectors 元素
MTP 不使用数据收集器。 而是采用进程内和进程外扩展的概念。 每个扩展都通过其各自的配置文件或通过命令行进行配置。
LoggerRunSettings 元素
MTP 中的记录器通过命令行参数或代码中的设置进行配置。
VSTest 筛选器支持
此扩展还提供使用 VSTest 筛选机制发现或仅运行与筛选表达式匹配的测试的功能。 有关详细信息,请参阅筛选器选项详细信息一节,或有关特定于框架的详细信息,请参阅运行选择性单元测试页。
通过测试框架启用后,可使用 --filter <FILTER_EXPRESSION>。
TestRun 参数
可以使用 --test-parameter格式的 key=value 命令行选项将参数传递给测试运行。 可以多次指定此选项,为每个要设置的参数指定一个。
然后,测试运行中的测试框架可以访问这些参数:
- 对于 MSTest,请使用 Properties
- 对于 NUnit,请使用 TestContext.TestParameters