CMake：构建和安装本地存储的子模块

Question

Stack Overflow 上有很多类似的问题，但没有一个能回答我的问题。

我有一个使用 CMake 构建的 C++ 库：

mylib
| - CMakeLists.txt
| - src/
|   | - m.h
|   | - m.cpp
| - include/
|   | - mylib/
|   |   | - a.h
|   |   | - something/
|   |   |   | - some.h
| - cmake/
|   - mylibConfig.cmake.in
|   - mylibConfigVersion.cmake.in

然后我创建另一个包含上述库的库或可执行文件：

myapp
| - CMakeLists.txt
| - src/
|   | - main.cpp
| - include/
|   | - myapp/
|   |   | - b.h
| - libs
|   | - mylib

并且想像这样在myapp 中使用mylib。请注意mylib 标头是如何包含在类似格式的目录中的：

#include <mylib/a.h>
#include <mylib/something/some.h>

mylib 应在构建 myapp 时构建，以便以下工作无需任何其他构建步骤：

$ cd myapp/build
$ cmake ..
$ make

这是我查看过的一些 Stack Overflow 帖子的列表。我都尝试过，但它们根本不起作用：

• CMake: How to build external projects and include their targets
• CMake ExternalProject_Add() and FindPackage()

Answer 1

假设在所描述的项目中，只有mylib/include 目录中的头文件被认为是公开的：

mylib 的顶级 CMakeLists.txt 需要包含：

cmake_minimum_required(VERSION 3.13 FATAL_ERROR)
project(mylib VERSION 0.1 LANGUAGES CXX)

add_library(${MyLibName} ${MyLib_SOURCES})

target_include_directories(${MyLibName}
    PUBLIC
        $<INSTALL_INTERFACE:include>
        $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
    PRIVATE
        ${CMAKE_CURRENT_SOURCE_DIR}/src
)

这确保了包括mylib 在内的项目只能访问include/ 目录中的文件。 include/ 中的文件可以像#include <myfile.h> 一样使用，include/mylib（通用约定）中的文件可以像#include <mylib/myfile.h> 一样使用。

myapp 的顶级 CMakeLists.txt 应包括：

cmake_minimum_required(VERSION 3.13 FATAL_ERROR)
project(myapp VERSION 0.1 LANGUAGES CXX)

add_subdirectory(libs/mylib)

add_executable(${MyAppName} ${MyApp_SOURCES})
target_link_libraries(${MyAppName} ${MyLibName}

使用add_subdirectory 确保mylib 将在myapp 和target_link_libraries 将mylib 添加到可执行文件之前构建。

正如 Tzalumen 所述，请务必查看 CMake tutorials，并更喜欢使用 cmake --build . 而不是 make。

Answer 2

所以，我实际上是在我的一个项目中这样做的。

首先，需要使用 ADD_LIBRARY() 构建库，但我假设您这样做。像

库的 CMakeLists.txt 中的ADD_LIBRARY (${MyLibName} ${SOURCES})

这会将库添加到 cmake 的库列表中。

其次，使用

将库添加到您的项目中

target_link_libraries (${PROJECT_NAME} ${MyLibName}) 在可执行文件的 CMakeLists.txt 中，与您的 add_executable (${PROJECT_NAME} ${SOURCES}) 相同

这将设置依赖链以强制 MyLibName 在 PROJECT_NAME 之前显式构建。