CMAKE_GENERATOR_PLATFORM¶

自 3.1 版添加。

用户提供的针对特定生成器的目标平台规范。

某些 CMake 生成器支持为本机构建系统提供的目标平台名称，用以选择编译器工具链。如果用户指定了平台名称（例如通过 cmake -A 选项或通过 CMAKE_GENERATOR_PLATFORM 环境变量），则此变量中可用该值。

此变量的值切勿由项目代码修改。CMAKE_TOOLCHAIN_FILE 变量中指定的可执行文件可以初始化 CMAKE_GENERATOR_PLATFORM。一旦使用此变量的特定值初始化了给定的构建树，则更改该值将带来未定义的行为。

仅在特定生成器支持平台规范

请查看本机构建系统文档以了解允许的平台名称。

Visual Studio 平台选择¶

Visual Studio 生成器支持使用以下这些形式之一进行平台规范

平台 指定目标平台（VS 目标体系结构），例如 x64、ARM64 或 Win32。选定的平台名称在 CMAKE_VS_PLATFORM_NAME 变量中提供。

关键字=值 对形式为由逗号分隔的选项列表，用于指定平台选择中与生成器相关的信息。支持的对是

版本=<版本>

自 3.27 版添加。

指定要使用的 Windows SDK 版本。在针对 Windows 或 Windows 商店时，VS 2015 及更高版本支持此操作。CMake 会将 CMAKE_VS_WINDOWS_TARGET_PLATFORM_VERSION 变量设置为选定的 SDK 版本。

<version> 可为以下之一：

10.0: 指定可使用任何 10.0 SDK 版本，并让 Visual Studio 进行选择。VS 2019 及更高版本支持此操作。
10.0.<build>.<increment>: 指定确切的 4 组件 SDK 版本，例如，10.0.19041.0。必须安装已指定的 SDK 版本。如果已设置，不得超过 CMAKE_VS_WINDOWS_TARGET_PLATFORM_VERSION_MAXIMUM 变量的值。
8.1: 指定 8.1 SDK 版本。VS 2015 始终对此提供支持。在 VS 2017 及更高版本中，必须安装 8.1 SDK。

如果未指定 version 字段，CMake 会按照 CMAKE_VS_WINDOWS_TARGET_PLATFORM_VERSION 变量文档中描述的方式选择版本。