vcpkg教程

vcpkg 可以帮助你在 不同的平台上管理 C 和 C++库。通过微软的这项工具,你可以很简单的安装各种 C++ 的库,例如 opencv 、opengl等.
文章主要包括以下的内容:

  • 如何安装vcpkg
  • vcpkg 的各种命令
  • 如何在 cmake 中使用 vcpkg
  • 如何在 VSCode 中使用 vcpkg

1. 安装 Linux 开发工具

在 Ubuntu 中你需要执行以下命令来安装工具包

1
2
sudo apt-get update
sudo apt-get install build-essential tar curl zip unzip

2.安装 vcpkpg,以及各种命令

在安装完 linux 平台下的开发工具后, vcpkg 的安装其实很简单,只需要执行以下的命令即可:

1
2
3
4
5
6
# 可选,选择一个目录安装vcpkg
cd [路径]
# 下载vcpkg
git clone https://github.com/microsoft/vcpkg
# 执行 bootstrap 脚本
./vcpkg/bootstrap-vcpkg.sh

vcpkg 就已经安装好了,现在你可以通过以下的命令来安装你想安装的各种库了

1
2
3
4
5
6
7
8
9
10
# 进入 vcpkg 安装目录
cd vcpkg
# 查看 help 信息(你也可以修改/etc/profile文件在PATH中添加vcpkg)
./vcpkg help
# 查找一个包
./vcpkg search [包名]
# 安装一个包
./vcpkg install [包名]

....

3. 如何在cmake 中使用 vcpkg

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

1
2
3
# 注意路径问题
cmake -B [build directory] -S . -DCMAKE_TOOLCHAIN_FILE=[path to vcpkg]/scripts/buildsystems/vcpkg.cmake
$ cmake --build [build directory]

注意你依旧需要在 CMKAELISTS.txt 文件中使用find_package来使用第三方库。

4. 在 VSCode 中如何使用vcpkg

使用 IDE 能够使得 第三方库 使用变得更加简单.
你需要 添加以下的代码到你的 settings.json,这样就可以让 cmake Tools 自动使用vcpkg 中的第三方库(而不用指定 -DCMAKE_TOOLCHAIN_FILE参数 ).

你需要安装 Cmake Tools 这个插件, 它会把生成的文件放在build 文件夹下,此时你可以使用 make 命令 “make Makefile” ,或者点击 VScode 底部的 lunch 按键,即可生成可运行文件

1
2
3
4
5
6
// 注意修改路径
{
"cmake.configureSettings": {
"CMAKE_TOOLCHAIN_FILE": "[vcpkg root]/scripts/buildsystems/vcpkg.cmake"
}
}

注意 你还需要确保你的 CMakeLists,txt 文件是正确的.
将vcpkg 的路径加入 c_cpp_properties.json 文件的includePath 字段,才能够使用代码自动补全功能
你可以参考官方的例子