CMake 개요

CMakeLists.txt 파일에는 프로젝트의 소스 코드, 헤더 파일, 라이브러리, 외부 종속성 및 컴파일러 설정에 대한 정보가 포함된다. CMake는 이러한 정보를 기반으로 플랫폼 독립적인 빌드 스크립트를 생성한다.

컴파일러 플래그 설정

컴파일러 플래그는 코드 최적화, 디버깅 정보 포함 여부, 경고 레벨 등을 결정하는 데 사용된다. CMake에서는 다양한 명령어와 변수를 통해 컴파일러 플래그를 설정할 수 있다.

• add_compile_options(): 이 명령어는 소스 파일에 적용될 컴파일러 플래그를 지정한다. 예를 들어, add_compile_options(-Wall -O2)와 같이 사용하여 모든 소스 파일에 -Wall과 -O2 플래그를 추가할 수 있다.

• target_compile_options(): 특정 타겟에 대해서만 컴파일러 플래그를 지정하고자 할 때 사용한다. target_compile_options(MyTarget PRIVATE -Wall -O2)와 같이 사용하여 MyTarget이라는 타겟에만 플래그를 적용할 수 있다. PRIVATE, PUBLIC, INTERFACE는 플래그의 가시성을 결정한다.

• CMAKE_CXX_FLAGS, CMAKE_C_FLAGS: CMake 프로젝트 전반에 걸쳐 기본 컴파일러 플래그를 설정할 때 사용한다. 예를 들어, set(CMAKE_CXX_FLAGS "-Wall -O2")로 C++ 컴파일러에 대한 플래그를 설정할 수 있다. C와 C++ 플래그는 각각 CMAKE_C_FLAGS와 CMAKE_CXX_FLAGS로 구분된다.

빌드 타입에 따른 설정

CMake에서는 빌드 타입에 따라 컴파일러 플래그를 다르게 설정할 수 있다. 이는 코드 최적화, 디버깅, 테스트 등의 목적에 따라 빌드 설정을 다르게 할 수 있게 한다.

• CMAKE_BUILD_TYPE: 이 변수는 빌드 타입을 지정한다. Debug, Release, RelWithDebInfo, MinSizeRel 등이 일반적인 빌드 타입이다. 예를 들어, set(CMAKE_BUILD_TYPE Debug)로 설정하면 디버그 빌드에 적합한 플래그가 적용된다.

• CMAKE_CXX_FLAGS_DEBUG, CMAKE_C_FLAGS_DEBUG: 디버그 빌드에 사용되는 플래그를 설정한다. 디버그 빌드 시 -g 플래그를 추가하고자 한다면, set(CMAKE_CXX_FLAGS_DEBUG "-g")로 설정할 수 있다.

• CMAKE_CXX_FLAGS_RELEASE, CMAKE_C_FLAGS_RELEASE: 릴리즈 빌드에 사용되는 플래그를 설정한다. 릴리즈 빌드에서는 주로 최적화 플래그 -O2나 -O3를 사용한다. 예를 들어, set(CMAKE_CXX_FLAGS_RELEASE "-O3")와 같이 설정한다.

조건부 컴파일 설정

플래그에 따라 특정 설정을 활성화하거나 비활성화할 수 있다. 조건부 컴파일 설정은 다양한 환경에서의 빌드 요구사항을 충족시킬 수 있다.

• if() 조건문 사용: CMakeLists.txt 내에서 if() 조건문을 사용하여 특정 플래그나 환경 변수에 따라 설정을 변경할 수 있다. 예를 들어, 특정 컴파일러에서만 플래그를 적용하려면 다음과 같이 설정할 수 있다: cmake if(CMAKE_CXX_COMPILER_ID STREQUAL "GNU") set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall") endif()

• option() 명령어: 특정 기능을 활성화하거나 비활성화할 수 있는 옵션을 제공한다. 예를 들어, 디버그 로그 출력을 활성화할 옵션을 만들고 싶다면: ```cmake option(ENABLE_DEBUG_LOG "Enable debug logging" OFF)

if(ENABLE_DEBUG_LOG) add_compile_options(-DENABLE_DEBUG_LOG) endif() ```

타겟 기반 플래그 설정

CMake는 특정 타겟에 대해서만 플래그를 설정할 수 있다. 이를 통해 다양한 타겟이 서로 다른 설정으로 빌드될 수 있다.

• target_compile_options(): 특정 타겟에 대한 플래그를 설정할 수 있다. 예를 들어, 라이브러리 타겟에는 -fPIC 플래그를 추가하고 싶다면: cmake target_compile_options(MyLibrary PRIVATE -fPIC)

• target_compile_definitions(): 특정 타겟에 대한 매크로 정의를 설정할 수 있다. 다음 예제는 DEBUG 매크로를 MyTarget에 대해 정의한다: cmake target_compile_definitions(MyTarget PRIVATE DEBUG)

• target_link_options(): 특정 타겟에 대해 링크 옵션을 설정할 수 있다. 예를 들어, MyExecutable 타겟에 대해 링커 플래그를 추가하고 싶다면: cmake target_link_options(MyExecutable PRIVATE -Wl,-rpath,/custom/lib/path)

외부 라이브러리 및 종속성 관리

CMake는 외부 라이브러리와 종속성을 관리할 수 있는 강력한 기능을 제공한다. 이는 종속성에 따라 플래그를 자동으로 설정할 수 있게 한다.

• find_package(): 외부 라이브러리를 찾기 위해 사용된다. 예를 들어, find_package(Boost REQUIRED)는 Boost 라이브러리를 찾고, 이를 사용할 수 있도록 플래그를 설정한다.

• target_link_libraries(): 특정 타겟에 외부 라이브러리를 링크한다. 예를 들어, MyTarget 타겟에 Boost 라이브러리를 링크하고 싶다면: cmake target_link_libraries(MyTarget PRIVATE Boost::Boost)

• ExternalProject_Add(): 외부 프로젝트를 빌드하고 연결할 수 있다. 이 기능은 종속성을 관리하는 데 유용하다.

---

관련 자료: - CMake 공식 문서: https://cmake.org/documentation/ - Professional CMake: A Practical Guide by Craig Scott - Mastering CMake by Ken Martin, Bill Hoffman