이 자습서에서는 단위 테스트 개념을 알아보기 위해 샘플 솔루션을 단계별로 빌드하는 대화형 환경을 안내합니다. 미리 빌드된 솔루션을 사용하여 자습서를 수행하고자 한다면, 시작하기 전에 샘플 코드 을(를) 보거나을(를) 다운로드하십시오. 다운로드 지침은 샘플 및 자습서참조하세요.
이 문서에서는 .NET Core 프로젝트를 테스트하는 방법에 대해 알아봅니다. ASP.NET Core 프로젝트를 테스트하는 경우 ASP.NET Core 통합 테스트를 참조하세요.
필수 조건
- 최신 .NET SDK
- Visual Studio Code 편집기
- C# 개발 키트
원본 프로젝트 만들기
셸 창을 엽니다. 솔루션을 보관할 unit-testing-using-mstest라는 디렉터리를 만듭니다. 이 새 디렉터리 내에서 dotnet new sln 실행하여 클래스 라이브러리 및 테스트 프로젝트에 대한 새 솔루션 파일을 만듭니다.
PrimeService 디렉터리를 만듭니다. 다음 개요는 지금까지의 디렉터리 및 파일 구조를 보여줍니다.
/unit-testing-using-mstest
unit-testing-using-mstest.sln
/PrimeService
현재 디렉터리를 PrimeService로 설정하고, dotnet new classlib를 실행하여 원본 프로젝트를 만드십시오.
디렉터리를 unit-testing-using-mstest 디렉터리로 다시 변경합니다.
dotnet sln add 실행하여 솔루션에 클래스 라이브러리 프로젝트를 추가합니다.
dotnet sln add PrimeService/PrimeService.csproj
PrimeService.cs 디렉터리에서 PrimeService의 이름을 Class1.cs(으)로 바꿉니다. 파일의 코드를 다음 코드로 바꿔 PrimeService 클래스의 실패한 구현을 만듭니다.
using System;
namespace Prime.Services
{
public class PrimeService
{
public bool IsPrime(int candidate)
{
throw new NotImplementedException("Please create a test first.");
}
}
}
테스트 프로젝트 만들기
PrimeService.Tests 디렉터리를 만듭니다. 다음 개요는 디렉터리 구조를 보여줍니다.
/unit-testing-using-mstest
unit-testing-using-mstest.sln
/PrimeService
Source Files
PrimeService.csproj
/PrimeService.Tests
PrimeService.Tests 디렉터리를 현재 디렉터리로 만들고 dotnet new mstest사용하여 새 프로젝트를 만듭니다. dotnet new 명령은 MSTest를 테스트 라이브러리로 사용하는 테스트 프로젝트를 만듭니다. 템플릿은 PrimeServiceTests.csproj 파일에서 테스트 실행기를 구성합니다.
<ItemGroup>
<PackageReference Include="MSTest" Version="4.1.0" />
</ItemGroup>
Note
표시된 패키지 버전은 예시입니다. 생성된 dotnet new mstest 버전은 .NET SDK에 따라 달라집니다. 템플릿 및 다운로드한 샘플은 최신 NuGet 패키지 버전을 사용하지 않을 수 있습니다.
테스트를 만들고 실행한 후 업데이트를 확인하려면 테스트 프로젝트 디렉터리에서 dotnet package list --outdated을 실행합니다. 패키지 참조를 최신 호환 안정적인 버전으로 업데이트하는 데 사용합니다 dotnet package add <PACKAGE_NAME> . 업데이트하기 전에 호환성이 깨지는 변경 사항에 대한 릴리스 정보를 검토하고, afterward. dotnet test를 다시 실행합니다
.NET 9 SDK 또는 이전 버전을 사용하는 경우 dotnet list package --outdated 및 dotnet add package <PACKAGE_NAME>를 대신 사용하세요.
테스트 프로젝트에는 단위 테스트를 만들고 실행하는 다른 패키지가 필요합니다. 이전 단계의 dotnet new 코드 검사 보고에 필요한 MSTest 패키지 및 도구를 추가했습니다.
PrimeService 클래스 라이브러리를 프로젝트에 다른 종속성으로 추가합니다.
dotnet reference add 명령을 사용합니다.
dotnet reference add ../PrimeService/PrimeService.csproj
GitHub의 샘플 리포지토리 전체 파일을 볼 수 있습니다.
다음 개요는 최종 솔루션 레이아웃을 보여줍니다.
/unit-testing-using-mstest
unit-testing-using-mstest.sln
/PrimeService
Source Files
PrimeService.csproj
/PrimeService.Tests
Test Source Files
PrimeServiceTests.csproj
unit-testing-using-mstest 디렉터리로 변경하고 dotnet sln add실행합니다.
dotnet sln add ./PrimeService.Tests/PrimeService.Tests.csproj
첫 번째 테스트 만들기
실패한 테스트를 작성하고 통과한 다음 프로세스를 반복합니다. PrimeService.Tests 디렉터리에서 UnitTest1.cs 제거하고 다음 콘텐츠가 포함된 PrimeService_IsPrimeShould.cs 새 C# 파일을 만듭니다.
using Microsoft.VisualStudio.TestTools.UnitTesting;
using Prime.Services;
namespace Prime.UnitTests.Services
{
[TestClass]
public class PrimeService_IsPrimeShould
{
private readonly PrimeService _primeService;
public PrimeService_IsPrimeShould()
{
_primeService = new PrimeService();
}
[TestMethod]
public void IsPrime_InputIs1_ReturnFalse()
{
bool result = _primeService.IsPrime(1);
Assert.IsFalse(result, "1 shouldn't be prime");
}
}
}
TestClass 특성 단위 테스트가 포함된 클래스를 나타냅니다. TestMethod 특성 메서드가 테스트 메서드임을 나타냅니다.
MSTest는 각 테스트에 대해 테스트 클래스의 새 인스턴스를 만들므로 생성자는 각 테스트에 대해 별도의 PrimeService 인스턴스를 만듭니다. 생성자에는 이 클래스의 모든 테스트에 필요한 설정만 포함됩니다. 테스트에 다른 설정이 필요한 경우 테스트 메서드에서 개체를 만들거나 해당 메서드에서 도우미 메서드를 호출합니다. 지침은 Setup 및 Teardown 대신 도우미 메서드 사용을 참조하세요.
이 파일을 저장하고 dotnet test 실행하여 테스트 및 클래스 라이브러리를 빌드한 다음 테스트를 실행합니다. MSTest 테스트 실행기는 테스트를 실행할 프로그램 진입점을 포함합니다.
dotnet test 는 만든 단위 테스트 프로젝트를 사용하여 테스트 실행기를 시작합니다.
아직 구현을 만들지 않았기 때문에 테스트가 실패합니다. 작동하는 PrimeService 클래스에서 가장 간단한 코드를 작성하여 이 테스트를 통과합니다.
public bool IsPrime(int candidate)
{
if (candidate == 1)
{
return false;
}
throw new NotImplementedException("Please create a test first.");
}
unit-testing-using-mstest 디렉터리에서 dotnet test 다시 실행합니다.
dotnet test 명령은 PrimeService 프로젝트 및 PrimeService.Tests 프로젝트에 대한 빌드를 실행합니다. 두 프로젝트를 모두 빌드한 후 이 단일 테스트를 실행합니다. 통과합니다.
추가 기능 추가
테스트를 한 번 통과했으니 이제 더 많은 테스트를 작성해야 합니다. 소수에 대한 몇 가지 다른 간단한 사례가 있습니다: 0, -1. TestMethod 특성사용하여 새 테스트를 추가할 수 있지만 빠르게 지루해집니다. 유사한 테스트 제품군을 작성할 수 있는 다른 MSTest 특성이 있습니다. 테스트 메서드는 동일한 코드를 실행할 수 있지만 입력 인수는 다릅니다. DataRow 특성 사용하여 해당 입력에 대한 값을 지정할 수 있습니다.
새 테스트를 만드는 대신 이러한 두 특성을 적용하여 단일 데이터 기반 테스트를 만듭니다. 데이터 기반 테스트는 가장 낮은 소수인 2보다 작은 여러 값을 테스트하는 방법입니다. PrimeService_IsPrimeShould.cs새 테스트 메서드를 추가합니다.
[TestMethod]
[DataRow(-1)]
[DataRow(0)]
[DataRow(1)]
public void IsPrime_ValuesLessThan2_ReturnFalse(int value)
{
bool result = _primeService.IsPrime(value);
Assert.IsFalse(result, $"{value} should not be prime");
}
dotnet test실행하면 이러한 테스트 중 두 가지가 실패합니다. 모든 테스트를 통과하려면 if 파일에서 IsPrime 메서드의 시작 부분에 있는 절을 변경합니다.
if (candidate < 2)
주 라이브러리에 더 많은 테스트, 더 많은 이론 및 더 많은 코드를 추가하여 계속 반복합니다. 테스트 의 완료된 버전과 라이브러리 의완전한 구현이 있습니다.
작은 라이브러리와 해당 라이브러리에 대한 단위 테스트 집합을 빌드했습니다. 새 패키지 및 테스트를 추가하는 것이 일반 워크플로의 일부가 되도록 솔루션을 구성했습니다. 대부분의 시간과 노력을 집중하여 애플리케이션의 목표를 해결했습니다.
Azure Pipelines 테스트 실행
변경 내용을 푸시할 때 테스트를 자동으로 실행하려면 완료된 솔루션이 포함된 리포지토리에 Azure Pipelines 구성을 추가하세요. Azure DevOps 프로젝트와 Microsoft 호스팅 에이전트에 대한 액세스 권한이 필요합니다. 필수 구성 요소는 첫 번째 파이프라인 만들기를 참조하세요.
리포지토리의 루트에서 다음 콘텐츠를 사용하여
azure-pipelines.yml파일을 만듭니다. 이 예제에서는PrimeService및PrimeService.Tests디렉터리가 리포지토리 루트에 있으며 두 프로젝트 모두 .NET 10을 대상으로 한다고 가정합니다.trigger: - main pool: vmImage: ubuntu-latest steps: - task: UseDotNet@2 displayName: Install .NET SDK inputs: packageType: sdk version: 10.0.x - task: DotNetCoreCLI@2 displayName: Run MSTest tests inputs: command: test projects: PrimeService.Tests/PrimeService.Tests.csproj arguments: --configuration Release publishTestResults: true리포지토리와 일치하도록 구성을 조정합니다.
- 브랜치 이름이 다른 경우
trigger에서main를 해당 브랜치 이름으로 바꾸세요. - 솔루션이 하위 디렉터리에 있는 경우 리포지토리 루트를 기준으로 테스트 프로젝트의 경로로
projects를 업데이트합니다. - 프로젝트가 다른 .NET 버전을 대상으로 하는 경우 일치하도록
UseDotNet@2작업의version을(를) 변경합니다. 예를 들어8.0.x을 대상으로 하는 프로젝트에는net8.0를 사용합니다. 리포지토리에global.json파일이 포함된 경우 설치된 SDK가 해당 버전 요구 사항을 충족하는지 확인하세요.
- 브랜치 이름이 다른 경우
자신의 솔루션 및
azure-pipelines.yml파일을 자신의 Git 리포지토리에 커밋하고 푸시합니다.Azure DevOps 프로젝트에서 파이프라인>을 선택하거나 첫 번째 파이프라인인 경우 파이프라인 만들기를 선택합니다. 리포지토리 공급자 및 리포지토리를 선택합니다.
파이프라인 구성 페이지에서 기존 Azure Pipelines YAML 파일을 선택하고, 분기와
/azure-pipelines.yml를 선택한 다음 계속을 선택합니다. 구성을 검토하고 실행을 선택합니다.
UseDotNet@2태스크는 .NET SDK를 설치합니다.
DotNetCoreCLI@2 작업은 dotnet test를 실행하며, 이 과정에서 종속성을 복원하고 테스트 프로젝트 및 해당 프로젝트에서 참조하는 라이브러리를 빌드한 다음 릴리스 구성에서 테스트를 실행합니다.
publishTestResults: true와 함께 태스크는 TRX 결과 파일을 생성하고 테스트가 실패하더라도 결과를 게시합니다. 실행 후 파이프라인 실행의 테스트 탭을 열어 통과된 테스트와 실패한 테스트를 검토합니다. 테스트에 실패하면 테스트 태스크 및 파이프라인도 실패합니다.
Note
이 예제에서는 dotnet new mstest의 기본 VSTest 구성을 .NET 10 SDK와 함께 사용합니다. Microsoft.Testing.Platform (MTP)를 사용하도록 설정한 경우 필수 러너 구성은 연속 통합에서 MTP 테스트 실행을 참조하세요.
참고하십시오
- Microsoft.VisualStudio.TestTools.UnitTesting
- 단위 테스트 MSTest 프레임워크 사용
- MSTest V2 테스트 프레임워크 문서
.NET