본문으로 건너뛰기
CMake · 6/9

CMake 테스트와 CTest — add_test·테스트 fixture·리포트

· Hawk · 6분 읽기
cmake build cpp testing ctest

#왜 테스트 자동화가 필요한가

테스트 실행 파일이 몇 개 생기는 순간부터 손으로 돌리는 일이 부담스러워집니다.

Terminal window
./build/test_math
./build/test_string
./build/test_network
./build/test_integration
# 어느 게 실패했지? 종료 코드 모음을 따로 추적해야...

테스트가 10개, 100개가 되면 네 가지 문제가 따라옵니다.

  1. 실행 누락 — 어떤 테스트가 실행됐는지 기억에 의존합니다. CI에서 한두 개를 빼먹은 채 통과 처리되는 사고가 자주 납니다.
  2. 실패 추적 — 어느 테스트가 깨졌는지 즉시 보이지 않습니다. 100줄짜리 로그를 뒤져야 합니다.
  3. 병렬 실행 — 직렬로 돌면 CI가 몇 분 걸려야 할 일을 몇십 분 걸립니다.
  4. CI 연동 — Jenkins·GitHub Actions·GitLab CI 모두 표준 입출력 포맷을 요구합니다. 직접 만든 셸 루프로는 한계가 있습니다.

CTest는 이 모든 문제를 한 번에 해결하는 CMake 내장 테스트 러너입니다. 별도 설치 없이 CMake와 함께 깔리고, 모든 CI 시스템이 기본으로 지원하며, 병렬 실행과 JUnit·SubunitXML 출력을 내장합니다.

CTest 실행 흐름

CTest의 좋은 점은 프레임워크 비종속성입니다. Google Test, Catch2, Boost.Test, doctest, 그리고 그냥 셸 스크립트까지 — 종료 코드 0/비-0만 돌려주면 CTest가 받아 줍니다. 이 단순함이 50년 가까이 살아남은 빌드 도구의 미학입니다.

#CTest 기초

#테스트 활성화

CTest를 사용하려면 enable_testing()을 호출해야 합니다. 이 명령은 반드시 최상위 CMakeLists.txt에 위치해야 합니다. 하위 디렉터리에서 호출하면 CTest가 테스트를 인식하지 못합니다.

# 최상위 CMakeLists.txt
cmake_minimum_required(VERSION 3.20)
project(MyProject)


enable_testing()  # 반드시 최상위에서 호출


add_subdirectory(src)
add_subdirectory(tests)

프로덕션 빌드에서는 테스트를 빼고 싶을 수 있습니다. BUILD_TESTING 옵션으로 조건부 활성화가 가능합니다.

option(BUILD_TESTING "Enable testing" ON)


if(BUILD_TESTING)
    enable_testing()
    add_subdirectory(tests)
endif()

#테스트 추가

add_test()로 테스트를 등록합니다. NAME에는 테스트 이름을, COMMAND에는 실행할 명령을 지정합니다.

# 테스트 실행 파일 생성
add_executable(test_math tests/test_math.cpp)
target_link_libraries(test_math PRIVATE mylib)


# CTest에 등록
add_test(NAME MathTest COMMAND test_math)

추가 인자가 필요하면 COMMAND 뒤에 나열합니다.

add_test(NAME MathTest COMMAND test_math --verbose --filter=Add*)

#테스트 실행

빌드 디렉터리에서 ctest를 실행합니다.

Terminal window
# 기본 실행
cd build
ctest


# CMake를 통한 실행
cmake --build build --target test


# 상세 출력 옵션
ctest --output-on-failure  # 실패한 테스트의 stdout/stderr만 표시
ctest -V                    # verbose — 모든 테스트 출력
ctest -VV                   # extra verbose — 더 자세한 정보

기본 출력은 간결합니다.

Test project /home/user/project/build
    Start 1: MathTest
1/3 Test #1: MathTest .........................   Passed    0.01 sec
    Start 2: StringTest
2/3 Test #2: StringTest .......................   Passed    0.02 sec
    Start 3: NetworkTest
3/3 Test #3: NetworkTest ......................***Failed    0.15 sec


67% tests passed, 1 tests failed out of 3

#CTest 옵션

#필터링

테스트 이름으로 필터링할 수 있습니다. 정규식을 지원합니다.

Terminal window
ctest -R "Math"           # 이름에 "Math"가 포함된 테스트만
ctest -R "^Unit"          # "Unit"으로 시작하는 테스트만
ctest -E "Slow|Network"   # "Slow" 또는 "Network" 포함 테스트 제외

라벨로 필터링하면 테스트 종류별 실행이 가능합니다.

Terminal window
ctest -L unit             # unit 라벨 테스트만
ctest -L integration      # integration 라벨 테스트만
ctest -LE slow            # slow 라벨 제외

#병렬 실행

테스트가 많으면 병렬 실행으로 시간을 단축합니다.

Terminal window
ctest -j 4                # 4개 병렬 실행
ctest -j $(nproc)         # CPU 코어 수만큼 병렬 실행
ctest --parallel 8        # -j와 동일

병렬 실행 시 주의할 점이 있습니다. 테스트 간에 공유 리소스(파일, 포트, DB)가 있으면 충돌이 발생할 수 있습니다. 이런 테스트는 RESOURCE_LOCK 속성으로 직렬화합니다.

set_tests_properties(DBTest1 DBTest2 PROPERTIES
    RESOURCE_LOCK "database"
)

#실패 처리 옵션

Terminal window
ctest --output-on-failure     # 실패한 테스트의 출력만 표시 (CI에서 권장)
ctest --stop-on-failure       # 첫 실패에서 즉시 중단
ctest --rerun-failed          # 이전에 실패한 테스트만 재실행
ctest --repeat until-fail:10  # 10번 연속 성공할 때까지 반복 (플레이키 테스트 탐지)

#테스트 속성

set_tests_properties()로 테스트별 속성을 설정합니다.

#타임아웃

무한 루프에 빠진 테스트를 방지합니다. 기본 타임아웃은 1500초(25분)입니다.

add_test(NAME SlowTest COMMAND slow_test)
set_tests_properties(SlowTest PROPERTIES TIMEOUT 60)  # 60초 제한


# 여러 테스트에 동시 적용
set_tests_properties(Test1 Test2 Test3 PROPERTIES TIMEOUT 30)

#라벨

테스트를 분류하여 선택적으로 실행할 수 있습니다.

add_test(NAME UnitTest1 COMMAND unit_test_1)
add_test(NAME UnitTest2 COMMAND unit_test_2)
add_test(NAME IntegrationTest COMMAND integration_test)
add_test(NAME E2ETest COMMAND e2e_test)


set_tests_properties(UnitTest1 UnitTest2 PROPERTIES LABELS "unit")
set_tests_properties(IntegrationTest PROPERTIES LABELS "integration")
set_tests_properties(E2ETest PROPERTIES LABELS "e2e;slow")  # 복수 라벨

CI 파이프라인에서 단계별로 실행할 때 유용합니다.

Terminal window
# PR 머지 전 — 빠른 테스트만
ctest -L unit -j 8


# 머지 후 — 전체 테스트
ctest -j 4

#환경 변수

테스트 실행 시 환경 변수를 주입합니다.

set_tests_properties(MyTest PROPERTIES
    ENVIRONMENT "LOG_LEVEL=debug;DB_HOST=localhost;DB_PORT=5432"
)

#작업 디렉터리

테스트가 특정 디렉터리에서 실행되어야 할 때 사용합니다.

set_tests_properties(MyTest PROPERTIES
    WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}/tests/fixtures
)

#기대 결과 설정

기본적으로 CTest는 반환 코드 0을 성공으로 간주합니다. 이를 변경할 수 있습니다.

# 실패를 기대하는 테스트 (반환 코드가 0이 아니면 성공)
set_tests_properties(ExpectedFailTest PROPERTIES WILL_FAIL TRUE)


# 출력에 특정 문자열이 있어야 성공
set_tests_properties(MyTest PROPERTIES
    PASS_REGULAR_EXPRESSION "All tests passed"
)


# 출력에 특정 문자열이 있으면 실패
set_tests_properties(MyTest PROPERTIES
    FAIL_REGULAR_EXPRESSION "ERROR|FAILED|SEGFAULT"
)

#CTest 고급 — Labels, Fixtures, Properties

#Labels — 테스트 분류

add_test(NAME UnitMath COMMAND test_math)
add_test(NAME UnitString COMMAND test_string)
add_test(NAME IntegrationDB COMMAND test_db)
add_test(NAME E2EWorkflow COMMAND test_workflow)


set_tests_properties(UnitMath UnitString PROPERTIES LABELS "unit")
set_tests_properties(IntegrationDB PROPERTIES LABELS "integration;slow")
set_tests_properties(E2EWorkflow PROPERTIES LABELS "e2e;slow")

라벨을 붙이면 원하는 그룹만 실행할 수 있습니다.

Terminal window
ctest -L unit              # unit 라벨만
ctest -L "unit|integration"   # 둘 중 하나
ctest -LE slow             # slow 제외
ctest -L unit -L integration  # 두 라벨 모두

CI 파이프라인에서 매우 유용합니다 — PR마다 빠른 단위 테스트만 돌리고, 야간 빌드에서 통합·E2E까지 모두 돌리는 식.

#Fixtures — 테스트 간 setup/teardown 의존성

# 1. 시작 - 데이터베이스 세팅
add_test(NAME StartDB COMMAND ./setup_db.sh)
set_tests_properties(StartDB PROPERTIES FIXTURES_SETUP DB)


# 2. 종료 - 정리
add_test(NAME StopDB COMMAND ./cleanup_db.sh)
set_tests_properties(StopDB PROPERTIES FIXTURES_CLEANUP DB)


# 3. DB가 필요한 테스트
add_test(NAME TestQuery COMMAND test_query)
set_tests_properties(TestQuery PROPERTIES FIXTURES_REQUIRED DB)

CTest는 자동으로 순서를 잡습니다:

  1. TestQuery를 실행해야 함 → DB fixture 필요
  2. StartDB(SETUP) 먼저 실행
  3. TestQuery 실행
  4. StopDB(CLEANUP) 마지막 실행 — 다른 테스트가 다 끝나기를 기다림

여러 테스트가 같은 fixture를 공유해도 setup/cleanup은 한 번만 실행됩니다. xUnit·Pytest의 fixture와 같은 개념입니다.

ctest -j4로 병렬 실행할 때도 fixture가 자동 보호되어, setup 중인 동안 다른 의존 테스트가 기다립니다.

#자주 쓰는 테스트 속성

속성의미
TIMEOUT 3030초 안에 안 끝나면 실패
WILL_FAIL TRUE비-0 종료가 기대 결과 (음성 테스트)
PASS_REGULAR_EXPRESSION "..."출력에 매칭되어야 통과
FAIL_REGULAR_EXPRESSION "..."매칭되면 실패
DISABLED TRUE일시 비활성화 (skipped로 보고됨)
RUN_SERIAL TRUE다른 테스트와 병렬 실행 금지
PROCESSORS 4이 테스트가 4 CPU 슬롯을 사용 (자원 추적)
ENVIRONMENT "VAR=value"환경 변수 설정
WORKING_DIRECTORY "..."시작 디렉터리
DEPENDS OtherTest다른 테스트 통과 후 실행

PROCESSORS가 흥미롭습니다. 한 테스트가 내부적으로 멀티 스레드를 쓴다면 (예: 4 스레드 사용), PROCESSORS 4로 알려 주세요. ctest -j8로 호출해도 2개씩만 동시 실행해 시스템 과부하를 막습니다.

#ctest_* 명령 — 스크립트 모드

대시보드 제출이나 복잡한 CI 워크플로에는 CTest 스크립트를 씁니다. CTestScript.cmake 파일에 절차를 적고 ctest -S CTestScript.cmake로 호출합니다.

CTestScript.cmake
set(CTEST_SOURCE_DIRECTORY ".")
set(CTEST_BINARY_DIRECTORY "build")
set(CTEST_CMAKE_GENERATOR "Ninja")


ctest_start("Continuous")
ctest_configure()
ctest_build()
ctest_test(PARALLEL_LEVEL 8)
ctest_coverage()
ctest_submit()

CDash 같은 대시보드 서버에 결과를 자동 업로드합니다. 큰 오픈소스 프로젝트(VTK, ITK, Slicer)에서 쓰는 패턴입니다.

#Google Test 연동

Google Test(GTest)는 가장 널리 쓰이는 C++ 테스트 프레임워크입니다. CMake와의 통합이 잘 되어 있습니다.

#FetchContent로 가져오기

include(FetchContent)


FetchContent_Declare(
    googletest
    GIT_REPOSITORY https://github.com/google/googletest.git
    GIT_TAG        v1.15.2
)


# Windows에서 런타임 라이브러리 충돌 방지 (중요!)
set(gtest_force_shared_crt ON CACHE BOOL "" FORCE)


FetchContent_MakeAvailable(googletest)

gtest_force_shared_crt 옵션은 Windows에서 /MD(동적 런타임)와 /MT(정적 런타임) 불일치를 방지합니다. 설정하지 않으면 링크 에러가 발생할 수 있습니다.

#테스트 코드 작성

tests/test_math.cpp
#include <gtest/gtest.h>
#include "mylib/math.hpp"


TEST(MathTest, Add) {
    EXPECT_EQ(add(2, 3), 5);
    EXPECT_EQ(add(-1, 1), 0);
    EXPECT_EQ(add(0, 0), 0);
}


TEST(MathTest, Subtract) {
    EXPECT_EQ(subtract(5, 3), 2);
    EXPECT_EQ(subtract(3, 5), -2);
}


TEST(MathTest, Overflow) {
    // int 오버플로우 테스트
    EXPECT_EQ(add(INT_MAX, 1), INT_MIN);  // 정의되지 않은 동작 주의
}

#자동 테스트 발견

gtest_discover_tests()는 테스트 실행 파일을 분석하여 각 TEST를 CTest에 개별 등록합니다. 이것이 Google Test 연동의 핵심입니다.

tests/CMakeLists.txt
add_executable(test_math test_math.cpp)
target_link_libraries(test_math PRIVATE
    mylib
    GTest::gtest_main  # main() 함수 제공
)


include(GoogleTest)
gtest_discover_tests(test_math)

gtest_discover_tests()를 사용하면 테스트 목록이 자동으로 생성됩니다.

Terminal window
$ ctest -N  # 테스트 목록 확인
Test #1: MathTest.Add
Test #2: MathTest.Subtract
Test #3: MathTest.Overflow

#수동 등록 vs 자동 발견

# 수동 등록 — 실행 파일 단위로 하나의 테스트
add_test(NAME MathTests COMMAND test_math)
# ctest -N 결과: Test #1: MathTests


# 자동 발견 — TEST 단위로 개별 테스트
gtest_discover_tests(test_math)
# ctest -N 결과: Test #1: MathTest.Add
#               Test #2: MathTest.Subtract
#               Test #3: MathTest.Overflow

자동 발견의 장점:

  1. 세밀한 필터링 — ctest -R "Add"로 특정 테스트만 실행
  2. 병렬화 — 테스트 케이스 단위로 병렬 실행 가능
  3. 실패 추적 — 어떤 테스트가 실패했는지 정확히 표시

#발견 옵션

gtest_discover_tests(test_math
    PROPERTIES LABELS "unit"                    # 모든 테스트에 라벨
    DISCOVERY_TIMEOUT 60                        # 발견 타임아웃
    WORKING_DIRECTORY ${CMAKE_BINARY_DIR}       # 작업 디렉터리
    TEST_PREFIX "MyProject."                    # 테스트 이름 접두사
)

#Catch2 연동

Catch2는 헤더 온리로 시작할 수 있는 가벼운 테스트 프레임워크입니다. v3부터는 컴파일된 라이브러리 형태도 지원합니다.

#FetchContent로 가져오기

include(FetchContent)


FetchContent_Declare(
    Catch2
    GIT_REPOSITORY https://github.com/catchorg/Catch2.git
    GIT_TAG        v3.5.0
)


FetchContent_MakeAvailable(Catch2)

#테스트 작성

tests/test_math.cpp
#include <catch2/catch_test_macros.hpp>
#include "mylib/math.hpp"


TEST_CASE("Addition works correctly", "[math]") {
    REQUIRE(add(2, 3) == 5);
    REQUIRE(add(-1, 1) == 0);


    SECTION("Edge cases") {
        REQUIRE(add(0, 0) == 0);
        REQUIRE(add(INT_MAX, 0) == INT_MAX);
    }
}


TEST_CASE("Subtraction works correctly", "[math]") {
    REQUIRE(subtract(5, 3) == 2);
    REQUIRE(subtract(3, 5) == -2);
}

#CMakeLists.txt

add_executable(test_math test_math.cpp)
target_link_libraries(test_math PRIVATE
    mylib
    Catch2::Catch2WithMain  # main() 함수 포함
)


include(Catch)
catch_discover_tests(test_math)

Catch2의 SECTION은 테스트 케이스 안에서 분기를 만들어 코드 재사용을 돕습니다. 각 SECTION은 별도의 테스트 실행으로 등록됩니다.

#코드 커버리지

테스트가 코드의 어느 부분을 실행하는지 측정합니다. CI에서 커버리지 리포트를 생성하면 테스트 누락을 발견할 수 있습니다.

#GCC/Clang 커버리지 설정

option(ENABLE_COVERAGE "Enable coverage reporting" OFF)


if(ENABLE_COVERAGE)
    if(CMAKE_CXX_COMPILER_ID MATCHES "GNU|Clang")
        # 테스트 대상 라이브러리에 커버리지 플래그 추가
        target_compile_options(mylib PRIVATE --coverage -O0 -g)
        target_link_options(mylib PRIVATE --coverage)


        # 테스트 실행 파일에도 추가
        target_compile_options(test_math PRIVATE --coverage -O0 -g)
        target_link_options(test_math PRIVATE --coverage)
    endif()
endif()

-O0은 최적화를 끄고, -g는 디버그 정보를 포함합니다. 최적화가 켜져 있으면 인라인 등으로 커버리지가 부정확해집니다.

#커버리지 측정 및 리포트

Terminal window
# 커버리지 활성화 빌드
cmake -B build -DENABLE_COVERAGE=ON -DCMAKE_BUILD_TYPE=Debug
cmake --build build


# 테스트 실행 (커버리지 데이터 생성)
ctest --test-dir build


# gcovr로 HTML 리포트 생성
gcovr -r . --html --html-details -o coverage.html


# 또는 lcov 사용
lcov --capture --directory build --output-file coverage.info
lcov --remove coverage.info '/usr/*' '*/tests/*' --output-file coverage.info
genhtml coverage.info --output-directory coverage_html

#CI에서 커버리지

GitHub Actions 예시:

- name: Build with coverage
  run: |
    cmake -B build -DENABLE_COVERAGE=ON
    cmake --build build


- name: Run tests
  run: ctest --test-dir build --output-on-failure


- name: Generate coverage report
  run: gcovr -r . --xml -o coverage.xml


- name: Upload to Codecov
  uses: codecov/codecov-action@v3
  with:
    files: coverage.xml

#실전 예시: 완전한 테스트 설정

프로젝트 구조:

mymath/
├── CMakeLists.txt
├── include/
│   └── mymath/
│       ├── add.hpp
│       ├── subtract.hpp
│       └── multiply.hpp
├── src/
│   ├── add.cpp
│   ├── subtract.cpp
│   ├── multiply.cpp
│   └── main.cpp
└── tests/
    ├── CMakeLists.txt
    ├── test_add.cpp
    ├── test_subtract.cpp
    ├── test_multiply.cpp
    └── test_integration.cpp

#최상위 CMakeLists.txt

cmake_minimum_required(VERSION 3.20)
project(MyMath VERSION 1.0.0 LANGUAGES CXX)


set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_CXX_EXTENSIONS OFF)


# === 라이브러리 ===
add_library(mymath
    src/add.cpp
    src/subtract.cpp
    src/multiply.cpp
)
target_include_directories(mymath PUBLIC
    $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
    $<INSTALL_INTERFACE:include>
)


# === 실행 파일 ===
add_executable(calculator src/main.cpp)
target_link_libraries(calculator PRIVATE mymath)


# === 테스트 ===
option(BUILD_TESTING "Enable testing" ON)
option(ENABLE_COVERAGE "Enable coverage" OFF)


if(BUILD_TESTING)
    enable_testing()
    add_subdirectory(tests)
endif()

#tests/CMakeLists.txt

include(FetchContent)


# === Google Test 가져오기 ===
FetchContent_Declare(
    googletest
    GIT_REPOSITORY https://github.com/google/googletest.git
    GIT_TAG        v1.15.2
)
set(gtest_force_shared_crt ON CACHE BOOL "" FORCE)
FetchContent_MakeAvailable(googletest)


# === 커버리지 함수 ===
function(add_coverage_flags target)
    if(ENABLE_COVERAGE AND CMAKE_CXX_COMPILER_ID MATCHES "GNU|Clang")
        target_compile_options(${target} PRIVATE --coverage -O0 -g)
        target_link_options(${target} PRIVATE --coverage)
    endif()
endfunction()


# === 단위 테스트 ===
add_executable(test_math
    test_add.cpp
    test_subtract.cpp
    test_multiply.cpp
)
target_link_libraries(test_math PRIVATE
    mymath
    GTest::gtest_main
)
add_coverage_flags(test_math)


include(GoogleTest)
gtest_discover_tests(test_math
    PROPERTIES LABELS "unit"
    DISCOVERY_TIMEOUT 30
)


# === 통합 테스트 ===
add_executable(test_integration test_integration.cpp)
target_link_libraries(test_integration PRIVATE
    mymath
    GTest::gtest_main
)
add_coverage_flags(test_integration)


gtest_discover_tests(test_integration
    PROPERTIES
        LABELS "integration"
        TIMEOUT 120
)


# === 부모 타겟에도 커버리지 적용 ===
if(ENABLE_COVERAGE)
    add_coverage_flags(mymath)
endif()

#실행 예시

Terminal window
# 빌드
cmake -B build
cmake --build build


# 모든 테스트 실행
ctest --test-dir build --output-on-failure


# 단위 테스트만
ctest --test-dir build -L unit -j 8


# 특정 테스트만
ctest --test-dir build -R "Add"


# 커버리지 포함 빌드
cmake -B build-cov -DENABLE_COVERAGE=ON -DCMAKE_BUILD_TYPE=Debug
cmake --build build-cov
ctest --test-dir build-cov
gcovr -r . --html -o coverage.html

#정리

  • enable_testing()은 최상위 CMakeLists.txt에서 호출해야 합니다.
  • add_test(NAME ... COMMAND ...)로 테스트를 등록합니다.
  • set_tests_properties()로 타임아웃, 라벨, 환경 변수 등을 설정합니다.
  • ctest -j N으로 병렬 실행, -R로 필터링, -L로 라벨 선택이 가능합니다.
  • Google Test는 gtest_discover_tests()로 TEST 단위 자동 등록이 가능합니다.
  • Catch2는 catch_discover_tests()를 사용합니다.
  • 커버리지는 --coverage 플래그와 gcovr/lcov로 측정합니다.
  • BUILD_TESTING 옵션으로 프로덕션 빌드에서 테스트를 제외할 수 있습니다.

#흔한 실수

#enable_testing()을 하위 디렉터리에서 호출

tests/CMakeLists.txt
enable_testing()  # ❌ 여기서 호출하면 CTest가 테스트를 못 찾음
add_test(NAME MyTest COMMAND test_app)

enable_testing()은 반드시 최상위 CMakeLists.txt에서 호출해야 합니다. 그래야 CTestTestfile.cmake가 올바른 위치에 생성됩니다.

#gtest_force_shared_crt 누락 (Windows)

FetchContent_MakeAvailable(googletest)  # ❌ Windows에서 링크 에러


# 올바른 방법
set(gtest_force_shared_crt ON CACHE BOOL "" FORCE)  # MakeAvailable 전에!
FetchContent_MakeAvailable(googletest)

#gtest_discover_tests가 빌드 시점에 실패

gtest_discover_tests(test_math)  # ❌ 크로스 컴파일 시 실패할 수 있음

gtest_discover_tests()는 빌드된 실행 파일을 실행해서 테스트 목록을 추출합니다. 크로스 컴파일 환경에서는 호스트에서 타겟 바이너리를 실행할 수 없으므로 실패합니다.

# 크로스 컴파일 시 대안
if(CMAKE_CROSSCOMPILING)
    add_test(NAME MathTests COMMAND test_math)  # 수동 등록
else()
    gtest_discover_tests(test_math)
endif()

#테스트 간 의존성 무시

# ❌ 테스트가 같은 파일을 사용하면 병렬 실행 시 충돌
add_test(NAME Test1 COMMAND test_app --output=/tmp/result.txt)
add_test(NAME Test2 COMMAND test_app --output=/tmp/result.txt)
# 올바른 방법 — 리소스 락 사용
set_tests_properties(Test1 Test2 PROPERTIES
    RESOURCE_LOCK "output_file"
)

#커버리지 플래그를 Release 빌드에 적용

# ❌ 최적화와 커버리지는 함께 쓰면 부정확
target_compile_options(mylib PRIVATE --coverage)  # -O2와 함께 적용되면 문제
# 올바른 방법
if(ENABLE_COVERAGE)
    target_compile_options(mylib PRIVATE --coverage -O0 -g)
endif()

커버리지 측정은 항상 Debug 빌드(-O0)에서 해야 정확합니다.

#다음 장 예고

Ch 7에서는 설치와 패키징을 다룹니다. install() 명령으로 빌드 결과물을 시스템에 설치하고, CPack으로 배포 패키지를 만드는 방법을 살펴봅니다.

#참고 자료

CMake · 6 of 9

  1. 1CMake 소개와 첫 프로젝트 — 설치부터 빌드까지
  2. 2CMake 언어 분석 — 변수·조건문·함수의 동작
  3. 3CMake 타겟과 라이브러리 — INTERFACE·PUBLIC·PRIVATE 전파
  4. 4CMake 옵션과 캐시 변수 — option·set·cache type 분석
  5. 5CMake find_package와 외부 의존성 — Module·Config·FetchContent
  6. 6CMake 테스트와 CTest — add_test·테스트 fixture·리포트
  7. 7CMake 설치와 패키징 — install·EXPORT·CPack
  8. 8Modern CMake 베스트 프랙티스 — target_* 중심 설계
  9. 9Modern CMake 고급 — BUILD/INSTALL_INTERFACE·Presets·cmake -E

관련 글

Modern CMake 고급 — BUILD/INSTALL_INTERFACE·Presets·cmake -E

Modern CMake의 고급 도구 모음 — 자주 안 보이지만 실무에서 결정적인 기능들.

·cmake

Modern CMake 베스트 프랙티스 — target_* 중심 설계

타겟 중심 접근법, 피해야 할 안티패턴, 대규모 프로젝트 구성 전략.

·cmake

CMake 설치와 패키징 — install·EXPORT·CPack

install 명령으로 빌드 결과물 배포, CPack으로 플랫폼별 패키지 생성.

·cmake