2020-08-31 19:07:55 +03:00
|
|
|
|
# Vcpkg: 总览
|
|
|
|
|
|
|
|
|
|
[English Overview](README.md)
|
2019-10-07 20:40:57 +03:00
|
|
|
|
|
2020-07-07 20:53:14 +03:00
|
|
|
|
Vcpkg 可帮助您在 Windows、 Linux 和 MacOS 上管理 C 和 C++ 库。
|
|
|
|
|
这个工具和生态链正在不断发展,我们一直期待您的贡献!
|
2019-10-07 20:40:57 +03:00
|
|
|
|
|
2022-08-22 19:25:00 +03:00
|
|
|
|
若您从未使用过 vcpkg,或者您正在尝试了解如何使用 vcpkg,请查阅 [入门](#入门) 章节。
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
2022-08-22 19:25:00 +03:00
|
|
|
|
如需获取有关可用命令的简短描述,请在编译 vcpkg 后执行 `vcpkg help` 或执行 `vcpkg help [command]` 来获取具体的帮助信息。
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
2022-08-22 19:18:59 +03:00
|
|
|
|
* GitHub: [https://github.com/microsoft/vcpkg](https://github.com/microsoft/vcpkg)
|
2020-07-07 20:53:14 +03:00
|
|
|
|
* Slack: [https://cppalliance.org/slack/](https://cppalliance.org/slack/), #vcpkg 频道
|
|
|
|
|
* Discord: [\#include \<C++\>](https://www.includecpp.org), #🌏vcpkg 频道
|
2021-03-19 01:03:30 +03:00
|
|
|
|
* 文档: [Documentation](docs/README.md)
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
|
|
|
|
# 目录
|
|
|
|
|
|
2020-08-31 19:07:55 +03:00
|
|
|
|
- [Vcpkg: 总览](#vcpkg-总览)
|
2020-07-07 20:53:14 +03:00
|
|
|
|
- [目录](#目录)
|
|
|
|
|
- [入门](#入门)
|
2020-07-08 08:08:09 +03:00
|
|
|
|
- [快速开始: Windows](#快速开始-windows)
|
|
|
|
|
- [快速开始: Unix](#快速开始-unix)
|
|
|
|
|
- [安装 Linux Developer Tools](#安装-linux-developer-tools)
|
|
|
|
|
- [安装 macOS Developer Tools](#安装-macos-developer-tools)
|
|
|
|
|
- [在 CMake 中使用 vcpkg](#在-cmake-中使用-vcpkg)
|
|
|
|
|
- [Visual Studio Code 中的 CMake Tools](#visual-studio-code-中的-cmake-tools)
|
|
|
|
|
- [Visual Studio CMake 工程中使用 vcpkg](#visual-studio-cmake-工程中使用-vcpkg)
|
|
|
|
|
- [CLion 中使用 vcpkg](#clion-中使用-vcpkg)
|
|
|
|
|
- [将 vcpkg 作为一个子模块](#将-vcpkg-作为一个子模块)
|
2020-07-07 20:53:14 +03:00
|
|
|
|
- [Tab补全/自动补全](#tab补全自动补全)
|
2022-11-30 20:27:23 +03:00
|
|
|
|
- [示例](#示例)
|
|
|
|
|
- [贡献](#贡献)
|
2022-02-25 07:54:11 +03:00
|
|
|
|
- [开源协议](#开源协议)
|
2022-11-30 20:27:23 +03:00
|
|
|
|
- [安全事项](#安全事项)
|
2020-07-07 20:53:14 +03:00
|
|
|
|
- [数据收集](#数据收集)
|
|
|
|
|
|
|
|
|
|
# 入门
|
|
|
|
|
|
2022-02-25 07:54:11 +03:00
|
|
|
|
首先,请阅读以下任一快速入门指南:
|
2022-08-22 19:25:00 +03:00
|
|
|
|
[Windows](#快速开始-windows) 或 [macOS 和 Linux](#快速开始-unix),
|
2020-07-07 20:53:14 +03:00
|
|
|
|
这取决于您使用的是什么平台。
|
|
|
|
|
|
2022-11-30 20:27:23 +03:00
|
|
|
|
更多有关信息,请参见 [安装和使用软件包][getting-started:using-a-package]。
|
2022-08-22 19:25:00 +03:00
|
|
|
|
如果 vcpkg 目录中没有您需要的库,
|
|
|
|
|
您可以 [在 GitHub 上打开问题][contributing:submit-issue]。
|
2022-11-30 20:27:23 +03:00
|
|
|
|
vcpkg 团队和贡献者可以在这里看到它,
|
2022-08-22 19:25:00 +03:00
|
|
|
|
并可能将这个库添加到 vcpkg。
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
2022-08-22 19:25:00 +03:00
|
|
|
|
安装并运行 vcpkg 后,
|
|
|
|
|
您可能希望将 [TAB 补全](#tab补全自动补全) 添加到您的 Shell 中。
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
2022-08-22 19:25:00 +03:00
|
|
|
|
最后,如果您对 vcpkg 的未来感兴趣,请查看 [清单][getting-started:manifest-spec]!
|
2020-07-07 20:53:14 +03:00
|
|
|
|
这是一项实验性功能,可能会出现错误。
|
|
|
|
|
因此,请尝试一下并[打开所有问题][contributing:submit-issue]!
|
|
|
|
|
|
|
|
|
|
## 快速开始: Windows
|
2019-10-07 20:40:57 +03:00
|
|
|
|
|
2022-02-25 07:54:11 +03:00
|
|
|
|
前置条件:
|
2020-07-07 20:53:14 +03:00
|
|
|
|
- Windows 7 或更新的版本
|
2020-07-08 08:08:09 +03:00
|
|
|
|
- [Git][getting-started:git]
|
2022-11-30 20:27:23 +03:00
|
|
|
|
- [Visual Studio][getting-started:visual-studio] 2015 Update 3 或更新的版本(**包含英文语言包**)
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
2022-08-22 19:25:00 +03:00
|
|
|
|
首先,**请使用 `git clone vcpkg`** 并执行 bootstrap.bat 脚本。
|
|
|
|
|
您可以将 vcpkg 安装在任何地方,但是通常我们建议您使用 vcpkg 作为 CMake 项目的子模块,并将其全局安装到 Visual Studio 项目中。
|
2020-07-07 20:53:14 +03:00
|
|
|
|
我们建议您使用例如 `C:\src\vcpkg` 或 `C:\dev\vcpkg` 的安装目录,否则您可能遇到某些库构建系统的路径问题。
|
|
|
|
|
|
|
|
|
|
```cmd
|
|
|
|
|
> git clone https://github.com/microsoft/vcpkg
|
|
|
|
|
> .\vcpkg\bootstrap-vcpkg.bat
|
|
|
|
|
```
|
|
|
|
|
|
2020-07-08 08:08:09 +03:00
|
|
|
|
使用以下命令安装您的项目所需要的库:
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
|
|
|
|
```cmd
|
|
|
|
|
> .\vcpkg\vcpkg install [packages to install]
|
|
|
|
|
```
|
|
|
|
|
|
2022-08-22 19:25:00 +03:00
|
|
|
|
请注意: vcpkg 在 Windows 中默认编译并安装 x86 版本的库。 若要编译并安装 x64 版本,请执行:
|
2021-12-29 01:57:02 +03:00
|
|
|
|
|
|
|
|
|
```cmd
|
|
|
|
|
> .\vcpkg\vcpkg install [package name]:x64-windows
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
或
|
|
|
|
|
|
|
|
|
|
```cmd
|
|
|
|
|
> .\vcpkg\vcpkg install [packages to install] --triplet=x64-windows
|
|
|
|
|
```
|
|
|
|
|
|
2022-08-22 19:25:00 +03:00
|
|
|
|
您也可以使用 `search` 子命令来查找 vcpkg 中集成的库:
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
|
|
|
|
```cmd
|
|
|
|
|
> .\vcpkg\vcpkg search [search term]
|
|
|
|
|
```
|
|
|
|
|
|
2022-08-22 19:25:00 +03:00
|
|
|
|
若您希望在 Visual Studio 中使用 vcpkg,请运行以下命令 (可能需要管理员权限)
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
|
|
|
|
```cmd
|
|
|
|
|
> .\vcpkg\vcpkg integrate install
|
|
|
|
|
```
|
|
|
|
|
|
2022-08-22 19:25:00 +03:00
|
|
|
|
在此之后,您可以创建一个非 CMake 项目 (或打开已有的项目)。
|
2022-02-25 07:54:11 +03:00
|
|
|
|
在您的项目中,所有已安装的库均可立即使用 `#include` 包含您需使用的库的头文件且无需额外配置。
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
2022-08-22 19:25:00 +03:00
|
|
|
|
若您在 Visual Studio 中使用 CMake 工程,请查阅[这里](#visual-studio-cmake-工程中使用-vcpkg)。
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
2022-08-22 19:25:00 +03:00
|
|
|
|
为了在 IDE 以外在 CMake 中使用 vcpkg,您需要使用以下工具链文件:
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
2020-08-31 19:07:55 +03:00
|
|
|
|
```cmd
|
2022-05-13 02:53:26 +03:00
|
|
|
|
> cmake -B [build directory] -S . "-DCMAKE_TOOLCHAIN_FILE=[path to vcpkg]/scripts/buildsystems/vcpkg.cmake"
|
2020-07-07 20:53:14 +03:00
|
|
|
|
> cmake --build [build directory]
|
|
|
|
|
```
|
|
|
|
|
|
2022-08-22 19:25:00 +03:00
|
|
|
|
在 CMake 中,您仍需通过 `find_package` 来使用 vcpkg 中已安装的库。
|
|
|
|
|
请查阅 [CMake 章节](#在-cmake-中使用-vcpkg) 获取更多信息,其中包含了在 IDE 中使用 CMake 的内容。
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
2022-08-22 19:25:00 +03:00
|
|
|
|
对于其他工具 (包括 Visual Studio Code),请查阅 [集成指南][getting-started:integration]。
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
|
|
|
|
## 快速开始: Unix
|
|
|
|
|
|
2022-02-25 07:54:11 +03:00
|
|
|
|
Linux平台前置条件:
|
2020-07-08 08:08:09 +03:00
|
|
|
|
- [Git][getting-started:git]
|
|
|
|
|
- [g++][getting-started:linux-gcc] >= 6
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
2022-08-22 19:25:00 +03:00
|
|
|
|
macOS 平台前置条件:
|
2020-07-08 08:08:09 +03:00
|
|
|
|
- [Apple Developer Tools][getting-started:macos-dev-tools]
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
2022-11-30 20:27:23 +03:00
|
|
|
|
首先,请下载 vcpkg 并执行 bootstrap.sh 脚本。
|
|
|
|
|
您可以将 vcpkg 安装在任何地方,但是通常我们建议您使用 vcpkg 作为 CMake 项目的子模块。
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
$ git clone https://github.com/microsoft/vcpkg
|
|
|
|
|
$ ./vcpkg/bootstrap-vcpkg.sh
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
使用以下命令安装任意包:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
$ ./vcpkg/vcpkg install [packages to install]
|
|
|
|
|
```
|
|
|
|
|
|
2022-08-22 19:25:00 +03:00
|
|
|
|
您也可以使用 `search` 子命令来查找 vcpkg 中已集成的库:
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
$ ./vcpkg/vcpkg search [search term]
|
|
|
|
|
```
|
|
|
|
|
|
2022-08-22 19:25:00 +03:00
|
|
|
|
为了在 CMake 中使用 vcpkg,您需要使用以下工具链文件:
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
2020-08-31 19:07:55 +03:00
|
|
|
|
```sh
|
2022-05-13 02:53:26 +03:00
|
|
|
|
$ cmake -B [build directory] -S . "-DCMAKE_TOOLCHAIN_FILE=[path to vcpkg]/scripts/buildsystems/vcpkg.cmake"
|
2020-08-31 19:07:55 +03:00
|
|
|
|
$ cmake --build [build directory]
|
2020-07-07 20:53:14 +03:00
|
|
|
|
```
|
|
|
|
|
|
2022-08-22 19:25:00 +03:00
|
|
|
|
在 CMake 中,您仍需通过 `find_package` 来使用 vcpkg 中已安装的库。
|
|
|
|
|
为了您更好的在 CMake 或 VSCode CMake Tools 中使用 vcpkg,
|
2020-07-08 08:08:09 +03:00
|
|
|
|
请查阅 [CMake 章节](#在-cmake-中使用-vcpkg) 获取更多信息,
|
2022-08-22 19:25:00 +03:00
|
|
|
|
其中包含了在 IDE 中使用 CMake 的内容。
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
2020-07-08 08:08:09 +03:00
|
|
|
|
对于其他工具,请查阅 [集成指南][getting-started:integration]。
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
|
|
|
|
## 安装 Linux Developer Tools
|
2019-10-07 20:40:57 +03:00
|
|
|
|
|
2022-08-22 19:25:00 +03:00
|
|
|
|
在 Linux 的不同发行版中,您需要安装不同的工具包:
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
2022-08-22 19:25:00 +03:00
|
|
|
|
- Debian,Ubuntu,popOS 或其他基于 Debian 的发行版:
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
$ sudo apt-get update
|
|
|
|
|
$ sudo apt-get install build-essential tar curl zip unzip
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
- CentOS
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
$ sudo yum install centos-release-scl
|
|
|
|
|
$ sudo yum install devtoolset-7
|
|
|
|
|
$ scl enable devtoolset-7 bash
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
对于其他的发行版,请确保已安装 g++ 6 或更新的版本。
|
2020-08-31 19:07:55 +03:00
|
|
|
|
若您希望添加特定发行版的说明,[请提交一个 PR][contributing:submit-pr]!
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
|
|
|
|
## 安装 macOS Developer Tools
|
|
|
|
|
|
2021-12-29 01:57:02 +03:00
|
|
|
|
在 macOS 中,您唯一需要做的是在终端中运行以下命令:
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
$ xcode-select --install
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
然后按照出现的窗口中的提示进行操作。
|
2022-08-22 19:25:00 +03:00
|
|
|
|
此时,您就可以使用 bootstrap.sh 编译 vcpkg 了。 请参阅 [快速开始](#快速开始-unix)
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
|
|
|
|
## 在 CMake 中使用 vcpkg
|
|
|
|
|
|
|
|
|
|
### Visual Studio Code 中的 CMake Tools
|
|
|
|
|
|
2022-08-22 19:25:00 +03:00
|
|
|
|
将以下内容添加到您的工作区的 `settings.json` 中将使 CMake Tools 自动使用 vcpkg 中的第三方库:
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
|
|
|
|
```json
|
|
|
|
|
{
|
|
|
|
|
"cmake.configureSettings": {
|
|
|
|
|
"CMAKE_TOOLCHAIN_FILE": "[vcpkg root]/scripts/buildsystems/vcpkg.cmake"
|
|
|
|
|
}
|
|
|
|
|
}
|
2019-10-07 20:40:57 +03:00
|
|
|
|
```
|
|
|
|
|
|
2020-07-07 20:53:14 +03:00
|
|
|
|
### Visual Studio CMake 工程中使用 vcpkg
|
|
|
|
|
|
2022-08-22 19:25:00 +03:00
|
|
|
|
打开 CMake 设置选项,将 vcpkg toolchain 文件路径在 `CMake toolchain file` 中:
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
[vcpkg root]/scripts/buildsystems/vcpkg.cmake
|
2019-10-07 20:40:57 +03:00
|
|
|
|
```
|
|
|
|
|
|
2020-07-07 20:53:14 +03:00
|
|
|
|
### CLion 中使用 vcpkg
|
|
|
|
|
|
|
|
|
|
打开 Toolchains 设置
|
2020-08-31 19:07:55 +03:00
|
|
|
|
(File > Settings on Windows and Linux, CLion > Preferences on macOS),
|
|
|
|
|
并打开 CMake 设置 (Build, Execution, Deployment > CMake)。
|
2020-07-07 20:53:14 +03:00
|
|
|
|
最后在 `CMake options` 中添加以下行:
|
|
|
|
|
|
2019-10-07 20:40:57 +03:00
|
|
|
|
```
|
2020-08-21 21:46:35 +03:00
|
|
|
|
-DCMAKE_TOOLCHAIN_FILE=[vcpkg root]/scripts/buildsystems/vcpkg.cmake
|
2019-10-07 20:40:57 +03:00
|
|
|
|
```
|
|
|
|
|
|
2022-11-30 20:27:23 +03:00
|
|
|
|
您必须手动将此选项加入每个项目配置文件中。
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
|
|
|
|
### 将 vcpkg 作为一个子模块
|
|
|
|
|
|
2022-08-22 19:25:00 +03:00
|
|
|
|
当您希望将 vcpkg 作为一个子模块加入到您的工程中时,
|
2020-07-07 20:53:14 +03:00
|
|
|
|
您可以在第一个 `project()` 调用之前将以下内容添加到 CMakeLists.txt 中,
|
2022-08-22 19:25:00 +03:00
|
|
|
|
而无需将 `CMAKE_TOOLCHAIN_FILE` 传递给 CMake 调用。
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
|
|
|
|
```cmake
|
2022-05-13 02:53:26 +03:00
|
|
|
|
set(CMAKE_TOOLCHAIN_FILE "${CMAKE_CURRENT_SOURCE_DIR}/vcpkg/scripts/buildsystems/vcpkg.cmake"
|
2020-07-07 20:53:14 +03:00
|
|
|
|
CACHE STRING "Vcpkg toolchain file")
|
2019-10-07 20:40:57 +03:00
|
|
|
|
```
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
2022-08-22 19:25:00 +03:00
|
|
|
|
使用此种方式可无需设置 `CMAKE_TOOLCHAIN_FILE` 即可使用 vcpkg,且更容易完成配置工作。
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
2020-08-31 19:35:11 +03:00
|
|
|
|
[getting-started:using-a-package]: docs/examples/installing-and-using-packages.md
|
2022-05-18 03:12:53 +03:00
|
|
|
|
[getting-started:integration]: docs/users/buildsystems/integration.md
|
2020-07-07 20:53:14 +03:00
|
|
|
|
[getting-started:git]: https://git-scm.com/downloads
|
|
|
|
|
[getting-started:cmake-tools]: https://marketplace.visualstudio.com/items?itemName=ms-vscode.cmake-tools
|
|
|
|
|
[getting-started:linux-gcc]: #installing-linux-developer-tools
|
|
|
|
|
[getting-started:macos-dev-tools]: #installing-macos-developer-tools
|
|
|
|
|
[getting-started:macos-brew]: #installing-gcc-on-macos
|
|
|
|
|
[getting-started:macos-gcc]: #installing-gcc-on-macos
|
|
|
|
|
[getting-started:visual-studio]: https://visualstudio.microsoft.com/
|
|
|
|
|
[getting-started:manifest-spec]: docs/specifications/manifests.md
|
|
|
|
|
|
2022-08-22 19:25:00 +03:00
|
|
|
|
# Tab 补全/自动补全
|
2019-10-07 20:40:57 +03:00
|
|
|
|
|
2022-11-30 20:27:23 +03:00
|
|
|
|
`vcpkg` 支持在 Powershell 和 Bash 中自动补全命令,包名称及选项。
|
2022-08-22 19:25:00 +03:00
|
|
|
|
若您需要在指定的 shell 中启用 Tab 补全功能,请依据您使用的 shell 运行:
|
2019-10-07 20:40:57 +03:00
|
|
|
|
|
2020-07-07 20:53:14 +03:00
|
|
|
|
```pwsh
|
|
|
|
|
> .\vcpkg integrate powershell
|
|
|
|
|
```
|
2019-10-07 20:40:57 +03:00
|
|
|
|
|
2020-07-07 20:53:14 +03:00
|
|
|
|
或
|
2019-10-07 20:40:57 +03:00
|
|
|
|
|
2020-08-31 19:07:55 +03:00
|
|
|
|
```sh
|
2021-12-29 01:57:02 +03:00
|
|
|
|
$ ./vcpkg integrate bash # 或 zsh
|
2019-10-07 20:40:57 +03:00
|
|
|
|
```
|
|
|
|
|
|
2020-07-08 08:08:09 +03:00
|
|
|
|
然后重新启动控制台。
|
2019-10-07 20:40:57 +03:00
|
|
|
|
|
|
|
|
|
## 示例
|
|
|
|
|
|
2021-03-19 01:03:30 +03:00
|
|
|
|
请查看 [文档](docs/README.md) 获取具体示例,
|
2020-07-07 20:53:14 +03:00
|
|
|
|
其包含 [安装并使用包](docs/examples/installing-and-using-packages.md),
|
2020-07-08 08:08:09 +03:00
|
|
|
|
[使用压缩文件添加包](docs/examples/packaging-zipfiles.md)
|
2022-08-22 19:25:00 +03:00
|
|
|
|
和 [从 GitHub 源中添加一个包](docs/examples/packaging-github-repos.md)。
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
2021-12-29 01:57:02 +03:00
|
|
|
|
我们的文档现在也可以从 [vcpkg.io](https://vcpkg.io/) 在线获取。
|
2022-08-22 19:25:00 +03:00
|
|
|
|
我们真诚的希望您向我们提出关于此网站的任何建议! 请在[这里](https://github.com/vcpkg/vcpkg.github.io/issues) 创建 issue.
|
2019-10-07 20:40:57 +03:00
|
|
|
|
|
2022-08-22 19:25:00 +03:00
|
|
|
|
观看 4 分钟 [demo 视频](https://www.youtube.com/watch?v=y41WFKbQFTw)。
|
2019-10-07 20:40:57 +03:00
|
|
|
|
|
2022-02-25 07:54:11 +03:00
|
|
|
|
## 贡献
|
2019-10-07 20:40:57 +03:00
|
|
|
|
|
2020-07-07 20:53:14 +03:00
|
|
|
|
Vcpkg是一个开源项目,并通过您的贡献不断发展。
|
|
|
|
|
下面是一些您可以贡献的方式:
|
|
|
|
|
|
2022-08-22 19:25:00 +03:00
|
|
|
|
* [提交一个关于 vcpkg 或已支持包的新 issue][contributing:submit-issue]
|
|
|
|
|
* [提交修复 PR 和创建新包][contributing:submit-pr]
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
2022-02-25 07:54:11 +03:00
|
|
|
|
请参阅我们的 [贡献准则](CONTRIBUTING_zh.md) 了解更多详细信息。
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
2022-08-22 19:25:00 +03:00
|
|
|
|
该项目采用了 [Microsoft 开源行为准则][contributing:coc]。
|
|
|
|
|
获取更多信息请查看 [行为准则 FAQ][contributing:coc-faq] 或联系 [opencode@microsoft.com](mailto:opencode@microsoft.com) 提出其他问题或意见。
|
2020-07-07 20:53:14 +03:00
|
|
|
|
|
|
|
|
|
[contributing:submit-issue]: https://github.com/microsoft/vcpkg/issues/new/choose
|
|
|
|
|
[contributing:submit-pr]: https://github.com/microsoft/vcpkg/pulls
|
|
|
|
|
[contributing:coc]: https://opensource.microsoft.com/codeofconduct/
|
|
|
|
|
[contributing:coc-faq]: https://opensource.microsoft.com/codeofconduct/
|
2019-10-07 20:40:57 +03:00
|
|
|
|
|
2022-02-25 07:54:11 +03:00
|
|
|
|
# 开源协议
|
2019-10-07 20:40:57 +03:00
|
|
|
|
|
2022-11-30 20:27:23 +03:00
|
|
|
|
在此存储库中使用的代码均遵循 [MIT License](LICENSE.txt)。这些库是根据其作者的开源协议受到许可的。
|
|
|
|
|
vcpkg会将库的协议文件放置在 `installed/<triplet>/share/<port>/copyright` 中。
|
|
|
|
|
|
|
|
|
|
# 安全事项
|
|
|
|
|
|
|
|
|
|
大多数vcpkg中的库采用其官方发布的构建工具来构建它们,并从其官方渠道下载源码及构建工具。
|
|
|
|
|
若您的环境包含防火墙或反病毒程序,为了避免构建失败,请考虑在禁用防火墙与反病毒程序的环境中构建它们一次,
|
|
|
|
|
再将它们生成的二进制缓存共享给原始环境中使用。
|
2019-10-07 20:40:57 +03:00
|
|
|
|
|
2020-07-07 20:53:14 +03:00
|
|
|
|
# 数据收集
|
2019-10-07 20:40:57 +03:00
|
|
|
|
|
2022-08-22 19:25:00 +03:00
|
|
|
|
vcpkg 会收集使用情况数据,以帮助我们改善您的体验。
|
|
|
|
|
Microsoft 收集的数据是匿名的。
|
2021-12-29 01:57:02 +03:00
|
|
|
|
您也可以通过以下步骤禁用数据收集:
|
|
|
|
|
- 将选项 `-disableMetrics` 传递给 bootstrap-vcpkg 脚本并重新运行此脚本
|
|
|
|
|
- 向 vcpkg 命令传递选项 `--disable-metrics`
|
|
|
|
|
- 设置环境变量 `VCPKG_DISABLE_METRICS`
|
|
|
|
|
|
2023-03-07 02:46:35 +03:00
|
|
|
|
请在 [https://learn.microsoft.com/vcpkg/about/privacy](https://learn.microsoft.com/vcpkg/about/privacy) 中了解有关 vcpkg 数据收集的更多信息。
|