cmake/Help/variable/CMAKE_VS_PLATFORM_TOOLSET_VERSION.rst

34 lines
1.2 KiB
ReStructuredText
Raw Normal View History

2018-08-09 18:06:22 +02:00
CMAKE_VS_PLATFORM_TOOLSET_VERSION
---------------------------------
2021-09-14 00:13:48 +02:00
.. versionadded:: 3.12
2018-08-09 18:06:22 +02:00
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.
2021-09-14 00:13:48 +02:00
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.