2016-12-03 23:28:24 +01:00
|
|
|
Visual Studio 15 2017
|
|
|
|
|
---------------------
|
2016-10-30 18:24:19 +01:00
|
|
|
|
2021-09-14 00:13:48 +02:00
|
|
|
.. versionadded:: 3.7.1
|
|
|
|
|
|
2016-12-03 23:28:24 +01:00
|
|
|
Generates Visual Studio 15 (VS 2017) project files.
|
2016-10-30 18:24:19 +01:00
|
|
|
|
2018-10-28 12:09:07 +01:00
|
|
|
Project Types
|
|
|
|
|
^^^^^^^^^^^^^
|
2016-10-30 18:24:19 +01:00
|
|
|
|
2021-09-14 00:13:48 +02:00
|
|
|
Only Visual C++ and C# projects may be generated (and Fortran with
|
|
|
|
|
Intel compiler integration). Other types of projects (JavaScript,
|
|
|
|
|
Powershell, Python, etc.) are not supported.
|
2017-04-14 19:02:05 +02:00
|
|
|
|
2017-07-20 19:35:53 +02:00
|
|
|
Instance Selection
|
|
|
|
|
^^^^^^^^^^^^^^^^^^
|
|
|
|
|
|
2021-09-14 00:13:48 +02:00
|
|
|
.. versionadded:: 3.11
|
2021-11-20 13:41:27 +01:00
|
|
|
|
2022-03-29 21:10:50 +02:00
|
|
|
VS 2017 supports multiple installations on the same machine. The
|
|
|
|
|
:variable:`CMAKE_GENERATOR_INSTANCE` variable may be used to select one.
|
2017-07-20 19:35:53 +02:00
|
|
|
|
2018-10-28 12:09:07 +01:00
|
|
|
Platform Selection
|
|
|
|
|
^^^^^^^^^^^^^^^^^^
|
|
|
|
|
|
2019-11-11 23:01:05 +01:00
|
|
|
The default target platform name (architecture) is ``Win32``.
|
|
|
|
|
|
2018-10-28 12:09:07 +01:00
|
|
|
The :variable:`CMAKE_GENERATOR_PLATFORM` variable may be set, perhaps
|
2022-11-16 20:14:03 +01:00
|
|
|
via the :option:`cmake -A` option, to specify a target platform
|
2018-10-28 12:09:07 +01:00
|
|
|
name (architecture). For example:
|
|
|
|
|
|
|
|
|
|
* ``cmake -G "Visual Studio 15 2017" -A Win32``
|
|
|
|
|
* ``cmake -G "Visual Studio 15 2017" -A x64``
|
|
|
|
|
* ``cmake -G "Visual Studio 15 2017" -A ARM``
|
|
|
|
|
* ``cmake -G "Visual Studio 15 2017" -A ARM64``
|
|
|
|
|
|
|
|
|
|
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 15 2017 Win64``
|
|
|
|
|
Specify target platform ``x64``.
|
|
|
|
|
|
|
|
|
|
``Visual Studio 15 2017 ARM``
|
|
|
|
|
Specify target platform ``ARM``.
|
|
|
|
|
|
2017-04-14 19:02:05 +02:00
|
|
|
Toolset Selection
|
|
|
|
|
^^^^^^^^^^^^^^^^^
|
|
|
|
|
|
|
|
|
|
The ``v141`` toolset that comes with Visual Studio 15 2017 is selected by
|
|
|
|
|
default. The :variable:`CMAKE_GENERATOR_TOOLSET` option may be set, perhaps
|
2022-11-16 20:14:03 +01:00
|
|
|
via the :option:`cmake -T` option, to specify another toolset.
|
2017-04-14 19:02:05 +02:00
|
|
|
|
2019-11-11 23:01:05 +01:00
|
|
|
.. |VS_TOOLSET_HOST_ARCH_DEFAULT| replace::
|
|
|
|
|
By default this generator uses the 32-bit variant even on a 64-bit host.
|
|
|
|
|
|
2021-09-14 00:13:48 +02:00
|
|
|
.. include:: VS_TOOLSET_HOST_ARCH_LEGACY.txt
|
