빌드 설정 - 실험 도서관

CMakeLists.txt 파일의 가장 첫 부분에는 프로젝트 이름과 최소 요구되는 CMake 버전을 설정할 수 있다.

cmake_minimum_required(VERSION 3.10)
project(MyProject)

cmake_minimum_required는 CMake의 최소 버전을 지정한다. project 명령어는 프로젝트의 이름을 지정하며, 이후 프로젝트 이름이 변수로 사용될 수 있다.

프로젝트에서 사용될 소스 파일과 헤더 파일을 정의할 수 있다.

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

set 명령어를 사용하여 파일들을 변수로 지정할 수 있다. 이러한 변수는 이후 빌드 과정에서 사용된다.

CMakeLists.txt에서는 컴파일 후 생성될 실행 파일을 정의할 수 있다.

add_executable(MyExecutable ${SOURCES}${HEADERS})

add_executable 명령어는 실행 파일을 생성하며, 첫 번째 인자로 실행 파일의 이름을, 두 번째 인자로 소스 파일과 헤더 파일을 지정한다.

프로젝트에서 사용하는 라이브러리를 추가할 수 있다. 외부 라이브러리를 사용하거나 직접 작성한 라이브러리를 추가할 수 있다.

add_library(MyLibrary STATIC library.cpp library.h)

add_library 명령어를 사용하여 정적 라이브러리 또는 동적 라이브러리를 생성할 수 있다. 이때, STATIC은 정적 라이브러리, SHARED는 동적 라이브러리를 의미한다.

생성된 실행 파일이나 라이브러리에 다른 라이브러리를 링크할 수 있다.

target_link_libraries(MyExecutable MyLibrary)

target_link_libraries 명령어는 특정 타겟(실행 파일이나 라이브러리)에 다른 라이브러리를 연결한다. 이 명령어는 CMakeLists.txt에서 매우 중요한 역할을 하며, 외부 라이브러리나 내부 라이브러리를 타겟에 연결하는 데 사용된다.

CMake는 컴파일러 옵션을 설정하는 기능도 제공한다. 이 옵션은 코드 최적화, 디버깅 정보 포함, 경고 제어 등을 위해 설정할 수 있다.

target_compile_options(MyExecutable PRIVATE -Wall -Wextra -O2)

target_compile_options 명령어는 타겟에 대해 컴파일러 옵션을 설정한다. PRIVATE, PUBLIC, INTERFACE 중 하나를 사용하여 옵션의 가시성을 결정할 수 있다.

CMake에서는 디버그와 릴리즈 설정을 분리할 수 있다.

set(CMAKE_BUILD_TYPE Debug)

CMAKE_BUILD_TYPE을 설정하여 디버그(Debug), 릴리즈(Release), 또는 기타 사용자 정의 빌드 유형을 지정할 수 있다.

CMake는 외부 패키지를 찾는 기능도 제공한다. 이를 통해 타사 라이브러리나 패키지를 쉽게 통합할 수 있다.

find_package(OpenCV REQUIRED)

find_package 명령어는 외부 패키지를 찾고, 해당 패키지의 경로와 설정을 자동으로 구성한다. REQUIRED 옵션은 패키지가 필수적임을 의미하며, 찾지 못할 경우 에러를 발생시킨다.

프로젝트의 조건에 따라 설정을 달리할 수 있다.

if(WIN32)
    set(OS_DEFINES "-D_WINDOWS")
elseif(UNIX)
    set(OS_DEFINES "-D_LINUX")
endif()

if, elseif, endif 명령어를 사용하여 특정 조건에 따라 다른 설정을 적용할 수 있다. 예를 들어, 운영 체제에 따라 다른 정의를 설정할 수 있다.

프로젝트의 설치 규칙을 정의할 수 있다.

install(TARGETS MyExecutable DESTINATION bin)
install(FILES "${PROJECT_SOURCE_DIR}/config.cfg" DESTINATION etc)

install 명령어를 사용하여 타겟 또는 파일을 특정 디렉토리에 설치할 수 있다. 이는 빌드된 파일을 적절한 위치에 배포하기 위해 사용된다.

CMake는 사용자 정의 명령어나 타겟을 정의하는 기능도 제공한다.

add_custom_command(TARGET MyExecutable POST_BUILD
    COMMAND ${CMAKE_COMMAND} -E copy$<TARGET_FILE:MyExecutable> ${CMAKE_BINARY_DIR}/bin)

add_custom_command 명령어를 사용하여 빌드 후 특정 작업을 수행할 수 있다. 여기서는 빌드된 실행 파일을 특정 위치로 복사하는 예시이다.