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

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

Ver3.0 전체 열람

Ver3.0 🚀 C++ 패키지 관리의 새로운 시대: Conan과 vcpkg로 의존성 관리 완벽 정복하기

2026.01.28

재능넷

댓글 0 전체 35 페이지

🚀 C++ 패키지 관리의 새로운 시대: Conan과 vcpkg로 의존성 관리 완벽 정복하기

현대적인 C++ 개발을 위한 필수 도구들을 친구처럼 쉽게 알려드립니다!

👋 안녕! C++ 개발하면서 라이브러리 설치 때문에 머리 아팠던 경험 있지? 헤더 파일 찾아서 복사하고, 라이브러리 경로 설정하고, 버전 충돌로 밤새 디버깅하고... 정말 끔찍하지 않아?

오늘은 그런 고민을 한 방에 날려줄 Conan과 vcpkg라는 두 가지 강력한 패키지 관리 도구를 소개할게! 이 친구들을 알고 나면 C++ 개발이 정말 편해진다고 장담할 수 있어. 😎

재능넷에서도 많은 개발자들이 이런 현대적인 도구 활용법을 공유하고 있는데, 오늘 이 글을 통해 너도 C++ 패키지 관리의 달인이 될 수 있을 거야!

🤔 왜 C++에는 패키지 관리자가 필요할까?

다른 언어들을 보면 정말 부럽지 않아? Python에는 pip가 있고, JavaScript에는 npm이 있고, Rust에는 cargo가 있잖아. 그런데 C++는... 음, 역사가 오래된 만큼 복잡한 사연이 있어. 📚

C++는 1980년대부터 사용되어 온 언어라서, 패키지 관리라는 개념이 생기기 전부터 존재했어. 그래서 전통적으로는 이런 식으로 라이브러리를 관리했지:

😰 전통적인 C++ 라이브러리 관리의 고통

1. 수동 다운로드
라이브러리 공식 웹사이트에 가서 소스코드나 바이너리를 다운로드해야 했어. 버전도 직접 확인하고 말이야.

2. 빌드 설정 지옥
CMakeLists.txt나 Makefile에 include 경로, 라이브러리 경로를 일일이 추가해야 했지. 경로 하나 틀리면? 컴파일 에러의 향연! 🔥

3. 버전 충돌
프로젝트 A는 Boost 1.70이 필요한데, 프로젝트 B는 Boost 1.75가 필요하면? 시스템에 두 버전을 동시에 관리하는 건 정말 악몽이었어.

4. 플랫폼 의존성
Windows에서 잘 돌아가던 프로젝트를 Linux로 옮기면? 모든 라이브러리를 다시 설정해야 했어. 😭

이런 문제들 때문에 C++ 커뮤니티에서는 오랫동안 "표준 패키지 관리자"를 원했어. 그리고 드디어 2010년대 중반부터 본격적인 해결책들이 등장하기 시작했지!

🎯 Conan: 파이썬 기반의 강력한 패키지 관리자

Conan은 2016년에 JFrog라는 회사에서 만든 C/C++ 패키지 관리자야. 파이썬으로 작성되어 있어서 설치도 쉽고, 크로스 플랫폼을 완벽하게 지원해. 🐍

💡 Conan의 핵심 철학
Conan은 "바이너리 패키지 관리"에 집중해. 즉, 소스코드를 매번 컴파일하는 게 아니라, 미리 빌드된 바이너리를 다운로드해서 사용할 수 있어. 이게 엄청난 시간 절약이지!

⚙️ Conan 설치하기

Conan 설치는 정말 간단해. Python이 설치되어 있다면 pip로 한 줄이면 끝이야:

터미널 / 명령 프롬프트

pip install conan

설치가 완료되면 버전을 확인해보자:

conan --version

Conan 2.0 이상이 설치되었다면 준비 완료! ✅

📦 Conan으로 첫 번째 패키지 설치하기

실제 예제로 배우는 게 제일 빠르지? 유명한 JSON 라이브러리인 nlohmann_json을 설치해볼게.

Step 1: conanfile.txt 작성

프로젝트 루트 디렉토리에 conanfile.txt 파일을 만들어:

[requires]
nlohmann_json/3.11.2

[generators]
CMakeDeps
CMakeToolchain

[options]

[imports]

이 파일이 뭘 의미하는지 하나씩 뜯어볼까? 🔍

[requires]: 필요한 패키지와 버전을 명시해. 여기서는 nlohmann_json 버전 3.11.2를 요청했어.

[generators]: CMake와 통합하기 위한 파일들을 자동으로 생성해줘. CMakeDeps는 의존성 정보를, CMakeToolchain은 빌드 설정을 만들어줘.

[options]: 패키지별 빌드 옵션을 설정할 수 있어. 지금은 비워뒀지만, 나중에 필요하면 추가할 수 있어.

[imports]: 특정 파일들을 프로젝트로 복사하고 싶을 때 사용해.

Step 2: 패키지 설치

이제 실제로 패키지를 설치해보자:

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

--build=missing 옵션은 미리 빌드된 바이너리가 없으면 소스에서 직접 빌드하라는 의미야. 처음에는 시간이 좀 걸릴 수 있어. ⏰

Step 3: CMakeLists.txt 작성

이제 CMake 설정 파일을 만들어보자:

cmake_minimum_required(VERSION 3.15)
project(MyProject)

set(CMAKE_CXX_STANDARD 17)

# Conan이 생성한 파일들을 찾아
find_package(nlohmann_json REQUIRED)

add_executable(main main.cpp)
target_link_libraries(main nlohmann_json::nlohmann_json)

Step 4: 코드 작성 및 빌드

간단한 예제 코드를 작성해보자 (main.cpp):

#include <nlohmann/json.hpp>
#include <iostream>

using json = nlohmann::json;

int main() {
    json j;
    j["name"] = "Conan";
    j["type"] = "Package Manager";
    j["awesome"] = true;
    
    std::cout << j.dump(4) << std::endl;
    return 0;
}

이제 빌드해보자:

cd build
cmake .. -DCMAKE_TOOLCHAIN_FILE=conan_toolchain.cmake
cmake --build .

실행하면 예쁘게 포맷된 JSON이 출력될 거야! 🎉

🔧 Conan의 고급 기능들

1. 프로파일 관리

Conan은 "프로파일"이라는 개념으로 다양한 빌드 설정을 관리해. 예를 들어, Debug용 프로파일과 Release용 프로파일을 따로 만들 수 있어:

# Debug 프로파일 생성
conan profile detect --force

# 프로파일 확인
conan profile show default

프로파일 파일을 직접 수정해서 컴파일러, 빌드 타입, 아키텍처 등을 세밀하게 조정할 수 있어.

2. 원격 저장소 관리

Conan은 기본적으로 ConanCenter라는 공식 저장소를 사용하지만, 회사 내부 저장소나 개인 저장소도 추가할 수 있어:

# 원격 저장소 목록 확인
conan remote list

# 새 저장소 추가
conan remote add my-repo https://my-company.com/artifactory/api/conan/conan-local

이건 팀 프로젝트에서 엄청 유용해! 회사 내부에서만 사용하는 라이브러리를 공유할 수 있거든. 🏢

3. conanfile.py로 더 강력하게

conanfile.txt는 간단하지만 제한적이야. 더 복잡한 설정이 필요하면 conanfile.py를 사용할 수 있어:

from conan import ConanFile
from conan.tools.cmake import CMake, cmake_layout

class MyProjectConan(ConanFile):
    name = "myproject"
    version = "1.0"
    settings = "os", "compiler", "build_type", "arch"
    
    def requirements(self):
        self.requires("nlohmann_json/3.11.2")
        self.requires("fmt/9.1.0")
        
    def build_requirements(self):
        self.tool_requires("cmake/3.25.0")
        
    def layout(self):
        cmake_layout(self)
        
    def build(self):
        cmake = CMake(self)
        cmake.configure()
        cmake.build()

Python 코드로 작성하니까 조건문, 반복문 등을 자유롭게 사용할 수 있어. 정말 강력하지? 💪

🪟 vcpkg: Microsoft가 만든 크로스 플랫폼 패키지 관리자

vcpkg는 Microsoft가 2016년에 오픈소스로 공개한 C++ 패키지 관리자야. 처음에는 Windows 전용으로 시작했지만, 지금은 Linux와 macOS도 완벽하게 지원해. 🌍

💡 vcpkg의 핵심 철학
vcpkg는 "소스 기반 빌드"를 기본으로 해. 즉, 패키지를 설치할 때 소스코드를 다운로드해서 현재 시스템에 맞게 컴파일해. 이게 좀 느릴 수는 있지만, 호환성 문제가 거의 없어!

⚙️ vcpkg 설치하기

vcpkg 설치는 Git 저장소를 클론하는 것부터 시작해:

Windows (PowerShell)

git clone https://github.com/microsoft/vcpkg.git
cd vcpkg
.\bootstrap-vcpkg.bat

Linux / macOS

git clone https://github.com/microsoft/vcpkg.git
cd vcpkg
./bootstrap-vcpkg.sh

부트스트랩이 완료되면 vcpkg 실행 파일이 생성돼. 이제 환경 변수에 추가하면 어디서든 사용할 수 있어:

Windows

setx VCPKG_ROOT "C:\path\to\vcpkg"
setx PATH "%PATH%;%VCPKG_ROOT%"

Linux / macOS (bash)

export VCPKG_ROOT=/path/to/vcpkg
export PATH=$VCPKG_ROOT:$PATH

📦 vcpkg로 패키지 설치하기

vcpkg의 사용법은 정말 직관적이야. 패키지를 검색하고 설치하는 게 한 줄이면 끝나거든!

Step 1: 패키지 검색

먼저 어떤 패키지들이 있는지 검색해보자:

vcpkg search json

이렇게 하면 "json"이 포함된 모든 패키지가 나와. nlohmann-json, jsoncpp, rapidjson 등등 많은 옵션이 있어. 🔎

Step 2: 패키지 설치

원하는 패키지를 찾았으면 설치해보자:

vcpkg install nlohmann-json

이 명령어 하나로 끝이야! vcpkg가 알아서 소스를 다운로드하고, 컴파일하고, 설치해줘. 처음에는 시간이 좀 걸릴 수 있어. ☕

⚠️ 주의사항
vcpkg는 기본적으로 x86 아키텍처용으로 빌드해. x64가 필요하면 vcpkg install nlohmann-json:x64-windows처럼 트리플렛을 명시해줘야 해!

Step 3: Visual Studio / CMake 통합

vcpkg를 Visual Studio와 통합하려면:

vcpkg integrate install

이 명령어를 실행하면 Visual Studio가 자동으로 vcpkg에 설치된 패키지들을 인식해. 별도의 설정 없이 바로 #include로 사용할 수 있어! 🎯

CMake를 사용한다면 toolchain 파일을 지정해줘:

cmake -B build -S . -DCMAKE_TOOLCHAIN_FILE=[vcpkg root]/scripts/buildsystems/vcpkg.cmake
cmake --build build

📝 vcpkg.json으로 의존성 관리하기

vcpkg도 Conan처럼 매니페스트 파일을 지원해. vcpkg.json이라는 파일로 프로젝트의 의존성을 선언할 수 있어:

{
  "name": "my-awesome-project",
  "version": "1.0.0",
  "dependencies": [
    "nlohmann-json",
    "fmt",
    "spdlog"
  ],
  "builtin-baseline": "2023.11.20"
}

이 파일을 프로젝트 루트에 두고 CMake를 실행하면, vcpkg가 자동으로 필요한 패키지들을 설치해줘. 팀원들과 공유할 때 엄청 편리하지! 👥

builtin-baseline이 뭐야?

builtin-baseline은 vcpkg 저장소의 특정 커밋을 가리켜. 이걸 명시하면 모든 팀원이 동일한 버전의 패키지를 사용하게 돼. 버전 불일치로 인한 문제를 예방할 수 있어!

최신 baseline을 확인하려면 vcpkg GitHub 저장소의 커밋 히스토리를 확인하면 돼.

🔧 vcpkg의 고급 기능들

1. 트리플렛(Triplet) 시스템

vcpkg는 "트리플렛"이라는 개념으로 빌드 타겟을 관리해. 트리플렛은 플랫폼, 아키텍처, 링킹 방식을 조합한 거야:

# Windows 64비트, 동적 링킹
vcpkg install boost:x64-windows

# Windows 64비트, 정적 링킹
vcpkg install boost:x64-windows-static

# Linux 64비트
vcpkg install boost:x64-linux

# macOS ARM64
vcpkg install boost:arm64-osx

커스텀 트리플렛도 만들 수 있어. triplets/ 디렉토리에 새 파일을 만들면 돼! 🎨

2. 바이너리 캐싱

vcpkg는 소스 기반이라 빌드 시간이 오래 걸릴 수 있어. 하지만 바이너리 캐싱을 활성화하면 한 번 빌드한 패키지를 재사용할 수 있어:

# 로컬 파일 시스템 캐시
vcpkg install boost --binarysource=clear;files,C:\vcpkg-cache,readwrite

# Azure Blob Storage 캐시 (팀 공유용)
vcpkg install boost --binarysource=clear;x-azblob,https://account.blob.core.windows.net/container,sas-token

팀 프로젝트에서 Azure나 AWS S3 같은 클라우드 스토리지를 캐시로 사용하면, 모든 팀원이 빌드 시간을 크게 단축할 수 있어! ⚡

3. 오버레이 포트

공식 vcpkg 저장소에 없는 패키지나, 기존 패키지를 수정하고 싶을 때 "오버레이 포트"를 사용할 수 있어:

# 커스텀 포트 디렉토리 생성
mkdir my-ports
mkdir my-ports/my-custom-lib

# portfile.cmake 작성
# (패키지 빌드 방법 정의)

# 오버레이 포트로 설치
vcpkg install my-custom-lib --overlay-ports=./my-ports

이 기능은 회사 내부 라이브러리를 관리할 때 정말 유용해!

⚖️ Conan vs vcpkg: 어떤 걸 선택해야 할까?

자, 이제 두 도구를 모두 살펴봤으니 가장 중요한 질문이 남았어. "나는 어떤 걸 써야 하지?" 🤷

정답은... 상황에 따라 다르다는 거야! 각각 장단점이 있거든. 하나씩 비교해볼게.

비교 항목	Conan	vcpkg
설치 난이도	쉬움 (pip 한 줄)	보통 (Git 클론 필요)
빌드 속도	빠름 (바이너리 다운로드)	느림 (소스 컴파일)
호환성	바이너리 호환성 이슈 가능	매우 높음 (현재 환경에 맞춤)
패키지 수	1,000개 이상	2,000개 이상
학습 곡선	중간 (프로파일 개념)	낮음 (직관적)
커스터마이징	매우 유연함	유연함
IDE 통합	CMake 통합	Visual Studio 네이티브 지원
기업 지원	JFrog Artifactory	Azure Artifacts

✅ Conan을 선택하면 좋은 경우

크로스 플랫폼 프로젝트
Linux, Windows, macOS를 모두 지원해야 하고, 각 플랫폼별로 최적화된 바이너리가 필요할 때

CI/CD 파이프라인
빌드 시간을 최소화해야 하는 자동화 환경에서 바이너리 캐싱이 큰 장점

복잡한 의존성 관리
여러 버전의 라이브러리를 동시에 관리하거나, 세밀한 빌드 옵션 제어가 필요할 때

Python 생태계 친화적
이미 Python을 사용하는 팀이라면 설치와 스크립팅이 자연스러움

✅ vcpkg를 선택하면 좋은 경우

Windows 중심 개발
Visual Studio를 주로 사용하고, Windows 플랫폼이 메인이라면 네이티브 통합이 강력함

빠른 시작
복잡한 설정 없이 바로 시작하고 싶을 때. 학습 곡선이 낮아서 초보자에게 친화적

최신 패키지
vcpkg는 패키지 업데이트가 빠른 편이고, 커뮤니티가 활발함

Microsoft 생태계
Azure DevOps, Visual Studio, WSL 등 MS 도구들과 함께 사용할 때 시너지가 좋음

💡 프로 팁: 둘 다 써도 돼!
사실 Conan과 vcpkg를 동시에 사용하는 것도 가능해. 예를 들어, 주요 의존성은 Conan으로 관리하고, Windows 전용 라이브러리는 vcpkg로 설치하는 식이지. 도구는 목적에 맞게 유연하게 사용하는 게 최고야!

🛠️ 실전 프로젝트: 두 도구를 함께 사용하기

이론만 배우면 재미없지? 실제 프로젝트에서 어떻게 활용하는지 예제를 만들어볼게. 간단한 웹 서버를 만들면서 Conan과 vcpkg를 모두 사용해보자! 🚀

📋 프로젝트 요구사항

목표: HTTP 요청을 받아서 JSON 응답을 반환하는 간단한 웹 서버

사용할 라이브러리:
- cpp-httplib: 경량 HTTP 서버 라이브러리
- nlohmann-json: JSON 파싱 및 생성
- spdlog: 로깅
- fmt: 문자열 포맷팅

🎯 방법 1: Conan으로 구현

Step 1: conanfile.txt 작성

[requires]
cpp-httplib/0.14.1
nlohmann_json/3.11.2
spdlog/1.12.0
fmt/10.1.1

[generators]
CMakeDeps
CMakeToolchain

[options]
cpp-httplib/*:with_openssl=False

Step 2: CMakeLists.txt 작성

cmake_minimum_required(VERSION 3.15)
project(WebServerConan CXX)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

find_package(httplib REQUIRED)
find_package(nlohmann_json REQUIRED)
find_package(spdlog REQUIRED)
find_package(fmt REQUIRED)

add_executable(server_conan main.cpp)

target_link_libraries(server_conan 
    httplib::httplib
    nlohmann_json::nlohmann_json
    spdlog::spdlog
    fmt::fmt
)

Step 3: main.cpp 작성

#include <httplib.h>
#include <nlohmann/json.hpp>
#include <spdlog/spdlog.h>
#include <fmt/core.h>

using json = nlohmann::json;

int main() {
    httplib::Server svr;
    
    spdlog::info("서버 시작 중...");
    
    // GET 엔드포인트
    svr.Get("/api/hello", [](const httplib::Request& req, httplib::Response& res) {
        json response;
        response["message"] = "Hello from Conan!";
        response["timestamp"] = std::time(nullptr);
        response["status"] = "success";
        
        res.set_content(response.dump(2), "application/json");
        spdlog::info("GET /api/hello 요청 처리됨");
    });
    
    // POST 엔드포인트
    svr.Post("/api/echo", [](const httplib::Request& req, httplib::Response& res) {
        try {
            auto input = json::parse(req.body);
            
            json response;
            response["echo"] = input;
            response["received_at"] = std::time(nullptr);
            
            res.set_content(response.dump(2), "application/json");
            spdlog::info("POST /api/echo 요청 처리됨");
        } catch (const json::exception& e) {
            json error;
            error["error"] = "Invalid JSON";
            error["details"] = e.what();
            
            res.status = 400;
            res.set_content(error.dump(2), "application/json");
            spdlog::error("JSON 파싱 오류: {}", e.what());
        }
    });
    
    auto port = 8080;
    spdlog::info("서버가 포트 {}에서 실행 중입니다", port);
    svr.listen("0.0.0.0", port);
    
    return 0;
}

Step 4: 빌드 및 실행

# 의존성 설치
mkdir build && cd build
conan install .. --build=missing

# 빌드
cmake .. -DCMAKE_TOOLCHAIN_FILE=conan_toolchain.cmake -DCMAKE_BUILD_TYPE=Release
cmake --build . --config Release

# 실행
./server_conan  # Linux/macOS
# 또는
.\Release\server_conan.exe  # Windows

서버가 실행되면 브라우저나 curl로 테스트해볼 수 있어:

# GET 요청 테스트
curl http://localhost:8080/api/hello

# POST 요청 테스트
curl -X POST http://localhost:8080/api/echo \
  -H "Content-Type: application/json" \
  -d '{"name":"Conan","type":"Package Manager"}'

🎯 방법 2: vcpkg로 구현

Step 1: vcpkg.json 작성

{
  "name": "webserver-vcpkg",
  "version": "1.0.0",
  "dependencies": [
    "cpp-httplib",
    "nlohmann-json",
    "spdlog",
    "fmt"
  ],
  "builtin-baseline": "2023.11.20"
}

Step 2: CMakeLists.txt 작성

cmake_minimum_required(VERSION 3.15)
project(WebServerVcpkg CXX)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

find_package(httplib CONFIG REQUIRED)
find_package(nlohmann_json CONFIG REQUIRED)
find_package(spdlog CONFIG REQUIRED)
find_package(fmt CONFIG REQUIRED)

add_executable(server_vcpkg main.cpp)

target_link_libraries(server_vcpkg 
    PRIVATE
    httplib::httplib
    nlohmann_json::nlohmann_json
    spdlog::spdlog
    fmt::fmt
)

main.cpp는 위의 Conan 버전과 동일해! 코드는 패키지 관리자와 독립적이니까. 😊

Step 3: 빌드 및 실행

# CMake 설정 (vcpkg toolchain 사용)
cmake -B build -S . -DCMAKE_TOOLCHAIN_FILE=[vcpkg root]/scripts/buildsystems/vcpkg.cmake

# 빌드
cmake --build build --config Release

# 실행
./build/server_vcpkg  # Linux/macOS
# 또는
.\build\Release\server_vcpkg.exe  # Windows

🎓 학습 포인트
이 예제에서 주목할 점은 main.cpp가 완전히 동일하다는 거야! 패키지 관리자는 빌드 시스템의 일부일 뿐, 실제 코드와는 분리되어 있어. 이게 바로 좋은 아키텍처의 특징이지!

🔥 고급 주제: 패키지 관리 베스트 프랙티스

이제 기본은 마스터했으니, 실무에서 정말 중요한 베스트 프랙티스들을 알려줄게. 이런 것들을 알고 있으면 프로 개발자처럼 보일 거야! 😎

📌 1. 버전 고정하기 (Version Pinning)

문제: "내 컴퓨터에서는 되는데요?"라는 말을 들어본 적 있지? 이건 대부분 버전 불일치 때문이야.

해결책: 항상 정확한 버전을 명시해!

# 나쁜 예 (Conan)
[requires]
boost/*  # 어떤 버전이 설치될지 모름!

# 좋은 예
[requires]
boost/1.82.0  # 정확한 버전 명시

// 나쁜 예 (vcpkg.json)
{
  "dependencies": ["boost"]  // 최신 버전이 자동으로...
}

// 좋은 예
{
  "dependencies": [
    {
      "name": "boost",
      "version>=": "1.82.0"
    }
  ],
  "builtin-baseline": "2023.11.20"  // baseline으로 전체 버전 고정
}

📌 2. 의존성 최소화하기

⚠️ 의존성 지옥 (Dependency Hell)
의존성이 많아질수록 관리가 어려워져. 특히 의존성의 의존성(transitive dependencies)까지 고려하면 복잡도가 기하급수적으로 증가해!

원칙:
1. 정말 필요한 라이브러리만 추가하기
2. 헤더 온리 라이브러리 선호하기 (빌드 시간 단축)
3. 큰 라이브러리보다 작고 집중된 라이브러리 선호하기

예시:
전체 Boost를 설치하는 대신, 필요한 모듈만 설치:

# Boost 전체 (수 GB!)
conan install boost/1.82.0

# 필요한 것만 (수십 MB)
conan install boost-filesystem/1.82.0
conan install boost-asio/1.82.0

📌 3. 로컬 캐시 관리하기

패키지 관리자를 오래 사용하다 보면 로컬 캐시가 엄청나게 커져. 정기적으로 정리해주는 게 좋아! 🧹

Conan 캐시 관리

# 캐시 위치 확인
conan config home

# 사용하지 않는 패키지 제거
conan remove "*" -c

# 특정 패키지만 제거
conan remove "boost/*"

# 캐시 크기 확인 (Linux/macOS)
du -sh ~/.conan2

vcpkg 캐시 관리

# 빌드 캐시 정리
vcpkg remove --outdated

# 전체 재설치가 필요하면
rm -rf vcpkg/buildtrees
rm -rf vcpkg/packages
rm -rf vcpkg/downloads

📌 4. CI/CD 통합하기

현대적인 개발에서 CI/CD는 필수야. 패키지 관리자를 CI 파이프라인에 통합하는 방법을 알아보자!

GitHub Actions 예제 (Conan)

name: Build with Conan

on: [push, pull_request]

jobs:
  build:
    runs-on: ubuntu-latest
    
    steps:
    - uses: actions/checkout@v3
    
    - name: Set up Python
      uses: actions/setup-python@v4
      with:
        python-version: '3.10'
    
    - name: Install Conan
      run: pip install conan
    
    - name: Install dependencies
      run: |
        mkdir build && cd build
        conan install .. --build=missing
    
    - name: Build
      run: |
        cd build
        cmake .. -DCMAKE_TOOLCHAIN_FILE=conan_toolchain.cmake
        cmake --build .
    
    - name: Test
      run: |
        cd build
        ctest --output-on-failure

GitHub Actions 예제 (vcpkg)

name: Build with vcpkg

on: [push, pull_request]

jobs:
  build:
    runs-on: ubuntu-latest
    
    steps:
    - uses: actions/checkout@v3
    
    - name: Install vcpkg
      run: |
        git clone https://github.com/microsoft/vcpkg.git
        ./vcpkg/bootstrap-vcpkg.sh
    
    - name: Build
      run: |
        cmake -B build -S . \
          -DCMAKE_TOOLCHAIN_FILE=${{ github.workspace }}/vcpkg/scripts/buildsystems/vcpkg.cmake
        cmake --build build
    
    - name: Test
      run: |
        cd build
        ctest --output-on-failure

💡 프로 팁: 캐싱 활용하기
CI에서 매번 패키지를 다시 빌드하면 시간이 오래 걸려. GitHub Actions의 캐싱 기능을 활용하면 빌드 시간을 크게 단축할 수 있어!

📌 5. 보안 고려사항

🔒 보안은 선택이 아니라 필수!
오픈소스 패키지를 사용할 때는 항상 보안을 염두에 두어야 해. 악의적인 코드가 포함될 수 있거든.

보안 체크리스트:

1. 공식 저장소만 사용하기
- Conan: ConanCenter (center.conan.io)
- vcpkg: 공식 GitHub 저장소

2. 패키지 검증하기
- 다운로드 수, 별점, 최근 업데이트 날짜 확인
- GitHub에서 소스코드 직접 확인
- 알려진 취약점 검색 (CVE 데이터베이스)

3. 정기적인 업데이트
- 보안 패치가 포함된 새 버전으로 업데이트
- 하지만 메이저 버전 업그레이드는 신중하게!

4. 의존성 스캔 도구 사용
- OWASP Dependency-Check
- Snyk
- GitHub Dependabot

🚨 흔한 문제들과 해결 방법

실제로 사용하다 보면 여러 가지 문제에 부딪히게 돼. 내가 겪었던 (그리고 해결했던!) 문제들을 공유할게. 🔧

❌ 문제 1: "패키지를 찾을 수 없습니다"

증상:
ERROR: Package 'some-library/1.0.0' not found

원인:
1. 패키지 이름이나 버전이 잘못됨
2. 원격 저장소가 설정되지 않음
3. 패키지가 해당 플랫폼을 지원하지 않음

해결 방법:

# Conan: 사용 가능한 버전 검색
conan search "some-library*" -r=conancenter

# vcpkg: 패키지 검색
vcpkg search some-library

# 원격 저장소 확인
conan remote list  # Conan
vcpkg version      # vcpkg

❌ 문제 2: 버전 충돌

증상:

ERROR: Version conflict detected: library-a requires boost/1.70.0 but library-b requires boost/1.75.0

해결 방법:
1. 두 라이브러리가 모두 호환되는 Boost 버전 찾기
2. 라이브러리 중 하나를 업데이트하거나 다운그레이드
3. 최후의 수단: 별도의 프로젝트로 분리

# Conan: 버전 오버라이드
[requires]
library-a/1.0.0
library-b/2.0.0
boost/1.75.0  # 명시적으로 버전 지정

[overrides]
boost/1.75.0  # 모든 의존성에서 이 버전 강제

❌ 문제 3: 빌드 실패

증상:
패키지는 설치되었는데 빌드할 때 링크 에러나 헤더를 찾을 수 없다는 에러

원인:
1. CMake 설정이 잘못됨
2. 플랫폼/아키텍처 불일치
3. 빌드 타입 불일치 (Debug vs Release)

해결 방법:

# Conan: 빌드 타입 명시
conan install .. --build=missing -s build_type=Release

# vcpkg: 트리플렛 명시
vcpkg install some-library:x64-windows

# CMake: 상세 로그 확인
cmake .. --trace-expand

❌ 문제 4: 느린 빌드 속도

증상:
패키지 설치나 빌드에 너무 오랜 시간이 걸림

해결 방법:

# Conan: 바이너리 캐시 활성화
conan config set storage.download_cache="~/.conan/download_cache"

# vcpkg: 바이너리 캐싱
vcpkg install boost --binarysource=clear;files,C:\vcpkg-cache,readwrite

# 병렬 빌드 활성화
cmake --build . -j 8  # 8개 코어 사용

또한 불필요한 의존성을 제거하고, 헤더 온리 라이브러리를 선호하는 것도 도움이 돼!

❌ 문제 5: 크로스 컴파일 문제

증상:
Windows에서 Linux용 바이너리를 빌드하거나, x86에서 ARM용 빌드를 할 때 문제 발생

해결 방법:

# Conan: 크로스 컴파일 프로파일 생성
# linux-arm64 프로파일 예시
[settings]
os=Linux
arch=armv8
compiler=gcc
compiler.version=11
build_type=Release

[buildenv]
CC=aarch64-linux-gnu-gcc
CXX=aarch64-linux-gnu-g++

# 사용
conan install .. --profile=linux-arm64

# vcpkg: 커스텀 트리플렛 생성
# arm64-linux.cmake 파일 생성
set(VCPKG_TARGET_ARCHITECTURE arm64)
set(VCPKG_CRT_LINKAGE dynamic)
set(VCPKG_LIBRARY_LINKAGE static)
set(VCPKG_CMAKE_SYSTEM_NAME Linux)

# 사용
vcpkg install some-library:arm64-linux

🌟 미래의 C++ 패키지 관리

C++ 패키지 관리의 미래는 어떻게 될까? 몇 가지 흥미로운 트렌드를 살펴보자! 🔮

📦 C++ 표준 패키지 관리자?

C++ 커뮤니티에서는 오랫동안 "공식" 패키지 관리자를 원해왔어. 실제로 C++23, C++26 표준화 과정에서 패키지 관리와 모듈 시스템에 대한 논의가 활발해.

C++ Modules가 C++20에서 도입되었고, 이게 패키지 관리의 미래를 바꿀 수 있어. 모듈은 헤더 파일의 문제점들을 해결하고, 더 빠른 컴파일과 더 나은 의존성 관리를 가능하게 해줘.

☁️ 클라우드 기반 빌드

미래에는 로컬에서 패키지를 빌드하는 대신, 클라우드에서 미리 빌드된 바이너리를 다운로드하는 게 표준이 될 거야. 이미 Conan과 vcpkg 모두 이 방향으로 발전하고 있어:

- JFrog Artifactory: Conan 패키지를 위한 엔터프라이즈급 저장소
- Azure Artifacts: vcpkg 바이너리 캐싱
- GitHub Packages: 오픈소스 프로젝트를 위한 무료 호스팅

🤖 AI 기반 의존성 관리

상상해봐! AI가 자동으로:
- 프로젝트에 필요한 라이브러리를 추천해주고
- 버전 충돌을 자동으로 해결하고
- 보안 취약점을 미리 경고해주고
- 최적의 빌드 설정을 제안해주는 거야!

이미 GitHub Copilot 같은 도구들이 코드 작성을 도와주고 있잖아? 패키지 관리도 곧 그렇게 될 거야. 🚀

💡 지금 배워두면 미래에 유리해!
Conan과 vcpkg를 지금 배워두면, 미래의 C++ 패키지 관리 시스템으로 전환할 때도 쉽게 적응할 수 있어. 핵심 개념들은 비슷할 테니까!

🎓 학습 리소스와 커뮤니티

혼자 공부하기 힘들다면? 걱정 마! 훌륭한 리소스와 커뮤니티가 많아. 👥

📚 공식 문서

Conan:
- 공식 문서: docs.conan.io
- ConanCenter: conan.io/center
- GitHub: github.com/conan-io/conan

vcpkg:
- 공식 문서: vcpkg.io
- GitHub: github.com/microsoft/vcpkg
- 패키지 검색: vcpkg.io/en/packages.html

💬 커뮤니티

Conan:
- Slack: cpplang.slack.com (#conan 채널)
- Reddit: r/cpp
- Stack Overflow: [conan] 태그

vcpkg:
- Discord: discord.gg/vcpkg
- GitHub Discussions: github.com/microsoft/vcpkg/discussions
- Stack Overflow: [vcpkg] 태그

🎥 추천 영상 및 튜토리얼

- CppCon 발표 영상들 (YouTube에서 "CppCon Conan" 또는 "CppCon vcpkg" 검색)
- Microsoft의 vcpkg 공식 튜토리얼
- JFrog의 Conan 웨비나 시리즈
- 각종 개발자 블로그들

🌐 재능넷에서도 배워보세요!
재능넷(https://www.jaenung.net)의 '지식인의 숲'에는 C++ 패키지 관리뿐만 아니라 다양한 프로그래밍 지식이 가득해. 실무 경험이 풍부한 개발자들이 공유하는 팁과 노하우를 확인해보세요!

🎯 실전 프로젝트 아이디어

이론만 배우면 금방 잊어버려. 직접 프로젝트를 만들면서 연습해보자! 여기 몇 가지 아이디어를 줄게. 💡

🎮 프로젝트 1: 간단한 게임 엔진

사용할 라이브러리:
- SDL2 (그래픽 및 입력)
- GLM (수학 라이브러리)
- nlohmann-json (설정 파일)
- spdlog (로깅)

배울 수 있는 것:
- 여러 라이브러리를 함께 사용하는 방법
- 크로스 플랫폼 빌드
- 복잡한 의존성 관리

🌐 프로젝트 2: RESTful API 서버

사용할 라이브러리:
- cpp-httplib 또는 Crow (HTTP 서버)
- SQLite3 (데이터베이스)
- jwt-cpp (인증)
- nlohmann-json (JSON 처리)

배울 수 있는 것:
- 웹 서비스 개발
- 데이터베이스 통합
- 보안 고려사항

📊 프로젝트 3: 데이터 분석 도구

사용할 라이브러리:
- Eigen (선형대수)
- Matplotlib-cpp (시각화)
- CSV-parser (데이터 입력)
- Boost.Program_options (CLI)

배울 수 있는 것:
- 과학 계산 라이브러리 사용
- 데이터 시각화
- 명령줄 도구 개발

🤖 프로젝트 4: 머신러닝 추론 엔진

사용할 라이브러리:
- ONNX Runtime (모델 추론)
- OpenCV (이미지 처리)
- Protobuf (데이터 직렬화)
- gRPC (네트워크 통신)

배울 수 있는 것:
- AI/ML 통합
- 고성능 컴퓨팅
- 마이크로서비스 아키텍처

✨ 마무리하며

와! 여기까지 읽었다면 정말 대단해! 👏

우리는 오늘 C++ 패키지 관리의 A부터 Z까지 살펴봤어. 전통적인 방식의 문제점부터 시작해서, Conan과 vcpkg라는 두 가지 강력한 도구를 배웠지. 실전 예제도 만들어보고, 고급 기능들과 베스트 프랙티스도 알아봤어.

🎯 핵심 요약

1. 패키지 관리자는 필수
현대적인 C++ 개발에서 패키지 관리자는 선택이 아니라 필수야. 시간을 절약하고, 버그를 줄이고, 협업을 쉽게 만들어줘.

2. Conan vs vcpkg
- Conan: 바이너리 우선, 유연한 설정, 크로스 플랫폼에 강함
- vcpkg: 소스 기반, 간편한 사용, Visual Studio 통합 우수
둘 다 훌륭한 도구니까 프로젝트에 맞게 선택하면 돼!

3. 베스트 프랙티스
- 버전을 명확하게 고정하기
- 의존성 최소화하기
- CI/CD에 통합하기
- 보안 항상 염두에 두기

4. 계속 배우기
기술은 계속 발전해. 공식 문서를 읽고, 커뮤니티에 참여하고, 실제 프로젝트를 만들면서 계속 성장하자!

🚀 다음 단계
1. 작은 프로젝트부터 시작해서 Conan이나 vcpkg를 적용해보기
2. 기존 프로젝트를 패키지 관리자로 마이그레이션하기
3. 팀원들과 지식 공유하기
4. 오픈소스 프로젝트에 기여하면서 실력 키우기

재능넷에서 다른 개발자들의 경험담도 읽어보고, 궁금한 점이 있으면 질문도 올려봐. 함께 성장하는 게 제일 빠른 길이야!

C++ 개발이 점점 더 현대적이고 편리해지고 있어. 패키지 관리자는 그 변화의 중심에 있지. 오늘 배운 내용을 바탕으로 더 나은 C++ 개발자가 되길 바라! 💪

질문이나 피드백이 있다면 언제든지 환영이야. 우리 모두 함께 배우고 성장하는 개발자 커뮤니티를 만들어가자! 🌟

행복한 코딩 되길! Happy Coding! 🎉

📚 더 많은 C++ 지식이 필요하신가요?

재능넷의 '지식인의 숲'에서 다양한 프로그래밍 지식을 탐험해보세요!
실무 경험이 풍부한 개발자들이 공유하는 생생한 노하우가 가득합니다.

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

지적 재산권 보호 고지

사용 제한: 재능넷의 명시적 서면 동의 없이 본 컨텐츠를 복제, 수정, 배포, 또는 상업적으로 활용하는 행위는 엄격히 금지됩니다.
데이터 수집 금지: 본 컨텐츠에 대한 무단 스크래핑, 크롤링, 및 자동화된 데이터 수집은 법적 제재의 대상이 됩니다.
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개 분야

🚀 C++ 패키지 관리의 새로운 시대: Conan과 vcpkg로 의존성 관리 완벽 정복하기

🤔 왜 C++에는 패키지 관리자가 필요할까?

😰 전통적인 C++ 라이브러리 관리의 고통

🎯 Conan: 파이썬 기반의 강력한 패키지 관리자

⚙️ Conan 설치하기

📦 Conan으로 첫 번째 패키지 설치하기

🔧 Conan의 고급 기능들

1. 프로파일 관리

2. 원격 저장소 관리

3. conanfile.py로 더 강력하게

🪟 vcpkg: Microsoft가 만든 크로스 플랫폼 패키지 관리자

⚙️ vcpkg 설치하기

📦 vcpkg로 패키지 설치하기

📝 vcpkg.json으로 의존성 관리하기

builtin-baseline이 뭐야?

🔧 vcpkg의 고급 기능들

1. 트리플렛(Triplet) 시스템

2. 바이너리 캐싱

3. 오버레이 포트

⚖️ Conan vs vcpkg: 어떤 걸 선택해야 할까?

✅ Conan을 선택하면 좋은 경우

✅ vcpkg를 선택하면 좋은 경우

🛠️ 실전 프로젝트: 두 도구를 함께 사용하기

📋 프로젝트 요구사항

🎯 방법 1: Conan으로 구현

🎯 방법 2: vcpkg로 구현

🔥 고급 주제: 패키지 관리 베스트 프랙티스

📌 1. 버전 고정하기 (Version Pinning)

📌 2. 의존성 최소화하기

📌 3. 로컬 캐시 관리하기

Conan 캐시 관리

vcpkg 캐시 관리

📌 4. CI/CD 통합하기

GitHub Actions 예제 (Conan)

GitHub Actions 예제 (vcpkg)

📌 5. 보안 고려사항

🚨 흔한 문제들과 해결 방법

❌ 문제 1: "패키지를 찾을 수 없습니다"

❌ 문제 2: 버전 충돌

❌ 문제 3: 빌드 실패

❌ 문제 4: 느린 빌드 속도

❌ 문제 5: 크로스 컴파일 문제

🌟 미래의 C++ 패키지 관리

📦 C++ 표준 패키지 관리자?

☁️ 클라우드 기반 빌드

🤖 AI 기반 의존성 관리

🎓 학습 리소스와 커뮤니티

📚 공식 문서

💬 커뮤니티

🎥 추천 영상 및 튜토리얼

🎯 실전 프로젝트 아이디어

🎮 프로젝트 1: 간단한 게임 엔진

🌐 프로젝트 2: RESTful API 서버

📊 프로젝트 3: 데이터 분석 도구

🤖 프로젝트 4: 머신러닝 추론 엔진

✨ 마무리하며

🎯 핵심 요약

📚 더 많은 C++ 지식이 필요하신가요?

관련 키워드

댓글 작성

로그인이 필요합니다

댓글 0

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

지적 재산권 보호 고지

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