다음을 통해 공유


Visual Studio에서 C/C++에 대한 단위 테스트 작성

테스트 탐색기 창을 사용하여 C++ 유닛 테스트를 작성하여 실행할 수 있으며, 다른 언어에서처럼 작동합니다. 테스트 탐색기에 대한 자세한 내용은 테스트 탐색기를 사용하여 단위 테스트 실행을 참조하세요.

참고

Live Unit Testing, 코딩된 UI 테스트 및 IntelliTest 등의 일부 기능은 C++에서 지원되지 않습니다.

Visual Studio에는 다음 C++ 테스트 기능이 포함되어 있으며 추가 다운로드가 필요하지 않습니다.

  • C++에 대한 Microsoft 단위 테스트 프레임워크
  • Google Test
  • Boost.Test
  • CTest

설치된 프레임워크를 사용할 수 있으며 또는 Visual Studio 내에서 사용하려는 프레임워크에 대해 자체 테스트 어댑터를 작성할 수 있습니다. 테스트 어댑터는 테스트 탐색기 창에 단위 테스트를 통합합니다. 몇 가지 타사 어댑터를 Visual Studio Marketplace에서 제공하고 있습니다. 자세한 내용은 타사 단위 테스트 프레임워크 설치를 참조하세요.

Visual Studio 2017 이상(Professional 및 Enterprise)

C++ 단위 테스트 프로젝트는 CodeLens를 지원합니다.

Visual Studio 2017 이상(모든 버전)

  • Google Test 어댑터C++를 통한 데스크톱 개발 워크로드의 기본 구성 요소로 포함되어 있습니다. 솔루션에 추가할 수 있는 프로젝트 템플릿이 있습니다. 솔루션 탐색기 솔루션 노드를 마우스 오른쪽 단추로 클릭하고 바로 가기 메뉴에서 추가>새 프로젝트를 선택하여 프로젝트 템플릿을 추가합니다. 도구>옵션을 통해 구성할 수 있는 옵션도 있습니다. 자세한 내용은 방법: Visual Studio에서 Google Test 사용을 참조하세요.

  • Boost.TestC++를 통한 데스크톱 개발 워크로드의 기본 구성 요소로 포함되어 있습니다. 테스트 탐색기와 통합되었지만 현재는 프로젝트 템플릿이 없습니다. 수동으로 구성해야 합니다. 자세한 내용은 방법: Visual Studio에서 Boost.Test 사용을 참조하세요.

  • CTest 지원은 C++를 사용한 데스크톱 개발 워크로드의 일부인 C++ CMake 도구 구성 요소에 포함되어 있습니다. 자세한 내용은 방법: Visual Studio에서 CTest 사용을 참조하세요.

이전 버전의 Visual Studio

Visual Studio Marketplace에서 Google Test 어댑터 및 Boost.Test 어댑터 확장을 다운로드할 수 있습니다. 이러한 확장은 Test adapter for Boost.TestTest adapter for Google Test에 있습니다.

Copilot /tests 슬래시 명령을 사용하여 코드에서 단위 테스트를 만들 수도 있습니다. 예를 들어 /tests using Boost framework를 입력하여 Boost.Test 테스트를 생성할 수 있습니다. 자세한 내용은 Copilot Chat에서 슬래시 명령 사용하기를 참조하세요.

기본 테스트 워크플로

다음 섹션에서는 C++ 단위 테스트를 시작하기 위한 기본 단계를 보여 줍니다. 기본 구성은 Microsoft 및 Google Test 프레임워크에서 유사합니다. Boost.Test에서는 수동으로 테스트 프로젝트를 만들어야 합니다.

Visual Studio 2022에서 테스트 프로젝트 만들기

하나 이상의 테스트 프로젝트 내에서 단위 테스트를 정의하고 실행합니다. 테스트 프로젝트는 실행 파일의 코드를 호출하고 해당 동작을 보고하는 별도의 앱을 만듭니다. 테스트하려는 코드와 동일한 솔루션에 테스트 프로젝트를 만듭니다.

기존 솔루션에 새 테스트 프로젝트를 추가하려면

  1. 솔루션 탐색기에서 솔루션 노드를 마우스 오른쪽 단추로 클릭합니다.
  2. 팝업 메뉴에서 추가>새 프로젝트를 선택합니다.
  3. 언어C++로 설정하고 검색 상자에 ‘test’를 입력합니다. 다음 그림에서는 C++를 사용한 데스크톱 개발UWP 개발 워크로드가 설치되었을 때 사용할 수 있는 테스트 프로젝트를 보여줍니다.

Visual Studio 2022의 C++ 테스트 프로젝트

Visual Studio 2019에서 테스트 프로젝트 만들기

하나 이상의 테스트 프로젝트 내에서 테스트를 정의하고 실행합니다. 테스트하려는 코드와 동일한 솔루션에 프로젝트를 만듭니다. 기존 솔루션에 새 테스트 프로젝트를 추가하려면

  1. 솔루션 탐색기에서 솔루션 노드를 마우스 오른쪽 단추로 클릭합니다.
  2. 팝업 메뉴에서 추가>새 프로젝트를 선택합니다.
  3. 언어C++로 설정하고 검색 상자에 ‘test’를 입력합니다. 다음 그림에서는 C++를 사용한 데스크톱 개발UWP 개발 워크로드가 설치되었을 때 사용할 수 있는 테스트 프로젝트를 보여줍니다.

Visual Studio 2019의 C++ 테스트 프로젝트

솔루션의 다른 프로젝트에 대한 참조 만들기

테스트 중인 프로젝트의 함수에 액세스할 수 있도록 하려면 테스트 프로젝트에서 프로젝트에 대한 참조를 추가합니다. 솔루션 탐색기에서 테스트 프로젝트 노드를 마우스 오른쪽 단추로 클릭하여 팝업 메뉴를 표시합니다. 추가>참조를 선택합니다. [참조 추가] 대화 상자에서 테스트할 프로젝트를 선택합니다.

참조 추가

테스트 코드가 테스트할 함수를 내보내지 않는 경우 .obj 또는 .lib 출력 파일을 테스트 프로젝트의 종속성에 추가합니다. 자세한 내용은 개체 또는 라이브러리 파일에 테스트를 연결하려면을 참조하세요. main 함수 또는 다른 표준 진입점(예: wmain, WinMain 또는 DllMain)이 있는 개체 파일은 포함하지 마세요. 프로젝트에 새 원본 파일을 추가할 때 해당 개체 파일을 포함하도록 테스트 프로젝트 종속성을 업데이트합니다.

헤더 파일에 대해 #include 지시문 추가

다음으로, 단위 테스트 .cpp 파일에서 테스트할 형식과 함수를 선언하는 모든 헤더 파일에 대해 #include 지시문을 추가합니다. #include "를 입력하면 선택할 수 있도록 IntelliSense가 활성화됩니다. 더 많은 헤더에 대해 반복합니다.

IntelliSense에 추가되어 포함할 헤더 파일을 강조 표시하는 #include 지시문을 보여 주는 솔루션 탐색기 스크린샷

원본 파일의 각 include 문에 전체 경로를 입력할 필요가 없도록 하려면 프로젝트>속성>C/C++>일반>추가 포함 디렉터리에 필요한 폴더를 추가하세요.

테스트 메서드 작성

참고

이 섹션에서는 C/C++용 Microsoft 단위 테스트 프레임워크에 대한 구문을 보여 줍니다. 문서화된 내용은 다음과 같습니다. Microsoft.VisualStudio.TestTools.CppUnitTestFramework API 참조. Google Test 설명서는 Google Test 입문을 참조하세요. Boost.Test는 Boost Test 라이브러리: 단위 테스트 프레임워크를 참조하세요.

테스트 프로젝트의 .cpp 파일에는 스텁 클래스와 메서드가 정의되어 있으며, 테스트 코드를 작성하는 방법에 대한 예제를 보여 줍니다. 시그니처는 테스트 탐색기 창에서 메서드를 검색 가능하게 하는 TEST_CLASS 및 TEST_METHOD 매크로를 사용합니다.

TEST_CLASS 및 TEST_METHOD 매크로를 사용하는 스텁 클래스와 메서드를 포함하는 unittest1.cpp 코드 파일을 보여 주는 테스트 탐색기 창의 스크린샷

TEST_CLASS 및 TEST_METHOD는 Microsoft Native Test Framework의 일부입니다. 테스트 탐색기는 유사한 방식으로 다른 지원되는 프레임워크에서 테스트 메서드를 검색합니다.

TEST_METHOD는 void를 반환합니다. 테스트 결과를 내려면 Assert 클래스에서 정적 메서드를 사용하여 예상되는 결과와 대조하여 실제 결과를 테스트합니다. 다음 예제에서는 MyClassstd::string을 취하는 생성자가 있다고 가정합니다. 이 예제에서는 생성자가 예상대로 클래스를 초기화하는지 테스트하는 방법을 보여줍니다.

TEST_METHOD(TestClassInit)
{
    std::string name = "Bill";
    MyClass mc(name);
    Assert::AreEqual(name, mc.GetName());
}

이전 예에서 Assert::AreEqual 호출의 결과가 테스트 통과 또는 실패 여부를 결정합니다. Assert 클래스에는 예상 결과를 실제 결과와 비교하는 그 밖의 많은 메서드가 포함되어 있습니다.

특성을 테스트 메서드에 추가하여 테스트 소유자, 우선 순위 및 기타 정보를 지정할 수 있습니다. 그런 다음 이 값을 사용하여 테스트 탐색기에서 테스트를 정렬하고 그룹화할 수 있습니다. 자세한 내용은 테스트 탐색기를 사용하여 단위 테스트 실행을 참조하세요.

테스트 실행

  1. 테스트 메뉴에서 Windows>테스트 탐색기를 선택합니다. 다음 그림에서는 테스트를 아직 실행하지 않은 테스트 프로젝트를 보여 줍니다.

    테스트 실행 전 테스트 탐색기

    참고

    테스트 탐색기와의 CTest 통합은 아직 제공되지 않습니다. CMake 주 메뉴에서 CTest 테스트를 실행합니다.

  2. 창에 일부 테스트가 보이지 않을 경우 솔루션 탐색기에서 노드를 마우스 오른쪽 단추로 클릭하고 빌드 또는 다시 빌드를 선택하여 테스트 프로젝트를 빌드합니다.

  3. 테스트 탐색기에서 모두 실행을 선택하거나 실행하려는 특정 테스트를 선택합니다. 테스트를 마우스 오른쪽 단추로 클릭하면 중단점을 사용하는 디버그 모드에서 실행 등, 다른 옵션이 표시됩니다. 모든 테스트가 실행되면 어떤 테스트에 통과했고 어떤 테스트에 실패했는지 창에 표시됩니다.

    테스트 실행 후 테스트 탐색기

실패한 테스트에 대해서는 원인 진단을 위해 상세 정보를 보여주는 메시지가 나타납니다. 실패한 테스트를 마우스 오른쪽 단추로 클릭하여 팝업 메뉴를 표시합니다. 디버그를 선택하여 오류가 발생한 함수를 단계별로 실행합니다.

테스트 탐색기에 관한 자세한 내용은 테스트 탐색기를 사용하여 단위 테스트 실행을 참조하세요.

단위 테스트에 관한 자세한 내용은 단위 테스트 기본 사항을 참조하세요.

CodeLens 사용

Visual Studio 2017 이상(Professional 및 Enterprise 버전)

CodeLens를 사용하면 코드 편집기를 종료하지 않고도 유닛 테스트 상태를 신속하게 확인할 수 있습니다.

다음 방법 중 하나로 C++ 단위 테스트 프로젝트에 대한 CodeLens를 초기화합니다.

  • 테스트 프로젝트 또는 솔루션을 편집하고 빌드합니다.
  • 프로젝트 또는 솔루션을 다시 빌드합니다.
  • 테스트 탐색기 창에서 테스트를 실행합니다.

초기화되면 각 단위 테스트 위에서 테스트 상태 아이콘을 확인할 수 있습니다.

C++ CodeLens 아이콘

자세한 정보를 보거나 단위 테스트를 실행 또는 디버그하려면 아이콘을 선택합니다.

C++ CodeLens 실행 및 디버그