Acasă Explorează Ajutor
Înregistrare Autentificare
Apq
/
CMake
oglindă de https://github.com/Kitware/CMake.git
1
0
Bifurcare 0
Fisiere Probleme 0 Wiki
Arbore: c46b265839
Ramuri Etichete
CMake
/
Help
/
generator
/
Visual Studio 17 2022.rst

Visual Studio 17 2022.rst 2.1 KB
Istoric Crud

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061 
  1. Visual Studio 17 2022
    2. 

  2. ---------------------
    3. 

  3. 

  4. .. versionadded:: 3.21
    5. 

  5. 

  6. Generates Visual Studio 17 (VS 2022) project files.
    7. 

  7. 

  8. .. warning::
    9. 

  9. 

  10.   This is experimental and based on "Visual Studio 2022 Preview 1.1".
    11. 

  11.   As of this version of CMake, VS 2022 has not been released.
    12. 

  12. 

  13. Project Types
    14. 

  14. ^^^^^^^^^^^^^
    15. 

  15. 

  16. Only Visual C++ and C# projects may be generated.  Other types of
    17. 

  17. projects (JavaScript, Powershell, Python, etc.) are not supported.
    18. 

  18. 

  19. Instance Selection
    20. 

  20. ^^^^^^^^^^^^^^^^^^
    21. 

  21. 

  22. VS 2022 supports multiple installations on the same machine.
    23. 

  23. The :variable:`CMAKE_GENERATOR_INSTANCE` variable may be set as a
    24. 

  24. cache entry containing the absolute path to a Visual Studio instance.
    25. 

  25. If the value is not specified explicitly by the user or a toolchain file,
    26. 

  26. CMake queries the Visual Studio Installer to locate VS instances, chooses
    27. 

  27. one, and sets the variable as a cache entry to hold the value persistently.
    28. 

  28. 

  29. When CMake first chooses an instance, if the ``VS170COMNTOOLS`` environment
    30. 

  30. variable is set and points to the ``Common7/Tools`` directory within
    31. 

  31. one of the instances, that instance will be used.  Otherwise, if more
    32. 

  32. than one instance is installed we do not define which one is chosen
    33. 

  33. by default.
    34. 

  34. 

  35. Platform Selection
    36. 

  36. ^^^^^^^^^^^^^^^^^^
    37. 

  37. 

  38. The default target platform name (architecture) is that of the host
    39. 

  39. and is provided in the :variable:`CMAKE_VS_PLATFORM_NAME_DEFAULT` variable.
    40. 

  40. 

  41. The :variable:`CMAKE_GENERATOR_PLATFORM` variable may be set, perhaps
    42. 

  42. via the :manual:`cmake(1)` ``-A`` option, to specify a target platform
    43. 

  43. name (architecture).  For example:
    44. 

  44. 

  45. * ``cmake -G "Visual Studio 17 2022" -A Win32``
    46. 

  46. * ``cmake -G "Visual Studio 17 2022" -A x64``
    47. 

  47. * ``cmake -G "Visual Studio 17 2022" -A ARM``
    48. 

  48. * ``cmake -G "Visual Studio 17 2022" -A ARM64``
    49. 

  49. 

  50. Toolset Selection
    51. 

  51. ^^^^^^^^^^^^^^^^^
    52. 

  52. 

  53. The ``v142`` toolset that comes with VS 17 2022 Preview 1.1 is selected by
    54. 

  54. default.  The :variable:`CMAKE_GENERATOR_TOOLSET` option may be set, perhaps
    55. 

  55. via the :manual:`cmake(1)` ``-T`` option, to specify another toolset.
    56. 

  56. 

  57. .. |VS_TOOLSET_HOST_ARCH_DEFAULT| replace::
    58. 

  58.    By default this generator uses the 64-bit variant on x64 hosts and
    59. 

  59.    the 32-bit variant otherwise.
    60. 

  60. 

  61. .. include:: VS_TOOLSET_HOST_ARCH.txt
    62.