Ejecución de pruebas con MSTest

Sugerencia

Antes de elegir una configuración de ejecutor, consulte Introducción a las plataformas de prueba.

Hay varias maneras de ejecutar pruebas de MSTest en función de las necesidades. Puede ejecutar pruebas desde un IDE (por ejemplo, Visual Studio, Visual Studio Code o JetBrains Rider), o desde la línea de comandos, o desde un servicio de CI (como Acciones de GitHub o Azure DevOps).

Históricamente, MSTest se basaba en VSTest para ejecutar pruebas en todos los contextos, pero a partir de la versión 3.2.0, MSTest tiene su propio ejecutor de pruebas. Este nuevo ejecutor es más ligero y más rápido que VSTest, y es la manera recomendada de ejecutar pruebas de MSTest.

VSTest frente a MTP

MSTest admite la ejecución de pruebas con VSTest y Microsoft.Testing.Platform (MTP). La compatibilidad con MTP se basa en el ejecutor de MSTest, que puede ejecutar pruebas en todos los contextos (por ejemplo, canales de integración continua (IC), 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 otras dependencias de la aplicación, como vstest.console o dotnet test, necesarias para ejecutar las pruebas. Sin embargo, todavía puede ejecutar las pruebas mediante dotnet test.

El ejecutor de MSTest se código abierto y se basa en la biblioteca MTP. Puede encontrar código Microsoft.Testing.Platform en el repositorio microsoft/testfx GitHub. El ejecutor de pruebas MSTest viene incluido con MSTest in 3.2.0 o una versión más reciente.

Habilitación de MTP en un proyecto de MSTest

Use el SDK de MSTest para simplificar considerablemente la configuración del proyecto, la administración de versiones y la alineación de MTP y sus extensiones.

MSTest.Sdk sustituye a Microsoft.NET.Sdk como SDK del proyecto, y MTP está habilitado de forma predeterminada:

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

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

</Project>

Note

MSTest.Sdk solo funciona cuando el proyecto puede usar Microsoft.NET.Sdk como SDK base. Si el project requiere un SDK diferente, no reemplace el <Project Sdk="..."> valor por MSTest.Sdk.

Por ejemplo, algunos proyectos de prueba de integración de ASP.NET Core usan Microsoft.NET.Sdk.Web. MSTest.Sdk deriva de Microsoft.NET.Sdk, por lo que no importa los objetivos del SDK de ASP.NET Core que Microsoft.NET.Sdk.Web proporciona.

También puede configurar MSTest manualmente en lugar de usar MSTest.Sdk. La configuración manual es necesaria cuando el proyecto necesita un SDK de nivel superior diferente (por ejemplo, Microsoft.NET.Sdk.Web), pero también puede elegirlo con el estándar Microsoft.NET.Sdk. Agregue la propiedad EnableMSTestRunner y establezca OutputType en Exe en el archivo del proyecto. A continuación, agregue las referencias de MSTest que requiere el proyecto. Asegúrese de que usa MSTest 3.2.0 o posterior y actualice a la versión más reciente de MSTest disponible.

Considere el siguiente archivo de proyecto de ejemplo:

<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/unit-testing-with-dotnet-test#show-failure-per-test
      -->
    <TestingPlatformShowTestsFailure>true</TestingPlatformShowTestsFailure>

    <OutputType>Exe</OutputType>

    <TargetFramework>net10.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="4.1.0" />
  </ItemGroup>

</Project>

Sugerencia

Para asegurarse de que todos los proyectos de prueba de la solución usan el ejecutor de MSTest, establezca las propiedades EnableMSTestRunner y TestingPlatformDotnetTestSupport en Directory.Build.props en lugar de archivos project individuales.

Configuraciones y filtros

.runsettings

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

Uso de dotnet run:

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

Uso de dotnet exec:

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

O bien:

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

Usando el archivo ejecutable:

Contoso.MyTests.exe --settings config.runsettings

Filtro de pruebas

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