Condividi tramite


Supporto di Microsoft.Testing.Platform in MSTest (MSTest runner)

MSTest supporta l'esecuzione di test con VSTest e Microsoft.Testing.Platform (MTP). Il supporto per MTP è basato sullo strumento di esecuzione MSTest, che può eseguire test in tutti i contesti, ad esempio pipeline di integrazione continua (CI), interfaccia della riga di comando, Esplora test di Visual Studio e Esplora testo di VS Code. Lo strumento di esecuzione MSTest è incorporato direttamente nei progetti di test MSTest e non sono necessarie altre dipendenze dell'app, come ad esempio vstest.console o dotnet test per eseguire i test. Tuttavia, è comunque possibile eseguire i test usando dotnet test.

MsTest runner è open source e si basa sulla libreria Microsoft.Testing.Platform. È possibile trovare il codice Microsoft.Testing.Platform nel repository GitHub microsoft/testfx. Il runner MSTest viene fornito con MSTest in 3.2.0 o una versione successiva.

Abilitare Microsoft.Testing.Platform in un progetto MSTest

È consigliabile usare MSTest SDK perché semplifica notevolmente la configurazione del progetto e aggiorna il progetto e garantisce un allineamento corretto delle versioni della piattaforma (Microsoft.Testing.Platform) e delle relative estensioni.

Quando si usa MSTest SDK, per impostazione predefinita si è scelto di usare Microsoft.Testing.Platform.

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

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

</Project>

In alternativa, è possibile abilitare lo strumento di esecuzione MSTest aggiungendo la proprietà EnableMSTestRunner e impostando OutputType su Exe nel file di progetto. È anche necessario assicurarsi di usare MSTest 3.2.0 o versione successiva. È consigliabile eseguire l'aggiornamento alla versione più recente di MSTest disponibile.

Si consideri il file di progetto di esempio seguente:

<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>

Suggerimento

Per assicurarsi che tutti i progetti di test nella soluzione usino lo strumento di esecuzione MSTest, impostare le proprietà EnableMSTestRunner e TestingPlatformDotnetTestSupport in file Directory.Build.props anziché singoli file di progetto.

Configurazioni e filtri

.runsettings

Microsoft.Testing.Platform supporta il runsettings tramite l'opzione della riga di comando --settings. Per l'elenco completo delle voci MSTest supportate, vedere Configurare MSTest: Runsettings. I comandi seguenti mostrano vari esempi di utilizzo.

Utilizzo di dotnet run:

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

Utilizzo di dotnet exec:

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

oppure

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

Utilizzo del file eseguibile:

Contoso.MyTests.exe --settings config.runsettings

Filtro dei test

È possibile fornire il filtro di test con semplicità usando l'opzione della riga di comando --filter. I comandi seguenti mostrano alcuni esempi.

Utilizzo di dotnet run:

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

Utilizzo di dotnet exec:

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

oppure

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

Uso dell'eseguibile

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