[CMake] Window에서 CMake 사용하여 프로젝트 만들기

💡 본 문서는 'Window에서 CMake 사용하여 프로젝트 만들기'에 대해 정리해놓은 글입니다.
제목 그대로 Window에서 CMake 사용하기 위한 환경 설정 및 이를 이용한 프로젝트를 만드는 방법에 대해 정리하였으니 참고하시기 바랍니다.

1. 환경 설정

1.1 CMake 설치하기

윈도우(Windows)에서 CMake를 설치하는 방법은 간단합니다. 가장 먼저 CMake의 공식 홈페이지에서 다운로드 페이지로 접속합니다. 

윈도우용 CMake 설치 실행파일인 'cmake-<version>-win64-x64.msi' 파일을 다운로드 합니다. 이후 기본적으로 [Next] 버튼을 눌러서 쭉 설치를 진행하되 system PATH를 설정하는 부분에서 'Add CMake to the system PATH for all users'를 선택합니다.

설치가 완료되면 cmake 명령으로 설치를 확인합니다.

$ cmake
Usage

  cmake [options] <path-to-source>
  cmake [options] <path-to-existing-build>
  cmake [options] -S <path-to-source> -B <path-to-build>

Specify a source directory to (re-)generate a build system for it in the
current working directory.  Specify an existing build directory to
re-generate its build system.

Run 'cmake --help' for more information.

이때 터미널을 껐다가 킬 경우 cmake 명령을 인식하지 못하는데, 이는 윈도우 특성상 환경변수가 컴퓨터 재부팅을 해야 적용이 되기 때문입니다. 전원을 끄기 귀찮다면 다음의 명령을 통해 PATH 환경변수를 적용해주면 사용할 수 있습니다.

$ set PATH="C:\Program Files\CMake\bin\";%PATH%

다른 방법으로는 [Problem Fix] 윈도우 환경변수 재부팅 안하고 적용하기에 설명된 것처럼 다음의 명령을 통해 환경변수 설정을 적용할 수 있습니다.

$ taskkill /f /im explorer.exe

1.2 Make 설치하기

윈도우(Windows) 환경에서 GNU Make를 설치하여 이용하는 방법은 또한 간단합니다. gnuwin32 홈페이지에서 make 다운로드 페이지로 들어갑니다.

이후  다음과 같이 소스코드 없이 바로 설치할 수 있는 설치 파일을 받기 위해 [Setup] 링크를 누릅니다.

https://ndb796.tistory.com/381

다운로드가 끝다면 바로 설치 프로그램을 실행하여 설치를 진행할 수 있습니다. 기본 설정 그대로 [Next] 버튼만 누르셔도 정상적으로 설치됩니다.

이후 CMake와 달리 Make의 실행파일 경로를 환경변수로 등록해주어야 사용할 수 있습니다. 따라서 기본적으로 설치되는 경로인 'C;\Program Files (x86)\GnuWin32\bin'를 시스템 환경 변수 PATH에 추가해주어야 합니다.

https://ndb796.tistory.com/381

이후에 명령 프롬프트(CMD)에서 make -v 명령을 입력했을 때, 버전 정보가 출력이 되면 정상적으로 설치가 완료된 겁니다.

2. CMake 프로젝트 제작하기

2.1. CMake & Make 프로젝트 빌드하기

이제 CMake로 예제프로젝트인 eigen을 빌드해보도록 하겠습니다.

$ git clone https://gitlab.com/libeigen/eigen.git

$ cd eigen
$ mkdir build
$ cd build

$ cmake -DCMAKE_BUILD_TYPE=Debug -G "MinGW Makefiles" -DCMAKE_INSTALL_PREFIX=../install ..
$ make -j4
$ sudo make install

여기서 중요한 부분은 cmake 옵션 중 -G "MinGW Makefiles" 입니다. 해당부분을 넣지 않으면 계속해서 NMake Makefiles를 찾게 되어 꼭 포함시켜주어야 합니다.

2.2. 빌드한 파일 활용하기

이제 eigen 라이브러리를 사용하는 프로젝트를 만들어보겠습니다.

먼저 프로젝트를 위해 project 폴더를 만들겠습니다. 앞으로 해당 폴더 하위로 example.cpp와 CMakeLists.txt를 작성할 예정이니 참고하시기 바랍니다.

먼저 해당 라이브러리를 사용하는 example.cpp 파일을 작성합니다.

#include <iostream>
#include <Eigen/Dense>
 
using Eigen::MatrixXd;
 
int main()
{
  MatrixXd m(2,2);
  m(0,0) = 3;
  m(1,0) = 2.5;
  m(0,1) = -1;
  m(1,1) = m(1,0) + m(0,1);
  std::cout << m << std::endl;
}

이후 cpp 파일에서 eigen 라이브러리를 사용하기 위해 동일 경로에 CMakeLists.txt파일을 작성합니다. 

cmake_minimum_required (VERSION 3.0)
project (myproject)
 
set(EIGEN3_INCLUDE_DIR "~/eigen/cmake")
include_directories(${EIGEN3_INCLUDE_DIR})

find_package (Eigen3 REQUIRED)
 
add_executable (example example.cpp)
target_link_libraries (example Eigen3::Eigen)

여기서 EIGEN3_INCLUDE_DIR이라는 환경변수에는 아까 빌드한 eigen 폴더 내부 cmake 경로로 입력합니다. 

이후 아까 eigen을 빌드한 것처럼 해당 소스코드를 빌드하면, example이라는 실행파일이 생성되는 것을 확인할 수 있습니다.

$ mkdir build
$ cd build

$ cmake -DCMAKE_BUILD_TYPE=Debug  -G "MinGW Makefiles" ..
$ make -j4

이제 build 폴더 내에 생성된 example 실행파일을 실행시키면? 다음과 같이 성공적으로 print하는 것을 확인할 수 있습니다.

$ example
3  2.5
-1 1.5

참고

• [Blog] 윈도우(Windows)에서 CMake 설치하는 방법: https://ndb796.tistory.com/365
• [Blog] 윈도우(Windows)에서 make 명령 사용하기:https://ndb796.tistory.com/381
• [Blog] [Problem Fix] 윈도우 환경변수 재부팅 안하고 적용하기: https://csj000714.tistory.com/805