如何在这个项目中使用现代 cmake

Question

一段时间以来，我在将现代 cmake 整合到我一直在工作的项目中时遇到了一些问题，并且似乎被困在如何定义单个 CMakeList 和顶级 CMakeList 上。

我的项目结构非常简单。

├── build
└── src
    ├── include
    │   ├── database
    │   │   ├── database.cpp
    │   │   └── database.h
    │   ├── match
    │   │   ├── match.h
    │   │   └── mathc.cpp
    │   ├── record
    │   │   ├── lib
    │   │   ├── record.cpp
    │   │   └── record.h
    │   └── spectogram
    │       ├── spectogram.cpp
    │       └── spectrogram.h
    └── main.cpp

main.cpp 链接到所有包含，并且一些包含应该知道其他包含的存在，意思是，我应该能够包含match.h database.h。一些第三方库也将被使用，在这种情况下，我使用的是 portaudio，使用 externalproject_add 下载和安装，它应该只对包含库的包含可见，在这种情况下 record，应该只看到这个。

但我应该如何定义单个 CMakeList，目前尚不清楚。

我已经在网上搜寻了一种正确的设置方法，但似乎找不到我理解的方法。

如何为该项目定义 CMakeLists，如何确保包含对 Main.cpp 和需要它们的包含文件可见，以及如何使第三方库仅可见用于包含它的内容。

CMakeLists 示例结构尝试： CMakeLists.txt

cmake_minimum_required(VERSION 3.2)
project(soundcloud)
#add_subdirectory(src/database)
#add_subdirectory(src/match)
#add_subdirectory(src/record)
add_subdirectory(src/include/spectogram)

add_executable(cmakeDemo src/main.cpp)
SET_TARGET_PROPERTIES(cmakeDemo PROPERTIES LINKER_LANGUAGE Cxx)
target_link_libraries(cmakeDemo spectogram)
#target_link_libraries(cmakeDemo database match record spectogram)

src/include/database/CMakeLists.txt

add_library(spectogram STATIC .)
target_include_directories(spectogram PUBLIC .)

收到错误消息：

CMake Error: Error required internal CMake variable not set, cmake may not be built correctly.
Missing variable is:
CMAKE_Cxx_LINK_EXECUTABLE
CMake Error: Cannot determine link language for target "spectogram".
CMake Error: CMake can not determine linker language for target: spectogram

Answer 1

您可以使用target_include_directories 的PRIVATE 属性。当 PRIVATE 时，这意味着包含目录将可用于目标的源。当 PUBLIC 时，链接到目标的任何人都可以使用它。

如果我在单个 CMakeLists.txt 中编写此内容，我会这样做：

cmake_minimum_required(VERSION 3.0)

add_library(database STATIC src/include/database.cpp)
target_include_directories(database PUBLIC src/include/database)

################
add_library(match STATIC src/include/mathc.cpp)
target_include_directories(match PUBLIC src/include/match)

################
include(ExternalProject)
ExternalProject_Add(portAudio ${SomeCommands})

add_library(record STATIC src/include/record.cpp)
target_include_directories(record PUBLIC src/include/record)  # When cmakeDemo links to this, it'll get these includes
target_include_directories(record PRIVATE src/include/record/lib)   # When cmakeDemo links to this, it won't get these includes
target_link_libraries(record portAudio)

#################
add_library(spectogram STATIC src/include/spectogram.cpp)
target_include_directories(spectogram PUBLIC src/include/spectogram)

##################
add_executable(cmakeDemo src/main.cpp)
target_link_libraries(cmakeDemo database match record spectogram)

如果我要使用分布式 CMakeLists.txt 执行此操作，我会拆分 ###### 行所在的文件，修复路径，并使用 add_subdirectory() 包含来自更高级别 cmake 文件的子目录.

Answer 2

首先，您不链接到包含，您只是在编译期间“包含”它们。

有些人在每个包含相当独立的编译单元的目录中都放了一个CMakeList.txt。

有些人只在顶部使用一个大的。

只有一个 CMakeList.txt 文件更容易开始，但如果项目变得庞大，事情就会变得一团糟。

对于每个编译单元，您可以使用 target_include_directories 指定包含目录