# Quản lý gói bằng vcpkg

**vcpkg** là trình quản lý gói C/C++ miễn phí để thu thập và quản lý thư viện. Chọn từ hơn 1500 thư viện mã nguồn mở để tải xuống và dựng trong một bước hoặc thêm thư viện riêng của bạn để đơn giản hóa quy trình build. Được duy trì bởi nhóm Microsoft C++ và những người đóng góp mã nguồn mở. Bạn có thể tìm các gói phụ thuộc cùng với nền tảng được hỗ trợ trong phần "Supports" trên [Vcpkg Port Explorer](https://vcpkg.link/) ![devhw](data:image/png;base64,UklGRt4AAABXRUJQVlA4TNIAAAAvD8ADED/BoG0jSe5SXP5I7gkNRG3byLnX4Tn+2K4I2raNw5/iqPxlEwBAGlwuj8BNBPpnsblrANx3P36s+DHQIcQ0dmEfEGPc8WEcCCcO/M2hXv3rDJTcHCTB1es7l9P2UoywA2a3jSW/pp77EhxGkq1E8zjH3R3e/fxjREOI6P8EcH+lqu/oTK/6kS+YwlHVAMjkP0ErP1UNIZZmnsB32Y2lZjNPO7HUUA1HkVWz73lAIiWM6WaegFcHzNOJ3bv89WhdNu1TDx/txhT2np2bzWU=).

**Nền tảng được hỗ trợ**

Bảng sau đây nêu ra các ví dụ về hỗ trợ gói trên các nền tảng khác nhau.

| Tên gói | Hỗ trợ | Mô tả |
| --- | --- | --- |
| qt5-base | Tất cả | Hỗ trợ tất cả các nền tảng. |
| opencv2 | !uwp & !(arm & windows) | Không hỗ trợ uwp và không hỗ trợ Windows trên Arm. |
| libtorch | (windows & !static) | osx | linux | Hỗ trợ Windows (liên kết động), macOS và Linux. |
| rocksdb | !uwp & !(arm & !arm64 & android) | Không hỗ trợ uwp, Arm (ngoại trừ Arm64) và Android. |
| ncnn | !(windows & arm) | Không hỗ trợ Windows trên Arm. |
| tbb | (windows & !uwp) | linux | osx | ios | android | Hỗ trợ Windows (ngoại trừ uwp), Linux, MacOS, iOS và Android. |
| openmvg | (x86 | x64 | arm64) & !xbox | Hỗ trợ x86 (ngoại trừ xbox), x64 (ngoại trừ xbox) và Arm64 (ngoại trừ xbox). |

## Bắt đầu với vcpkg

vcpkg là một tiện ích hữu ích để tải xuống và quản lý thư viện nhằm tránh các vấn đề về phần phụ thuộc trong quá trình build.

**Điều kiện tiên quyết để cài đặt**

- PC chạy WoS
- Windows 7 trở lên
- Git
- Visual Studio 2015 trở lên

### Cài đặt vcpkg

1. Sao chép repo vcpkg

git clone https://github.com/Microsoft/vcpkg.git
        Copy to clipboard
2. Chạy tập lệnh bootstrap để build vcpkg.

.\vcpkg\bootstrap-vcpkg.bat
        Copy to clipboard
3. Cài đặt thư viện cho dự án.

vcpkg install package_name:arm64-windows
        Copy to clipboard

    Sau khi cài đặt vcpkg, hãy dùng lệnh `vcpkg install package_name:arm64-windows`. Các hành động sau sẽ tự động diễn ra:

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

    Bạn có thể tìm thấy thông tin bổ sung và log chi tiết trong `\\vcpkg\\buildtrees\\detect_compiler\\config-arm64-windows-rel-CMakeCache.txt.log` và `\\vcpkg\\buildtrees\\detect_compiler\\config-arm64-windows-out.log`.
4. Gỡ cài đặt thư viện cho dự án.

vcpkg remove package_name:arm64-windows
        Copy to clipboard

### Cấu trúc thư mục vcpkg

Bảng sau mô tả nội dung của các nhánh vcpkg:

| `Buildtrees` | Các tệp tạm thời được tạo trong quá trình build và build trung gian |
| --- | --- |
| `Docs` | Tài liệu và ví dụ. |
| `Installed` | Các thư viện phần phụ thuộc đã được dựng và cài đặt. Khi sử dụng Visual Studio hoặc CMake với vcpkg, vcpkg sẽ tìm kiếm các tệp cần thiết tại đây. |
| `Downloads` | Các tệp mã nguồn cho thư viện phần phụ thuộc đã tải xuống. |
| `Packages` | Thư mục được dùng làm nơi trung gian trong quá trình cài đặt các phiên bản khác nhau. |
| `Ports` | Tệp mô tả thư mục, phiên bản và vị trí tải xuống của từng thư viện. |
| `Scripts` | Các tập lệnh mà vcpkg dùng (CMake, PowerShell). |
| `Toolsrc` | Mã nguồn C++ cho vcpkg và các thành phần liên quan. |
| `Triplets` | Cài đặt cho từng nền tảng mục tiêu được hỗ trợ, chẳng hạn như arm64-windows. |

Bảng sau đây mô tả nội dung của các thư mục con `vcpkg/installed/arm64-windows/`:

| `Bin` | (phiên bản phát hành) Các tệp thực thi (tệp nhị phân) của thư viện phần phụ thuộc đã cài đặt. |
| --- | --- |
| `Lib` | (phiên bản phát hành) Các tệp thư viện tĩnh của thư viện phần phụ thuộc đã cài đặt. |
| `Debug` | (phiên bản gỡ lỗi) Tệp ký hiệu gỡ lỗi của thư viện phần phụ thuộc đã cài đặt. |
| `Share` | Các tệp được chia sẻ (chẳng hạn như tệp tài nguyên và cấu hình) của thư viện phần phụ thuộc đã cài đặt. |
| `Include` | Các tệp header của thư viện phần phụ thuộc đã cài đặt. |
| `Tools` | Các công cụ và tập lệnh để build thư viện phụ thuộc đã cài đặt. |
| `Manual-tools` | Các công cụ hoặc thư viện được cài đặt thủ công. |

## Khắc phục sự cố

Trang này mô tả một số quy trình khắc phục sự cố phổ biến với vcpkg.

### Các lệnh vcpkg thường dùng

Sau đây là danh sách các lệnh vcpkg thường dùng. Các lệnh này có thể hữu ích khi khắc phục sự cố cài đặt gói.

| `vcpkg install package_name` | Cài đặt gói đã chỉ định |
| --- | --- |
| `vcpkg remove package_name` | Xóa gói đã chỉ định khỏi vcpkg |
| `vcpkg list` | Liệt kê tất cả các gói đã cài đặt |
| `vcpkg search package_name` | Tìm kiếm gói có tên đã chỉ định để xem gói đó có có sẵn không |
| `vcpkg update` | Cập nhật vcpkg và các gói đã cài đặt lên phiên bản mới nhất |
| `vcpkg upgrade` | Nâng cấp gói phần mềm đã cài đặt lên phiên bản mới nhất |

Để được hỗ trợ thêm và truy cập phần hỏi đáp, hãy tham khảo [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=) và [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=).

### Không cài đặt được thư viện

Đôi khi vcpkg có thể không cài đặt được thư viện. Nếu điều này xảy ra, hãy làm như sau:

- Đảm bảo rằng mã cục bộ của bạn được cập nhật: `git pull https://github.com/microsoft/ vcpkg`.
- Chạy: `vcpkg install package_name:arm64-windows --debug` để lấy thông tin debug log chi tiết hơn.
- Khởi động lại cmd.

### Không cài đặt được openh264 trên WoS

1. Để cài đặt openh264, hãy chạy lệnh sau trong dòng lệnh:

vcpkg install openh264:arm64-windows
        Copy to clipboard
2. Nếu cài đặt không thành công:

    1. Kiểm tra xem nasm đã được cài đặt đúng cách chưa bằng cách chạy **nasm -v**.
    2. Thêm `nasm.exe` đã cài đặt vào biến môi trường.

Các log sau đây chứa nhiều thông tin hơn:

- Log lỗi CMake tại scripts/cmake/vcpkg\_execute\_required\_process.cmake:112 (mesage)…...
- 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

### Không cài đặt được qt5-base trên WoS

Để cài đặt qt5-base, hãy chạy lệnh sau trong dòng lệnh:

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

Rất tiếc, vcpkg bỏ qua cờ và hiện [không có giải pháp hiệu quả nào](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=) cho lỗi này. Để được hỗ trợ thêm, hãy liên hệ trực tiếp với Microsoft.

Các log sau đây chứa nhiều thông tin hơn:

- Error log: 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

    Cú pháp:

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

    Đảm bảo rằng Visual Studio hoặc C++ Build SKU đã được cài đặt.

### Quá trình cài đặt/build sẽ mất nhiều thời gian

vcpkg có thể mất một khoảng thời gian để cài đặt và build các gói, đặc biệt là đối với các gói lớn và phức tạp. Có thể mất tới 40 phút để build toàn bộ thư viện.

### Thư viện không được hỗ trợ cho đích Windows ARM64

Để thêm thư viện làm đích Windows ARM64, hãy liên hệ với chủ sở hữu thư viện. Quy trình build chính thức cho từng thư viện phải được chủ sở hữu thư viện cập nhật để nhắm đến Windows Arm64.

Last Published: Dec 16, 2025

[Previous Topic
Build bằng clang++/LLVM](https://docs.qualcomm.com/bundle/publicresource/80-62010-1VI/topics/build-clang-llvm.md) [Next Topic
Chuyển đổi](https://docs.qualcomm.com/bundle/publicresource/80-62010-1VI/topics/port.md)