Visual Studio 15 2017.rst 1.3 KB

12345678910111213141516171819202122232425262728293031323334353637
  1. Visual Studio 15 2017
  2. ---------------------
  3. Generates Visual Studio 15 (VS 2017) project files.
  4. The :variable:`CMAKE_GENERATOR_PLATFORM` variable may be set
  5. to specify a target platform name (architecture).
  6. For compatibility with CMake versions prior to 3.1, one may specify
  7. a target platform name optionally at the end of this generator name:
  8. ``Visual Studio 15 2017 Win64``
  9. Specify target platform ``x64``.
  10. ``Visual Studio 15 2017 ARM``
  11. Specify target platform ``ARM``.
  12. Instance Selection
  13. ^^^^^^^^^^^^^^^^^^
  14. VS 2017 supports multiple installations on the same machine.
  15. CMake queries the Visual Studio Installer to locate VS instances.
  16. If more than one instance is installed we do not define which one
  17. is chosen by default. If the ``VS150COMNTOOLS`` environment variable
  18. is set and points to the ``Common7/Tools`` directory within one of
  19. the instances, that instance will be used. The environment variable
  20. must remain consistently set whenever CMake is re-run within a given
  21. build tree.
  22. Toolset Selection
  23. ^^^^^^^^^^^^^^^^^
  24. The ``v141`` toolset that comes with Visual Studio 15 2017 is selected by
  25. default. The :variable:`CMAKE_GENERATOR_TOOLSET` option may be set, perhaps
  26. via the :manual:`cmake(1)` ``-T`` option, to specify another toolset.
  27. .. include:: VS_TOOLSET_HOST_ARCH.txt