CMAKE_VS_WINDOWS_TARGET_PLATFORM_VERSION

在 3.4 版被加入.

Visual Studio Windows Target Platform Version.

When targeting Windows 10 and above, Visual Studio Generators for VS 2015 and above support specification of a Windows SDK version:

  • If CMAKE_GENERATOR_PLATFORM specifies a version= field, as documented by Visual Studio Platform Selection, that SDK version is selected.

  • Otherwise, if the WindowsSDKVersion environment variable is set to an available SDK version, that version is selected. This is intended for use in environments established by vcvarsall.bat or similar scripts.

    在 3.27 版被加入: This is enabled by policy CMP0149.

  • Otherwise, if CMAKE_SYSTEM_VERSION is set to an available SDK version, that version is selected.

    在 3.27 版的變更: This is disabled by policy CMP0149.

  • Otherwise, CMake uses the latest Windows SDK version available.

The chosen Windows target version number is provided in CMAKE_VS_WINDOWS_TARGET_PLATFORM_VERSION. If no Windows 10 SDK is available this value will be empty.

One may set a CMAKE_WINDOWS_KITS_10_DIR environment variable to an absolute path to tell CMake to look for Windows 10 SDKs in a custom location. The specified directory is expected to contain Include/10.0.* directories.

See also CMAKE_VS_WINDOWS_TARGET_PLATFORM_VERSION_MAXIMUM.