Introducción al ejecutor de MSTest

Artículo
12/20/2024

El ejecutor de MSTest es una alternativa ligera y portátil a VSTest para ejecutar pruebas en todos los contextos (por ejemplo, canalizaciones de integración continua [CI], CLI, Explorador de pruebas de Visual Studio y Explorador de texto de VS Code). El ejecutor de MSTest se inserta directamente en los proyectos de prueba de MSTest y no hay dependencias de otras aplicaciones, como vstest.console o dotnet test, necesarias para ejecutar las pruebas.

El ejecutor de MSTest es de código abierto y se basa en una biblioteca Microsoft.Testing.Platform. Puede encontrar el código Microsoft.Testing.Platform en el repositorio de GitHub microsoft/testfx. El ejecutor de MSTest viene incluido con MSTest in 3.2.0-preview.23623.1 o una versión posterior.

Habilitación del ejecutor de MSTest en un proyecto de MSTest

Se recomienda utilizar el SDK de MSTest, ya que simplifica enormemente la configuración y la actualización del proyecto, y garantiza una alineación adecuada de las versiones de la plataforma (ejecutor de MSTest) y sus extensiones.

Cuando se usa MSTest SDK, de forma predeterminada se opta por usar el ejecutor de MSTest.

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

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

</Project>

Como alternativa, puede habilitar el ejecutor de MSTest añadiendo la propiedad EnableMSTestRunner y estableciendo OutputType en Exe en su archivo de proyecto. También debe asegurarse de que usa MSTest 3.2.0-preview.23623.1 o más reciente.

Considere el siguiente archivo de proyecto de ejemplo:

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

  <PropertyGroup>
    <!-- Enable the MSTest runner, this is an opt-in feature -->
    <EnableMSTestRunner>true</EnableMSTestRunner>
    <OutputType>Exe</OutputType>

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

    <IsPackable>false</IsPackable>
    <IsTestProject>true</IsTestProject>
  </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
    -->
    <PackageReference Include="MSTest" Version="3.2.0" />

    <!--
      Coverlet collector isn't compatible with MSTest runner, 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>

Sugerencia

Se recomienda establecer la propiedad EnableMSTestRunner en Directory.Build.props archivo en lugar de archivo csproj para asegurarse de que todos los proyectos de prueba de la solución usan el ejecutor de MSTest.

Configuraciones y filtros

.runsettings

El ejecutor de MSTest admite el runsettings a través de la opción de línea de comandos --settings. Para obtener la lista completa de entradas de MSTest admitidas, consulte Configuración de MSTest: Runsettings. Los siguientes comandos muestran varios ejemplos de uso.

Usar dotnet run:

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

Usar dotnet exec:

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

O bien

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

Con el archivo ejecutable:

Contoso.MyTests.exe --settings config.runsettings

Filtro de pruebas

Puede proporcionar las pruebas de filtro sin problemas mediante la opción de línea de comandos --filter. Los siguientes comandos muestran algunos ejemplos.