팁 (조언)
실행기 구성을 선택하기 전에 테스트 플랫폼 개요를 참조하세요.
요구 사항에 따라 MSTest 테스트를 실행하는 방법은 여러 가지가 있습니다. IDE(예: Visual Studio, Visual Studio Code 또는 JetBrains Rider) 또는 명령줄 또는 CI 서비스(예: GitHub Actions 또는 Azure DevOps)에서 테스트를 실행할 수 있습니다.
지금까지 MSTest는 모든 컨텍스트에서 테스트를 실행하기 위해 VSTest 의존했지만 버전 3.2.0부터 MSTest에는 자체 테스트 실행기를 가지고 있습니다. 이 새로운 실행기는 VSTest보다 더 가볍고 빠르며, MSTest 테스트를 실행하는 데 권장되는 방법입니다.
VSTest 및 MTP
MSTest는 VSTest 및 MTP(Microsoft.Testing.Platform)를 사용하여 테스트를 실행할 수 있습니다. MTP에 대한 지원은 모든 컨텍스트(예: CI(연속 통합) pipelines, CLI, Visual Studio 테스트 탐색기 및 VS Code 텍스트 탐색기)에서 테스트를 실행할 수 있는 MSTest Runner를 통해 지원됩니다. MSTest Runner는 MSTest 테스트 프로젝트에 직접 포함되며 테스트를 실행하는 데 필요한 다른 앱 종속성(예: vstest.console 또는 dotnet test)이 없습니다. 그러나 을 사용하여 dotnet test테스트를 계속 실행할 수 있습니다.
MSTest runner는 오픈 소스 MTP 라이브러리를 기반으로 합니다.
Microsoft.Testing.Platform GitHub 리포지토리에서 코드를 찾을 수 있습니다. MSTest Runner는 MSTest in 3.2.0 또는 그 이상의 버전과 함께 제공됩니다.
.NET 10 SDK 이상 버전을 사용하여 전용 MTP 모드를 dotnet testglobal.json선택합니다. .NET 11부터 DOTNET_TEST_RUNNER 환경 변수를 사용하여 현재 프로세스에 대한 해당 선택을 재정의할 수 있습니다. 지원되는 입력, SDK 버전 요구 사항 및 MTP 관련 옵션은 MTP를 참조하세요dotnet test.
프로그래밍 방식의 테스트 검색 및 실행
사용자 지정 테스트 UI, 통합 테스트 서비스 또는 보고서 생성기의 경우 테스트 플랫폼과 일치하는 인터페이스를 선택합니다.
| Requirement | Interface | Details |
|---|---|---|
| 메타데이터 및 라이브 결과를 사용하여 .NET 코드에서 MTP 테스트를 검색하고 실행합니다. | MTP 서버 모드 클라이언트 | MTP 2.4부터 Microsoft.Testing.Platform.ServerMode.Client.Sources는 형식화된 검색 및 실행 메서드를 제공합니다. 패키지는 내부 C# 형식을 주입합니다. 다른 .NET 언어는 C# 래퍼를 호출할 수 있습니다. |
| 명령줄 프로세스를 통해 MTP 테스트를 검색하고 구조화된 메타데이터를 활용합니다. | --list-tests json |
MTP 2.3 이상에서 사용할 수 있습니다. JSON 문서를 읽은 다음, 선택한 테스트를 --filter-uid로 실행하세요. 텍스트 형식은 컴퓨터에서 읽을 수 있는 API가 아닙니다. |
| 기존 VSTest 검색 및 실행 통합을 유지합니다. | Microsoft.TestPlatform.TranslationLayer |
vstest.console를 VsTestConsoleWrapper 및 호환되는 VSTest 어댑터와 함께 사용합니다. 래퍼는 네이티브 MTP 프로토콜이 아닌 VSTest 프로토콜을 사용합니다. |
| 테스트 메타데이터를 사용하거나 테스트 프로세스 내에서 사용자 지정 보고서를 생성합니다. | MTP 확장 | 테스트 프레임워크가 게시하는 메시지를 소비하도록 IDataConsumer를 구현합니다. 이 확장 지점은 외부 테스트 클라이언트 API가 아닙니다. |
MTP는 탐색 및 실행을 지원합니다. 터미널 출력을 구문 분석하거나 형식화된 서버 모드 클라이언트를 사용하기 위해 Process.Start 래퍼를 빌드할 필요가 없습니다. 전체 C# 예제 및 Visual Basic 호출 코드에 대해서는 .NET에서 테스트 검색 및 실행을 참조하세요.
검색에는 MSTest 범주 및 사용자 지정 TestProperty 메타데이터가 포함될 수 있습니다. 사용 가능한 필드는 프레임워크 및 전송에 따라 달라집니다. 두 API 모두 임의의 메모리 내 속성을 직렬화하지 않습니다.
업데이트 및 메타데이터 사용을 참조하세요.
기존 VsTestConsoleWrapper 통합의 경우 클라이언트를 마이그레이션할 때까지 VSTest 호환 프로젝트 구성 및 어댑터를 유지합니다. 프레임워크의 VSTest 호환성은 VSTest 번역 계층을 모든 MTP 테스트 애플리케이션에 대한 클라이언트로 만들지 않습니다. 호환성 계층의 범위는 VSTest Bridge에서 확인하세요.
MSTest 프로젝트에서 MTP 사용
MSTest SDK를 사용하여 MTP 및 해당 확장의 프로젝트 구성, 버전 관리 및 맞춤을 크게 간소화할 수 있습니다.
MSTest.Sdk 는 Microsoft.NET.Sdk 프로젝트 SDK로 대체되고 MTP는 기본적으로 사용하도록 설정됩니다.
<Project Sdk="MSTest.Sdk/4.1.0">
<PropertyGroup>
<TargetFramework>net10.0</TargetFramework>
<ImplicitUsings>enable</ImplicitUsings>
<Nullable>enable</Nullable>
</PropertyGroup>
</Project>
메모
MSTest.Sdk는 프로젝트가 Microsoft.NET.Sdk를 기본 SDK로 사용할 수 있는 경우에만 작동합니다. 프로젝트에 다른 SDK가 필요한 경우 <Project Sdk="..."> 값을 MSTest.Sdk으로 바꾸지 마세요.
예를 들어 일부 ASP.NET Core 통합 테스트 프로젝트에서는 .를 사용합니다Microsoft.NET.Sdk.Web.
MSTest.Sdk
Microsoft.NET.Sdk에서 파생되므로 제공하는 ASP.NET Core SDK 대상을 Microsoft.NET.Sdk.Web 가져오지 않습니다.
MSTest를 사용하는 MSTest.Sdk대신 수동으로 구성할 수도 있습니다. 프로젝트에 다른 최상위 SDK(예 Microsoft.NET.Sdk.Web: )가 필요한 경우 수동 구성이 필요하지만 표준 Microsoft.NET.Sdk으로 선택할 수도 있습니다.
EnableMSTestRunner 속성을 추가하고 프로젝트 파일에 설정합니다 OutputTypeExe. 그런 다음 프로젝트에 필요한 MSTest 참조를 추가합니다. MSTest 3.2.0 이상 버전을 사용하고 있는지 확인하고 사용 가능한 최신 MSTest 버전으로 업데이트합니다.
다음 예제 project 파일을 고려합니다.
<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/unit-testing-with-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>
팁 (조언)
솔루션의 모든 테스트 프로젝트에서 MSTest runner를 사용하도록 하려면 개별 project 파일 대신 EnableMSTestRunner 및 TestingPlatformDotnetTestSupport 속성을 Directory.Build.props 파일에 설정합니다.
구성 및 필터
.runsettings
MTP는 명령줄 옵션을 통해 --settings를 지원합니다. 지원되는 MSTest 항목의 전체 목록은 MSTest 구성: 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. 다음 명령은 몇 가지 예를 보여 줍니다.
dotnet run사용:
dotnet run --project Contoso.MyTests -- --filter "FullyQualifiedName~UnitTest1|TestCategory=CategoryA"
dotnet exec사용:
dotnet exec Contoso.MyTests.dll --filter "FullyQualifiedName~UnitTest1|TestCategory=CategoryA"
-또는-
dotnet Contoso.MyTests.dll --filter "FullyQualifiedName~UnitTest1|TestCategory=CategoryA"
실행 파일 사용:
Contoso.MyTests.exe --filter "FullyQualifiedName~UnitTest1|TestCategory=CategoryA"
참고하십시오
.NET