4 .. versionadded:: 3.7.1
6 Generates Visual Studio 15 (VS 2017) project files.
11 Only Visual C++ and C# projects may be generated (and Fortran with
12 Intel compiler integration). Other types of projects (JavaScript,
13 Powershell, Python, etc.) are not supported.
18 .. versionadded:: 3.11
20 VS 2017 supports multiple installations on the same machine. The
21 :variable:`CMAKE_GENERATOR_INSTANCE` variable may be used to select one.
26 The default target platform name (architecture) is ``Win32``.
28 The :variable:`CMAKE_GENERATOR_PLATFORM` variable may be set, perhaps
29 via the :manual:`cmake(1)` ``-A`` option, to specify a target platform
30 name (architecture). For example:
32 * ``cmake -G "Visual Studio 15 2017" -A Win32``
33 * ``cmake -G "Visual Studio 15 2017" -A x64``
34 * ``cmake -G "Visual Studio 15 2017" -A ARM``
35 * ``cmake -G "Visual Studio 15 2017" -A ARM64``
37 For compatibility with CMake versions prior to 3.1, one may specify
38 a target platform name optionally at the end of the generator name.
39 This is supported only for:
41 ``Visual Studio 15 2017 Win64``
42 Specify target platform ``x64``.
44 ``Visual Studio 15 2017 ARM``
45 Specify target platform ``ARM``.
50 The ``v141`` toolset that comes with Visual Studio 15 2017 is selected by
51 default. The :variable:`CMAKE_GENERATOR_TOOLSET` option may be set, perhaps
52 via the :manual:`cmake(1)` ``-T`` option, to specify another toolset.
54 .. |VS_TOOLSET_HOST_ARCH_DEFAULT| replace::
55 By default this generator uses the 32-bit variant even on a 64-bit host.
57 .. include:: VS_TOOLSET_HOST_ARCH_LEGACY.txt