0a29d2f8b0
* Add Vietnamese Translation * Fix anchor links * Update README.md Co-authored-by: Cheney Wang <38240633+Cheney-W@users.noreply.github.com> --------- Co-authored-by: Cheney Wang <38240633+Cheney-W@users.noreply.github.com>
14 KiB
Vcpkg: Tổng quan
English 中文总览 Español 한국어 Français
Vcpkg giúp bạn quản lý các thư viện C và C++ trên Windows, Linux và MacOS. Phần mềm này và hệ sinh thái của nó vẫn đang không ngừng phát triển, và chúng tôi luôn trân trọng những đóng góp của bạn!
Nếu bạn chưa từng sử dụng vcpkg trước đây, hoặc nếu bạn đang tìm hiểu cách để sử dụng vcpkg, xin hãy xem phần Bắt Đầu cho hướng dẫn cài đặt vcpkg.
Để xem mô tả ngắn về những lệnh khả thi, khi bạn đã cài đặt vcpkg, bạn có thể chạy vcpkg help, hoặc vcpkg help [command] cho những lệnh nhất định.
- GitHub: Các port ở https://github.com/microsoft/vcpkg, phần mềm ở https://github.com/microsoft/vcpkg-tool
- Slack: https://cppalliance.org/slack/, kênh #vcpkg
- Discord: #include <C++>, kênh #🌏vcpkg
- Docs: Tài liệu
Mục Lục
- Vcpkg: Tổng quan
- Mục Lục
- Bắt Đầu
- Gợi ý/Tự động điền
- Các ví dụ
- Đóng Góp
- Giấy Phép
- Bảo Mật
- Thu Thập Dữ Liệu
Bắt Đầu
Đầu tiên, hãy làm theo hướng dẫn cài đặt cho Windows, hoặc macOS và Linux, tùy theo hệ điều hành mà bạn đang sử dụng.
Ngoài ra, hãy xem Cài đặt và Sử dụng Packages. Nếu một thư viện bạn cần hiện đang chưa có trong vcpkg, bạn có thể mở một issue trên GitHub repo nơi mà đội ngũ vcpkg và cộng đồng có thể thấy và có khả năng thêm port đó vào vcpkg.
Sau khi bạn đã cài đặt vcpkg, bạn có thể muốn thêm tự động điền vào shell của bạn.
Bắt Đầu Nhanh: Windows
Yêu cầu:
- Windows 7 trở lên
- Git
- Visual Studio 2015 Update 3 trở lên với gói ngôn ngữ Tiếng Anh
Đầu tiên, tải và khởi động vcpkg; nó có thể được cài đặt bất kỳ đâu, nhưng
chúng tôi khuyến cáo sử dụng vcpkg như một submoudle cho các project CMake,
và cài đặt nó toàn máy cho các project Visual Studio.
Chúng tôi gợi ý cài ở những nơi như C:\src\vcpkg hoặc C:\dev\vcpkg,
bởi vì nếu cài những nơi khác bạn có thể gặp các lỗi đường dẫn đối với
hệ thống build của một vài port.
> git clone https://github.com/microsoft/vcpkg
> .\vcpkg\bootstrap-vcpkg.bat
Để cài đặt các thư viện cho project của bạn, hãy chạy:
> .\vcpkg\vcpkg install [packages to install]
Lưu ý: Lệnh này sẽ mặc định cài đặt phiên bản x86 của thư viện, để cài x64 hãy chạy:
> .\vcpkg\vcpkg install [package name]:x64-windows
Hoặc
> .\vcpkg\vcpkg install [packages to install] --triplet=x64-windows
Bạn cũng có thể tìm kiếm các thư viện bạn cần với lệnh search:
> .\vcpkg\vcpkg search [search term]
Để sử dụng vcpkg với Visual Studio, hãy chạy lệnh sau (có thể yêu cầu quyền administrator):
> .\vcpkg\vcpkg integrate install
Sau khi xong, bạn có thể tạo một project mới (trừ CMake), hoặc mở một project có sẵn.
Tất cả các thư viện sẽ ngay lập tức có sẵn để được #include và sử dụng
trong project của bạn mà không cần cấu hình gì thêm.
Nếu bạn đang sử dụng CMake với Visual Studio, hãy tiếp tục ở đây.
Để sử dụng vcpkg với CMake bên ngoài một IDE, bạn có thể sử dụng file toolchain:
> cmake -B [build directory] -S . "-DCMAKE_TOOLCHAIN_FILE=[path to vcpkg]/scripts/buildsystems/vcpkg.cmake"
> cmake --build [build directory]
Với CMake, bạn vẫn sẽ cần thêm find_package và những lệnh khác để sử dụng thư viện.
Hãy xem phần CMake để biết thêm,
bao gồm việc sử dụng CMake với một IDE.
Bắt Đầu Nhanh: Unix
Yêu cầu cho Linux:
Yêu cầu cho macOS:
Đầu tiên, tải và khởi động vcpkg; nó có thể được cài đặt bất kỳ đâu, nhưng chúng tôi khuyến cáo sử dụng vcpkg như một submoudle cho các project CMake.
$ git clone https://github.com/microsoft/vcpkg
$ ./vcpkg/bootstrap-vcpkg.sh
Để cài đặt các thư viện cho project của bạn, hãy chạy:
$ ./vcpkg/vcpkg install [packages to install]
Bạn cũng có thể tìm kiếm các thư viện bạn cần với lệnh search:
$ ./vcpkg/vcpkg search [search term]
Để sử dụng vcpkg với CMake, bạn có thể sử dụng file toolchain:
$ cmake -B [build directory] -S . "-DCMAKE_TOOLCHAIN_FILE=[path to vcpkg]/scripts/buildsystems/vcpkg.cmake"
$ cmake --build [build directory]
Với CMake, bạn vẫn sẽ cần thêm find_package và những lệnh khác để sử dụng thư viện.
Hãy xem phần CMake để biết thêm
về các tốt nhất để sử dụng vcpkg với CMake,
và Công cụ CMake cho VSCode.
Cài đặt Developer Tools cho Linux
Dưới nhiều phiên bản Linux, có các package sau đây bạn sẽ cần phải cài đặt:
- Debian, Ubuntu, popOS, và các phiên bản khác dựa trên Debian:
$ sudo apt-get update
$ sudo apt-get install build-essential tar curl zip unzip
- CentOS
$ sudo yum install centos-release-scl
$ sudo yum install devtoolset-7
$ scl enable devtoolset-7 bash
Cho bất kỳ phiên bản nào khác, hãy chắc chắn rằng bạn cài đặt g++ 6 trở lên. Nếu bạn muốn thêm hướng dẫn cho phiên bản của bạn, xin hãy mở một PR!
Cài đặt Developer Tools cho macOS
Trên macOS, thứ duy nhất bạn cần làm là chạy lệnh sau đây trong terminal:
$ xcode-select --install
Sau đó làm theo hướng dẫn trong cửa sổ được mở ra.
Sau đó bạn sẽ có thể khởi động vcpkg theo hướng dẫn ở bắt đầu nhanh
Sử dụng vcpkg với CMake
Visual Studio Code với Công cụ CMake
Thêm phần sau đây vào file settings.json trong workspace của bạn
sẽ làm cho Công cụ CMake tự động sử dụng vcpkg cho các thư viện
của bạn:
{
"cmake.configureSettings": {
"CMAKE_TOOLCHAIN_FILE": "[vcpkg root]/scripts/buildsystems/vcpkg.cmake"
}
}
Vcpkg với Visual Studio CMake Projects
Mở CMake Settings Editor, dưới phần CMake toolchain file,
thêm đường dẫn tới file vcpkg toolchain:
[vcpkg root]/scripts/buildsystems/vcpkg.cmake
Vcpkg với CLion
Mở Toolchains settings
(File > Settings on Windows and Linux, CLion > Preferences on macOS),
và đi tới phần CMake settings (Build, Execution, Deployment > CMake).
Sau đó, trong CMake options, thên dòng sau đây:
-DCMAKE_TOOLCHAIN_FILE=[vcpkg root]/scripts/buildsystems/vcpkg.cmake
Bạn phải thêm dòng này vào mỗi profile khác nhau.
Vcpkg dưới dạng Submodule
Khi sử dụng vcpkg như một submodule cho project của bạn,
bạn có thể thêm dòng sau đây vào file CMakeLists.txt trước dòng project() đầu tiên,
thay vì phải sự dụng lệnh CMAKE_TOOLCHAIN_FILE.
set(CMAKE_TOOLCHAIN_FILE "${CMAKE_CURRENT_SOURCE_DIR}/vcpkg/scripts/buildsystems/vcpkg.cmake"
CACHE STRING "Vcpkg toolchain file")
Cách này vẫn hỗ trợ những người không dùng vcpkg,
bằng cách trực tiếp thêm CMAKE_TOOLCHAIN_FILE,
nhưng nó sẽ khiến việc cấu hình-build trở nên dễ dàng hơn.
Gợi ý/Tự động điền
vcpkg hỗ trợ tự động điền các lệnh, tên package, và các
cài đặt trong lẫn powershell và bash.
Để bật tự động điền trong shell của bạn, hãy chạy:
> .\vcpkg integrate powershell
Hoặc
$ ./vcpkg integrate bash # or zsh
tùy theo shell mà bạn sử dụng, rồi khởi động lại console.
Các ví dụ
Hãy xem tài liệu cho các hướng dẫn chi tiết, bao gồm cài đặt và sử dụng một package, thêm package mới từ file zip, và thêm package mới từ GitHub repo.
Tài liệu của chúng tôi hiện đang có sẵn tại website https://vcpkg.io/. Chúng tôi rất trân trọng bất kỳ phản hồi nào của các bạn! Bạn có thể tạo một issue trong https://github.com/vcpkg/vcpkg.github.io/issues.
Xem video demo dài 4 phút.
Đóng Góp
Vcpkg là một dự án mã nguồn mở, và được xây dụng từ sự đóng góp của các bạn. Sau đây là các cách mà bạn có thể đóng góp:
- Tạo Issues về vcpkg hoặc các package.
- Sửa lỗi và Thêm các package mới
Xin hãy xem chi tiết trong Hướng dẫn Đóng góp.
Dự án này áp dụng Bộ Quy tắc Ứng xử Mã Nguồn Mở của Microsoft. Các thông tin thêm, hãy xem Quy tắc Ứng xử FAQ hoặc gửi mail cho chúng tôi tại opencode@microsoft.com với các câu hỏi hoặc bình luận.
Giấy Phép
Mã nguồn trong repository này được cấp phép theo Giấy phép MIT. Các thư viện
cung cấp bởi các port được cấp phép theo các điều khoản của tác giả gốc. Khi khả thi, vcpkg
đặt (các) giấy phép liên quan tại installed/<triplet>/share/<port>/copyright.
Bảo Mật
Hầu hết các port đều build các thư viện liên quan sử dụng các hệ thống build gốc được khuyến cáo bởi tác giả gốc của các thư viện đó, và tải mã nguồn và công cụ build từ nguồn chính thức của họ. Để sử dụng dưới tường lửa, các quyền truy cập nhất định sẽ dựa vào port nào đang được cài đặt. Nếu bạn buộc phải cài đặt trong một môi trường "cách ly không khí", xin hãy cân nhắc việc cài đặt một lần trong môi trường không "cách ly không khí", để tạo asset cache được chia sẻ với môi trường "cách ly không khí" kia.
Thu Thập Dữ Liệu
vcpkg thu thập dữ liệu trong lúc sử dụng để giúp chúng tôi cải thiện trải nghiệm của bạn. Dữ liệu thu thập được bởi Microsoft là ẩn danh. Bạn có thể tùy chọn không thu thập dữ liệu bằng cách
- chạy bootstrap-vcpkg với lệnh -disableMetrics
- chạy vcpkg với lệnh --disable-metrics
- thêm VCPKG_DISABLE_METRICS vào biến môi trường
Đọc thêm về việc thu thập dữ liệu của vcpkg tại https://learn.microsoft.com/vcpkg/about/privacy.