AI 기반 시각화 전문지식 서비스

프로그램개발 · 분야 선택22개 분야

Ver2.0 전체 열람

Ver2.0 🛠️ 빌드 시스템: CMake 사용법 마스터하기 🛠️

2025.05.12

재능넷

댓글 0 전체 39 페이지

콘텐츠 대표 이미지 - 🛠️ 빌드 시스템: CMake 사용법 마스터하기 🛠️

안녕? 오늘은 C++ 개발자라면 꼭 알아야 할 CMake에 대해 함께 알아보자! 프로젝트가 커질수록 소스 파일 관리와 빌드 과정이 복잡해지는 건 당연한 일이지. 그럴 때 CMake 같은 빌드 시스템이 우리의 구원자가 되어줄 거야. 😎

내가 재능넷에서 프로그래밍 강의를 진행하면서 가장 많이 받는 질문 중 하나가 바로 "빌드 시스템은 어떻게 구성하나요?"야. 특히 C++ 프로젝트에서 이 부분은 정말 중요하거든. 오늘 이 글을 통해 그 해답을 찾아보자!

🤔 왜 CMake를 사용해야 할까?

C++ 프로젝트를 개발할 때 그냥 IDE의 '빌드' 버튼만 누르면 되는 거 아니냐고? 음... 작은 프로젝트라면 그래도 괜찮을 수 있어. 하지만 프로젝트가 커지면 다음과 같은 문제들이 생겨:

여러 플랫폼(Windows, Linux, macOS)에서 동작해야 할 때
다양한 라이브러리 의존성을 관리해야 할 때
팀 단위로 개발할 때 모든 개발자가 동일한 환경에서 빌드해야 할 때
CI/CD 파이프라인을 구축할 때
빌드 옵션을 세밀하게 제어해야 할 때

CMake는 이런 문제들을 해결해주는 크로스 플랫폼 빌드 시스템 생성기야. 한 번 CMake 설정 파일을 작성하면, 어떤 플랫폼에서든 필요한 빌드 파일(Makefile, Visual Studio 프로젝트 등)을 자동으로 생성해줘. 정말 편리하지? 🚀

📚 CMake 개요

CMake는 1999년에 처음 등장했어. 처음에는 단순한 빌드 도구였지만, 지금은 C++뿐만 아니라 다양한 언어의 프로젝트를 관리하는 강력한 도구로 발전했지. 특히 C++ 표준이 계속 발전하면서 CMake도 함께 진화해왔어. 현재는 버전 3.x대를 사용하고 있고, 최신 C++ 표준과 다양한 빌드 환경을 완벽하게 지원해.

CMake의 핵심 개념은 다음과 같아:

CMakeLists.txt: 프로젝트 구성을 정의하는 핵심 파일
타겟(Target): 라이브러리나 실행 파일과 같은 빌드 결과물
변수(Variable): CMake 내에서 정보를 저장하고 참조하는 방법
명령어(Command): CMake 스크립트에서 사용하는 함수들
모듈(Module): 재사용 가능한 CMake 스크립트 모음

⚙️ CMake 설치하기

CMake를 사용하기 전에 먼저 설치해야 하겠지? 각 운영체제별 설치 방법을 알아보자:

Windows

Windows에서는 공식 웹사이트에서 인스톨러를 다운로드하거나 패키지 관리자를 사용할 수 있어:

choco install cmake

또는

winget install Kitware.CMake

macOS

macOS에서는 Homebrew를 사용하는 것이 가장 간편해:

brew install cmake

Linux

Ubuntu나 Debian 기반 배포판에서는:

sudo apt-get install cmake

Fedora나 RHEL 기반 배포판에서는:

sudo dnf install cmake

설치가 완료되면 터미널에서 다음 명령어로 CMake가 제대로 설치되었는지 확인해보자:

cmake --version

최신 버전의 CMake를 사용하는 것이 좋아. 최소한 버전 3.10 이상을 권장해! 최신 C++ 표준과 다양한 기능을 지원하거든. 🔄

🚀 첫 번째 CMake 프로젝트

이론은 충분해! 이제 실제로 CMake를 사용해서 간단한 C++ 프로젝트를 빌드해보자. 가장 기본적인 "Hello, World!" 프로그램부터 시작할게. 😊

프로젝트 구조

먼저 다음과 같은 디렉토리 구조를 만들어보자:

hello_cmake/
├── CMakeLists.txt
└── main.cpp

main.cpp

가장 간단한 C++ 코드를 작성해보자:

#include <iostream>

int main() {
    std::cout << "Hello, CMake World!" << std::endl;
    return 0;
}

CMakeLists.txt

이제 CMake 설정 파일을 작성해보자:

cmake_minimum_required(VERSION 3.10)

# 프로젝트 이름 설정
project(HelloCMake VERSION 1.0)

# C++ 표준 설정
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 실행 파일 타겟 추가
add_executable(hello_cmake main.cpp)

각 줄이 무슨 의미인지 살펴보자:

cmake_minimum_required: 필요한 최소 CMake 버전을 지정해
project: 프로젝트 이름과 버전을 설정해
set(CMAKE_CXX_STANDARD 17): C++17 표준을 사용하도록 설정해
add_executable: 실행 파일을 만들고, 필요한 소스 파일을 지정해

프로젝트 빌드하기

이제 프로젝트를 빌드해보자. CMake는 소스 디렉토리와 별도로 빌드 디렉토리를 사용하는 것을 권장해. 이를 "out-of-source build"라고 불러. 이렇게 하면 소스 코드와 빌드 결과물이 섞이지 않아서 관리하기 편해져. 👍

터미널에서 다음 명령어를 실행해보자:

# 빌드 디렉토리 생성
mkdir build
cd build

# CMake 구성
cmake ..

# 빌드 실행
cmake --build .

빌드가 성공적으로 완료되면 build 디렉토리 안에 hello_cmake(Windows에서는 hello_cmake.exe) 실행 파일이 생성돼. 이제 실행해보자:

./hello_cmake

터미널에 "Hello, CMake World!"가 출력되면 성공이야! 🎉

📝 주요 CMake 명령어

CMake에는 다양한 명령어가 있어. 자주 사용하는 중요한 명령어들을 알아보자:

이 외에도 많은 명령어가 있지만, 위의 명령어들만 알아도 기본적인 CMake 프로젝트는 충분히 구성할 수 있어. 특히 target_link_libraries와 target_include_directories는 현대적인 CMake에서 매우 중요한 명령어야. 이 명령어들을 사용하면 의존성을 명확하게 관리할 수 있거든. 🧩

📂 여러 파일로 구성된 프로젝트

실제 프로젝트는 대부분 여러 파일로 구성되어 있지. 이번에는 조금 더 복잡한 구조의 프로젝트를 CMake로 관리해보자.

프로젝트 구조

calculator/
├── CMakeLists.txt
├── include/
│   └── calculator/
│       ├── add.h
│       ├── subtract.h
│       └── multiply.h
├── src/
│   ├── add.cpp
│   ├── subtract.cpp
│   ├── multiply.cpp
│   └── main.cpp
└── tests/
    ├── CMakeLists.txt
    └── test_calculator.cpp

헤더 파일

간단한 계산기 함수를 정의해보자:

include/calculator/add.h

#pragma once

namespace calculator {
    int add(int a, int b);
}

include/calculator/subtract.h

#pragma once

namespace calculator {
    int subtract(int a, int b);
}

include/calculator/multiply.h

#pragma once

namespace calculator {
    int multiply(int a, int b);
}

소스 파일

src/add.cpp

#include "calculator/add.h"

namespace calculator {
    int add(int a, int b) {
        return a + b;
    }
}

src/subtract.cpp

#include "calculator/subtract.h"

namespace calculator {
    int subtract(int a, int b) {
        return a - b;
    }
}

src/multiply.cpp

#include "calculator/multiply.h"

namespace calculator {
    int multiply(int a, int b) {
        return a * b;
    }
}

src/main.cpp

#include <iostream>
#include "calculator/add.h"
#include "calculator/subtract.h"
#include "calculator/multiply.h"

int main() {
    std::cout << "10 + 5 = " << calculator::add(10, 5) << std::endl;
    std::cout << "10 - 5 = " << calculator::subtract(10, 5) << std::endl;
    std::cout << "10 * 5 = " << calculator::multiply(10, 5) << std::endl;
    return 0;
}

테스트 파일

tests/test_calculator.cpp

#include <cassert>
#include <iostream>
#include "calculator/add.h"
#include "calculator/subtract.h"
#include "calculator/multiply.h"

int main() {
    // 테스트 add
    assert(calculator::add(5, 3) == 8);
    
    // 테스트 subtract
    assert(calculator::subtract(5, 3) == 2);
    
    // 테스트 multiply
    assert(calculator::multiply(5, 3) == 15);
    
    std::cout << "모든 테스트 통과!" << std::endl;
    return 0;
}

CMakeLists.txt

calculator/CMakeLists.txt

cmake_minimum_required(VERSION 3.10)
project(Calculator VERSION 1.0)

# C++ 표준 설정
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 라이브러리 소스 파일 목록
set(SOURCES
    src/add.cpp
    src/subtract.cpp
    src/multiply.cpp
)

# 라이브러리 생성
add_library(calculator_lib STATIC ${SOURCES})

# 라이브러리의 include 경로 설정
target_include_directories(calculator_lib
    PUBLIC
        ${CMAKE_CURRENT_SOURCE_DIR}/include
)

# 실행 파일 생성
add_executable(calculator src/main.cpp)

# 실행 파일에 라이브러리 링크
target_link_libraries(calculator
    PRIVATE
        calculator_lib
)

# 테스트 디렉토리 추가
add_subdirectory(tests)

calculator/tests/CMakeLists.txt

# 테스트 실행 파일 생성
add_executable(test_calculator test_calculator.cpp)

# 테스트 실행 파일에 라이브러리 링크
target_link_libraries(test_calculator
    PRIVATE
        calculator_lib
)

프로젝트 빌드하기

이제 이 프로젝트를 빌드해보자:

mkdir build
cd build
cmake ..
cmake --build .

빌드가 완료되면 calculator 실행 파일과 test_calculator 테스트 실행 파일이 생성돼. 각각 실행해보자:

./calculator
./tests/test_calculator

이 예제에서는 정적 라이브러리(STATIC)를 만들고, 그 라이브러리를 실행 파일과 테스트 파일에 링크했어. 이렇게 하면 코드 재사용성이 높아지고, 프로젝트 구조가 더 깔끔해져. 또한 add_subdirectory 명령어를 사용해서 테스트 디렉토리의 CMakeLists.txt도 함께 처리했어. 🧱

🔄 현대적인 CMake 사용법

CMake는 오랜 역사를 가진 도구이다 보니, 시간이 지나면서 사용 방식이 많이 변화했어. 최근에는 "Modern CMake"라고 불리는 접근 방식이 권장되고 있어. 이 방식의 핵심은 "타겟 중심(target-centric)" 접근법이야. 🎯

타겟 중심 접근법

전통적인 CMake에서는 전역 변수와 디렉토리 속성을 많이 사용했어:

# 전통적인 방식 (권장하지 않음)
include_directories(include)
add_definitions(-DSOME_DEFINE)
link_libraries(some_lib)

add_executable(my_app main.cpp)

하지만 현대적인 CMake에서는 각 타겟에 직접 속성을 설정해:

# 현대적인 방식 (권장)
add_executable(my_app main.cpp)

target_include_directories(my_app PRIVATE include)
target_compile_definitions(my_app PRIVATE SOME_DEFINE)
target_link_libraries(my_app PRIVATE some_lib)

이 방식의 장점은:

의존성이 명확해짐
속성의 범위(PRIVATE, PUBLIC, INTERFACE)를 명시적으로 지정할 수 있음
불필요한 전역 상태를 피할 수 있음

인터페이스 라이브러리

현대적인 CMake에서는 INTERFACE 라이브러리를 사용해 헤더 전용 라이브러리나 설정 모음을 만들 수 있어:

# 컴파일 옵션을 모아둔 인터페이스 라이브러리
add_library(project_options INTERFACE)
target_compile_features(project_options INTERFACE cxx_std_17)
target_compile_options(project_options INTERFACE -Wall -Wextra -Wpedantic)

# 경고를 에러로 취급하는 빌드 타입 설정
if(CMAKE_BUILD_TYPE STREQUAL "Release")
    target_compile_options(project_options INTERFACE -Werror)
endif()

# 실제 타겟에 옵션 적용
add_executable(my_app main.cpp)
target_link_libraries(my_app PRIVATE project_options)

가져온 타겟 사용하기

외부 라이브러리를 사용할 때는 find_package로 찾은 타겟을 직접 링크하는 것이 좋아:

# Boost 라이브러리 찾기
find_package(Boost 1.70 REQUIRED COMPONENTS filesystem system)

add_executable(my_app main.cpp)

# 직접 Boost 타겟 링크
target_link_libraries(my_app PRIVATE 
    Boost::filesystem 
    Boost::system
)

재능넷에서 C++ 관련 강의를 들어보면 이런 현대적인 CMake 사용법을 많이 배울 수 있어. 실제 업계에서도 이런 방식이 표준으로 자리잡고 있지. 특히 대규모 프로젝트에서는 이런 접근법이 코드 관리와 빌드 성능에 큰 도움이 돼. 🚀

📚 외부 라이브러리 사용하기

실제 프로젝트에서는 외부 라이브러리를 자주 사용하게 돼. CMake에서는 find_package 명령어를 사용해 외부 라이브러리를 찾고 사용할 수 있어.

find_package 사용하기

예를 들어, OpenCV 라이브러리를 사용하는 프로젝트를 만들어보자:

cmake_minimum_required(VERSION 3.10)
project(OpenCVExample VERSION 1.0)

# OpenCV 패키지 찾기
find_package(OpenCV REQUIRED)

# 실행 파일 생성
add_executable(image_processor main.cpp)

# OpenCV 라이브러리 링크 및 include 경로 설정
target_link_libraries(image_processor PRIVATE ${OpenCV_LIBS})
target_include_directories(image_processor PRIVATE ${OpenCV_INCLUDE_DIRS})

여기서 REQUIRED 옵션은 패키지를 찾지 못하면 CMake 구성 단계에서 오류를 발생시켜. 이렇게 하면 빌드 전에 의존성 문제를 빨리 발견할 수 있지. 🔍

FetchContent 사용하기

CMake 3.11부터는 FetchContent 모듈을 사용해 빌드 시점에 외부 라이브러리를 자동으로 다운로드하고 빌드할 수 있어:

cmake_minimum_required(VERSION 3.14)
project(FetchExample VERSION 1.0)

include(FetchContent)

# Google Test 다운로드
FetchContent_Declare(
    googletest
    GIT_REPOSITORY https://github.com/google/googletest.git
    GIT_TAG        release-1.11.0
)

# 다운로드한 콘텐츠 사용 가능하게 만들기
FetchContent_MakeAvailable(googletest)

# 테스트 실행 파일 생성
add_executable(my_tests tests.cpp)

# Google Test 링크
target_link_libraries(my_tests PRIVATE gtest_main gmock)

이 방식의 장점은 사용자가 직접 라이브러리를 설치하지 않아도 된다는 거야. 프로젝트를 클론하고 빌드하기만 하면 필요한 모든 의존성이 자동으로 처리돼. 단점은 매번 빌드할 때마다 외부 라이브러리도 함께 빌드해야 해서 시간이 더 걸릴 수 있다는 점이야. ⏱️

패키지 관리자와 함께 사용하기

대규모 프로젝트에서는 Conan이나 vcpkg 같은 C++ 패키지 관리자를 CMake와 함께 사용하는 경우가 많아. 예를 들어, Conan을 사용하는 방법을 살펴보자:

# conanfile.txt
[requires]
fmt/8.0.1
nlohmann_json/3.10.5

[generators]
cmake_find_package

그리고 CMakeLists.txt에서:

cmake_minimum_required(VERSION 3.10)
project(ConanExample VERSION 1.0)

# Conan 패키지 경로 추가
list(APPEND CMAKE_MODULE_PATH ${CMAKE_BINARY_DIR})

# 패키지 찾기
find_package(fmt REQUIRED)
find_package(nlohmann_json REQUIRED)

add_executable(json_formatter main.cpp)

target_link_libraries(json_formatter PRIVATE 
    fmt::fmt
    nlohmann_json::nlohmann_json
)

빌드 전에 다음 명령어로 의존성을 설치해:

mkdir build && cd build
conan install .. --build=missing
cmake ..
cmake --build .

외부 라이브러리 관리는 프로젝트가 커질수록 더 중요해져. 특히 여러 플랫폼에서 동작해야 하는 프로젝트라면 CMake와 패키지 관리자의 조합이 매우 유용해. 재능넷에서도 이런 주제의 강의가 인기가 많아. 실무에서 꼭 필요한 스킬이니까! 📦

🌍 크로스 플랫폼 빌드

CMake의 가장 큰 장점 중 하나는 크로스 플랫폼 지원이야. 같은 소스 코드와 CMake 파일로 Windows, Linux, macOS 등 다양한 플랫폼에서 빌드할 수 있지.

플랫폼별 설정

플랫폼에 따라 다른 설정이 필요할 때는 조건문을 사용할 수 있어:

# 플랫폼 감지
if(WIN32)
    # Windows 전용 설정
    add_definitions(-DWINDOWS_PLATFORM)
    target_sources(my_app PRIVATE src/windows_specific.cpp)
elseif(APPLE)
    # macOS 전용 설정
    add_definitions(-DMACOS_PLATFORM)
    target_sources(my_app PRIVATE src/macos_specific.cpp)
elseif(UNIX AND NOT APPLE)
    # Linux 전용 설정
    add_definitions(-DLINUX_PLATFORM)
    target_sources(my_app PRIVATE src/linux_specific.cpp)
endif()

컴파일러별 설정

컴파일러에 따라 다른 옵션을 설정할 수도 있어:

# 컴파일러 감지
if(CMAKE_CXX_COMPILER_ID STREQUAL "MSVC")
    # MSVC 컴파일러 옵션
    target_compile_options(my_app PRIVATE /W4 /WX)
elseif(CMAKE_CXX_COMPILER_ID STREQUAL "GNU")
    # GCC 컴파일러 옵션
    target_compile_options(my_app PRIVATE -Wall -Wextra -Wpedantic)
elseif(CMAKE_CXX_COMPILER_ID STREQUAL "Clang")
    # Clang 컴파일러 옵션
    target_compile_options(my_app PRIVATE -Wall -Wextra -Wpedantic)
endif()

제너레이터 표현식

더 복잡한 조건이 필요할 때는 제너레이터 표현식을 사용할 수 있어:

# 디버그 모드에서만 특정 옵션 적용
target_compile_definitions(my_app PRIVATE
    $<$<CONFIG:Debug>:DEBUG_MODE>
    $<$<CONFIG:Release>:NDEBUG>
)

# 특정 컴파일러에서만 옵션 적용
target_compile_options(my_app PRIVATE
    $<$<CXX_COMPILER_ID:MSVC>:/W4>
    $<$<OR:$<CXX_COMPILER_ID:GNU>,$<CXX_COMPILER_ID:Clang>>:-Wall>
)

제너레이터 표현식은 CMake의 강력한 기능 중 하나야. 빌드 시스템 생성 시점에 평가되는 조건식으로, 매우 유연한 설정이 가능해. 🔄

툴체인 파일

다른 아키텍처를 위한 크로스 컴파일을 할 때는 툴체인 파일을 사용해:

# arm-linux.cmake
set(CMAKE_SYSTEM_NAME Linux)
set(CMAKE_SYSTEM_PROCESSOR arm)

set(CMAKE_C_COMPILER arm-linux-gnueabihf-gcc)
set(CMAKE_CXX_COMPILER arm-linux-gnueabihf-g++)

set(CMAKE_FIND_ROOT_PATH /usr/arm-linux-gnueabihf)
set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)

이 툴체인 파일을 사용해 빌드하려면:

cmake -DCMAKE_TOOLCHAIN_FILE=arm-linux.cmake ..

크로스 플랫폼 개발은 쉽지 않은 작업이지만, CMake를 사용하면 많은 부분이 자동화돼. 특히 게임 개발이나 임베디드 시스템 개발처럼 여러 플랫폼을 지원해야 하는 프로젝트에서 CMake는 필수적인 도구야. 재능넷에서도 이런 크로스 플랫폼 개발 관련 강의가 인기가 많아. 🌐

🧪 테스트 자동화

CMake는 CTest라는 테스트 프레임워크를 내장하고 있어. 이를 사용하면 테스트를 쉽게 자동화할 수 있지.

CTest 기본 사용법

CMakeLists.txt에 다음 줄을 추가해:

enable_testing()

그리고 테스트를 등록해:

add_test(NAME MyTest COMMAND my_test_executable)

빌드 후 테스트를 실행하려면:

cd build
ctest

Google Test 연동

Google Test와 함께 사용하면 더 강력한 테스트 환경을 구축할 수 있어:

cmake_minimum_required(VERSION 3.14)
project(TestExample VERSION 1.0)

# Google Test 가져오기
include(FetchContent)
FetchContent_Declare(
    googletest
    GIT_REPOSITORY https://github.com/google/googletest.git
    GIT_TAG        release-1.11.0
)
FetchContent_MakeAvailable(googletest)

# 테스트 활성화
enable_testing()

# 테스트 실행 파일 생성
add_executable(math_tests math_tests.cpp)
target_link_libraries(math_tests PRIVATE gtest_main)

# Google Test 테스트 등록
include(GoogleTest)
gtest_discover_tests(math_tests)

gtest_discover_tests 함수는 Google Test 실행 파일에서 모든 테스트를 자동으로 찾아서 CTest에 등록해줘. 이렇게 하면 각 테스트 케이스가 개별적으로 CTest에 표시돼. 🔍

코드 커버리지 측정

CMake와 함께 gcov/lcov를 사용해 코드 커버리지를 측정할 수도 있어:

# 커버리지 측정을 위한 컴파일 옵션 설정
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} --coverage")

# 테스트 실행 파일 생성
add_executable(math_tests math_tests.cpp)
target_link_libraries(math_tests PRIVATE gtest_main --coverage)

# 커버리지 리포트 생성을 위한 사용자 정의 타겟
add_custom_target(coverage
    COMMAND lcov --capture --directory . --output-file coverage.info
    COMMAND lcov --remove coverage.info '/usr/*' --output-file coverage.info
    COMMAND genhtml coverage.info --output-directory coverage_report
    WORKING_DIRECTORY ${CMAKE_BINARY_DIR}
    COMMENT "Generating code coverage report"
)

빌드 후 다음 명령어로 커버리지 리포트를 생성할 수 있어:

cd build
cmake --build . --target coverage

테스트 자동화는 현대 소프트웨어 개발에서 매우 중요한 부분이야. CMake와 CTest를 사용하면 빌드 프로세스에 테스트를 통합해서 코드 품질을 지속적으로 관리할 수 있어. 재능넷에서도 TDD(테스트 주도 개발) 관련 강의가 인기가 많아. 실무에서 정말 중요한 스킬이니까! 🧪

✅ CMake 모범 사례

지금까지 CMake의 다양한 기능을 살펴봤어. 이제 실제 프로젝트에서 CMake를 효과적으로 사용하기 위한 모범 사례를 알아보자.

이런 모범 사례를 따르면 CMake 프로젝트를 더 깔끔하고 유지보수하기 쉽게 만들 수 있어. 특히 타겟 중심 접근법과 적절한 범위 지정자 사용은 현대적인 CMake의 핵심이야. 재능넷에서 진행하는 C++ 프로젝트 관리 강의에서도 이런 모범 사례를 많이 다루고 있어. 👍

🔥 고급 주제

기본적인 내용을 마스터했다면, 이제 더 고급 주제로 넘어가보자. 이런 기능들은 대규모 프로젝트에서 특히 유용해.

사용자 정의 명령어

반복되는 작업을 함수나 매크로로 정의해 재사용할 수 있어:

# 사용자 정의 함수
function(add_formatted_target target_name)
    add_executable(${target_name} ${ARGN})
    target_link_libraries(${target_name} PRIVATE project_options)
    
    # 코드 포맷팅 타겟 추가
    add_custom_target(
        format_${target_name}
        COMMAND clang-format -i ${ARGN}
        WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
        COMMENT "Formatting source files for ${target_name}"
    )
endfunction()

# 함수 사용
add_formatted_target(my_app src/main.cpp src/utils.cpp)

미리 컴파일된 헤더(PCH) 사용

대규모 프로젝트에서 빌드 시간을 단축하기 위해 PCH를 사용할 수 있어:

# PCH 헤더 파일
target_precompile_headers(my_app
    PRIVATE
        <vector>
        <string>
        <map>
        <memory>
        "common/utils.h"
)

유니티 빌드

여러 소스 파일을 하나로 합쳐서 컴파일 시간을 단축할 수 있어:

# 유니티 빌드 활성화
set_target_properties(my_app PROPERTIES
    UNITY_BUILD ON
    UNITY_BUILD_BATCH_SIZE 8  # 한 번에 합칠 파일 수
)

설치 및 내보내기

라이브러리를 다른 프로젝트에서 사용할 수 있도록 설치 규칙을 정의할 수 있어:

# 라이브러리 설치
install(
    TARGETS my_lib
    EXPORT MyLibTargets
    LIBRARY DESTINATION lib
    ARCHIVE DESTINATION lib
    RUNTIME DESTINATION bin
    INCLUDES DESTINATION include
)

# 헤더 파일 설치
install(
    DIRECTORY include/
    DESTINATION include
)

# 타겟 내보내기
install(
    EXPORT MyLibTargets
    FILE MyLibTargets.cmake
    NAMESPACE MyLib::
    DESTINATION lib/cmake/MyLib
)

# 설정 파일 생성 및 설치
configure_package_config_file(
    cmake/MyLibConfig.cmake.in
    ${CMAKE_CURRENT_BINARY_DIR}/MyLibConfig.cmake
    INSTALL_DESTINATION lib/cmake/MyLib
)

# 버전 파일 생성 및 설치
write_basic_package_version_file(
    ${CMAKE_CURRENT_BINARY_DIR}/MyLibConfigVersion.cmake
    VERSION ${PROJECT_VERSION}
    COMPATIBILITY SameMajorVersion
)

# 설정 파일 설치
install(
    FILES
        ${CMAKE_CURRENT_BINARY_DIR}/MyLibConfig.cmake
        ${CMAKE_CURRENT_BINARY_DIR}/MyLibConfigVersion.cmake
    DESTINATION lib/cmake/MyLib
)

이런 고급 기능들은 대규모 프로젝트나 라이브러리를 개발할 때 특히 유용해. 빌드 시간을 단축하고, 다른 프로젝트에서 쉽게 사용할 수 있는 패키지를 만들 수 있거든. 재능넷에서도 이런 고급 CMake 기법에 대한 강의가 있어. 실무에서 정말 도움이 많이 되는 내용이지! 🚀

🔧 문제 해결

CMake를 사용하다 보면 다양한 문제에 부딪힐 수 있어. 자주 발생하는 문제와 해결 방법을 알아보자.

자주 발생하는 오류

라이브러리를 찾지 못하는 경우

CMake가 라이브러리를 찾지 못하면 다음과 같은 오류가 발생해:

CMake Error at CMakeLists.txt:10 (find_package):
  Could not find a package configuration file provided by "Boost" with any of
  the following names:

    BoostConfig.cmake
    boost-config.cmake

해결 방법:

# 추가 검색 경로 지정
set(CMAKE_PREFIX_PATH ${CMAKE_PREFIX_PATH} "/path/to/boost")

# 또는 환경 변수 설정
# export CMAKE_PREFIX_PATH=/path/to/boost:$CMAKE_PREFIX_PATH

컴파일러 호환성 문제

C++ 표준 버전 불일치로 인한 오류:

error: this file requires compiler and library support for the ISO C++ 2017 standard

해결 방법:

# C++ 표준 버전 명시적 설정
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_CXX_EXTENSIONS OFF)

빌드 타입 관련 문제

멀티 설정 생성기(예: Visual Studio)에서 빌드 타입이 적용되지 않는 문제:

해결 방법:

# 단일 설정 생성기용
if(NOT CMAKE_BUILD_TYPE)
    set(CMAKE_BUILD_TYPE "Release" CACHE STRING "Build type" FORCE)
endif()

# 멀티 설정 생성기용
set(CMAKE_CONFIGURATION_TYPES "Debug;Release;RelWithDebInfo;MinSizeRel" CACHE STRING "" FORCE)

디버깅 팁

CMake 스크립트를 디버깅하는 방법:

변수 값 출력하기

message(STATUS "My variable: ${MY_VARIABLE}")

# 변수 타입 확인
if(DEFINED MY_VARIABLE)
    message(STATUS "MY_VARIABLE is defined")
endif()

# 리스트 내용 출력
foreach(item IN LISTS MY_LIST)
    message(STATUS "List item: ${item}")
endforeach()

--trace 옵션 사용하기
CMake 실행 시 --trace 옵션을 사용하면 모든 명령어 실행을 추적할 수 있어:
```
cmake --trace ..
```
--debug-output 옵션 사용하기
더 자세한 디버그 정보를 보려면:
```
cmake --debug-output ..
```

문제 해결 능력은 CMake를 마스터하는 데 매우 중요해. 오류 메시지를 꼼꼼히 읽고, 문서를 참조하는 습관을 들이면 대부분의 문제를 해결할 수 있어. 재능넷에서도 CMake 트러블슈팅에 관한 질문이 많이 올라오는데, 이런 경험을 공유하면서 함께 성장할 수 있어. 🔍

📚 추가 자료

CMake에 대해 더 깊이 공부하고 싶다면 다음 자료들을 참고해보자:

📖 책

"Professional CMake: A Practical Guide" by Craig Scott
"CMake Cookbook" by Radovan Bast and Roberto Di Remigio
"Effective CMake" by Daniel Pfeifer

🌐 웹사이트

CMake 공식 문서: https://cmake.org/documentation/
CMake 튜토리얼: https://cmake.org/cmake/help/latest/guide/tutorial/
Modern CMake: https://cliutils.gitlab.io/modern-cmake/

🎬 동영상

CppCon의 "More Modern CMake" 강연
재능넷의 "C++ 빌드 시스템 마스터하기" 강의
YouTube의 "CMake Tutorial" 시리즈

이런 자료들을 통해 CMake에 대한 이해를 더 깊게 할 수 있어. 특히 재능넷에서 제공하는 실무 중심의 CMake 강의는 실제 프로젝트에 바로 적용할 수 있는 내용이 많아서 추천해! 🌟

🏁 마치며

지금까지 CMake의 기본부터 고급 주제까지 다양한 내용을 살펴봤어. CMake는 처음에는 배우기 어려울 수 있지만, 한번 익숙해지면 C++ 프로젝트 관리에 정말 강력한 도구가 돼. 특히 크로스 플랫폼 개발이나 대규모 프로젝트에서는 필수적인 도구라고 할 수 있지.

CMake를 마스터하는 것은 하루아침에 이루어지지 않아. 꾸준한 학습과 실습이 필요해. 작은 프로젝트부터 시작해서 점점 복잡한 기능을 추가해나가는 것이 좋은 방법이야. 그리고 다른 오픈 소스 프로젝트의 CMakeLists.txt 파일을 분석해보는 것도 많은 도움이 돼. 🔍

재능넷에서는 이런 CMake 관련 강의와 프로젝트 경험을 공유할 수 있는 기회가 많아. 특히 C++ 개발자들 사이에서는 빌드 시스템 구성 경험이 매우 가치 있게 평가되거든. 여러분도 이 글을 통해 CMake에 대한 기본적인 이해를 얻고, 더 나아가 실제 프로젝트에 적용해보길 바라! 🚀

질문이나 더 알고 싶은 내용이 있다면 재능넷 커뮤니티에서 언제든지 물어봐. 함께 성장하는 개발자 커뮤니티에서 만나자! 👋

지식인의 숲 - 지적 재산권 보호 고지

지적 재산권 보호 고지

사용 제한: 재능넷의 명시적 서면 동의 없이 본 컨텐츠를 복제, 수정, 배포, 또는 상업적으로 활용하는 행위는 엄격히 금지됩니다.
데이터 수집 금지: 본 컨텐츠에 대한 무단 스크래핑, 크롤링, 및 자동화된 데이터 수집은 법적 제재의 대상이 됩니다.
AI 학습 제한: 재능넷의 AI 생성 컨텐츠를 타 AI 모델 학습에 무단 사용하는 행위는 금지되며, 이는 지적 재산권 침해로 간주됩니다.

5.5K

PHP 15년 경력 | CRM/ERP/API/AI 연계 웹시스템 개발

PHP 백엔드 개발 15년 경력의 전문 개발자입니다. 홈페이지부터 CRM·ERP 업무 시스템, API 연동, OpenAI 연계까지 고객이 원하는 기능을 정확하게 구현해드립니다. [이런 작업 가능합니다] 기업 홈페이지 / 랜딩페이지 회원가입·로그인·마이페이지 게시판·댓글·파일 업로드 관리자 페이지 (데이터 관리·통계) CRM·ERP 업무 자동화 시스템 외부

50,000원~

9.5K

홈페이지부터 앱·서버까지 이어서 만들어 드립니다, 반응형 소개 홈페이지 제작

홈페이지부터 앱, 서버까지 이어서 맡아 드립니다. 병원, 미용실, 식당 같은 소개 홈페이지를 만들었고, 같은 사람이 필요한 만큼 이어서 맡습니다. 홈페이지에서 시작해 앱, 서버까지 이어서 맡을 수 있습니다. 이런 일을 합니다 - 소개 홈페이지: 병원, 미용실, 식당처럼 우리 가게를 소개하는 홈페이지를 만듭니다. - 반응형 화면: PC, 태블릿, 휴대폰 화면

500,000원~

1.9K

PHP, ASP, HTML, CSS, IMAGE - 홈페이지, 쇼핑몰 유지보수 및 개발

웹에이젼시 개발자로 16년차 입니다. 웹서버 셋팅부터 웹프로그램, 웹디자인 모두 가능합니다. 홈페이지를 운영중인데, 수정하거나 기능 업그레이드가 필요하시면 언제든 연락주십시오. 홈페이지나 쇼핑몰을 제작하고 싶은데, 무엇을 먼저 시작해야 할지 모르신다면, 우선 연락주십시오. 1. 홈페이지/쇼핑몰 유지보수 간단한 텍스트 부터 디자인 변경, 복잡한 프로그램까지

10,000원~

재능인 3급 인증

12.3K

PHP, ASP 개발 유지보수해드립니다.

안녕하세요. 자기소개는 아래에 썼으니 참고부탁드리구요. (가끔 개인적 사정으로 인해 연락을 못받거나 답변이 늦어질 수 있습니다. 양해부탁드립니다.) PHP, ASP, MySQL, MSSQL, jQuery 언어에 대해 개발/유지보수 해드릴 수 있습니다. 이 재능기부를 통해 앞으로 좋은 관계 맺어나갔으면 합니다. 참여 여부를 떠나 성심성의껏 답해드릴테니 부담없

5,000원~

6.4K

[빠른 개발]쇼핑몰, 홈페이지, 어플등 저렴하게 제작해 드립니다.

안녕하세요. 경력 13년차 프리랜서입니다. 팀으로 프로젝트 작업하여 빠르고 퀄리티 있게 작업해드리겠습니다. 관계자 분이 ok 하실 때까지 제작 해드리겠습니다. 각 페이지별로 고도화하여 사용자들이 이용하는데 불편함 없이 만들어 드리며, 의뢰자와 함께 소통하여 더 나은 방향으로 만들어 드리고있습니다. - 팀 경력 - - 프로그램 개발 15년 풀스택 개발자,

50,000원~

재능인 5급 인증

9.2K

홈페이지 정가제 실시 15페이지 미만 홈페이지 25만원에 제작합니다.

250,000원~

웹개발 전문가가 최상의 결과물을 보여드립니다.

안녕하세요. 25년 웹개발 경력의 개발자입니다. 웹사이트 개발, 유지보수를 도와드립니다. ERP, 게임포털, 검색포털등에서 오랫동안 개발하고 서비스를 운영해 온 경험으로 최적의 결과물을 제공해드립니다. 웹사이트과 운영과 관련된 모든 부분(하드웨어 인프라, 클라우드 적용, 설계 및 구축)에 대해서 도움을 드릴 수 있습니다. 1. 작업이 가능한 내용 A.

5,000원~

재능인 4급 인증

10K

거품없는 다양한 프로그램 개발

안녕하세요. 부동산, 학원, 재고관리, 기관/관공서, 기업, ERP, 기타 솔루션, 일반 서비스(웹, 모바일) 등 다양한 분야에서 개발을 해왔습니다. 거품이 없는 가격대비 원하는 기능을 효율적인 방향으로 개발을 진행해 드리며 당장이 아닌 추후 관리나 비용면등을 고려하여 최대한 부담없는 프로그램을 만들어 드리는 것이 저의 목표입니다. 한번 인연이 되시면

5,000원~

프로그램개발 · 분야 선택22개 분야

🛠️ 빌드 시스템: CMake 사용법 마스터하기 🛠️

🤔 왜 CMake를 사용해야 할까?

📚 CMake 개요

⚙️ CMake 설치하기

Windows

macOS

Linux

🚀 첫 번째 CMake 프로젝트

프로젝트 구조

main.cpp

CMakeLists.txt

프로젝트 빌드하기

📝 주요 CMake 명령어

📂 여러 파일로 구성된 프로젝트

프로젝트 구조

헤더 파일

소스 파일

테스트 파일

CMakeLists.txt

프로젝트 빌드하기

🔄 현대적인 CMake 사용법

타겟 중심 접근법

인터페이스 라이브러리

가져온 타겟 사용하기

📚 외부 라이브러리 사용하기

find_package 사용하기

FetchContent 사용하기

패키지 관리자와 함께 사용하기

🌍 크로스 플랫폼 빌드

플랫폼별 설정

컴파일러별 설정

제너레이터 표현식

툴체인 파일

🧪 테스트 자동화

CTest 기본 사용법

Google Test 연동

코드 커버리지 측정

✅ CMake 모범 사례

🔥 고급 주제

사용자 정의 명령어

미리 컴파일된 헤더(PCH) 사용

유니티 빌드

설치 및 내보내기

🔧 문제 해결

자주 발생하는 오류

디버깅 팁

📚 추가 자료

📖 책

🌐 웹사이트

🎬 동영상

🏁 마치며

관련 키워드

댓글 작성

로그인이 필요합니다

댓글 0

지식인의 숲 - 지적 재산권 보호 고지

지적 재산권 보호 고지

해당 지식과 관련있는 인기재능