[c++] CMake

CMake란?

• makefile 의 직접적인 작성에서 한발자국 더 나아가 명령어를 통해 자동으로 makefile을 만들어주는 방식

 

직접적인 컴파일 방식

>> g++ main.cpp -o main
>> ./main
<< HELLO WORLD!!

 

 

CMake 사용법

 

Cmake 설치

>> brew install cmake

>> cmake --version
<< cmake version 3.31.0

 

Cmake 테스트

설치 후에 간단하게 main.cpp 파일을 Cmake를 통해 빌드해보자.

 

CMake를 사용하기위해서는 CmakeLists.txt라는 파일을 생성해줘야한다.

CmakeLists.txt에는 빌드를 진행하기위해 필요한 정보들을 담아서 어떻게 빌드를 진행할 것인지 알려주는 작업이 필요하다.
( ex: 어떤 파일을 빌드할 것인지.. , 실행파일의 이름은 무엇으로 할것인지.. , 프로젝트의 이름은 무엇인지.. 등등 )

 

 

현재 디렉토리 구조

Cmake-test
    - main.cpp
    - (CmakeLists.txt를 생성해야할 위치)

 

CMakeLists.txt

# CMakeLists.txt
project(hello_world)
 
add_executable(main main.cpp)

위에 CMakeLists.txt는 빌드를 하기위한 아주 기본적인 내용들을 담고있다.

 

project(hello_world)

• project 명을 통해 프로젝트의 이름, 버전, 언어 등을 인식할 수 있도록 지정해줄 수 있다.
• project를 지정하지않는다고해서 컴파일이 안되는것은 아니지만 호환성이나 의존성 등으로 인해 지정하는것이 권장된다.
  

add_executable(main main.cpp)

• 어떠한 파일을 빌드항목에 포함시킬 것이고 실행파일의 이름은 무엇으로 할것인지 지정해준다.
• 위와 같은 경우는 실행파일의 이름을 main 으로 할 것이고 빌드 파일들 항목에는 main.cpp만 포함한다는 내용을 담고있다.
  ( 추가적으로 파일들을 넣어줘야하는 상황이라면 들여쓰기를 통해 쓰는것이 가능하다. )

ex)

add_executable(main 
    	main.cpp
        test.cpp
)

 

 

빌드 후 실행해보기

이제는 CMakeLists.txt 을 바탕으로 CMake 한 내용들이 담길 디렉토리를 지정 후 생성해줘야한다.

main.cpp 파일이 있는 위치에서 바로 생성을 해도 되긴하지만 그러면 디렉토리 구조가 너무 지저분해지기때문에 CMake build 내용들이 담길 디렉토리를 생성하는 것을 권장한다.

 

디렉토리구조

Cmake-test
    - main.cpp
    - CmakeLists.txt
    - (build 디렉토리 생성위치)

보편적으로는 위와같이 CmakeLists.txt 파일이 있는 위치에 디렉토리를 생성하여 내용들을 담는편이다.

 

<< mkdir build
(디렉토리의 이름은 다른것으로 해도 상관 X)
<< cd build
<< cmake .. 
(build 디렉토리 안에 있으니 cmake 명령어는 .. 경로에 있는 cmakelists.txt 를 참조하겠다는 의미)
<< ls
CMakeCache.txt      CMakeFiles          Makefile            cmake_install.cmake
<< make
<< ./main
>> HELLO WORLD!!

 

CMake에서는 이것뿐아니라 다양하게 빌드 시 어떠한 라이브러리를 같이 빌드할것인지, CMake를 할려면 필요한 최소 버전 등등 다양한 조건들을 추가할 수 있다.

 

 

참고자료

https://gist.github.com/luncliff/6e2d4eb7ca29a0afd5b592f72b80cb5c?permalink_comment_id=3300758