NUnit 執行器概觀

發行項
05/26/2024

NUnit 執行器是 VSTest 的輕量型且可攜式替代方案，適合在所有內容中執行測試 (例如，持續整合 (CI) 管線、CLI、Visual Studio 測試總管和 VS Code 文字總管)。 NUnit 執行器會直接內嵌在 NUnit 測試專案中，而且沒有其他應用程式相依性，例如執行測試所需的 vstest.console 或 dotnet test。

NUnit 執行器為開放原始碼，並建置在 Microsoft.Testing.Platform 程式庫上。您可以在 microsoft/testfx GitHub 存放庫中找到 Microsoft.Testing.Platform 程式碼。 NUnit 執行器會與 NUnit 5.0.0-beta.2 或更新版本搭售。

在 NUnit 專案中啟用 NUnit 執行器

您可以新增 EnableNUnitRunner 屬性，並將 OutputType 設定為專案檔中的 Exe，以啟用 NUnit 執行器。您也需要確定您使用 NUnit 5.0.0-beta.2 或更新版本。

請考慮下列範例專案檔：

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

  <PropertyGroup>
    <!-- Enable the NUnit runner, this is an opt-in feature -->
    <EnableNUnitRunner>true</EnableNUnitRunner>
    <OutputType>Exe</OutputType>

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

    <IsPackable>false</IsPackable>
    <IsTestProject>true</IsTestProject>
  </PropertyGroup>

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

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

組態和篩選

.runsettings

NUnit 執行器透過命令列選項 --settings 支援 runsettings。下列命令顯示範例。

使用 dotnet run：

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

使用 dotnet exec：

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

-或-

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

使用可執行檔：

Contoso.MyTests.exe --settings config.runsettings

測試篩選

您可以使用命令列選項 --filter 順暢地提供測試篩選條件。下列命令顯示一些範例。