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

How to use modern cmake for this project

本文关键字:cmake 项目      更新时间:2023-10-16

一段时间以来,我在将现代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链接到所有include,其中一些include应该知道其他include的存在,这意味着我应该能够将match.h包含在database.h。一些第三方库也将被使用,在这种情况下,我使用的是portaudio,下载和安装使用externalproject_add,它应该只对包含库的include可见,在这种情形下,record应该只看到这个。

但我应该如何定义个人CMakeList,目前还不清楚。

我已经在网上搜索了一个合适的设置方法,但似乎找不到一个我能理解的。

如何定义该项目的CMakeList,如何确保includes对Main.cpp和需要它们的includes文件可见,以及如何使第三方库仅对正在使用的includes可见。

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

您可以使用target_include_directories的PRIVATE属性。当PRIVATE时,这意味着include目录将可用于目标的源。当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文件中的子目录。

首先,您不链接到include,只需在编译过程中"include"它们。

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

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

只有一个CMakeList.txt文件可以更容易地启动,但如果项目变得庞大,事情就会变得一团糟。

对于每个编译单元,您可以使用target_include_directions 指定include目录