CMake · 2/9

CMake 언어 분석 — 변수·조건문·함수의 동작

2026년 6월 2일 · Hawk · 7분 읽기

#왜 CMake 언어를 알아야 하는가

Ch 1의 세 줄짜리 CMakeLists.txt는 시작점입니다. 실제 프로젝트는 곧 다음과 같은 요구를 만납니다.

Debug 빌드에서만 특정 매크로를 켜고 싶다.
GCC와 Clang에서 다른 경고 옵션을 쓰고 싶다.
소스 파일 목록을 한 자리에 변수로 모으고 싶다.
반복되는 설정을 함수로 묶고 싶다.

이런 요구는 모두 CMake가 자체 스크립팅 언어라는 사실에서 출발합니다.

1
if(CMAKE_CXX_COMPILER_ID STREQUAL "GNU")
2
    target_compile_options(app PRIVATE -Wall -Wextra -Werror)
3
elseif(CMAKE_CXX_COMPILER_ID STREQUAL "MSVC")
4
    target_compile_options(app PRIVATE /W4 /WX)
5
endif()

겉으로 평범해 보이는 위 코드에 CMake 언어의 특이점이 모두 담겨 있습니다. 변수 참조, 문자열 비교, 조건 분기, 컴파일러 식별. 이 장은 그 언어의 핵심 어휘를 다룹니다.

CMake 언어는 다른 스크립팅 언어와 비교했을 때 기묘하게 느껴지는 자리가 몇 군데 있습니다. 변수가 문자열만 있는 점, 리스트가 세미콜론으로 구분되는 점, if()가 변수 이름을 자동 역참조하는 점. 다른 언어 경험이 있다면 이런 자리에서 한 번씩 발을 헛디딥니다. 본 장은 그런 함정들을 미리 짚어 둡니다.

#CMake 언어 기초

CMake는 명령어 기반 언어입니다. 모든 구문이 명령(인자1 인자2 ...) 모양입니다. Python·JavaScript처럼 연산자나 표현식이 없습니다. 대입도 =이 아니라 set(...)이라는 명령입니다. 이 사실이 처음에는 어색하지만, 곧 대부분의 일이 명령 호출 한 줄로 끝나는 깔끔함으로 다가옵니다.

1
cmake_minimum_required(VERSION 3.15)
2
project(MyApp LANGUAGES CXX)
3
add_executable(app main.cpp)

#대소문자

명령어는 대소문자를 구분하지 않습니다. 관례상 소문자를 사용합니다.

1
# 모두 같은 동작
2
message("Hello")
3
MESSAGE("Hello")
4
Message("Hello")
5

6
# 권장: 소문자
7
message("Hello")

변수 이름은 대소문자를 구분합니다. MY_VAR와 my_var는 다른 변수입니다.

#주석

1
# 한 줄 주석
2

3
#[[
4
여러 줄 주석
5
CMake 3.0 이상에서 지원
6
복잡한 설명이 필요할 때 유용
7
]]

#인자 구분

인자는 공백이나 세미콜론으로 구분합니다.

1
# 이 세 줄은 같습니다
2
set(SRCS main.cpp utils.cpp config.cpp)
3
set(SRCS "main.cpp" "utils.cpp" "config.cpp")
4
set(SRCS main.cpp;utils.cpp;config.cpp)

#변수 — 모두 문자열이다

CMake의 가장 큰 특징 중 하나: 모든 변수는 문자열입니다. 숫자도, 리스트도, 불리언도 결국 문자열입니다. 10이라는 변수의 내부 표현은 문자열 "10"이고, TRUE도 문자열 "TRUE"입니다. 비교 시점에 CMake가 의미를 해석합니다.

이 단일 타입 모델은 단순하지만 함정도 있습니다. 빈 문자열과 정의되지 않은 변수가 거의 같은 식으로 동작하고, 리스트는 세미콜론으로 구분된 문자열이기 때문에 공백이 끼면 의미가 달라집니다.

#변수 설정과 참조

set() 명령으로 변수를 설정하고, ${변수명}으로 참조합니다.

1
set(MY_VAR "Hello")
2
message(${MY_VAR})        # Hello
3
message("${MY_VAR}")      # Hello
4
message("Say: ${MY_VAR}") # Say: Hello

따옴표 안에서도 변수가 확장됩니다. 공백이 포함된 값은 따옴표로 감싸야 합니다.

1
set(PATH "/usr/local/bin")
2
set(MSG "Install path is ${PATH}")
3
message("${MSG}")  # Install path is /usr/local/bin

#변수 해제

1
set(MY_VAR "value")
2
unset(MY_VAR)
3
message("${MY_VAR}")  # (빈 문자열)

#변수 스코프

CMake 변수는 세 가지 스코프를 가집니다.

CMake 변수 스코프 계층

캐시 스코프 (CMakeCache.txt에 저장, 영구)
디렉터리 스코프 (CMakeLists.txt별)
- 함수 스코프 (function 내부, 호출당 하나)

1
# 현재 스코프
2
set(VAR "value")
3

4
# 부모 스코프로 전달 (함수 내부에서)
5
set(VAR "value" PARENT_SCOPE)
6

7
# 캐시 변수 (영구 저장, 빌드 디렉터리에 저장됨)
8
set(VAR "value" CACHE STRING "설명")

#환경 변수

1
# 환경 변수 읽기
2
message("HOME: $ENV{HOME}")
3

4
# 환경 변수 설정 (CMake 프로세스 내에서만)
5
set(ENV{MY_VAR} "value")

#리스트

CMake에서 리스트는 세미콜론으로 구분된 문자열입니다. 별도의 리스트 타입이 없습니다.

1
set(MY_LIST "a;b;c")          # 리스트 (문자열)
2
set(MY_LIST a b c)            # 같은 결과
3
set(MY_LIST "a" "b" "c")      # 같은 결과
4

5
message("${MY_LIST}")         # a;b;c

#리스트 조작

list() 명령으로 리스트를 조작합니다.

1
set(SRCS main.cpp utils.cpp)
2

3
# 추가
4
list(APPEND SRCS config.cpp)
5
# SRCS = main.cpp;utils.cpp;config.cpp
6

7
# 길이
8
list(LENGTH SRCS LEN)
9
message("Length: ${LEN}")     # Length: 3
10

11
# 인덱스 접근 (0부터 시작)
12
list(GET SRCS 0 FIRST)
13
message("First: ${FIRST}")    # First: main.cpp
14

15
# 마지막 요소 (-1)
16
list(GET SRCS -1 LAST)
17
message("Last: ${LAST}")      # Last: config.cpp
18

19
# 제거
20
list(REMOVE_ITEM SRCS utils.cpp)
21
# SRCS = main.cpp;config.cpp
22

23
# 필터링 (정규식)
24
list(FILTER SRCS INCLUDE REGEX ".*\\.cpp")
25

26
# 정렬
27
list(SORT SRCS)
28

29
# 중복 제거
30
list(REMOVE_DUPLICATES SRCS)

#foreach — 리스트 순회

1
set(SRCS main.cpp utils.cpp config.cpp)
2

3
foreach(SRC ${SRCS})
4
    message("Source: ${SRC}")
5
endforeach()

출력은 Source: main.cpp, Source: utils.cpp, Source: config.cpp.

범위 반복도 지원합니다.

1
# 0부터 5까지
2
foreach(i RANGE 5)
3
    message("${i}")
4
endforeach()
5
# 출력: 0 1 2 3 4 5
6

7
# start, end, step
8
foreach(i RANGE 1 10 2)
9
    message("${i}")
10
endforeach()
11
# 출력: 1 3 5 7 9

#while 반복

1
set(COUNT 0)
2
while(COUNT LESS 5)
3
    message("Count: ${COUNT}")
4
    math(EXPR COUNT "${COUNT} + 1")
5
endwhile()

#문자열 처리

#string 명령

1
set(STR "Hello, World!")
2

3
# 길이
4
string(LENGTH "${STR}" LEN)     # LEN = 13
5

6
# 부분 문자열 (시작, 길이)
7
string(SUBSTRING "${STR}" 0 5 SUBSTR)  # SUBSTR = Hello
8

9
# 치환
10
string(REPLACE "World" "CMake" RESULT "${STR}")
11
# RESULT = Hello, CMake!
12

13
# 대소문자 변환
14
string(TOUPPER "${STR}" UPPER)  # UPPER = HELLO, WORLD!
15
string(TOLOWER "${STR}" LOWER)  # LOWER = hello, world!
16

17
# 앞뒤 공백 제거
18
string(STRIP "  hello  " STRIPPED)  # STRIPPED = hello
19

20
# 비교
21
string(COMPARE EQUAL "abc" "abc" IS_EQUAL)  # IS_EQUAL = TRUE

#정규식

1
# 첫 번째 매칭
2
string(REGEX MATCH "[0-9]+" NUMS "abc123def456")
3
# NUMS = 123
4

5
# 모든 매칭
6
string(REGEX MATCHALL "[0-9]+" ALL_NUMS "abc123def456")
7
# ALL_NUMS = 123;456
8

9
# 치환
10
string(REGEX REPLACE "[0-9]+" "X" RESULT "a1b2c3")
11
# RESULT = aXbXcX

#math 연산

1
math(EXPR RESULT "1 + 2 * 3")     # RESULT = 7
2
math(EXPR RESULT "(1 + 2) * 3")   # RESULT = 9
3
math(EXPR RESULT "10 / 3")        # RESULT = 3 (정수 나눗셈)

#조건문

#기본 구조

1
if(condition)
2
    # ...
3
elseif(condition)
4
    # ...
5
else()
6
    # ...
7
endif()

endif(), elseif(), else()에 조건을 반복하지 않아도 됩니다(옛날 스타일에서는 반복했습니다).

#조건식 종류

불리언 값:

1
if(TRUE)      # 참
2
if(FALSE)     # 거짓
3
if(VAR)       # VAR이 TRUE, ON, YES, 1, Y 또는 비어 있지 않으면 참
4
if(NOT VAR)   # 부정

문자열 비교:

1
if(VAR STREQUAL "value")          # 문자열 같음
2
if(VAR STREQUAL "")               # 빈 문자열 확인
3
if("${VAR}" STREQUAL "value")     # 권장: 따옴표로 감싸기

숫자 비교:

1
if(VAR EQUAL 10)           # 같음
2
if(VAR LESS 10)            # 미만
3
if(VAR GREATER 10)         # 초과
4
if(VAR LESS_EQUAL 10)      # 이하
5
if(VAR GREATER_EQUAL 10)   # 이상

존재 확인:

1
if(DEFINED VAR)             # 변수가 정의되어 있으면
2
if(EXISTS path)             # 파일/디렉터리가 존재하면
3
if(IS_DIRECTORY path)       # 디렉터리면
4
if(TARGET target_name)      # 타겟이 존재하면

논리 연산:

1
if(A AND B)
2
if(A OR B)
3
if(NOT A)
4
if((A OR B) AND C)

정규식 매칭:

1
if(VAR MATCHES "^[0-9]+$")  # 숫자로만 구성

버전 비교:

1
if(CMAKE_VERSION VERSION_LESS "3.15")
2
if(PROJECT_VERSION VERSION_GREATER_EQUAL "2.0.0")

#실전 예시

1
# 빌드 타입별 설정
2
if(CMAKE_BUILD_TYPE STREQUAL "Debug")
3
    message(STATUS "Debug build - adding debug symbols")
4
    add_compile_definitions(DEBUG_MODE)
5
endif()
6

7
# 컴파일러별 경고 옵션
8
if(CMAKE_CXX_COMPILER_ID STREQUAL "GNU")
9
    target_compile_options(app PRIVATE -Wall -Wextra -Wpedantic)
10
elseif(CMAKE_CXX_COMPILER_ID STREQUAL "Clang")
11
    target_compile_options(app PRIVATE -Wall -Wextra -Weverything)
12
elseif(CMAKE_CXX_COMPILER_ID STREQUAL "MSVC")
13
    target_compile_options(app PRIVATE /W4 /permissive-)
14
endif()
15

16
# 플랫폼별 설정
17
if(WIN32)
18
    target_compile_definitions(app PRIVATE PLATFORM_WINDOWS)
19
elseif(APPLE)
20
    target_compile_definitions(app PRIVATE PLATFORM_MACOS)
21
elseif(UNIX)
22
    target_compile_definitions(app PRIVATE PLATFORM_LINUX)
23
endif()
24

25
# 타겟 존재 확인
26
if(TARGET mylib)
27
    target_link_libraries(app PRIVATE mylib)
28
endif()

#함수와 매크로

반복되는 코드를 재사용하려면 함수나 매크로를 정의합니다.

#function

1
function(my_function ARG1 ARG2)
2
    message("ARG1 = ${ARG1}")
3
    message("ARG2 = ${ARG2}")
4
    message("ARGC = ${ARGC}")     # 인자 개수
5
    message("ARGV = ${ARGV}")     # 모든 인자 리스트
6
    message("ARGN = ${ARGN}")     # 명명되지 않은 추가 인자들
7
endfunction()
8

9
my_function("Hello" "World" "Extra1" "Extra2")

출력은 다음과 같다.

ARG1 = Hello
ARG2 = World
ARGC = 4
ARGV = Hello;World;Extra1;Extra2
ARGN = Extra1;Extra2

함수는 자체 스코프를 가집니다. 함수 안에서 설정한 변수는 함수 밖에서 보이지 않습니다.

1
function(set_var)
2
    set(MY_VAR "inside function")
3
    message("Inside: ${MY_VAR}")  # inside function
4
endfunction()
5

6
set_var()
7
message("Outside: ${MY_VAR}")     # (빈 문자열)

부모 스코프로 값을 전달하려면 PARENT_SCOPE를 사용합니다.

1
function(get_version OUTPUT_VAR)
2
    set(${OUTPUT_VAR} "1.2.3" PARENT_SCOPE)
3
endfunction()
4

5
get_version(VERSION)
6
message("Version: ${VERSION}")    # Version: 1.2.3

#macro

매크로는 호출 위치에서 텍스트 치환됩니다. 자체 스코프가 없습니다.

1
macro(set_var_macro)
2
    set(MY_VAR "from macro")
3
endmacro()
4

5
set_var_macro()
6
message("${MY_VAR}")  # from macro (호출자 스코프에서 설정됨)

#function vs macro

특성	function	macro
스코프	자체 스코프	호출자 스코프
변수 전달	`PARENT_SCOPE` 필요	자동 반영
동작 방식	함수 호출	텍스트 치환
디버깅	예측 가능	예상치 못한 부작용 가능

권장: 대부분의 경우 function을 사용하세요. 스코프가 격리되어 예측 가능한 동작을 보장합니다. 매크로는 간단한 텍스트 치환이 필요할 때만 사용합니다.

#실전 예시

공통 설정을 함수로 묶는 패턴입니다.

1
function(add_my_executable TARGET_NAME)
2
    # ARGN은 추가 인자들 (소스 파일)
3
    add_executable(${TARGET_NAME} ${ARGN})
4

5
    # 공통 설정 적용
6
    target_compile_features(${TARGET_NAME} PRIVATE cxx_std_17)
7

8
    if(MSVC)
9
        target_compile_options(${TARGET_NAME} PRIVATE /W4)
10
    else()
11
        target_compile_options(${TARGET_NAME} PRIVATE -Wall -Wextra)
12
    endif()
13

14
    # 공통 정의
15
    target_compile_definitions(${TARGET_NAME} PRIVATE
16
        $<$<CONFIG:Debug>:DEBUG_BUILD>
17
    )
18
endfunction()
19

20
# 사용
21
add_my_executable(app1 main1.cpp utils.cpp)
22
add_my_executable(app2 main2.cpp)

#제너레이터 표현식

**제너레이터 표현식(Generator Expressions)**은 CMake 구성 시점이 아니라 빌드 시스템 생성 시점에 평가됩니다. $<...> 문법을 사용합니다.

#왜 필요한가

일반 변수는 CMake 실행 시점에 평가됩니다. 그러나 어떤 정보는 빌드 시스템이 생성될 때까지 알 수 없습니다.

1
# 문제: CMAKE_BUILD_TYPE은 multi-config 생성기에서 빈 문자열
2
if(CMAKE_BUILD_TYPE STREQUAL "Debug")
3
    target_compile_definitions(app PRIVATE DEBUG_MODE)
4
endif()

Visual Studio나 Xcode는 multi-config 생성기입니다. 구성 시점에는 빌드 타입을 모르고, 빌드 시점에 선택합니다. 이때 제너레이터 표현식을 사용합니다.

1
# 해결: 빌드 시점에 평가
2
target_compile_definitions(app PRIVATE
3
    $<$<CONFIG:Debug>:DEBUG_MODE>
4
)

#기본 문법

제너레이터 식은 세 종류의 패턴을 가집니다.

1
# 1. 조건부 — 조건이 참이면 값, 거짓이면 빈 문자열
2
$<조건:값>
3

4
# 2. if-else — 조건이 참이면 첫 인자, 거짓이면 두 번째
5
$<IF:조건,참값,거짓값>
6

7
# 3. 속성/정보 참조 — 타겟 정보 추출
8
$<TARGET_FILE:타겟>

#중첩 구문 — `$<$<...>:...>`이 무엇을 의미하는가

제너레이터 식에서 가장 헷갈리는 것은 중첩 구문입니다.

1
target_compile_definitions(app PRIVATE
2
    $<$<CONFIG:Debug>:DEBUG_MODE>
3
)

여기엔 $<...>이 두 번 등장합니다. 안쪽부터 풀어 봅시다.

1단계 — 안쪽 $<CONFIG:Debug>이 무엇을 돌려주는가

$<CONFIG:Debug>은 질문 형태의 표현입니다. “지금 빌드 구성이 Debug인가?” 그 결과는 1 또는 0입니다.

빌드 타입이 Debug면 → 1
그 외 (Release / RelWithDebInfo / MinSizeRel) → 0

2단계 — 바깥 $<조건:값>은 어떻게 결합되는가

$<조건:값> 형태는 “조건이 1이면 값을 내고, 0이면 빈 문자열을 낸다”는 의미입니다. 안쪽 결과 1/0이 그대로 바깥의 조건이 됩니다.

따라서 전체는 이렇게 풀립니다.

`CONFIG`	`$<CONFIG:Debug>`	`$<$<CONFIG:Debug>:DEBUG_MODE>`
Debug	`1`	`DEBUG_MODE`
Release	`0`	`(빈 문자열)`

빌드 시스템 생성 단계에서 CMake는 각 구성마다 이 식을 풀어 결과를 컴파일러 인자로 넣습니다. Debug 빌드에서는 -DDEBUG_MODE가 들어가고, Release 빌드에서는 아무것도 안 들어갑니다.

#`$<IF:...>` — 명시적 if-else

위와 같은 효과를 if-else 형태로 적을 수도 있습니다.

1
target_compile_definitions(app PRIVATE
2
    $<IF:$<CONFIG:Debug>,DEBUG_MODE,NDEBUG>
3
)

Debug → DEBUG_MODE
Release/기타 → NDEBUG

빈 문자열 분기가 의미 있을 때(예: 위처럼 Release에서 대체값이 있을 때)는 $<IF:...>가 더 명확합니다. 빈 문자열로 충분하면 짧은 $<조건:값> 형태가 관용입니다.

#왜 `if`로는 안 되는가

같은 일을 단순히 if로 적으면 안 되는가? 됩니다 — 단, single-config 생성기(Make, Ninja)에서만.

1
# Make, Ninja에서는 동작
2
if(CMAKE_BUILD_TYPE STREQUAL "Debug")
3
    target_compile_definitions(app PRIVATE DEBUG_MODE)
4
endif()

문제는 multi-config 생성기(Visual Studio, Xcode)입니다. 이들은 구성 시점에 빌드 타입을 정하지 않습니다. 하나의 솔루션·프로젝트 안에 Debug·Release·RelWithDebInfo가 공존하고, 사용자가 IDE에서 빌드 시점에 선택합니다. 따라서 구성 시점에 CMAKE_BUILD_TYPE은 빈 문자열이고, 위 if는 항상 false가 되어 DEBUG_MODE가 어디에도 들어가지 않습니다.

제너레이터 식은 이 한계를 정확히 풀어 줍니다. 구성 시점이 아니라 각 빌드 생성 시점에 평가되므로, multi-config에서도 각 구성마다 올바른 결과가 들어갑니다.

#자주 쓰는 표현식

빌드 타입:

1
target_compile_definitions(app PRIVATE
2
    $<$<CONFIG:Debug>:DEBUG_MODE>
3
    $<$<CONFIG:Release>:NDEBUG>
4
)

컴파일러:

1
target_compile_options(app PRIVATE
2
    $<$<CXX_COMPILER_ID:GNU>:-Wall -Wextra>
3
    $<$<CXX_COMPILER_ID:MSVC>:/W4>
4
)

플랫폼:

1
target_link_libraries(app PRIVATE
2
    $<$<PLATFORM_ID:Linux>:pthread>
3
    $<$<PLATFORM_ID:Windows>:ws2_32>
4
)

빌드 vs 설치:

1
target_include_directories(mylib PUBLIC
2
    $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
3
    $<INSTALL_INTERFACE:include>
4
)

이 패턴은 라이브러리를 만들 때 중요합니다. 빌드할 때는 소스 디렉터리의 include를, 설치 후에는 설치된 include 경로를 사용합니다.

#정리 표

표현식	의미
`$<CONFIG:Debug>`	빌드 타입이 Debug면 1
`$<PLATFORM_ID:Linux>`	플랫폼이 Linux면 1
`$<CXX_COMPILER_ID:GNU>`	컴파일러가 GCC면 1
`$<TARGET_FILE:tgt>`	타겟의 출력 파일 전체 경로
`$<TARGET_FILE_DIR:tgt>`	타겟의 출력 디렉터리
`$<BUILD_INTERFACE:...>`	빌드 시에만 적용
`$<INSTALL_INTERFACE:...>`	설치 시에만 적용
`$<BOOL:val>`	val이 참이면 1
`$<AND:a,b>`	a AND b
`$<OR:a,b>`	a OR b
`$<NOT:a>`	NOT a

#message 출력

디버깅과 상태 출력에 message()를 사용합니다.

1
message("일반 메시지")
2
message(STATUS "상태 메시지")         # -- 접두사로 출력
3
message(WARNING "경고")               # 경고 메시지
4
message(AUTHOR_WARNING "개발자 경고")  # -Wno-dev로 끌 수 있음
5
message(SEND_ERROR "오류")            # 오류, 구성은 계속 진행
6
message(FATAL_ERROR "치명적 오류")     # 오류, 즉시 중단

1
# 변수 디버깅
2
message(STATUS "CMAKE_CXX_COMPILER: ${CMAKE_CXX_COMPILER}")
3
message(STATUS "CMAKE_BUILD_TYPE: ${CMAKE_BUILD_TYPE}")
4
message(STATUS "PROJECT_SOURCE_DIR: ${PROJECT_SOURCE_DIR}")

#흔한 실수

#변수 참조 시 따옴표 누락

1
# 회피: 빈 문자열일 때 문제 발생
2
if(${MY_VAR} STREQUAL "value")  # MY_VAR이 비어 있으면 구문 오류
3

4
# Good: 따옴표로 감싸기
5
if("${MY_VAR}" STREQUAL "value")

${MY_VAR}이 빈 문자열이면 if( STREQUAL "value")가 되어 구문 오류가 발생합니다. 따옴표로 감싸면 if("" STREQUAL "value")가 되어 안전합니다.

#리스트와 문자열 혼동

1
set(PATH "C:/Program Files/MyApp")
2
message("${PATH}")  # C:/Program Files/MyApp
3

4
# 위험: 공백이 리스트 구분자로 해석될 수 있음
5
foreach(P ${PATH})
6
    message("${P}")  # C:/Program, Files/MyApp (두 개로 분리!)
7
endforeach()
8

9
# Good: 따옴표로 감싸기
10
foreach(P "${PATH}")
11
    message("${P}")  # C:/Program Files/MyApp
12
endforeach()

#if() 조건의 자동 변수 역참조

1
set(VAR "SOME_VALUE")
2
set(SOME_VALUE "Hello")
3

4
# CMake의 자동 역참조 (혼란스러움)
5
if(VAR)
6
    # VAR이 "SOME_VALUE"이고, SOME_VALUE도 정의되어 있으므로
7
    # 이중 역참조가 발생할 수 있음
8
endif()
9

10
# Good: 명시적으로 참조
11
if(DEFINED VAR)
12
    message("VAR is defined: ${VAR}")
13
endif()

CMake의 if()는 변수 이름을 자동으로 역참조하는 특이한 동작이 있습니다. 명시적으로 ${VAR}를 사용하거나 DEFINED를 사용하는 것이 안전합니다.

#function에서 PARENT_SCOPE 누락

1
# 회피: 값이 반환되지 않음
2
function(get_value OUTPUT)
3
    set(${OUTPUT} "result")
4
endfunction()
5

6
get_value(MY_RESULT)
7
message("${MY_RESULT}")  # (빈 문자열)
8

9
# Good: PARENT_SCOPE 사용
10
function(get_value OUTPUT)
11
    set(${OUTPUT} "result" PARENT_SCOPE)
12
endfunction()
13

14
get_value(MY_RESULT)
15
message("${MY_RESULT}")  # result

#제너레이터 표현식 디버깅 불가

1
# 회피: 구성 시점에 출력하면 리터럴 문자열
2
message("Value: $<CONFIG>")  # 출력: Value: $<CONFIG>
3

4
# 제너레이터 표현식은 빌드 시점에 평가됨
5
# 디버깅하려면 file(GENERATE ...) 사용
6
file(GENERATE
7
    OUTPUT "${CMAKE_BINARY_DIR}/debug-genex.txt"
8
    CONTENT "Config: $<CONFIG>\n"
9
)

#정리

CMake는 명령어 기반 스크립팅 언어입니다.
변수는 set()으로 설정, ${}로 참조합니다.
리스트는 세미콜론으로 구분된 문자열이며, list() 명령으로 조작합니다.
조건문: if(), elseif(), else(), endif().
반복문: foreach(), while().
함수는 자체 스코프를 가지고, 매크로는 텍스트 치환입니다.
제너레이터 표현식은 빌드 시스템 생성 시점에 평가되며, $<...> 문법을 사용합니다.
변수 참조 시 따옴표로 감싸는 것이 안전합니다.

#`cmake_policy()` — 정책 시스템

Ch 1에서 cmake_minimum_required(VERSION 3.20)이 정책 데이터베이스를 그 버전의 동작으로 설정한다고 했습니다. 이제 그 정책 시스템 자체를 봅니다.

CMake는 버전이 올라가면서 기존 동작을 바꿔야 했던 결정들을 번호가 매겨진 정책으로 등록합니다. 예: CMP0048, CMP0077, CMP0135.

각 정책은 OLD와 NEW 두 동작을 가집니다.

OLD — 정책 도입 이전의 동작 (역호환성).
NEW — 도입 이후의 새 동작 (권장).

1
cmake_policy(GET CMP0077 RESULT)
2
message("CMP0077: ${RESULT}")    # NEW 또는 OLD
3

4
# 특정 정책을 명시적으로 설정
5
cmake_policy(SET CMP0077 NEW)

대부분의 경우 cmake_minimum_required가 한 번에 정책을 정해 줍니다. 하지만 다음 두 자리에서는 *명시적 cmake_policy()*가 필요합니다.

외부 모듈을 가져왔는데 그 모듈이 옛 정책을 요구할 때. include로 들어온 코드의 정책을 우리 의도와 다르게 설정해야 할 때.
서드파티 빌드에서 사용하는 FetchContent로 가져온 라이브러리가 옛 정책을 가정해 경고를 띄울 때.

1
# FetchContent 가져오기 전에 정책 명시
2
cmake_policy(SET CMP0135 NEW)   # URL_HASH 경고 끄기
3

4
include(FetchContent)
5
FetchContent_Declare(...)

정책 번호와 이름은 공식 문서에 모여 있습니다. 일상 작업에서는 외울 필요 없고, 경고 메시지가 뜨면 그때 검색하면 됩니다. 경고는 친절하게 정책 번호를 알려 줍니다 — CMake Warning (dev) at CMakeLists.txt:5 (FetchContent_Declare): Policy CMP0135 is not set: ....

#다음 장 예고

Ch 3: 타겟에서는 Modern CMake의 심장 — 타겟(target)을 다룹니다. add_executable·add_library·target_link_libraries와 그 모든 곳에 등장하는 PRIVATE / PUBLIC / INTERFACE 세 가시성. 이 셋의 의미를 정확히 잡으면 의존성 추적의 90%가 끝납니다.

#참고 자료

이 글을 참조하는 글 (1)

CMake 소개와 첫 프로젝트 — 설치부터 빌드까지— CMake

#왜 CMake 언어를 알아야 하는가

#CMake 언어 기초

#대소문자

#주석

#인자 구분

#변수 — 모두 문자열이다

#변수 설정과 참조

#변수 해제

#변수 스코프

#환경 변수

#리스트

#리스트 조작

#foreach — 리스트 순회

#while 반복

#문자열 처리

#string 명령

#정규식

#math 연산

#조건문

#기본 구조

#조건식 종류

#실전 예시

#함수와 매크로

#function

#macro

#function vs macro

#실전 예시

#제너레이터 표현식

#왜 필요한가

#기본 문법

#중첩 구문 — $<$<...>:...>이 무엇을 의미하는가

#$<IF:...> — 명시적 if-else

#왜 if로는 안 되는가

#자주 쓰는 표현식

#정리 표

#message 출력

#흔한 실수

#변수 참조 시 따옴표 누락

#리스트와 문자열 혼동

#if() 조건의 자동 변수 역참조

#function에서 PARENT_SCOPE 누락

#제너레이터 표현식 디버깅 불가

#정리

#cmake_policy() — 정책 시스템

#다음 장 예고

#참고 자료

CMake · 2 of 9

관련 글

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

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

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

이 글을 참조하는 글 (1)

#중첩 구문 — `$<$<...>:...>`이 무엇을 의미하는가

#`$<IF:...>` — 명시적 if-else

#왜 `if`로는 안 되는가

#`cmake_policy()` — 정책 시스템