Podpora Microsoft.Testing.Platform (MTP) v NUnit (NUnit runner)

Spropitné

Před povolením běžce se podívejte na přehled testovacích platforem.

NUnit podporuje spouštění testů s VSTest a Microsoft.Testing.Platform (MTP). Podpora MTP je založená na spouštěči NUnit, který může spouštět testy ve všech kontextech (například kontinuální integrace (CI), pipeliny, příkazová řádka, Průzkumník testů Visual Studio a VS Code Test Explorer). Spouštěč NUnit je vložený přímo do testovacích projektů NUnit a nejsou k dispozici žádné další závislosti aplikací, jako jsou vstest.console nebo dotnet test, potřebné ke spuštění testů. Přesto však můžete testy spouštět pomocí dotnet test.

Běžící modul NUnit je open source a vychází z MTP. Kód Microsoft.Testing.Platform najdete v úložišti microsoft/testfx GitHub. Spouštěč NUnit je podporován v NUnit3TestAdapter verze 5.0 nebo vyšší. Další informace najdete v tématu NUnit a MTP.

Povolit spouštěč NUnit v projektu NUnit

NUnit runner můžete povolit přidáním vlastnosti EnableNUnitRunner a nastavením OutputType na Exe do souboru project. Musíte také zajistit, že používáte NUnit3TestAdapter verze 5.0 nebo novější.

Spropitné

Pokud chcete zajistit, aby všechny testovací projekty ve vašem řešení používaly spouštěč NUnit, nastavte vlastnosti EnableNUnitRunner a TestingPlatformDotnetTestSupport v souboru Directory.Build.props místo jednotlivých souborů projektů.

Podívejte se na následující příklad project souboru:

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <!-- Enable the NUnit runner, this is an opt-in feature -->
    <EnableNUnitRunner>true</EnableNUnitRunner>
    <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>net8.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.9.0" />
    <PackageReference Include="NUnit" Version="4.3.2" />
    <PackageReference Include="NUnit.Analyzers" Version="4.6.0">
      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
      <PrivateAssets>all</PrivateAssets>
    </PackageReference>
    <PackageReference Include="NUnit3TestAdapter" Version="5.0.0" />

    <!--
      Coverlet collector isn't compatible with NUnit 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>

Konfigurace a filtry

.runsettings

NUnit runner podporuje runsettings prostřednictvím možnosti příkazového řádku --settings. Následující příkazy ukazují příklady.

Použití dotnet run:

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

Použití dotnet exec:

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

-nebo-

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

Používání spustitelného souboru:

Contoso.MyTests.exe --settings config.runsettings

Filtr testů

Můžete testy filtrovat bez problémů pomocí volby příkazového řádku --filter. Následující příkazy ukazují některé příklady.