| Visual Studio 15 2017 |
| --------------------- |
| |
| .. versionadded:: 3.7.1 |
| |
| Generates Visual Studio 15 (VS 2017) project files. |
| |
| Project Types |
| ^^^^^^^^^^^^^ |
| |
| 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. |
| |
| Instance Selection |
| ^^^^^^^^^^^^^^^^^^ |
| |
| .. versionadded:: 3.11 |
| |
| VS 2017 supports multiple installations on the same machine. The |
| :variable:`CMAKE_GENERATOR_INSTANCE` variable may be used to select one. |
| |
| Platform Selection |
| ^^^^^^^^^^^^^^^^^^ |
| |
| The default target platform name (architecture) is ``Win32``. |
| |
| The :variable:`CMAKE_GENERATOR_PLATFORM` variable may be set, perhaps |
| via the :option:`cmake -A` option, to specify a target platform |
| 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``. |
| |
| 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 |
| via the :option:`cmake -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_LEGACY.txt |
