소스 파일 및 타겟 설정 - 소프트웨어 융합

CMakeLists.txt 파일은 프로젝트의 소스 파일, 헤더 파일, 라이브러리, 타겟 등을 정의하고, 이들을 빌드하고 관리하는 방식을 지정한다. 또한, CMakeLists.txt 파일은 다른 CMake 모듈과의 상호작용을 관리하며, 빌드 옵션, 컴파일러 설정 등을 지정할 수 있다.

프로젝트 설정

CMakeLists.txt 파일의 시작 부분에서 프로젝트를 정의한다. 이를 위해 project() 명령어를 사용하며, 프로젝트의 이름과 버전을 명시할 수 있다.

cmake_minimum_required(VERSION 3.10)
project(MyProject VERSION 1.0)

cmake_minimum_required() 명령어는 CMake의 최소 버전을 지정하며, 이 버전보다 낮은 CMake를 사용할 경우 오류를 발생시킨다.

소스 파일 설정

소스 파일을 지정하는 것은 CMake에서 매우 중요한 단계이다. 소스 파일들은 일반적으로 변수에 저장되며, 이를 통해 나중에 간단하게 참조할 수 있다. set() 명령어를 사용하여 소스 파일을 변수에 정의한다.

set(SOURCES
    main.cpp
    file1.cpp
    file2.cpp
)

이 예에서는 SOURCES라는 변수에 프로젝트의 주요 소스 파일들을 나열하고 있다. 이렇게 정의된 변수는 이후에 타겟을 생성할 때 사용된다.

타겟 설정

CMake에서 타겟(target)은 빌드할 결과물(예: 실행 파일, 라이브러리)을 의미한다. 타겟은 add_executable() 또는 add_library() 명령어를 사용하여 생성할 수 있다.

실행 파일 타겟

add_executable(MyExecutable ${SOURCES})

이 명령어는 MyExecutable이라는 실행 파일을 생성하며, 앞서 정의한 소스 파일들을 사용하여 빌드한다.

정적 라이브러리 타겟

add_library(MyStaticLib STATIC ${SOURCES})

이 명령어는 정적 라이브러리(.a 또는 .lib)를 생성하며, 소스 파일들을 정적으로 링크하여 라이브러리를 만든다.

동적 라이브러리 타겟

add_library(MySharedLib SHARED ${SOURCES})

이 명령어는 동적 라이브러리(.so 또는 .dll)를 생성하며, 빌드 시에 동적으로 링크되는 라이브러리를 만든다.

타겟 속성 설정

타겟을 생성한 후에는 해당 타겟의 속성을 설정할 수 있다. 예를 들어, 타겟이 특정 라이브러리에 링크되도록 하거나, 타겟의 컴파일 옵션을 지정할 수 있다.

타겟 링크 라이브러리 설정

target_link_libraries(MyExecutable PRIVATE MyStaticLib)

이 명령어는 MyExecutable이 MyStaticLib 정적 라이브러리에 링크되도록 설정한다. PRIVATE 키워드는 링크 설정이 타겟 내에서만 사용됨을 의미한다. PUBLIC 또는 INTERFACE를 사용할 수도 있다.

컴파일 옵션 설정

target_compile_options(MyExecutable PRIVATE -Wall -Wextra)

이 명령어는 MyExecutable을 컴파일할 때 경고 메시지를 표시하는 -Wall 및 -Wextra 옵션을 추가로 설정한다.

파일 및 디렉터리 구조 관리

CMake는 소스 파일이 위치한 디렉터리를 관리할 수 있는 기능도 제공한다. 프로젝트가 여러 디렉터리로 나뉘어 있는 경우, 각 디렉터리에 별도의 CMakeLists.txt 파일을 두고, 이를 상위 디렉터리의 CMakeLists.txt에서 포함시킬 수 있다.

서브 디렉터리 추가

add_subdirectory(src)
add_subdirectory(lib)

이 명령어는 src 및 lib 디렉터리에 있는 CMakeLists.txt 파일을 포함시켜, 해당 디렉터리의 설정이 상위 디렉터리의 빌드 프로세스에 통합되도록 한다.

CMake 변수 및 조건부 설정

CMake에서는 다양한 변수와 조건문을 사용하여 빌드 설정을 동적으로 관리할 수 있다.

변수 설정 및 사용

set(CMAKE_CXX_STANDARD 17)

이 명령어는 C++ 표준 버전을 C++17로 설정한다. 이후 모든 타겟은 C++17 표준을 따르게 된다.

조건문 사용

if(WIN32)
    message(STATUS "Building for Windows")
elseif(UNIX)
    message(STATUS "Building for Unix-like OS")
endif()

이 예에서는 운영 체제에 따라 다른 메시지를 출력하도록 조건부 설정을 적용 하였다.

관련 자료: - CMake 공식 문서: https://cmake.org/documentation/ - Mastering CMake by Ken Martin and Bill Hoffman