视觉工作室 15 2017

在 3.7.1 版本加入.

生成 Visual Studio 15 (VS 2017) 项目文件。

项目类型

只能生成 Visual C++ 和 C# 项目(以及带有 Intel 编译器集成的 Fortran)。不支持其他类型的项目(JavaScript、Powershell、Python 等)。

实例选择

在 3.11 版本加入.

VS 2017 支持在同一台机器上安装多个。 CMAKE_GENERATOR_INSTANCE 变量可用于选择一个。

平台选择

默认的目标平台名称(架构)是 Win32

CMAKE_GENERATOR_PLATFORM 变量可以通过 cmake -A 选项设置,以指定目标平台名称(架构)。例如:

  • cmake -G "Visual Studio 15 2017" -A Win32

  • cmake -G "Visual Studio 15 2017" -A x64

  • cmake -G "Visual Studio 15 2017" -A ARM

  • cmake -G "Visual Studio 15 2017" -A ARM64

为了与 3.1 之前的 CMake 版本兼容,可以在生成器名称的末尾选择性地指定一个目标平台名称。这仅支持:

Visual Studio 15 2017 Win64

指定目标平台“x64”。

Visual Studio 15 2017 ARM

指定目标平台“ARM”。

工具集选择

默认选择 Visual Studio 15 2017 自带的“v141”工具集。 CMAKE_GENERATOR_TOOLSET 选项可以通过 cmake -T 选项设置,以指定另一个工具集。

在 3.8 版本加入: 对于这个版本的 Visual Studio 附带的每个工具集,都有自己为 32 位 (x86) 和 64 位 (x64) 主机编译的变体(独立于它们所针对的体系结构) . |VS_TOOLSET_HOST_ARCH_DEFAULT|可以通过在工具集规范中添加 host=x86host=x64 来明确请求使用 32 位或 64 位主机工具。有关详细信息,请参阅 CMAKE_GENERATOR_TOOLSET 变量。

在 3.14 版本加入: 添加了对 host=x86 选项的支持。