Visual Studio中集成的vcpkg

发布时间 2023-09-06 18:21:41作者: vcpkg_C++包管理器

vcpkg:Visual Studio 2022中的C++库管理器

Vcpkg 是一个 C++ 库管理器,它可以帮助你在 Windows、Linux 和 MacOS 上安装和使用第三方库。它支持超过 2000 个开源库,包括 Boost、OpenCV、Qt 等。Vcpkg 还可以自动处理库之间的依赖关系,让你的开发过程更加方便。

在本文中,我将介绍如何在 Visual Studio 2022 中安装和使用 vcpkg,以及如何在历史版本的 Visual Studio 中使用 vcpkg。也会列出一些 vcpkg 目前存在的问题和限制。

如何在Visual Studio 2022中安装vcpkg

从 Visual Studio 2022 开始,vcpkg 已经被包含在 Visual Studio Installer 中,你可以直接在安装或修改 Visual Studio 时选择安装 vcpkg。具体步骤如下:

1. 打开 Visual Studio 安装器,选择安装或修改 Visual Studio 2022。

2. 在安装页面中,选择你需要的工具选项,例如“C++桌面开发”。

3. 在组件页面中,勾选 “vcpkg - C++库管理器”。

4. 点击修改或安装,等待安装完成。

5. 安装完成后,你就可以使用 vcpkg 了。

如何在Visual Studio 2022中使用vcpkg

在 Visual Studio 中的 vcpkg 只能使用 manifest 模式,无法使用经典模式。因为在使用经典模式时需要安装 vcpkg 的 ports文件夹,但是当前 vcpkg 目录位于 Visual Studio 的安装目录下,没有对该目录的写入权限,所以 ports 安装会失败。

如果要在 Visual Studio 工程中以 manifest 模式使用 vcpkg,需要进行设置:在 “配置属性 -> vcpkg” 中将“use vcpkg manifest”置为“是”,然后保存。

 

Manifest 模式使用方法见链接:Manifest 使用示例 - Msbuild 工程 - vcpkg_C++包管理器 - 博客园 (cnblogs.com)

如何在旧版本的Visual Studio中使用vcpkg

如果你使用的是旧版本的 Visual Studio(2019或更低),你需要手动安装 vcpkg,并设置 CMake 工具链文件来指向 vcpkg.cmake 文件。这样,CMake 就可以自动找到并链接你安装的库。具体步骤如下:

1. 打开命令提示符,切换到你想要安装 vcpkg 的目录,例如 C:\src。

2. 输入以下命令,克隆 vcpkg 的仓库:`git clone https://github.com/microsoft/vcpkg`。

3. 输入以下命令,进入 vcpkg 的目录:`cd vcpkg`。

4. 输入以下命令,运行 bootstrap 脚本:`bootstrap-vcpkg.bat`。

5. 等待脚本完成后,你就可以使用 vcpkg 了。

6. 打开 Visual Studio,创建或打开一个 CMake 项目。

7. 在解决方案资源管理器中,右键单击 CMakeLists.txt 文件,选择打开文件夹设置。

8. 在设置页面中,选择 “配置 -> CMake -> 工具链”。

9. 在工具链文件中,输入内容:`C:\src\vcpkg\scripts\buildsystems\vcpkg.cmake`,点击确定,保存设置更改。

10. 在命令提示符中,切换到 vcpkg 的目录,输入以下命令,安装你需要的库:`vcpkg install portName`。

11. 然后运行以下命令:`vcpkg integrate install`。

12. 回到 Visual Studio,重新生成项目。

13. 在代码中,你就可以使用 `#include <headfile.h>` 指令来引用库的头文件了。

你也可以参考以下博客中对于 vcpkg 的使用方法:

MSbuild 工程中使用 vcpkg: 在MSbuild工程中使用vcpkg提供的库 - vcpkg_C++包管理器 - 博客园 (cnblogs.com)

CMake 工程中使用 vcpkg: 在CMake工程中使用vcpkg提供的库 - vcpkg_C++包管理器 - 博客园 (cnblogs.com)

Visual Studio 集成的vcpkg存在的已知问题

以下功能尚不适用于 vcpkg 的内部构件,但计划在 Visual Studio 未来版本中修复:

  • “工具 > 选项 > vcpkg 包管理器设置” 允许你通过自定义一个 vcpkg 库来管理 vcpkg artifacts,该设置仍然存在并可用于其预期目的,但不会替换其他上下文中的 vcpkg 内置副本,例如在终端。将来,我们计划使用一种方法可以全局设置它们,而不必使用 `vcpkg integrate install` 命令。

  • 无需运行 `vcpkg integrate install` 命令,即可使用 vcpkg 安装的包。

  • 当智能检测方法检查到一个库的代码未被找到或者没有被 manifest 模式安装时可以快速的提示结果。

你可以在 vcpkg 的 GitHub 页面上查看更多的问题和建议:microsoft/vcpkg: C++ Library Manager for Windows, Linux, and MacOS (github.com)

结语

Vcpkg 是一个非常有用的 C++ 库管理器,它可以让你在 Visual Studio 中轻松地安装和使用第三方库。它支持多种操作系统和开源库,还可以自动处理依赖关系。如果你是一个 C++ 开发者,我强烈建议你尝试一下 vcpkg,它会给你带来很多便利和乐趣。