# vcpkg를 사용한 패키지 관리

**vcpkg** 는 라이브러리를 확보하고 관리하기 위한 무료 C/C++ 패키지 관리자입니다. 1500개 이상의 오픈 소스 라이브러리 중에서 선택하여 한 번에 다운로드하고 빌드하거나, 빌드 프로세스를 간소화하기 위해 자신만의 비공개 라이브러리를 추가할 수 있습니다. Microsoft C++ 팀과 오픈 소스 기여자들이 유지 관리합니다. 지원되는 플랫폼 및 종속 패키지는 [Vcpkg Port Explorer](https://vcpkg.link/) ![devhw](data:image/png;base64,UklGRt4AAABXRUJQVlA4TNIAAAAvD8ADED/BoG0jSe5SXP5I7gkNRG3byLnX4Tn+2K4I2raNw5/iqPxlEwBAGlwuj8BNBPpnsblrANx3P36s+DHQIcQ0dmEfEGPc8WEcCCcO/M2hXv3rDJTcHCTB1es7l9P2UoywA2a3jSW/pp77EhxGkq1E8zjH3R3e/fxjREOI6P8EcH+lqu/oTK/6kS+YwlHVAMjkP0ErP1UNIZZmnsB32Y2lZjNPO7HUUA1HkVWz73lAIiWM6WaegFcHzNOJ3bv89WhdNu1TDx/txhT2np2bzWU=) 의 “Supports” 섹션에서 찾을 수 있습니다.

**지원되는 플랫폼**

아래 표에는 다양한 플랫폼에 대한 패키지 지원의 몇 가지 예시가 나와 있습니다.

| 패키지 이름 | 지원 | 설명 |
| --- | --- | --- |
| qt5-base | 모두 | 모든 플랫폼을 지원합니다. |
| opencv2 | !uwp & !(arm & windows) | uwp를 지원하지 않으며 Windows on Arm을 지원하지 않습니다. |
| libtorch | (windows & !static) | osx | linux | Windows(비정적 링크), MacOS 및 Linux를 지원합니다. |
| rocksdb | !uwp & !(arm & !arm64 & android) | uwp, Arm(Arm64 제외), Android를 지원하지 않습니다. |
| ncnn | !(windows & arm) | Windows on Arm은 지원하지 않습니다. |
| tbb | (windows & !uwp) | linux | osx | ios | android | Windows(uwp 제외), Linux, MacOS, IOS, Android를 지원합니다. |
| openmvg | (x86 | x64 | arm64) & !xbox | x86(xbox 제외), x64(xbox 제외) 및 Arm64(xbox 제외)를 지원합니다. |

## vcpkg 시작하기

vcpkg는 빌드 프로세스 중 종속성 문제를 방지하기 위해 라이브러리를 다운로드하고 관리하는 데 유용한 유틸리티입니다.

**설치 요구 조건**

- WoS PC
- Windows 7 이상
- Git
- Visual Studio 2015 이상

### vcpkg 설치하기

1. vcpkg 저장소를 복제합니다.

git clone https://github.com/Microsoft/vcpkg.git
        Copy to clipboard
2. 부트스트랩 스크립트를 실행하여 vcpkg를 빌드합니다.

.\vcpkg\bootstrap-vcpkg.bat
        Copy to clipboard
3. 프로젝트용 라이브러리를 설치합니다.

vcpkg install package_name:arm64-windows
        Copy to clipboard

    vcpkg가 설치된 후 `vcpkg install package_name:arm64- windows` 명령어를 사용하세요. 다음 작업이 자동으로 수행됩니다.

![../../_images/vcpkg_flow_chart.png](data:image/png;base64,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)

    추가 정보와 자세한 로그는 `\\vcpkg\\buildtrees\\detect_compiler\\config-arm64-windows-rel-CMakeCache.txt.log` and `\\vcpkg\\buildtrees\\detect_compiler\\config-arm64-windows-out.log` 에서 확인할 수 있습니다.
4. 프로젝트용 라이브러리를 제거합니다.

vcpkg remove package_name:arm64-windows
        Copy to clipboard

### vcpkg 디렉토리 구조

다음 표에서는 vcpkg 브랜치의 내용을 설명합니다.

| `Buildtrees` | 빌드 프로세스에서 생성된 임시 파일과 빌드 중간 결과물 |
| --- | --- |
| `Docs` | 문서 및 예제. |
| `Installed` | 빌드되고 설치된 종속요소 라이브러리. vcpkg와 함께 Visual Studio 또는 Cmake를 사용하는 경우 vcpkg는 여기에서 필요한 파일을 검색합니다. |
| `Downloads` | 다운로드한 종속요소 라이브러리의 소스 코드 파일. |
| `Packages` | 서로 다른 설치 간 스테이징에 사용하는 폴더. |
| `Ports` | 각 라이브러리의 디렉토리, 버전, 다운로드 위치를 설명하는 파일. |
| `Scripts` | vcpkg에서 사용하는 스크립트(CMake, PowerShell). |
| `Toolsrc` | vcpkg 및 관련 구성 요소의 C++ 소스 코드. |
| `Triplets` | 지원되는 각 타겟 플랫폼에 대한 설정(예: arm64-windows). |

다음 표는 `vcpkg/installed/arm64-windows/` 하위 디렉토리의 내용을 설명합니다.

| `Bin` | (릴리스 버전) 설치된 종속요소 라이브러리의 실행 파일(바이너리). |
| --- | --- |
| `Lib` | (릴리스 버전) 설치된 종속요소 라이브러리의 정적 라이브러리 파일. |
| `Debug` | (디버그 버전) 설치된 종속요소 라이브러리의 디버그 심볼 파일. |
| `Share` | 설치된 종속요소 라이브러리의 공유 파일(리소스 및 구성 파일 등). |
| `Include` | 설치된 종속요소 라이브러리의 헤더 파일. |
| `Tools` | 설치된 종속요소 라이브러리를 빌드하기 위한 도구 및 스크립트. |
| `Manual-tools` | 수동으로 설치한 도구 또는 라이브러리. |

## 문제 해결

이 페이지에서는 몇 가지 일반적인 vcpkg 문제 해결 절차에 대해 설명합니다.

### 자주 사용되는 vcpkg 명령어

다음은 자주 사용되는 vcpkg 명령어 목록입니다. 이러한 명령어들은 패키지 설치 문제를 해결할 때 유용할 수 있습니다.

| `vcpkg install package_name` | 지정된 패키지를 설치합니다. |
| --- | --- |
| `vcpkg remove package_name` | vcpkg에서 지정된 패키지를 제거합니다. |
| `vcpkg list` | 설치된 모든 패키지를 나열합니다. |
| `vcpkg search package_name` | 지정된 이름의 패키지가 설치되어 있는지 확인하기 위해 검색합니다. |
| `vcpkg update` | vcpkg 자체 및 설치된 패키지들을 최신 버전으로 업데이트합니다. |
| `vcpkg upgrade` | 설치된 소프트웨어 패키지를 최신 버전으로 업그레이드합니다. |

추가 지원 및 Q&A를 확인하려면 [https://github.com/microsoft/vcpkg/issues](https://github.com/microsoft/vcpkg/issues) ![devhw](data:image/png;base64,UklGRt4AAABXRUJQVlA4TNIAAAAvD8ADED/BoG0jSe5SXP5I7gkNRG3byLnX4Tn+2K4I2raNw5/iqPxlEwBAGlwuj8BNBPpnsblrANx3P36s+DHQIcQ0dmEfEGPc8WEcCCcO/M2hXv3rDJTcHCTB1es7l9P2UoywA2a3jSW/pp77EhxGkq1E8zjH3R3e/fxjREOI6P8EcH+lqu/oTK/6kS+YwlHVAMjkP0ErP1UNIZZmnsB32Y2lZjNPO7HUUA1HkVWz73lAIiWM6WaegFcHzNOJ3bv89WhdNu1TDx/txhT2np2bzWU=) 및 [https://github.com/microsoft/vcpkg/discussions](https://github.com/microsoft/vcpkg/discussions) ![devhw](data:image/png;base64,UklGRt4AAABXRUJQVlA4TNIAAAAvD8ADED/BoG0jSe5SXP5I7gkNRG3byLnX4Tn+2K4I2raNw5/iqPxlEwBAGlwuj8BNBPpnsblrANx3P36s+DHQIcQ0dmEfEGPc8WEcCCcO/M2hXv3rDJTcHCTB1es7l9P2UoywA2a3jSW/pp77EhxGkq1E8zjH3R3e/fxjREOI6P8EcH+lqu/oTK/6kS+YwlHVAMjkP0ErP1UNIZZmnsB32Y2lZjNPO7HUUA1HkVWz73lAIiWM6WaegFcHzNOJ3bv89WhdNu1TDx/txhT2np2bzWU=) 를 참조하세요.

### 라이브러리 설치 불가 문제

때때로 vcpkg가 라이브러리 설치에 실패할 수 있습니다. 이런 경우 다음을 수행하세요.

- 로컬 코드가 최신 상태인지 확인합니다. `git pull https://github.com/microsoft/ vcpkg`.
- 명령어: `vcpkg install package_name:arm64-windows --debug` 를 실행하여 자세한 디버그 로그 정보를 가져옵니다.
- cmd를 다시 시작합니다.

### WoS에서 openh264 설치 불가 문제

1. openh264를 설치하려면 명령줄에서 다음을 실행하세요.

vcpkg install openh264:arm64-windows
        Copy to clipboard
2. 설치에 실패한 경우:

    1. **nasm -v** 를 실행하여 nasm이 올바르게 설치되었는지 확인하세요.
    2. 설치된 `nasm.exe` 를 환경 변수에 추가하세요.

자세한 내용은 다음 로그를 참조하세요.

- CMake error log at scripts/cmake/vcpkg\_execute\_required\_process.cmake:112 (message)……
- C:\Users\xxx\Downloads\vcpkg\vcpkg\buildtrees\openh264\config-arm64-windows-dbg-meson-log.txt.log: ..\src\33cf500b7b-c619a10b3a.clean\meson.build:132:2: ERROR: Program ‘nasm’ not found or not executable
- C:\Users\xxx\Downloads\vcpkg\vcpkg\buildtrees\openh264\config-arm64-windows-dbg-out.log ..\src\33cf500b7b-c619a10b3a.clean\meson.build:132:2: ERROR: Program ‘nasm’ not found or not executable

### WoS에서 qt5-base 설치 불가 문제

qt5-base를 설치하려면 명령줄에서 다음을 실행하세요:

vcpkg install qt5-base:arm64-windows
    Copy to clipboard

안타깝게도 vcpkg가 플래그를 무시하며 현재로서는 [효과적인 해결방법이 없습니다](https://github.com/microsoft/vcpkg/issues/26974) ![devhw](data:image/png;base64,UklGRt4AAABXRUJQVlA4TNIAAAAvD8ADED/BoG0jSe5SXP5I7gkNRG3byLnX4Tn+2K4I2raNw5/iqPxlEwBAGlwuj8BNBPpnsblrANx3P36s+DHQIcQ0dmEfEGPc8WEcCCcO/M2hXv3rDJTcHCTB1es7l9P2UoywA2a3jSW/pp77EhxGkq1E8zjH3R3e/fxjREOI6P8EcH+lqu/oTK/6kS+YwlHVAMjkP0ErP1UNIZZmnsB32Y2lZjNPO7HUUA1HkVWz73lAIiWM6WaegFcHzNOJ3bv89WhdNu1TDx/txhT2np2bzWU=). 자세한 지원은 Microsoft에 직접 문의하세요.

자세한 내용은 다음 로그를 참조하세요.

- 오류 로그: CMake Error at scripts/cmake/vcpkg\_execute\_required\_process.cmake:112 (message)
- C:\Users\xxx\Downloads\vcpkg\vcpkg\buildtrees\qt5-base\config-arm64-windows-dbg-out.log
- C:\Users\xxx\Downloads\vcpkg\vcpkg\buildtrees\qt5-base\config-arm64-windows-dbg-err.log

Project ERROR: SDK setup script failed. Output:
        ===================
        [ERROR:vcvarsall.bat] Invalid argument found : Unknown_arm64
        [ERROR:vcvarsall.bat] Error in script usage. The correct usage is:
        Copy to clipboard

    구문:

vcvarsall.bat [arch] [platform_type] [winsdk_version] [-vcvars_ver=vc_version] [-vcvars_spectre_libs=spectre_mode]
        Copy to clipboard

    Visual Studio 또는 C++ Build SKU가 설치되어 있어야 합니다.

### 설치/빌드 프로세스에 긴 시간이 걸리는 문제

vcpkg는 패키지를 설치하고 빌드할 때, 특히 크고 복잡한 패키지의 경우 다소 시간이 걸릴 수 있습니다. 전체 라이브러리를 빌드하는 데 40분이 소요될 수 있습니다.

### 라이브러리가 Windows ARM64 타겟을 지원하지 않는 문제

라이브러리를 Windows ARM64 타겟으로 추가하려면 라이브러리 소유자에게 문의하세요. 각 라이브러리의 업스트림 빌드 프로세스는 라이브러리 소유자가 Windows Arm64를 타겟으로 하도록 업데이트해야 합니다.

Last Published: Jan 13, 2026

[Previous Topic
clang++/LLVM으로 빌드](https://docs.qualcomm.com/bundle/publicresource/80-62010-1KO/topics/build-clang-llvm.md) [Next Topic
포팅하기](https://docs.qualcomm.com/bundle/publicresource/80-62010-1KO/topics/port.md)