Esegui test con MSTest

Esistono diversi modi per eseguire test MSTest a seconda delle esigenze. È possibile eseguire test da un IDE (ad esempio, Visual Studio, Visual Studio Code o JetBrains Rider) o dalla riga di comando o da un servizio CI (ad esempio GitHub Actions o Azure DevOps).

Storicamente, MSTest si basava su VSTest per l'esecuzione di test in tutti i contesti, ma a partire dalla versione 3.2.0, MSTest ha un proprio test runner. Questo nuovo strumento di esecuzione è più leggero e veloce rispetto a VSTest ed è il modo consigliato per eseguire test MSTest.

VSTest vs Microsoft.Testing.Platform (MTP)

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, 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 Microsoft.Testing.Platform libreria. È possibile trovare Microsoft.Testing.Platform il codice nel repository GitHub microsoft/testfx . Lo strumento di esecuzione MSTest viene fornito in bundle con MSTest in 3.2.0 o 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/4.1.0">

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

</Project>

In alternativa, è possibile abilitare MSTest runner aggiungendo la EnableMSTestRunner proprietà e l'impostazione OutputType a 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>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>

Configurazioni e filtri

.runsettings

Microsoft.Testing.Platform supporta le impostazioni di esecuzione tramite l'opzione --settingsdella riga di comando . 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

Uso dell'eseguibile:

Contoso.MyTests.exe --settings config.runsettings

Filtro dei test

È possibile fornire il filtro dei test senza problemi usando l'opzione --filterdella riga di comando . 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"

Vedere anche

• Test con dotnet test
• Test dei filtri
• Ordine Unit test