C++第三方库管理工具vcpkg使用教程

目录

• vcpkg介绍
• vcpkg安装
• • 1、安装vs英语语言包
  • 2、更新PowerShell版本
  • 3、配置终端
  • 4、clone vcpkg
• vcpkg具体使用
• • 演示安装jsoncpp库
  • 指定位数安装
  • 查找支持的系统架构
  • 查看已经安装了哪些库
  • 如何卸载vcpkg
• 如何使用vcpkg下载好的库

---

vcpkg介绍

  vcpkg是c++第三方库管理工具，类似于java maven，C# Nuget，支持windows、macos、linux。vcpkg可以帮C++程序员快速的获取编译第三方库，一般C++第三方库需要手动编译，配置各种环境，例如OpenSSL，很多人基本编译不了；FFmpeg的Windows版，更是无法编译。有了vcpkg, 只要一条命令就可以获取到这些库，很方便。
  官网：https://vcpkg.io/en/index.html

  点击Get started可以查看如何安装vcpkg
  点击Browse Packages可以查找想要的库

  下面介绍如何安装使用vcpkg.

vcpkg安装 1、安装vs英语语言包

  vcpkg安装第三方库时，会有visual studio的语言不是英语的错误，如果不安装英语语言包，使用vcpkg安装第三方库时会有如下报错
Error: in triplet x64-windows: Unable to find a valid Visual Studio instance
The following VS instances were excluded because the English language pack is unavailable:
  例如我的电脑安装的是vs2019，需要修改安装，增加英语语言包

  设置vs语言

2、更新PowerShell版本

  vcpkg需要使用PS7以上的版本，另外PowerShell版本需要比较新的，或者在vcpkg安装第三方库时自动安装，如果网速不好，可能会安装失败，可以先下载离线包安装。
右键【windows开始】打开Windows PowerShell, 输入 $PSVersionTable可以查看版本，如下图：

  我现在的版本是5.1，在使用vcpkg时，提示需要使用7.2版本。
  powershell release下载路径 https://github.com/PowerShell/PowerShell/releases
找到7.2下载

  安装结束后，powershell7会自动添加到系统path

  现在的版本

3、配置终端

  终端配置文件可以选择刚刚安装的PowerShell, 以后右键打开时就是7.2版本了。

4、clone vcpkg

  打开git bash，开始clone vcpkg, 命令：

git clone https://github.com/Microsoft/vcpkg.git

  如果网络不好，可能无法clone, 需要有合理良好的网络环境。
vcpkag clone ok后，cd到vcpkg目录，执行脚本bootstrap-vcpkg.bat下载vcpkg.exe，如下图：

  执行结束之后在当前目录就可以看到vcpkg.exe, 如下图：

vcpkg具体使用 演示安装jsoncpp库

  将vcpkg.exe目录添加到系统path, 以后在任意目录都可以执行vcpkg.exe命令了，但是安装的文件依然是在vcpkg目录，安装第三方库的命令：

vcpkg install [name]

  比如安装jsoncpp库，输入以下命令进行安装

.\vcpkg install jsoncpp

  默认安装的是32位的，如下图

  首次安装时会比较慢，耐心等待。
  库的安装位置

  默认vcpkg是使用的全局安装，则会根据以下位置进行引用，vs2019会自动识别出来，不需要在"属性–包含目录"里设置路径。

指定位数安装

  指定版本安装前，先查找是否存在对应的版本，命令

.\vcpkg search 库的名字

  例如查找asdf库是否存在

  asdf这个库显然是没有的，下面看看ffmpeg是否有

  当然去官网也可以查看，在官网可以明确的知道支持哪些版本

  如果需要指定版本安装，比如安装64位jsoncpp的，命令如下：

./vcpkg install jsoncpp:x64-windows

  如下图

查找支持的系统架构

  如何查看版本位数呢，输入如下命令：

./vcpkg help triplet

  如下图

查看已经安装了哪些库

  命令

./vcpkg list

  输入 ./vcpkg list，如下图

如何卸载vcpkg

  直接删除目录即可

如何使用vcpkg下载好的库

  建议还是copy到项目目录，去vcpkg的packages目录找到各个库的include, lib, dll, 注意lib目录默认是release版，debug的lib dll需要去debug目录拷贝.

  mac、linux也可以使用，按照官网的指引进行安装即可。