Suporte à Microsoft.Testing.Platform no MSTest (executor do MSTest)

O MSTest dá suporte à execução de testes com o VSTest e o Microsoft.Testing.Platform (MTP). O suporte para MTP é alimentado pelo executor MSTest, que pode executar testes em todos os contextos (por exemplo, pipelines de CI (integração contínua), CLI, Gerenciador de Testes do Visual Studio e Gerenciador de Texto do VS Code). O executor MSTest é incorporado diretamente em seus projetos de teste MSTest e não há outras dependências de aplicativo, como vstest.console ou dotnet test, necessárias para executar seus testes. No entanto, você ainda pode executar seus testes usando dotnet test.

O executor MSTest é de software livre e se baseia na Microsoft.Testing.Platform biblioteca. Você pode encontrar Microsoft.Testing.Platform código no repositório GitHub microsoft/testfx . O executor MSTest vem empacotado com o MSTest in 3.2.0 ou mais recente.

Habilitar Microsoft.Testing.Platform em um projeto MSTest

É recomendável usar o SDK do MSTest , pois simplifica muito a configuração do projeto e a atualização do projeto e garante um alinhamento adequado das versões da plataforma (Microsoft.Testing.Platform) e suas extensões.

Quando você usa MSTest SDK, por padrão, você é optado por usar Microsoft.Testing.Platform.

<Project Sdk="MSTest.Sdk/3.8.2">

  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>

</Project>

Como alternativa, você pode habilitar o executor MSTest adicionando a propriedade EnableMSTestRunner e a configuração OutputType a Exe no seu arquivo de projeto. Você também precisa garantir que está usando MSTest 3.2.0 ou mais recente. Recomendamos que você atualize para a versão mais recente do MSTest disponível.

Considere o seguinte arquivo de projeto de exemplo:

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <!-- Enable Microsoft.Testing.Platform, this is an opt-in feature -->
    <EnableMSTestRunner>true</EnableMSTestRunner>
    <TestingPlatformDotnetTestSupport>true</TestingPlatformDotnetTestSupport>

    <!--
      Displays error on console in addition to the log file. Note that this feature comes with a performance impact.
      For more information, visit https://learn.microsoft.com/dotnet/core/testing/microsoft-testing-platform-integration-dotnet-test#show-failure-per-test
      -->
    <TestingPlatformShowTestsFailure>true</TestingPlatformShowTestsFailure>

    <OutputType>Exe</OutputType>

    <TargetFramework>net8.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>

  <ItemGroup>
    <!--
      MSTest meta package is the recommended way to reference MSTest.
      It's equivalent to referencing:
          Microsoft.NET.Test.Sdk
          MSTest.TestAdapter
          MSTest.TestFramework
          MSTest.Analyzers
      Starting with 3.8, it also includes:
          Microsoft.Testing.Extensions.TrxReport
          Microsoft.Testing.Extensions.CodeCoverage
    -->
    <PackageReference Include="MSTest" Version="3.8.0" />

    <!--
      Coverlet collector isn't compatible with Microsoft.Testing.Platform, you can
      either switch to Microsoft CodeCoverage (as shown below),
      or switch to be using coverlet global tool
      https://github.com/coverlet-coverage/coverlet#net-global-tool-guide-suffers-from-possible-known-issue
    -->
    <PackageReference Include="Microsoft.Testing.Extensions.CodeCoverage"
                      Version="17.10.1" />
  </ItemGroup>

</Project>

Configurações e filtros

.runsettings

Microsoft.Testing.Platform dá suporte aos runsettings por meio da opção --settingsde linha de comando. Para obter a lista completa de entradas do MSTest com suporte, consulte Configurar o MSTest: configurações de execução. Os comandos a seguir mostram vários exemplos de uso.

Usando dotnet run:

dotnet run --project Contoso.MyTests -- --settings config.runsettings

Usando dotnet exec:

dotnet exec Contoso.MyTests.dll --settings config.runsettings

-ou-

dotnet Contoso.MyTests.dll --settings config.runsettings

Usando o executável:

Contoso.MyTests.exe --settings config.runsettings

Filtro de testes

Você pode fornecer o filtro de testes perfeitamente usando a opção de linha de comando --filter. Os comandos a seguir mostram alguns exemplos.

Usando dotnet run:

dotnet run --project Contoso.MyTests -- --filter "FullyQualifiedName~UnitTest1|TestCategory=CategoryA"

Usando dotnet exec:

dotnet exec Contoso.MyTests.dll --filter "FullyQualifiedName~UnitTest1|TestCategory=CategoryA"

-ou-

dotnet Contoso.MyTests.dll --filter "FullyQualifiedName~UnitTest1|TestCategory=CategoryA"

Usando o executável:

Contoso.MyTests.exe --filter "FullyQualifiedName~UnitTest1|TestCategory=CategoryA"