Visual Studio 使用第三方库管理工具 vcpkg

一、介绍

    Windows下开发C/C++程序，少不了用开源的第三方库。比如线性代数和矩阵分析的库eigen，或者图像处理的OpenCV库。虽然这些库都是开源的，但是由于要编译debug和release版本的，32位以及64位的，如果像FFmpeg这种还要考虑是否引用其他开源库的功能，那么编译类型的组合会更多。如此多库的版本，编译和管理起来都十分麻烦。

    这时候我们就需要一个库管理工具，来管理我们所有的第三方库了。这里使用vcpkg集成到Visual Studio中。使用vcpkg的优点有：

• 自动下载开源库源代码
• 源码包的缓存管理和版本管理，可以升级版本
• 依赖关系检查（比如编译libcurl，会自动下载zlib、openssl进行编译）
• 无缝集成Visual Studio，不需要设置库文件、头文件的所在目录，自动集成。
• Visual Studio全平台支持，不仅支持Debug/Release、x86/x64编译，还支持UWP、ARM平台的编译。

二、vcpkg安装

1.下载源码

    vcpkg的源码地址，可以直接下载zip包或者git clone下来：GitHub - microsoft/vcpkg: C++ Library Manager for Windows, Linux, and MacOSC++ Library Manager for Windows, Linux, and MacOS. Contribute to microsoft/vcpkg development by creating an account on GitHub.https://github.com/Microsoft/vcpkg

2.编译vcpkg

    使用源码里的bat批处理文件即可编译，在PowerShell中进入到源码路径执行.\bootstrap-vcpkg.bat：

     Vcpkg大量使用的psl脚本，所以官方强烈推荐使用PowerShell而不时CMD命令行来执行各种操作。尽管在使用的时候兼容CMD，但是在编译这一步，请使用PowerShell。

    编译完成后会在源码路径下生成一个vcpkg.exe文件，可以输入.\vcpkg.exe --help查看帮助，检查是否安装成功。

3.添加环境变量

    在环境变量中添加vcpkg的路径：

三、使用vcpkg安装第三方库

1.查看Vcpkg支持的开源库列表

    进入到源码路径执行：

.\vcpkg.exe search

2.安装一个第三方库

    这里的“安装”其实是指下载和编译。

    比如要安装Windows的64位的OpenCV库，可以输入下面的命令安装：

.\vcpkg.exe install opencv:x64-windows

如果电脑中没有安装cmake，vcpkg会自动下载portable版本的cmake。但是由于各种原因，下载的网速很慢，所以建议先自行下载安装cmake。最好是下载最新版本的cmake。

安装后的第三方库放在vcpkg目录下的installed目录下，如果安装的是Windows的64位的库，installed目录下会有一个x64-windows，安装的第三方库的头文件，lib文件和dll文件都在里面。

3.指定编译某种架构的第三方库

    上面可以看到安装OpenCV的命令最后有:x64-windows，指定了安装的架构为Windows的64位库。

    如果不指定安装的架构，vcpkg默认把开源库编译成x86的Windows版本的库。可以使用下面的命令查看vcpkg支持安装多少种架构：

.\vcpkg.exe help triplet

• arm-uwp
• arm-windows
• arm64-uwp
• arm64-windows
• x64-uwp
• x64-windows-static
• x64-windows
• x86-uwp
• x86-windows-static
• x86-windows

    只需要在需要安装的第三方库后面使用冒号“:”指定相应的triplet，即可安装对应架构的第三方库。

4.移除一个指定的第三方库

    如果移除一个已经安装的开源库，那么执行remove指令即可。比如我们要移除OpenCV，那么执行命令：

.\vcpkg.exe remove opencv

• 这个时候只是移除了默认的x86-winodws版本的文件，如果有其他平台的版本需要移除，需要指定相应的triplet。
• 移除也只是移除了二进制程序库而已，源码包和解压缩的源码并没有删除。

5.列出已经安装的开源库

.\vcpkg.exe list

四、vcpkg和Visual Studio的集成

    在安装完我们需要用的第三方库后，常规情况下，需要设置include目录、lib目录等。vcpkg提供了两种方法，可以方便的在自己的项目中集成安装的第三方库。

1.集成到全局

    这种方法适用于 MSBuild 创建的项目，cmake 的项目也可以通过添加编译选项来引用下载的第三方库。执行命令：

 .\vcpkg integrate install

    当出现“Applied user-wide integration for this vcpkg root.”字样的时候，说明已经集成成功。根据输出也可以看到 cmake 项目使用的编译选项，以及在 MSBuild 项目中可以直接包含头文件引用。

    移除全局集成执行下面的命令即可：

 .\vcpkg integrate remove

2.集成到工程

    在大多数情况下，我们并不希望将所有安装的库集成到全局环境中，毕竟有很多第三方库我们希望进行自定义处理，或者根本不想使用这些第三方库。因此，将这些库集成到具体的工程中是最灵活的处理方式，也是工程级项目推荐的做法。

（1）生成配置文件

    首先执行如下命令，生成 nuget 配置文件：

 .\vcpkg integrate project

    根据输出可以看到在 vcpkg 的路径下生成了一个 .nupkg 的文件：

（2）基本配置

    接着，打开 vs2022 工具 -> NuGet包管理器 -> 程序包管理器设置 -> 程序包源

    添加安装的vcpkg包源，点击“加号”增加一个源。修改源的名字为vcpkg。在“源”的选项中点击右侧的"…"选择上一步中 .nupkg 文件的路径，然后点击右侧的“更新按钮”。点击“确定”，关闭设置对话框。

（3）工程配置

    用Visual Studio 打开一个工程或解决方案。右键点击需要设置的工程或解决方案，选择“管理NuGet程序包”。在右上角的“程序包源”中选择刚刚设置的“vcpkg”。这样在“浏览”选项卡中就可以看到第一步中生成的 nuget 配置文件。点击最右侧的“安装”，这样就可以集成到某个工程了。