vcpkg/README_zh_CN.md

Vcpkg 总览

概要

Vcpkg 可帮助您在 Windows、 Linux 和 MacOS 上管理 C 和 C++ 库。 这个工具和生态链正在不断发展，我们一直期待您的贡献！

若您从未使用过vcpkg或希望了解如何使用vcpkg，请查阅快速开始章节。

如需获取有关可用命令的简短描述，请在编译vcpkg后执行 vcpkg help 或执行 vcpkg help [command] 来获取具体的帮助信息。

• Github: https://github.com/microsoft/vcpkg
• Slack: https://cppalliance.org/slack/， #vcpkg 频道
• Discord: #include <C++>， #🌏vcpkg 频道
• 文档: Documentation

目录

• Vcpkg 总览
  • 概要
• 目录
• 入门
  • 快速开始: Windows
  • 快速开始: Unix
  • 安装 Linux Developer Tools
  • 安装 macOS Developer Tools
    • 在 macOS 10.15 之前版本中安装 GCC
  • 在 CMake 中使用 vcpkg
    • Visual Studio Code 中的 CMake Tools
    • Visual Studio CMake 工程中使用 vcpkg
    • CLion 中使用 vcpkg
    • 将 vcpkg 作为一个子模块
  • 快速开始: 清单
• Tab补全/自动补全
  • 示例
  • 贡献者
• License
• 数据收集

入门

首先，请遵循以下任一方面的快速入门指南： Windows 或 macOS和Linux， 这取决于您使用的是什么平台。

有关更多信息，请参见 [安装和使用软件包] [getting-vcpkg：using-a-package]。 如果vcpkg目录中没有您需要的库， 您可以 [在GitHub上打开问题] [getting-vcpkg：open-issue] vcpkg团队和社区可以看到它的地方， 并可能将这个库添加到vcpkg。

安装并运行vcpkg后， 您可能希望将 TAB补全 添加到您的Shell中。

最后，如果您对vcpkg的未来感兴趣，请查看 清单！ 这是一项实验性功能，可能会出现错误。 因此，请尝试一下并打开所有问题!

快速开始: Windows

需求:

• Windows 7 或更新的版本
• [Git][quick-start:git]
• [Visual Studio][quick-start:visual-studio] 2015 Update 3 或更新的版本（包含英文语言包）

首先，请下载vcpkg并执行bootstrap.bat脚本。 它可以安装在任何地方，但是通常我们建议您使用 vcpkg 作为 CMake 项目的子模块，并为 Visual Studio 项目在全局安装它。 我们建议您使用例如 C:\src\vcpkg 或 C:\dev\vcpkg 的安装目录，否则您可能遇到某些库构建系统的路径问题。

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

使用以下命令为您的项目安装需要的库：

> .\vcpkg\vcpkg install [packages to install]

您也可以使用 search 子命令来查找vcpkg中集成的库:

> .\vcpkg\vcpkg search [search term]

若您希望在 Visual Studio 中使用vcpkg，请运行以下命令 (首次启动需要管理员权限)

> .\vcpkg\vcpkg integrate install

在此之后， 您可以创建一个非cmake项目 (或打开已有的项目)。 在您的项目中，所有已安装的库均可立即使用 #include 包含您需使用的库的头文件并无需添加额外配置。

若您在 Visual Studio 中使用cmake工程，请查阅这里。

为了在IDE以外在cmake中使用vcpkg， 您需要使用以下工具链文件:

> cmake -B [build directory] -S . -DCMAKE_TOOLCHAIN_FILE=[path to vcpkg]/scripts/buildsystems/vcpkg.cmake
> cmake --build [build directory]

在cmake中，您仍需通过 find_package 来使用第三方库。 请查阅 CMake 章节 获取更多信息，其中包含了在IDE中使用cmake的内容。

对于其他工具 (包括Visual Studio Code)，请查阅 [集成指南][quick-start:integration]。

快速开始: Unix

Linux平台的使用需求:

• [Git][quick-start:git]
• [g++][quick-start:linux-gcc] >= 6

macOS平台的使用需求:

• [Apple Developer Tools][quick-start:apple-developer-tools]
• macOS 10.14 或更低版本中，您也需要:
  • [Homebrew][quick-start:homebrew]
  • Homebrew 中 [g++][quick-start:macos-gcc] >= 6

首先，请下载vcpkg并执行bootstrap.sh脚本。 我们总体上建议您将vcpkg作为cmake项目的子模块使用。

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

使用以下命令安装任意包：

$ ./vcpkg/vcpkg install [packages to install]

您也可以使用 search 子命令来查找vcpkg中集成的库:

$ ./vcpkg/vcpkg search [search term]

为了在cmake中使用vcpkg， 您需要使用以下工具链文件:

> cmake -B [build directory] -S . -DCMAKE_TOOLCHAIN_FILE=[path to vcpkg]/scripts/buildsystems/vcpkg.cmake
> cmake --build [build directory]

在cmake中，您仍需通过 find_package 来使用第三方库。 为了您更好的在cmake或 VSCode CMake Tools 中使用vcpkg， 请查阅 CMake 章节 获取更多信息， 其中包含了在IDE中使用cmake的内容。

对于其他工具，请查阅 [集成指南][quick-start:integration]。

安装 Linux Developer Tools

在Linux的不同发行版中，您需要安装不同的工具包:

• Debian， Ubuntu， popOS， 或其他基于 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

对于其他的发行版，请确保已安装 g++ 6 或更新的版本。 若您希望添加特定发行版的说明， 请提交一个 PR!

安装 macOS Developer Tools

在 macOS 10.15 中，唯一需要做的是在终端中运行以下命令:

$ xcode-select --install

然后按照出现的窗口中的提示进行操作。

在 macOS 10.14 及先前版本中，您也需要使用 homebrew 安装 g++。 请遵循以下部分中的说明：

在 macOS 10.15 之前版本中安装 GCC

此条_只_在您的macOS版本低于 10.15 时是必须的。 安装homebrew应当很轻松， 请查阅 <brew.sh> 以获取更多信息。 为了更简便，请使用以下命令:

$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

然后，为了获取最新版本的gcc，请运行以下命令：

$ brew install gcc

此时，您就可以使用 bootstarp.sh 编译vcpkg了。 请参阅 quick start guide

在 CMake 中使用 vcpkg

若您希望在CMake中使用vcpkg， 以下内容可能帮助您：

Visual Studio Code 中的 CMake Tools

将以下内容添加到您的工作区 settings.json 中将使CMake Tools自动使用vcpkg中的第三方库:

{
  "cmake.configureSettings": {
    "CMAKE_TOOLCHAIN_FILE": "[vcpkg root]/scripts/buildsystems/vcpkg.cmake"
  }
}

Visual Studio CMake 工程中使用 vcpkg

打开CMake设置选项，将 vcpkg toolchain 文件路径在 CMake toolchain file 中：

[vcpkg root]/scripts/buildsystems/vcpkg.cmake

CLion 中使用 vcpkg

打开 Toolchains 设置 (File > Settings on Windows and Linux， CLion > Preferences on macOS)， 并打开 CMake 设置 (Build， Execution， Deployment > CMake)。 最后在 CMake options 中添加以下行:

-DCMAKE_TOOLCHAIN_FILE=C:/Users/nimazzuc/src/vcpkg/scripts/buildsystems/vcpkg.cmake

遗憾的是， 您必须手动将此选项加入每个项目配置文件中。

将 vcpkg 作为一个子模块

当您希望将vcpkg作为一个子模块加入到您的工程中时， 您可以在第一个 project() 调用之前将以下内容添加到 CMakeLists.txt 中， 而无需将 CMAKE_TOOLCHAIN_FILE 传递给cmake调用。

set(CMAKE_TOOLCHAIN_FILE ${CMAKE_CURRENT_SOURCE_DIR}/vcpkg/scripts/buildsystems/vcpkg.cmake
  CACHE STRING "Vcpkg toolchain file")

这仍然允许您不通过直接传递 CMAKE_TOOLCHAIN_FILE 来使用vcpkg，但这会使配置构建步骤稍微容易一些。

快速开始: 清单

如果您期待vcpkg在未来会更好，我们真的很感激😄。 但是，首先要警告： vcpkg中的清单支持仍处于beta中！ 通常，它应该可以正常工作，但您很可能会在这种模式下使用vcpkg时遇到至少一个或两个错误。 另外，我们可能会在稳定之前破坏行为，因此请提前警告。 如果您遇到任何错误，请 提交一个issue！

首先，为 Windows 正常安装vcpkg或 Unix。 您可能希望将vcpkg安装在常用的位置，由于安装的目录位于本地，并且可以从同一vcpkg目录中同时运行多个vcpkg命令。

然后，您必须通过将 manifests 添加到以逗号分隔的 --feature-flags 选项中来打开 manifests vcpkg功能标记， 或将其添加到以逗号分隔的 VCPKG_FEATURE_FLAGS 环境变量中。

您也可能希望添加vcpkg路径至环境变量 PATH 中。 这时，我们要做的就是创建清单。 创建一个名为 vcpkg.json 的文件，然后添加以下内容：

{
  "name": "<name of your project>",
  "version-string": "<version of your project>",
  "dependencies": [
    "abseil",
    "boost"
  ]
}

您所安装的库将生成在 vcpkg_installed 文件夹中，并与您的 vcpkg.json 所在的文件夹相同。 如果您可以使用常规的CMake toolchain 或 Visual Studio / MSBuild 集成， 它将自动安装依赖项，尽管您需要将MSBuild的 VcpkgManifestEnabled 设置为 On。 如果您希望不使用CMake或MSBuild来安装依赖项，您可以使用命令 vcpkg install --feature-flags = manifests 。

请查阅 清单 获取更多信息。

Tab补全/自动补全

vcpkg 支持命令，包名称，以及 Powershell 和 Bash 中的选项。 要在您选择的 shell 中启用Tab补全功能，请运行：

> .\vcpkg integrate powershell

或

$ ./vcpkg integrate bash

这依据您使用的shell，然后重新启动控制台。

示例

请查看 文档获取具体示例， 其包含 安装并使用包， 使用压缩文件添加包， 与 从GitHub源中添加一个包。

我们的文档现在也可以从 ReadTheDocs 在线获取。

观看4分钟 demo视频。

贡献者

Vcpkg是一个开源项目，并通过您的贡献不断发展。 下面是一些您可以贡献的方式:

• 提交一个关于vcpkg或已支持包的新issue
• 提交修复PR和创建新包

请参阅我们的 贡献准则 了解更多详细信息。

该项目采用了 Microsoft开源行为准则。 获取更多信息请查看 行为准则FAQ 或联系 opencode@microsoft.com提出其他问题或意见。

License

在此存储库中使用的代码均遵循 MIT License。

数据收集

vcpkg会收集使用情况数据，以帮助我们改善您的体验。 Microsoft收集的数据是匿名的。 您也可以通过使用 -disableMetrics 、在命令行上将--disable-metrics传递给vcpkg，或通过设置环境变量 VCPKG_DISABLE_METRICS 并重新运行 bootstrap-vcpkg 脚本来选择禁用数据收集。 请在 privacy.md 中了解有关 vcpkg 数据收集的更多信息。