Help/generator/Visual Studio 12 2013.rst

   1 Visual Studio 12 2013
   2 ---------------------
   3
   4 Generates Visual Studio 12 (VS 2013) project files.
   5
   6 For compatibility with CMake versions prior to 3.0, one may specify this
   7 generator using the name "Visual Studio 12" without the year component.
   8
   9 Project Types
  10 ^^^^^^^^^^^^^
  11
  12 Only Visual C++ and C# projects may be generated (and Fortran with
  13 Intel compiler integration).  Other types of projects (JavaScript,
  14 Powershell, Python, etc.) are not supported.
  15
  16 Platform Selection
  17 ^^^^^^^^^^^^^^^^^^
  18
  19 The default target platform name (architecture) is ``Win32``.
  20
  21 .. versionadded:: 3.1
  22   The :variable:`CMAKE_GENERATOR_PLATFORM` variable may be set, perhaps
  23   via the :manual:`cmake(1)` ``-A`` option, to specify a target platform
  24   name (architecture).  For example:
  25
  26   * ``cmake -G "Visual Studio 12 2013" -A Win32``
  27   * ``cmake -G "Visual Studio 12 2013" -A x64``
  28   * ``cmake -G "Visual Studio 12 2013" -A ARM``
  29
  30 For compatibility with CMake versions prior to 3.1, one may specify
  31 a target platform name optionally at the end of the generator name.
  32 This is supported only for:
  33
  34 ``Visual Studio 12 2013 Win64``
  35   Specify target platform ``x64``.
  36
  37 ``Visual Studio 12 2013 ARM``
  38   Specify target platform ``ARM``.
  39
  40 Toolset Selection
  41 ^^^^^^^^^^^^^^^^^
  42
  43 The ``v120`` toolset that comes with Visual Studio 12 2013 is selected by
  44 default.  The :variable:`CMAKE_GENERATOR_TOOLSET` option may be set, perhaps
  45 via the :manual:`cmake(1)` ``-T`` option, to specify another toolset.
  46
  47 .. |VS_TOOLSET_HOST_ARCH_DEFAULT| replace::
  48    By default this generator uses the 32-bit variant even on a 64-bit host.
  49
  50 .. include:: VS_TOOLSET_HOST_ARCH_LEGACY.txt