Visual Studio 14 2015.rst 2.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566
  1. Visual Studio 14 2015
  2. ---------------------
  3. .. versionadded:: 3.1
  4. Generates Visual Studio 14 (VS 2015) project files.
  5. Project Types
  6. ^^^^^^^^^^^^^
  7. Only Visual C++ and C# projects may be generated (and Fortran with
  8. Intel compiler integration). Other types of projects (JavaScript,
  9. Powershell, Python, etc.) are not supported.
  10. Platform Selection
  11. ^^^^^^^^^^^^^^^^^^
  12. The default target platform name (architecture) is ``Win32``.
  13. The :variable:`CMAKE_GENERATOR_PLATFORM` variable may be set, perhaps
  14. via the :manual:`cmake(1)` ``-A`` option, to specify a target platform
  15. name (architecture). For example:
  16. * ``cmake -G "Visual Studio 14 2015" -A Win32``
  17. * ``cmake -G "Visual Studio 14 2015" -A x64``
  18. * ``cmake -G "Visual Studio 14 2015" -A ARM``
  19. For compatibility with CMake versions prior to 3.1, one may specify
  20. a target platform name optionally at the end of the generator name.
  21. This is supported only for:
  22. ``Visual Studio 14 2015 Win64``
  23. Specify target platform ``x64``.
  24. ``Visual Studio 14 2015 ARM``
  25. Specify target platform ``ARM``.
  26. Toolset Selection
  27. ^^^^^^^^^^^^^^^^^
  28. The ``v140`` toolset that comes with Visual Studio 14 2015 is selected by
  29. default. The :variable:`CMAKE_GENERATOR_TOOLSET` option may be set, perhaps
  30. via the :manual:`cmake(1)` ``-T`` option, to specify another toolset.
  31. .. |VS_TOOLSET_HOST_ARCH_DEFAULT| replace::
  32. By default this generator uses the 32-bit variant even on a 64-bit host.
  33. .. include:: VS_TOOLSET_HOST_ARCH_LEGACY.txt
  34. .. _`Windows 10 SDK Maximum Version for VS 2015`:
  35. Windows 10 SDK Maximum Version for VS 2015
  36. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  37. .. versionadded:: 3.19
  38. Microsoft stated in a "Windows 10 October 2018 Update" blog post that Windows
  39. 10 SDK versions (15063, 16299, 17134, 17763) are not supported by VS 2015 and
  40. are only supported by VS 2017 and later. Therefore by default CMake
  41. automatically ignores Windows 10 SDKs beyond ``10.0.14393.0``.
  42. However, there are other recommendations for certain driver/Win32 builds that
  43. indicate otherwise. A user can override this behavior by either setting the
  44. :variable:`CMAKE_VS_WINDOWS_TARGET_PLATFORM_VERSION_MAXIMUM` to a false value
  45. or setting the :variable:`CMAKE_VS_WINDOWS_TARGET_PLATFORM_VERSION_MAXIMUM` to
  46. the string value of the required maximum (e.g. ``10.0.15063.0``).