| CMAKE_VS_PLATFORM_TOOLSET_VERSION |
| --------------------------------- |
| |
| .. versionadded:: 3.12 |
| |
| Visual Studio Platform Toolset version. |
| |
| The :ref:`Visual Studio Generators` for VS 2017 and above allow to |
| select minor versions of the same toolset. The toolset version number |
| may be specified by a field in :variable:`CMAKE_GENERATOR_TOOLSET` of |
| the form ``version=14.11``. If none is specified CMake will choose a default |
| toolset. The value may be empty if no minor version was selected and the |
| default is used. |
| |
| If the value is not empty, it is the version number that MSBuild uses in |
| its ``Microsoft.VCToolsVersion.*.props`` file names. |
| |
| .. versionadded:: 3.19.7 |
| |
| VS 16.9's toolset may also be specified as ``14.28.16.9`` because |
| VS 16.10 uses the file name ``Microsoft.VCToolsVersion.14.28.16.9.props``. |
| |
| Three-Component MSVC Toolset Versions |
| ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
| |
| .. versionadded:: 3.19.7 |
| |
| The ``version=`` field may be given a three-component toolset version |
| such as ``14.28.29910``, and CMake will convert it to the name used by |
| MSBuild ``Microsoft.VCToolsVersion.*.props`` files. This is useful |
| to distinguish between VS 16.8's ``14.28.29333`` toolset and VS 16.9's |
| ``14.28.29910`` toolset. It also matches ``vcvarsall``'s ``-vcvars_ver=`` |
| behavior. |