13.1 使用 CMake 构建 Visual Studio 2017 项目

发布于 2025-05-06 21:46:01 字数 4888 浏览 0 评论 0 收藏

NOTE : 此示例代码可以在 https://github.com/dev-cafe/cmake-cookbook/tree/v1.0/chapter-13/recipe-01 中找到，其中包含一个 C++示例。该示例在 CMake 3.5 版（或更高版本) 中是有效的，并且已经在 GNU/Linux、macOS 和 Windows 上进行过测试。

早期版本的 Visual Studio 要求开发人员在不同的 Windows 版本中编辑源代码并运行 CMake 命令，但 Visual Studio 2017 引入了对 CMake 项目的内置支持( https://aka.ms/cmake )，它允许在同一个 IDE 中发生整个编码、配置、构建和测试工作流。本示例中，不需要使用命令行，我们将直接使用 Visual Studio 2017 构建一个简单的“hello world”CMake 示例项目。

准备工作

首先，下载并安装 Visual Studio Community 2017 ( https://www.visualstudio.com/downloads/ )。在撰写本文时，这个版本是免费的，有 30 天的试用期。我们将遵循的视频中的步骤: https://www.youtube.com/watch?v=_lKxJjV8r3Y

运行安装程序时，在左侧面板上选择 Desktop development with C++ ，并在右侧的 Summary 面板上选择用于 CMake 的 Visual C++工具：

Visual Studio 2017 15.4 中，还可以为 Linux 平台进行构建。为此，在工具集中选择 Linux development with C++ :

选择后，只要配置 Linux 服务器的访问权限，就可以从 Visual Studio 中同时对 Windows 和 Linux 机器进行构建。我们不在本章中演示这种方法。

这个示例中，我们将在 Windows 上构建一个二进制文件，我们的目标是配置和构建以下示例代码( hello-world.cpp )：

#include <cstdlib>
#include <iostream>
#include <string>
const std::string cmake_system_name = SYSTEM_NAME;
int main() {
  std::cout << "Hello from " << cmake_system_name << std::endl;

  return EXIT_SUCCESS;
}

具体实施

创建相应的源码：

创建一个目录，并将 hello-world.cpp 放在新目录中。

目录中，创建一个 CMakeLists.txt 文件，其内容为:

# set minimum cmake version
cmake_minimum_required(VERSION 3.5 FATAL_ERROR)

# project name and language
project(recipe-01 LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 11)
set(CMAKE_CXX_EXTENSIONS OFF)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

include(GNUInstallDirs)
set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY
  ${CMAKE_BINARY_DIR}/${CMAKE_INSTALL_LIBDIR})
set(CMAKE_LIBRARY_OUTPUT_DIRECTORY
  ${CMAKE_BINARY_DIR}/${CMAKE_INSTALL_LIBDIR})
set(CMAKE_RUNTIME_OUTPUT_DIRECTORY
  ${CMAKE_BINARY_DIR}/${CMAKE_INSTALL_BINDIR})

# define executable and its source file
add_executable(hello-world hello-world.cpp)

# we will print the system name in the code
target_compile_definitions(hello-world
  PUBLIC
    "SYSTEM_NAME=\"${CMAKE_SYSTEM_NAME}\""
  )

install(
  TARGETS
    hello-world
  DESTINATION
    ${CMAKE_INSTALL_BINDIR}
  )

打开 Visual Studio 2017，然后通过下面的 File ->Open -> Folder ，选择到新创建的包含源文件和 CMakeLists.txt 的文件夹下。
打开文件夹后，请注意 CMake 配置步骤是如何运行的（面板底部)：
现在，可以右键单击 CMakeLists.txt (右面板)，并选择 Build :
构建项目（参见底部面板上的输出):
这就成功地编译了可执行文件。下一小节中，我们将学习如何定位可执行文件，并更改构建和安装路径。