# Visual Studio 14 2015

Deprecated since version 4.2: This generator is deprecated and will be removed in a future version of CMake. It will still be possible to build with VS 14 2015 tools using the `Visual Studio 15 2017` (or above) generator with `CMAKE_GENERATOR_TOOLSET` set to `v140`, or by using the `NMake Makefiles` generator.

Added in version 3.1.

Generates Visual Studio 14 (VS 2015) 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.

## Platform Selection

The default target platform name (architecture) is `Win32`.

The `CMAKE_GENERATOR_PLATFORM` variable may be set, perhaps via the `cmake -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`

Changed in version 4.0: Previously, for compatibility with CMake versions prior to 3.1, one could specify a target platform name optionally at the end of the generator name. This has been removed. This was 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 `CMAKE_GENERATOR_TOOLSET` option may be set, perhaps via the `cmake -T` option, to specify another toolset.

Added in version 3.8: For each toolset that comes with this version of Visual Studio, there are variants that are themselves compiled for 32-bit (`x86`) and 64-bit (`x64`) hosts (independent of the architecture they target). By default this generator uses the 32-bit variant even on a 64-bit host. One may explicitly request use of either the 32-bit or 64-bit host tools by adding either `host=x86` or `host=x64` to the toolset specification. See the `CMAKE_GENERATOR_TOOLSET` variable for details.

Added in version 3.14: Added support for `host=x86` option.

## Windows 10 SDK Maximum Version for VS 2015

Added in version 3.19.

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 `CMAKE_VS_WINDOWS_TARGET_PLATFORM_VERSION_MAXIMUM` to a false value or setting the `CMAKE_VS_WINDOWS_TARGET_PLATFORM_VERSION_MAXIMUM` to the string value of the required maximum (e.g. `10.0.15063.0`).