Omówienie modułu uruchamiającego testy MSTest

Artykuł
12/20/2024

Moduł uruchamiający MSTest to uproszczona i przenośna alternatywa dla programu VSTest do uruchamiania testów we wszystkich kontekstach (na przykład potoki ciągłej integracji, interfejsu wiersza polecenia, Eksplorator testów programu Visual Studio i Eksplorator tekstu programu VS Code). Moduł uruchamiający MSTest jest osadzony bezpośrednio w projektach testowych MSTest i nie ma żadnych innych zależności aplikacji, takich jak vstest.console lub dotnet test, wymaganych do uruchamiania testów.

Moduł uruchamiający MSTest jest oprogramowaniem Microsoft.Testing.Platform open source i bazuje na bibliotece. Kod można znaleźć Microsoft.Testing.Platform w repozytorium Microsoft/testfx w witrynie GitHub. Moduł uruchamiający MSTest jest dostarczany z pakietem MSTest in 3.2.0-preview.23623.1 lub nowszym.

Włączanie modułu uruchamiającego MSTest w projekcie MSTest

Zaleca się używanie zestawu MSTest SDK , ponieważ znacznie upraszcza konfigurację projektu i aktualizowanie projektu, a także zapewnia odpowiednie dopasowanie wersji platformy (msTest runner) i jego rozszerzeń.

Jeśli używasz programu MSTest SDK, domyślnie decydujesz się na korzystanie z modułu uruchamiającego MSTest.

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

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

</Project>

Alternatywnie możesz włączyć moduł uruchamiający MSTest, dodając EnableMSTestRunner właściwość i ustawienie OutputType do Exe pliku projektu. Należy również upewnić się, że używasz MSTest 3.2.0-preview.23623.1 lub nowszych.

Rozważmy następujący przykładowy plik projektu:

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

Napiwek

Zaleca się ustawienie właściwości EnableMSTestRunner w pliku Directory.Build.props zamiast pliku csproj, aby upewnić się, że wszystkie projekty testowe w rozwiązaniu korzystają z modułu uruchamiającego testy MSTest.

Konfiguracje i filtry

.runsettings

Moduł uruchamiający MSTest obsługuje ustawienia runsettings za pomocą opcji --settingswiersza polecenia . Aby uzyskać pełną listę obsługiwanych wpisów MSTest, zobacz Konfigurowanie msTest: Runsettings. Poniższe polecenia pokazują różne przykłady użycia.

Za pomocą polecenia dotnet run:

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

Za pomocą polecenia dotnet exec:

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

— lub —

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

Przy użyciu pliku wykonywalnego:

Contoso.MyTests.exe --settings config.runsettings

Filtr testów

Filtr testów można zapewnić bezproblemowo przy użyciu opcji --filterwiersza polecenia . W poniższych poleceniach przedstawiono kilka przykładów.