Aracılığıyla paylaş

MSTest ile test çalıştırma

gereksinimlerinize bağlı olarak MSTest testlerini çalıştırmanın birkaç yolu vardır. Testleri bir IDE'den (örneğin, Visual Studio, Visual Studio Code veya JetBrains Rider) ya da komut satırından ya da ci hizmetinden (GitHub Actions veya Azure DevOps gibi) çalıştırabilirsiniz.

Geçmişte MSTest, tüm bağlamlarda testleri çalıştırmak için VSTest'e bağımlıdır ancak 3.2.0 sürümünden başlayarak MSTest'in kendi test çalıştırıcısı vardır. Bu yeni çalıştırıcı VSTest'ten daha basit ve daha hızlıdır ve MSTest testlerini çalıştırmak için önerilen yöntemdir.

VSTest vs Microsoft.Testing.Platform (MTP)

MSTest hem VSTest hem de Microsoft.Testing.Platform (MTP) ile test çalıştırmayı destekler. MTP desteği, tüm bağlamlarda (örneğin, sürekli tümleştirme (CI) işlem hatları, CLI, Visual Studio Test Gezgini ve VS Code Metin Gezgini) testleri çalıştırabilen MSTest çalıştırıcısı tarafından desteklenir. MSTest çalıştırıcısı doğrudan MSTest test projenize gömülüdür ve testlerinizi çalıştırmak için vstest.console veya dotnet test gibi başka uygulama bağımlılıkları yoktur. Ancak, kullanarak dotnet testtestlerinizi yine de çalıştırabilirsiniz.

MSTest çalıştırıcısı açık kaynaklıdır ve Microsoft.Testing.Platform kütüphanesi üzerine inşa edilmiştir. Kodu Microsoft.Testing.Platform GitHub deposunda bulabilirsiniz. MSTest çalıştırıcısı MSTest in 3.2.0 veya daha yenisi ile birlikte paketlenmiştir.

MSTest projesinde Microsoft.Testing.Platform'u etkinleştirme

Proje yapılandırmanızı ve projeyi güncelleştirmeyi büyük ölçüde basitleştirdiğinden ve platformun (Microsoft.Testing.Platform) sürümleriyle uzantılarının düzgün bir şekilde hizalanmasını sağladığından MSTest SDK'sını kullanmanız önerilir.

kullandığınızda MSTest SDK, varsayılan olarak Microsoft.Testing.Platform'u kullanmaya kabul edilirsiniz.

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

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

</Project>

Alternatif olarak, proje dosyanıza EnableMSTestRunner özelliğini ekleyip OutputType'yi Exe olarak ayarlayarak MSTest çalıştırıcısını etkinleştirebilirsiniz. MSTest 3.2.0 veya daha yeni bir sürümü kullandığınızdan da emin olmanız gerekir. Kullanılabilir en son MSTest sürümüne güncelleştirmenizi kesinlikle öneririz.

Aşağıdaki örnek proje dosyasını göz önünde bulundurun:

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

Tavsiye

Çözümünüzdeki tüm test projelerinin MSTest çalıştırıcısını kullandığından emin olmak için EnableMSTestRunner ve TestingPlatformDotnetTestSupport özelliklerini tek tek proje dosyaları yerine Directory.Build.props dosyasında ayarlayın.

Yapılandırmalar ve filtreler

.runsettings

Microsoft.Testing.Platform, komut satırı seçeneği aracılığıyla --settings destekler. Desteklenen MSTest girdilerinin tam listesi için bkz. MSTest: Runsettings'i yapılandırma. Aşağıdaki komutlar çeşitli kullanım örneklerini gösterir.

dotnet runkullanma:

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

dotnet execkullanma:

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

-veya-

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

Yürütülebilir dosyayı kullanma:

Contoso.MyTests.exe --settings config.runsettings

Testler filtresi

Komut satırı seçeneğini kullanarak test filtresini sorunsuz bir şekilde sağlayabilirsiniz --filter. Aşağıdaki komutlarda bazı örnekler gösterilmektedir.

dotnet runkullanma:

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

dotnet execkullanma:

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

-veya-

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

Yürütülebilir dosyayı kullanma:

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

Ayrıca bakınız

  • Last updated on