c++ - Visual Studio 2017 的 CMake 多项目设置

Question

首先，我是 CMake 新手。

我想做的是从直接在 VS 2017 中编译我的解决方案切换到 CMake，以便在 Linux 等其他平台上轻松构建项目。

文件夹结构:

project
  |─── CMakeLists.txt
  |─── bin
  |     | ─── intermediates
  |     |       |─── Win32
  |     |       |      |─── Debug
  |     |       |      └─── Release
  |     |       └─── Linux
  |     |              |─── Debug
  |     |              └─── Release
  |     |─── Win32
  |     |      |─── Debug
  |     |      └─── Release
  |     └─── Linux
  |            |─── Debug
  |            └─── Release
  |─── include
  |─── Project 1
  |      |─── CMakeLists.txt
  |      |─── src
  |      |─── res
  |      └─── header
  └─── Project 2
         |─── CMakeLists.txt
         |─── src
         |─── res
         └─── header

CMake 文件

这是我的 CMakeLists，第一个用于根项目，第二个用于第一个项目和第二个项目:

# Specify the minimum version for CMake
cmake_minimum_required(VERSION 3.8.2)

# Project's name
project(Project X)

# Set the C++ Version
message("!REQUIRED! -- Supported features = ${cxx_std_14}")
message("Supported features = ${cxx_std_17}")

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

# Set the output folder where the program will be created

set(CMAKE_BINARY_DIR ${CMAKE_SOURCE_DIR}/bin)
set(EXECUTABLE_OUTPUT_PATH ${CMAKE_BINARY_DIR})
set(LIBRARY_OUTPUT_PATH ${CMAKE_BINARY_DIR})

# Add the modules
add_subdirectory(Project 1)
add_subdirectory(Project 2) # depends on Project 1

第一个和第二个项目的CMakeLists.txt，因为文件的内容是一样的:

# Specify the minimum version for CMake
cmake_minimum_required(VERSION 3.8.2)

project(Project 1)

# In order to find all cpp files automatically for compilation
file(GLOB CPP_FILES src/*.cpp)
file(GLOB CPP_FILES header/*.h)

# Set the version number of the project here
set(VERSION_MAJOR "0")
set(VERSION_MINOR "1")
set(VERSION_PATCH "0")
set(VERSION ${VERSION_MAJOR}.${VERSION_MINOR}.${VERSION_PATCH})

这是我的 VS 设置:

Output Directory:       $(SolutionDir)bin\$(Platform)\$(Configuration)\
Intermediate Directory: $(SolutionDir)bin\intermediates\$(Platform)\$(Configuration)\

在这种情况下，项目 B 是可执行文件，而项目 A 只是一个库，必须链接到项目 B 才能编译项目 B。

问题:

• 如何将这些 Visual Studio 2017 设置应用到 CMake？ (我如何配置 CMAKE_BINARY_DIR 设置等)
• 项目 2 依赖于项目 1，CMake 会自动处理这个问题还是我必须向 CMakeLists.txt 添加一些内容？

Answer 1

有多个点需要解决:

1. CMAKE_BINARY_DIR 出于所有意图和目的，是一个只读变量，绝对应该这样对待。指定二进制目录的方法是在该目录中运行 CMake(当从命令行运行时)，或将该目录设置为二进制/输出目录(当使用 CMake GUI 时)。所以在你的情况下，为了实现你声称你想要的设置，你会这样做:

   > cd project/bin
   > cmake .. -G "Visual Studio whatever" ...
   

   (“whatever”当然是占位符)

   但是，我强烈建议您不要使用这样的布局。一个更好的布局将是一个纯粹的源代码之外的构建，就像这样:

   project
   project/source/CMakeLists.txt
   project/source/include
   project/source/...
   project/build/Win32
   project/build/Linux
   

   使用此设置，您将像这样运行:

   > cd project/build/Win32
   > cmake ../../source -G "Visual Studio whatever" ...
   

2. 您在 CMake 中设置二进制输出路径的方式与您作为“VS 设置”呈现的内容之间存在冲突。我不知道哪个是你的预期状态，但如果你想设置 CMake 以便你的二进制文件最终出现在你在 VS 设置中列出的输出目录中，你可以这样做:

   set(EXECUTABLE_OUTPUT_PATH ${CMAKE_BINARY_DIR}/${CMAKE_CFG_INTDIR})
   

   LIBRARY_OUTPUT_PATH 也是如此。

3. 就设置中间目录而言，这是 CMake 自行管理的内容，您无法真正影响它。不过，问题是您为什么要这么做。

4. 关于项目依赖性:您没有显示实际创建二进制文件的 CMake 命令(add_library()/add_executable())或设置的命令上他们的属性。但是，如果您指定项目 2 创建的可执行文件链接到项目 1 创建的库，CMake 将正确跟踪依赖关系。您可以这样指定它:

   target_link_libraries(targetNameOfProject2executable targetNameOfProject1library)
   

5. 请注意，使用 file(GLOB) 构建源文件列表是个坏主意，CMake 不鼓励这样做。原因很简单:添加源文件不会导致构建系统重新生成，这意味着源文件不会被拾取。如果您改为显式列出源文件，添加该文件将意味着您必须将其添加到 CMakeList 的列表(或它包含的文件中)，这将触发构建系统的重新生成。

   <

6. 针对 Linux 的注意事项:与 Visual Studio 不同，Makefile 生成器(实际上是 CMake 的大多数生成器)是单一配置，这意味着您必须为每个配置生成构建系统。在 out-of-souce 设置中，您可以这样做:

   > cd project/build/Linux/Debug
   > cmake ../../../../source -DCMAKE_BUILD_TYPE=Debug ...
   > cd project/build/Linux/Release
   > cmake ../../../../source -DCMAKE_BUILD_TYPE=Release ...