VCPKG 环境变量

VCPKG中有许多的环境变量，如何通过修改环境变量来实现期望的构建结果，可以参照下面的例子：

1. 指定特定的工具集

当一台机器上同时安装了多个版本的Visual Studio 或是一个Visual Studio安装了多个版本的工具集时，vcpkg会默认调用最新的工具集，若想使用旧的工具集，可通过修改指定triplet文件来实现：

例如要在x64-windows triplet下使用VS2017的工具集，可以添加如下内容到 triplets/x64-windows.cmake文件中：

set(VCPKG_PLATFORM_TOOLSET v141)

 2. 添加额外的编译选项

可以通过在对应port的portfile.cmake文件中添加如下内容来添加额外的编译选项：

set(VCPKG_CXX_FLAGS "/arch:SSE2 ${VCPKG_CXX_FLAGS}")
set(VCPKG_C_FLAGS "/arch:SSE2 ${VCPKG_C_FLAGS}") 

 注意：如果您手动设置了VCPKG_CXX_FLAGS，那么您必须同时设置VCPKG_C_FLAGS。

下面是vcpkg提供的其他的环境变量的一些介绍：

变量名称	功能	变量的值 / 扩展介绍
VCPKG_TARGET_ARCHITECTURE	指定生成库对应的目标机器的架构	x86/x64/arm/arm64/wasm32
VCPKG_CRT_LINKAGE	指定生成库时使用的MSVC CRT 链接方式(/MT /MD)	dynamic/static
VCPKG_LIBRARY_LINKAGE	指定生成库的类型	dynamic/static
VCPKG_CMAKE_SYSTEM_NAME	指定目标平台类型	Empty(Windows Desktop for legacy reasons) WindowsStore(Universal Windows Platform) MinGW(Minimalist GNU for Windows) Darwin(Mac OSX) iOS(iOS) Linux(Linux) Emscripten(WebAssembly)
VCPKG_CMAKE_SYSTEM_VERSION	指定目标平台的版本	可选变量
VCPKG_CHAINLOAD_TOOLCHAIN_FILE	指定要使用的备用 CMake toolchain文件
VCPKG_CXX_FLAGS	设置额外的编译选项	此选项还具有特定于配置和 C 标志的形式： VCPKG_CXX_FLAGS VCPKG_CXX_FLAGS_DEBUG VCPKG_CXX_FLAGS_RELEASE VCPKG_C_FLAGS VCPKG_C_FLAGS_DEBUG VCPKG_C_FLAGS_RELEASE
VCPKG_LINKER_FLAGS	设置额外的链接选项	此选项还具有用于配置特定标志的形式： VCPKG_LINKER_FLAGS VCPKG_LINKER_FLAGS_DEBUG VCPKG_LINKER_FLAGS_RELEASE
VCPKG_CMAKE_CONFIGURE_OPTIONS	设置额外的CMake 配置选项	可选变量
VCPKG_MAKE_CONFIGURE_OPTIONS	设置额外的automake/autoconf 配置选项	可选变量
VCPKG_DEP_INFO_OVERRIDE_VARS	设置覆盖默认triplet文件中的设置选项

Windows 变量名称	功能	变量的值 / 扩展介绍
VCPKG_ENV_PASSTHROUGH	指示 vcpkg 允许参加构建过程的额外环境变量	在 Windows 上，vcpkg 在与当前命令提示符隔离的特殊干净环境中构建第三方库，以确保构建的可靠性和一致性。此选项可以将额外的环境变量添加到干净环境中的附加环境变量列表，这些环境变量以及它们的哈希值都会记录在VCPKG abi 文件中
VCPKG_ENV_PASSTHROUGH_UNTRACKED	指示vcpkg 允许额外的环境变量进入构建过程，但不会被abi 记录
VCPKG_VISUAL_STUDIO_PATH	指定使用的Visual Studio的路径
VCPKG_PLATFORM_TOOLSET	指定要使用的基于 VS 的 C/C++ 编译器工具集	v140/v141/v142
VCPKG_LOAD_VCVARS_ENV	设置这个变量可解决当使用VCPKG_CHAINLOAD_TOOLCHAIN_FILE但不向该变量赋值时，vcpkg不设置VS环境变量的问题	TRUE/FALSE

MacOS 变量名称	功能	变量的值 / 扩展介绍
VCPKG_OSX_DEPLOYMENT_TARGET	设置编译二进制文件的最低 macOS 版本。这也会更改 CMake 将搜索的 macOS 平台 SDK 的版本
VCPKG_OSX_SYSROOT	设置 CMake 将使用的 macOS 平台 SDK 的名称或路径
VCPKG_OSX_ARCHITECTURES	设置 CMake 将使用的 macOS / IOS 目标架构

参考：https://github.com/microsoft/vcpkg/blob/master/docs/users/triplets.md

首次发布于：https://www.cnblogs.com/vcpkg/p/15019968.html