Help/generator/Visual Studio 11 2012.rst

   1 Visual Studio 11 2012
   2 ---------------------
   3
   4 Deprecated.  Generates Visual Studio 11 (VS 2012) project files.
   5
   6 .. note::
   7   This generator is deprecated and will be removed in a future version
   8   of CMake.  It will still be possible to build with VS 11 2012 tools
   9   using the :generator:`Visual Studio 12 2013` (or above) generator
  10   with :variable:`CMAKE_GENERATOR_TOOLSET` set to ``v110``, or by
  11   using the :generator:`NMake Makefiles` generator.
  12
  13 For compatibility with CMake versions prior to 3.0, one may specify this
  14 generator using the name "Visual Studio 11" without the year component.
  15
  16 Project Types
  17 ^^^^^^^^^^^^^
  18
  19 Only Visual C++ and C# projects may be generated (and Fortran with
  20 Intel compiler integration).  Other types of projects (JavaScript,
  21 Database, Website, etc.) are not supported.
  22
  23 Platform Selection
  24 ^^^^^^^^^^^^^^^^^^
  25
  26 The default target platform name (architecture) is ``Win32``.
  27
  28 .. versionadded:: 3.1
  29   The :variable:`CMAKE_GENERATOR_PLATFORM` variable may be set, perhaps
  30   via the :option:`cmake -A` option, to specify a target platform
  31   name (architecture).  For example:
  32
  33   * ``cmake -G "Visual Studio 11 2012" -A Win32``
  34   * ``cmake -G "Visual Studio 11 2012" -A x64``
  35   * ``cmake -G "Visual Studio 11 2012" -A ARM``
  36   * ``cmake -G "Visual Studio 11 2012" -A <WinCE-SDK>``
  37     (Specify a target platform matching a Windows CE SDK name.)
  38
  39 For compatibility with CMake versions prior to 3.1, one may specify
  40 a target platform name optionally at the end of the generator name.
  41 This is supported only for:
  42
  43 ``Visual Studio 11 2012 Win64``
  44   Specify target platform ``x64``.
  45
  46 ``Visual Studio 11 2012 ARM``
  47   Specify target platform ``ARM``.
  48
  49 ``Visual Studio 11 2012 <WinCE-SDK>``
  50   Specify target platform matching a Windows CE SDK name.
  51
  52 Toolset Selection
  53 ^^^^^^^^^^^^^^^^^
  54
  55 The ``v110`` toolset that comes with Visual Studio 11 2012 is selected by
  56 default.  The :variable:`CMAKE_GENERATOR_TOOLSET` option may be set, perhaps
  57 via the :option:`cmake -T` option, to specify another toolset.