3952228fe905b321681a7164b2abca5665710e2b
[platform/upstream/cmake.git] / Help / generator / Visual Studio 11 2012.rst
1 Visual Studio 11 2012
2 ---------------------
3
4 Generates Visual Studio 11 (VS 2012) project files.
5
6 For compatibility with CMake versions prior to 3.0, one may specify this
7 generator using the name "Visual Studio 11" 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 Database, Website, 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 11 2012" -A Win32``
27   * ``cmake -G "Visual Studio 11 2012" -A x64``
28   * ``cmake -G "Visual Studio 11 2012" -A ARM``
29   * ``cmake -G "Visual Studio 11 2012" -A <WinCE-SDK>``
30     (Specify a target platform matching a Windows CE SDK name.)
31
32 For compatibility with CMake versions prior to 3.1, one may specify
33 a target platform name optionally at the end of the generator name.
34 This is supported only for:
35
36 ``Visual Studio 11 2012 Win64``
37   Specify target platform ``x64``.
38
39 ``Visual Studio 11 2012 ARM``
40   Specify target platform ``ARM``.
41
42 ``Visual Studio 11 2012 <WinCE-SDK>``
43   Specify target platform matching a Windows CE SDK name.
44
45 Toolset Selection
46 ^^^^^^^^^^^^^^^^^
47
48 The ``v110`` toolset that comes with Visual Studio 11 2012 is selected by
49 default.  The :variable:`CMAKE_GENERATOR_TOOLSET` option may be set, perhaps
50 via the :manual:`cmake(1)` ``-T`` option, to specify another toolset.