| Visual Studio 17 2022 |
| --------------------- |
| |
| .. versionadded:: 3.21 |
| |
| Generates Visual Studio 17 (VS 2022) project files. |
| |
| Project Types |
| ^^^^^^^^^^^^^ |
| |
| Only Visual C++ and C# projects may be generated (and Fortran with |
| Intel compiler integration). Other types of projects (JavaScript, |
| Powershell, Python, etc.) are not supported. |
| |
| Instance Selection |
| ^^^^^^^^^^^^^^^^^^ |
| |
| VS 2022 supports multiple installations on the same machine. |
| The :variable:`CMAKE_GENERATOR_INSTANCE` variable may be set as a |
| cache entry containing the absolute path to a Visual Studio instance. |
| If the value is not specified explicitly by the user or a toolchain file, |
| CMake queries the Visual Studio Installer to locate VS instances, chooses |
| one, and sets the variable as a cache entry to hold the value persistently. |
| |
| When CMake first chooses an instance, if the ``VS170COMNTOOLS`` environment |
| variable is set and points to the ``Common7/Tools`` directory within |
| one of the instances, that instance will be used. Otherwise, if more |
| than one instance is installed we do not define which one is chosen |
| by default. |
| |
| Platform Selection |
| ^^^^^^^^^^^^^^^^^^ |
| |
| The default target platform name (architecture) is that of the host |
| and is provided in the :variable:`CMAKE_VS_PLATFORM_NAME_DEFAULT` variable. |
| |
| The :variable:`CMAKE_GENERATOR_PLATFORM` variable may be set, perhaps |
| via the :manual:`cmake(1)` ``-A`` option, to specify a target platform |
| name (architecture). For example: |
| |
| * ``cmake -G "Visual Studio 17 2022" -A Win32`` |
| * ``cmake -G "Visual Studio 17 2022" -A x64`` |
| * ``cmake -G "Visual Studio 17 2022" -A ARM`` |
| * ``cmake -G "Visual Studio 17 2022" -A ARM64`` |
| |
| Toolset Selection |
| ^^^^^^^^^^^^^^^^^ |
| |
| The ``v143`` toolset that comes with VS 17 2022 is selected by default. |
| The :variable:`CMAKE_GENERATOR_TOOLSET` option may be set, perhaps |
| via the :manual:`cmake(1)` ``-T`` option, to specify another toolset. |
| |
| .. |VS_TOOLSET_HOST_ARCH_DEFAULT| replace:: |
| By default this generator uses the 64-bit variant on x64 hosts and |
| the 32-bit variant otherwise. |
| |
| .. include:: VS_TOOLSET_HOST_ARCH.txt |
