本机环境

• Windows 10 专业版
• Visual Studio Community 2017 (版本 15.9.7)

Windows 下配置 Vcpkg

Vcpkg 是适用于Windows，Linux和MacOS的C ++库管理器，使用它可以方便地管理 C++ 的依赖库。

Vcpkg 的下载地址和使用说明： https://github.com/microsoft/vcpkg

如果想要了解 Vcpkg，可以参考一下 这篇原创博客

To get started:

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

PS> .\bootstrap-vcpkg.bat
Linux:~/$ ./bootstrap-vcpkg.sh

Then, to hook up user-wide integration, run (note: requires admin on first use)

PS> .\vcpkg integrate install
Linux:~/$ ./vcpkg integrate install

Install any packages with

PS> .\vcpkg install sdl2 curl
Linux:~/$ ./vcpkg install sdl2 curl

百度 AI c++ 版本的 SDK 代码中主要使用了依赖库curl(需要支持ssl) openssl jsoncpp (>1.6.2版本，0.x版本将不被支持)。因此直接使用 Vcpkg 来安装这些依赖库。

如果不指定安装的架构，vcpkg默认把开源库编译成x86的Windows版本的库。可以使用一下代码查询对应的版本：

$ .\vcpkg.exe help triplet

Available architecture triplets:
  arm-uwp
  arm-windows
  arm64-uwp
  arm64-windows
  x64-linux
  x64-osx
  x64-uwp
  x64-windows
  x64-windows-static
  x86-uwp
  x86-windows
  x86-windows-static

我这里编译的版本为 x64，因此使用 x64-window。

> cd d:\vcpkg # 根据你的目录进行修改
> ./vcpkg.exe install curl:x64-windows
> ./vcpkg.exe install jsoncpp:x64-windows
> ./vcpkg.exe install openssl:x64-windows

每安装完一个库，都会提示如何包含库，执行上面代码后会输出以下使用说明：

find_package(CURL CONFIG REQUIRED)                                          
target_link_libraries(main PRIVATE CURL::libcurl)

find_package(jsoncpp CONFIG REQUIRED)                                       
target_link_libraries(main PRIVATE jsoncpp_lib)

find_package(OpenSSL REQUIRED)                                              
target_link_libraries(main PRIVATE OpenSSL::SSL OpenSSL::Crypto)

安装的各种库的版本：

$ ./vcpkg.exe list
curl:x64-windows            7.66.0      A library for transferring data with URLs
curl[ssl]:x64-windows                 Default SSL backend
curl[winssl]:x64-windows              SSL support (Secure Channel / "WinSSL")
jsoncpp:x64-windows         1.9.1     jsoncpp is an implementation of a JSON reader an...
openssl-windows:x64-windows 1.0.2s-1  OpenSSL is an open source project that provides ...
openssl:x64-windows         1         OpenSSL is an open source project that provides ...
zlib:x64-windows            1.2.11-5  A compression library

配置 Visual Studio 使用 Vcpkg 安装的库

集成到全局

Vcpkg提供了一套机制，可以全自动的适配目录，而开发者不需要关心已安装的库的目录在哪里，也不需要设置。

$ ./vcpkg.exe integrate install
Applied user-wide integration for this vcpkg root.

All MSBuild C++ projects can now #include any installed libraries.
Linking will be handled automatically.
Installing new libraries will make them instantly available.

CMake projects should use: "-DCMAKE_TOOLCHAIN_FILE=D:/vcpkg/scripts/buildsystems/vcpkg.cmake"

当出现 “Applied user-wide integration for this vcpkg root.” 字样的时候，说明已经集成成功。这时候可以在任意的工程中使用安装好的第三方库。

移除全局集成:

./vcpkg.exe integrate remove

集成到工程

"集成到工程”需要利用 Visual Studio 中的 nuget 插件来实现。

生成配置

执行命令

$ ./vcpkg.exe integrate project
Created nupkg: D:\vcpkg\scripts\buildsystems\vcpkg.D.vcpkg.1.0.0.nupkg

With a project open, go to Tools->NuGet Package Manager->Package Manager Console and paste:
    Install-Package vcpkg.D.vcpkg -Source "D:\vcpkg\scripts\buildsystems"

执行命令成功后会在 “\scripts\buildsystems” 目录下，生成 nuget 配置文件.

NuGet配置

在 Visual Studio 中，点击菜单 “工具->选项”, 选择"NuGet包管理器->程序包源".

添加新的可用程序包源, 选择 vcpkg 目录下的 “scripts\buildsystems” 目录，然后点击右侧的 “更新” 按钮。

点击 “确定” 按钮，关闭对话框。

到此，全局性的设置已经完成。

工程配置

用 Visual Studio 打开一个工程或解决方案。右键点击需要设置的工程弹出菜单，选择“管理 NuGet 程序包”。

在右上角的 “程序包源” 中选择刚刚设置的 “vcpkg”。这样在 “浏览” 选项卡中就可以看到 “vcpkg.D.vcpkg”。点击最右侧的 “安装”。这样就可以集成到某个工程了。

测试 Jsoncpp 库

这里使用的是 jsoncpp 官方的 example。

#include <iostream>
#include <json/json.h>

int main() {
	const std::string rawJson = R"({"Age": 20, "Name": "colin"})";
	const int rawJsonLength = static_cast<int>(rawJson.length());
	JSONCPP_STRING err;
	Json::Value root;

	Json::CharReaderBuilder builder;
	const std::unique_ptr<Json::CharReader> reader(builder.newCharReader());
	if (!reader->parse(rawJson.c_str(), rawJson.c_str() + rawJsonLength, &root, &err)) {
		std::cout << "error" << std::endl;
		return EXIT_FAILURE;
	}

	const std::string name = root["Name"].asString();
	const int age = root["Age"].asInt();

	std::cout << name << std::endl;
	std::cout << age << std::endl;

	system("pause");
	return EXIT_SUCCESS;
}

如果能正常编译并输出结果则表示库安装成功了。

参考链接

• Visual Studio开源库集成器Vcpkg全教程--利用Vcpkg轻松集成开源第三方库
• Vcpkg + Visual Studio
• vcpkg：用于 Windows、Linux 和 MacOS 的 C++ 包管理器