mirror of
https://github.com/Kitware/CMake.git
synced 2026-04-29 02:19:18 -05:00
jonathan molinatto
ba497111f6
Since commit 83ddc4d289 (VS: Do not select a Windows SDK too high for
current VS version, 2017-08-07, v3.13.0-rc1~72^2~2) we enforce a maximum
SDK version for the VS 2015 generator. The blog post linked in the
original commit is no longer available, but it can be seen here:
* https://web.archive.org/web/20190108032520/https://blogs.msdn.microsoft.com/chuckw/2018/10/02/windows-10-october-2018-update/
In particular, it states:
> VS 2015 Users: The Windows 10 SDK (15063, 16299, 17134, 17763)
> is officially only supported for VS 2017.
However, in some circumstances a higher version can be used.
Add a `CMAKE_VS_WINDOWS_TARGET_PLATFORM_VERSION_MAXIMUM` to override the
generator's default maximum SDK version.
Fixes: #20633
64 lines
2.2 KiB
ReStructuredText
64 lines
2.2 KiB
ReStructuredText
Visual Studio 14 2015
|
|
---------------------
|
|
|
|
.. versionadded:: 3.1
|
|
|
|
Generates Visual Studio 14 (VS 2015) project files.
|
|
|
|
Project Types
|
|
^^^^^^^^^^^^^
|
|
|
|
Only Visual C++ and C# projects may be generated. Other types of
|
|
projects (JavaScript, Powershell, Python, etc.) are not supported.
|
|
|
|
Platform Selection
|
|
^^^^^^^^^^^^^^^^^^
|
|
|
|
The default target platform name (architecture) is ``Win32``.
|
|
|
|
The :variable:`CMAKE_GENERATOR_PLATFORM` variable may be set, perhaps
|
|
via the :manual:`cmake(1)` ``-A`` option, to specify a target platform
|
|
name (architecture). For example:
|
|
|
|
* ``cmake -G "Visual Studio 14 2015" -A Win32``
|
|
* ``cmake -G "Visual Studio 14 2015" -A x64``
|
|
* ``cmake -G "Visual Studio 14 2015" -A ARM``
|
|
|
|
For compatibility with CMake versions prior to 3.1, one may specify
|
|
a target platform name optionally at the end of the generator name.
|
|
This is supported only for:
|
|
|
|
``Visual Studio 14 2015 Win64``
|
|
Specify target platform ``x64``.
|
|
|
|
``Visual Studio 14 2015 ARM``
|
|
Specify target platform ``ARM``.
|
|
|
|
Toolset Selection
|
|
^^^^^^^^^^^^^^^^^
|
|
|
|
The ``v140`` toolset that comes with Visual Studio 14 2015 is selected by
|
|
default. The :variable:`CMAKE_GENERATOR_TOOLSET` option may be set, perhaps
|
|
via the :manual:`cmake(1)` ``-T`` option, to specify another toolset.
|
|
|
|
.. |VS_TOOLSET_HOST_ARCH_DEFAULT| replace::
|
|
By default this generator uses the 32-bit variant even on a 64-bit host.
|
|
|
|
.. include:: VS_TOOLSET_HOST_ARCH.txt
|
|
|
|
.. _`Windows 10 SDK Maximum Version for VS 2015`:
|
|
|
|
Windows 10 SDK Maximum Version for VS 2015
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
Microsoft stated in a "Windows 10 October 2018 Update" blog post that Windows
|
|
10 SDK versions (15063, 16299, 17134, 17763) are not supported by VS 2015 and
|
|
are only supported by VS 2017 and later. Therefore by default CMake
|
|
automatically ignores Windows 10 SDKs beyond ``10.0.14393.0``.
|
|
|
|
However, there are other recommendations for certain driver/Win32 builds that
|
|
indicate otherwise. A user can override this behavior by either setting the
|
|
:variable:`CMAKE_VS_WINDOWS_TARGET_PLATFORM_VERSION_MAXIMUM` to a false value
|
|
or setting the :variable:`CMAKE_VS_WINDOWS_TARGET_PLATFORM_VERSION_MAXIMUM` to
|
|
the string value of the required maximum (e.g. ``10.0.15063.0``).
|