Introducción al ejecutor de MSTest

Artículo
10/15/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>

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.