CPM.cmake(CMake Package Manager)는 CMake의 FetchContent 모듈을 확장하여, 프로젝트 외부의 라이브러리를 간편하게 가져오고 캐싱할 수 있도록 돕는 경량 의존성 관리 도구 입니다.

• 프로젝트 홈페이지 : https://github.com/cpm-cmake/CPM.cmake

일반적으로 GitHub 저장소에서 패키지를 받아오는 용도로 사용되지만, 사설 Git 서버(예: 내부 IP 기반 서버)에서도 충분히 활용 가능합니다.

이 문서에서는 사설 Git 서버를 구축하고, CPM.cmake를 이용해 해당 서버에서 라이브러리를 자동으로 다운로드하여 사용하는 방법 을 자세히 소개합니다.

CPM.cmake는 프로젝트 내에 직접 포함하는 것이 일반적입니다:

bash

  mkdir -p cmake
  wget -O cmake/CPM.cmake https://github.com/cpm-cmake/CPM.cmake/releases/latest/download/get_cpm.cmake

아래는 fmt, nlohmann/json, Catch2를 CPM(CMake Package Manager)을 통해 GitHub에서 받아 사용하는 예시입니다:

• fmt : https://github.com/fmtlib/fmt
• nlohmann/json : https://github.com/nlohmann/json
• Catch2 : https://github.com/catchorg/Catch2

cmake

  cmake_minimum_required(VERSION 3.14 FATAL_ERROR)
  
  # create project
  project(MyProject)
  
  # add executable
  add_executable(main main.cpp)
  
  # add dependencies
  include(cmake/CPM.cmake)
  
  CPMAddPackage("gh:fmtlib/fmt#7.1.3")
  CPMAddPackage("gh:nlohmann/json@3.10.5")
  CPMAddPackage("gh:catchorg/Catch2@3.4.0")
  
  # link dependencies
  target_link_libraries(main
      fmt::fmt
      nlohmann_json::nlohmann_json
      Catch2::Catch2WithMain
  )

#버전은 Git 태그/브랜치/커밋을 직접 지정하는 방식이며,
@버전은 CPM 내부 버전 추적용 이름을 포함하는 방식입니다.
일반적으로 @버전이 캐시 충돌을 줄이고 관리에 더 유리합니다.

다음은 사설 Git 저장소에서 라이브러리를 받아와 사용하는 예시입니다:

cmake

  cmake_minimum_required(VERSION 3.14)
  
  project(MyProject)
  
  include(cmake/CPM.cmake)
  
  CPMAddPackage(
    NAME MyLib
    GIT_REPOSITORY git@192.168.0.10:mylib.git
    GIT_TAG main   # 또는 특정 커밋 해시, 태그
  )
  
  add_executable(main main.cpp)
  target_link_libraries(main MyLib)

GIT_TAG는 반드시 명시해야 하며, 브랜치명, 태그명, 또는 커밋 해시를 사용할 수 있습니다.

CPM(CMake Package Manager)은 Git 저장소뿐만 아니라 압축 파일(.zip 등) 형식의 패키지 도 URL을 통해 직접 가져올 수 있습니다.

cmake

  # 버전은 자동 추정 (예: 파일명에서 추출)
  CPMAddPackage("https://example.com/my-package-1.2.3.zip")
  
  # MD5 해시값을 명시하여 무결성 검증
  CPMAddPackage("https://example.com/my-package-1.2.3.zip#MD5=68e20f674a48be38d60e129f600faf7d")
  
  # 명시적으로 버전 지정
  CPMAddPackage("https://example.com/my-package.zip@1.2.3")

이 방식은 Git을 사용하지 않는 사내 배포 시스템이나, 외부 공개 라이브러리를 간단히 가져오고자 할 때 유용합니다.

CPM.cmake는 다운로드된 의존성을 자동으로 캐싱합니다. 기본 캐시 위치는 다음과 같습니다:

• $HOME/.cache/CPM
• ${CMAKE_BINARY_DIR}/_deps (빌드 디렉토리 내)

이 디렉토리를 보존하거나 다른 머신에 복사하면 오프라인에서도 동일하게 사용할 수 있습니다.

단순한 Git 베어 저장소 외에도, 다음과 같은 웹 기반 Git 서버를 설치하여 사용자 인터페이스와 프로젝트 관리 기능을 강화할 수 있습니다:

• Gitea : 경량 오픈소스 Git 서비스
• GitLab CE : 보다 강력한 CI/CD, 권한 관리 등 제공

이런 도구들은 SSH/HTTPS 모두를 지원하며, 여러 개발자와 협업 시 매우 유용합니다.

사설 서버(IP: 192.168.0.10 등)에 Git을 설치합니다:

• bash

    sudo apt update
    sudo apt install git
  

베어 저장소를 생성합니다:

• bash

    mkdir -p /srv/git/mylib.git
    cd /srv/git/mylib.git
    git init --bare
  

클라이언트에서 해당 서버로 접속할 수 있도록 SSH 인증을 설정합니다:

• (1) 서버에 git 사용자 생성 (또는 기존 사용자 사용)
• (2) 클라이언트의 공개키를 서버의 ~/.ssh/authorized_keys에 등록
• (3) 클라이언트에서 SSH 접속 확인:

  • bash

    ssh git@192.168.0.10
    

CPM 사용을 위하여 비밀번호 없이 접근되도록 설정하는 것이 중요합니다.

사설 Git 서버가 HTTPS로 동작하고 있고, 자체 서명된 SSL 인증서를 사용하는 경우 다음 설정으로 인증서 검증을 건너뛸 수 있습니다:

bash

git config --global http.sslVerify false

⚠️ 단, 이 설정은 보안상 위험하므로, 내부 개발 환경 에서만 사용하는 것이 좋습니다.

• 프로젝트 홈페이지 : https://github.com/vector-of-bool/cmrc

CMake의 FetchContent를 이용하여 cmrc를 프로젝트에 추가할 수 있습니다.

cmake

  include(FetchContent)
  FetchContent_Declare(
      cmrc
      GIT_REPOSITORY https://github.com/vector-of-bool/cmrc.git
      GIT_TAG        master
  )
  FetchContent_MakeAvailable(cmrc)

CMake에서 리소스를 바이너리에 포함하려면 cmrc_add_resource_library를 사용해야 합니다.

cmake

  cmake_minimum_required(VERSION 3.10)
  project(MyProject)
  
  include(FetchContent)
  FetchContent_Declare(
      cmrc
      GIT_REPOSITORY https://github.com/vector-of-bool/cmrc.git
      GIT_TAG        master
  )
  FetchContent_MakeAvailable(cmrc)
  
  # 실행 파일 생성
  add_executable(MyProject src/main.cpp)
  
  # 리소스 라이브러리 생성
  cmrc_add_resource_library(resources STATIC
      resources/image.png
      resources/config.json
  )
  
  # cmrc를 사용하려면 cmrc::resources를 링크해야 함
  target_link_libraries(MyProject PRIVATE resources cmrc::resources)
  
  # cmrc를 사용하려면 이 설정이 필요함
  cmrc_add_library(resources)

먼저, #include <cmrc/cmrc.hpp>를 추가하고 CMRC_DECLARE()를 사용하여 리소스를 등록합니다.

cpp

  #include <iostream>
  #include <string>
  #include <cmrc/cmrc.hpp> // 헤더 추가
  
  CMRC_DECLARE(resources);
  
  int main() {
      // 리소스 파일 시스템 가져오기
      auto fs = cmrc::resources::get_filesystem();
  
      // 이미지 파일 읽기
      if (fs.exists("resources/image.png")) {
          auto file = fs.open("resources/image.png");
          std::cout << "이미지 파일 크기: " << file.size() << " 바이트" << std::endl;
      } else {
          std::cout << "리소스가 존재하지 않습니다!" << std::endl;
      }
  
      return 0;
  }

전체적인 예제를 정리하면 다음과 같습니다.

cmake

  cmake_minimum_required(VERSION 3.10)
  project(MyProject)
  
  # cmrc 가져오기
  include(FetchContent)
  FetchContent_Declare(
      cmrc
      GIT_REPOSITORY https://github.com/vector-of-bool/cmrc.git
      GIT_TAG        master
  )
  FetchContent_MakeAvailable(cmrc)
  
  # 실행 파일
  add_executable(MyProject src/main.cpp)
  
  # 리소스 라이브러리 생성
  cmrc_add_resource_library(resources STATIC resources/image.png)
  
  # cmrc 리소스 사용 설정
  target_link_libraries(MyProject PRIVATE resources cmrc::resources)

cmrc를 사용하면 CMake 프로젝트에서 리소스를 실행 파일에 포함 할 수 있음.

CMake에서 cmrc_add_resource_library를 사용 하여 리소스를 바이너리에 추가.

코드에서 파일처럼 cmrc::open()으로 리소스 접근 가능.

실행 파일을 단일 배포 파일 로 만들기에 적합.

cmake

  include(FetchContent)

cmake

  FetchContent_Declare(
      googletest
      GIT_REPOSITORY https://github.com/google/googletest.git
      GIT_TAG        release-1.12.1
  )

  FetchContent_MakeAvailable(googletest)

cmake

  FetchContent_Declare(
  <이름>
  GIT_REPOSITORY <URL>
  GIT_TAG <브랜치/태그>
  SOURCE_DIR <경로>
  BINARY_DIR <경로>
  )

cmake

  FetchContent_MakeAvailable(<이름>)

cmake

  cmake_minimum_required(VERSION 3.14)
  project(MyProject)
  
  include(FetchContent)
  
  FetchContent_Declare(
      fmt
      GIT_REPOSITORY https://github.com/fmtlib/fmt.git
      GIT_TAG        9.1.0
  )
  
  FetchContent_MakeAvailable(fmt)
  
  add_executable(main main.cpp)
  target_link_libraries(main PRIVATE fmt)

FetchContent는 프로젝트와 동일한 CMake 빌드 시스템을 공유하는 경우에 적합합니다.

ExternalProject는 별도로 빌드해야 하는 외부 바이너리를 가져올 때 적합합니다.

CMake는 FetchContent를 통해 다운로드한 패키지를 CMakeCache.txt에 저장하며, 이미 다운로드된 경우 다시 가져오지 않습니다.

필요하면 CMakeCache.txt를 삭제하거나 다음과 같이 강제로 업데이트할 수 있습니다.

cmake

  FetchContent_Populate(<이름> QUIET)

cmake

  FetchContent_Declare(
      spdlog
      GIT_REPOSITORY https://github.com/gabime/spdlog.git
      GIT_TAG        v1.10.0
  )
  
  set(SPDLOG_FMT_EXTERNAL ON CACHE BOOL "" FORCE) # fmt 사용 설정
  FetchContent_MakeAvailable(spdlog)