C++ Conan 완벽 가이드 | 현대적인 C++ 패키지 관리
이 글의 핵심
C++ Conan 완벽 가이드에 대한 실전 가이드입니다. 현대적인 C++ 패키지 관리 등을 예제와 함께 상세히 설명합니다.
Conan이란? 왜 필요한가
문제 시나리오: 의존성 지옥
문제: C++ 프로젝트에서 Boost, fmt, spdlog, OpenSSL을 사용하려고 합니다. 각 라이브러리를 수동으로 다운로드하고, 빌드하고, 헤더·라이브러리 경로를 CMakeLists.txt에 하드코딩해야 합니다. 팀원의 환경이 다르면 경로가 달라 빌드가 깨지고, 버전 업데이트 시 모든 과정을 반복해야 합니다.
해결: Conan은 Python의 pip, Node.js의 npm처럼 C++ 패키지 관리자입니다. conanfile.txt에 의존성을 명시하면, Conan이 자동으로 다운로드·빌드하고, CMake 설정 파일을 생성해 줍니다. 팀원은 conan install만 실행하면 동일한 환경을 구성할 수 있습니다.
같은 “의존성을 선언하고 재현 가능하게 맞춘다”는 관점에서 Python pip·uv·Poetry 비교·Node.js 모듈·npm·Go 모듈·go.sum·Rust Cargo와 나란히 읽으면 차이가 정리됩니다. 빌드 쪽 연결은 CMake·vcpkg와 함께 보세요.
flowchart LR
subgraph input["입력"]
conanfile["conanfile.txt\nboost/1.80.0\nfmt/9.1.0"]
end
subgraph conan["Conan"]
install["conan install"]
download["패키지 다운로드"]
build["빌드 (필요 시)"]
gen["CMake 파일 생성"]
end
subgraph output["출력"]
cmake["conan_toolchain.cmake"]
deps["CMakeDeps"]
end
conanfile --> install
install --> download
download --> build
build --> gen
gen --> cmake
gen --> deps
목차
- Conan 설치 및 기본 사용
- conanfile.txt vs conanfile.py
- CMake 통합
- 프로파일과 설정
- 자주 발생하는 문제와 해결법
- 프로덕션 패턴
- 완전한 예제: 멀티 라이브러리 프로젝트
1. Conan 설치 및 기본 사용
설치
# pip로 설치
pip install conan
# 버전 확인
conan --version
# Conan 2.x 권장기본 워크플로우
# 1. conanfile.txt 작성
cat > conanfile.txt << 'EOFC'
[requires]
boost/1.80.0
fmt/9.1.0
[generators]
CMakeDeps
CMakeToolchain
EOFC
# 2. 의존성 설치
conan install . --output-folder=build --build=missing
# 3. CMake 빌드
cd build
cmake .. -DCMAKE_TOOLCHAIN_FILE=conan_toolchain.cmake -DCMAKE_BUILD_TYPE=Release
cmake --build .conanfile.txt 구조
[requires]
boost/1.80.0
fmt/9.1.0
spdlog/1.11.0
[generators]
CMakeDeps
CMakeToolchain
[options]
boost:shared=False
fmt:header_only=True2. conanfile.txt vs conanfile.py
conanfile.txt (간단한 프로젝트)
[requires]
boost/1.80.0
fmt/9.1.0
[generators]
CMakeDeps
CMakeToolchainconanfile.py (복잡한 프로젝트)
from conan import ConanFile
from conan.tools.cmake import cmake_layout
class MyProjectConan(ConanFile):
name = "myproject"
version = "1.0"
settings = "os", "compiler", "build_type", "arch"
def requirements(self):
self.requires("boost/1.80.0")
self.requires("fmt/9.1.0")
# 조건부 의존성
if self.settings.os == "Linux":
self.requires("openssl/3.0.0")
def configure(self):
# 옵션 설정
self.options["boost"].shared = False
def layout(self):
cmake_layout(self)
def generate(self):
# 커스텀 생성 로직
pass3. CMake 통합
CMakeLists.txt
cmake_minimum_required(VERSION 3.20)
project(MyProject)
set(CMAKE_CXX_STANDARD 20)
# Conan이 생성한 파일 사용
find_package(Boost REQUIRED COMPONENTS filesystem)
find_package(fmt REQUIRED)
add_executable(myapp main.cpp)
target_link_libraries(myapp PRIVATE
Boost::filesystem
fmt::fmt
)빌드 스크립트
#!/bin/bash
# 의존성 설치
conan install . --output-folder=build --build=missing \
-s build_type=Release \
-s compiler.cppstd=20
# CMake 빌드
cd build
cmake .. -DCMAKE_TOOLCHAIN_FILE=conan_toolchain.cmake \
-DCMAKE_BUILD_TYPE=Release
cmake --build . -j$(nproc)4. 프로파일과 설정
프로파일 확인
# 기본 프로파일
conan profile show default
# 프로파일 탐지
conan profile detect커스텀 프로파일
# 프로파일 생성
cat > ~/.conan2/profiles/gcc12 << 'EOFP'
[settings]
os=Linux
arch=x86_64
compiler=gcc
compiler.version=12
compiler.libcxx=libstdc++11
compiler.cppstd=20
build_type=Release
EOFP
# 프로파일 사용
conan install . --profile=gcc12 --output-folder=build --build=missing빌드 타입별 설치
# Debug
conan install . -s build_type=Debug --output-folder=build/debug --build=missing
# Release
conan install . -s build_type=Release --output-folder=build/release --build=missing5. 자주 발생하는 문제와 해결법
문제 1: 패키지를 찾을 수 없음
증상: ERROR: Package 'boost/1.80.0' not found in local cache.
원인: 패키지가 로컬 캐시에 없고, 원격에서도 찾을 수 없음.
# 해결법 1: --build=missing으로 빌드
conan install . --build=missing
# 해결법 2: 원격 저장소 추가
conan remote add conancenter https://center.conan.io
# 해결법 3: 패키지 검색
conan search boost --remote=conancenter문제 2: 컴파일러 버전 불일치
증상: ERROR: Missing prebuilt package for 'boost/1.80.0'.
원인: 프로파일의 컴파일러 버전과 일치하는 사전 빌드 패키지가 없음.
# 해결법 1: --build=missing으로 로컬 빌드
conan install . --build=missing
# 해결법 2: 프로파일 수정
conan profile detect --force
# 해결법 3: 특정 컴파일러 버전 지정
conan install . -s compiler.version=11 --build=missing문제 3: CMake 통합 실패
증상: find_package(Boost) 실패.
원인: CMAKE_TOOLCHAIN_FILE을 지정하지 않음.
# ❌ 잘못된 사용
cmake ..
# ✅ 올바른 사용
cmake .. -DCMAKE_TOOLCHAIN_FILE=build/conan_toolchain.cmake문제 4: 빌드 타입 불일치
증상: Debug로 설치했는데 Release로 빌드하면 링크 에러.
원인: Conan 설치 시 build_type과 CMake 빌드 타입이 다름.
# 일치시키기
conan install . -s build_type=Release --output-folder=build --build=missing
cd build
cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_TOOLCHAIN_FILE=conan_toolchain.cmake6. 프로덕션 패턴
패턴 1: 멀티 빌드 타입 지원
# Debug
conan install . -s build_type=Debug --output-folder=build/debug --build=missing
cmake -B build/debug -DCMAKE_BUILD_TYPE=Debug \
-DCMAKE_TOOLCHAIN_FILE=build/debug/conan_toolchain.cmake
# Release
conan install . -s build_type=Release --output-folder=build/release --build=missing
cmake -B build/release -DCMAKE_BUILD_TYPE=Release \
-DCMAKE_TOOLCHAIN_FILE=build/release/conan_toolchain.cmake패턴 2: 락 파일로 버전 고정
# 락 파일 생성
conan lock create conanfile.txt --lockfile-out=conan.lock
# 락 파일로 설치 (정확한 버전)
conan install . --lockfile=conan.lock --output-folder=build --build=missing패턴 3: 프라이빗 패키지 서버
# 회사 내부 Artifactory 추가
conan remote add company https://artifactory.company.com/conan
# 인증
conan remote login company admin -p password
# 설치
conan install . --remote=company패턴 4: Docker로 재현 가능한 빌드
FROM ubuntu:22.04
RUN apt-get update && apt-get install -y python3-pip cmake g++
RUN pip3 install conan
WORKDIR /app
COPY conanfile.txt .
RUN conan install . --output-folder=build --build=missing
COPY . .
RUN cd build && cmake .. -DCMAKE_TOOLCHAIN_FILE=conan_toolchain.cmake && make7. 완전한 예제: HTTP 서버
conanfile.txt
[requires]
boost/1.80.0
fmt/9.1.0
spdlog/1.11.0
openssl/3.0.0
[generators]
CMakeDeps
CMakeToolchain
[options]
boost:shared=False
boost:without_test=TrueCMakeLists.txt
cmake_minimum_required(VERSION 3.20)
project(HttpServer VERSION 1.0.0)
set(CMAKE_CXX_STANDARD 20)
find_package(Boost REQUIRED COMPONENTS system thread)
find_package(fmt REQUIRED)
find_package(spdlog REQUIRED)
find_package(OpenSSL REQUIRED)
add_executable(http_server
src/main.cpp
src/server.cpp
)
target_link_libraries(http_server PRIVATE
Boost::system
Boost::thread
fmt::fmt
spdlog::spdlog
OpenSSL::SSL
)빌드
# 의존성 설치
conan install . --output-folder=build --build=missing -s build_type=Release
# CMake 빌드
cd build
cmake .. -DCMAKE_TOOLCHAIN_FILE=conan_toolchain.cmake -DCMAKE_BUILD_TYPE=Release
cmake --build . -j$(nproc)
# 실행
./http_serverConan 2.x 주요 변경사항
| 항목 | Conan 1.x | Conan 2.x |
|---|---|---|
| 프로파일 | ~/.conan/profiles | ~/.conan2/profiles |
| 명령어 | conan install . --install-folder=build | conan install . --output-folder=build |
| 제너레이터 | cmake, cmake_find_package | CMakeDeps, CMakeToolchain |
| 레시피 | ConanFile | ConanFile (API 변경) |
정리
| 개념 | 설명 |
|---|---|
| Conan | C++ 패키지 관리자 |
| conanfile.txt | 간단한 의존성 명시 |
| conanfile.py | 복잡한 빌드 로직 |
| conan install | 의존성 설치 및 CMake 파일 생성 |
| CMakeToolchain | CMake 툴체인 파일 생성 |
| CMakeDeps | find_package용 Config 파일 생성 |
Conan은 C++ 프로젝트의 의존성 관리를 자동화해, 팀원 간 환경 차이를 없애고 빌드 재현성을 보장합니다.
FAQ
Q1: Conan vs vcpkg?
A: Conan은 Python 기반으로 유연하고, 프라이빗 패키지 서버 구축이 쉽습니다. vcpkg는 Microsoft가 만들어 Windows 통합이 좋고, 사용이 간단합니다. 팀 환경과 선호도에 따라 선택하세요.
Q2: conanfile.txt vs conanfile.py?
A: conanfile.txt는 간단한 프로젝트에 적합하고, conanfile.py는 조건부 의존성, 커스텀 빌드 로직이 필요한 복잡한 프로젝트에 사용합니다.
Q3: —build=missing은 뭔가요?
A: 사전 빌드된 패키지가 없으면 로컬에서 빌드합니다. 처음 설치 시 시간이 걸릴 수 있지만, 이후에는 캐시를 사용해 빠릅니다.
Q4: 프로파일은 왜 필요한가요?
A: 컴파일러, OS, 아키텍처, 빌드 타입 등을 지정합니다. 같은 패키지도 프로파일에 따라 다르게 빌드되므로, 팀원 간 프로파일을 통일하면 환경 차이를 없앨 수 있습니다.
Q5: Conan 캐시는 어디에?
A: ~/.conan2/p/에 패키지가 캐시됩니다. conan cache clean으로 정리할 수 있습니다.
Q6: Conan 학습 리소스는?
A:
- Conan 공식 문서
- Conan Center (패키지 검색)
- “Conan C++ Package Manager Guide”
한 줄 요약: Conan으로 C++ 의존성을 자동으로 관리할 수 있습니다. 다음으로 vcpkg 가이드를 읽어보면 좋습니다.
같이 보면 좋은 글 (내부 링크)
이 주제와 연결되는 다른 글입니다.
- C++ vcpkg 완벽 가이드 | Microsoft C++ 패키지 관리자
- C++ CMake 완벽 가이드 | 크로스 플랫폼 빌드·최신 CMake 3.28+ 기능·프리셋·모듈
- C++ CMake find_package 완벽 가이드 | 외부 라이브러리 통합
관련 글
- C++ CMake find_package 완벽 가이드 | 외부 라이브러리 통합
- C++ CMake Targets 완벽 가이드 | 타겟 기반 빌드 시스템
- C++ CMake 완벽 가이드 | 크로스 플랫폼 빌드·최신 CMake 3.28+ 기능·프리셋·모듈
- C++ vcpkg 완벽 가이드 | Microsoft C++ 패키지 관리자
- C++ Benchmarking |