CMake add_subdirectory

简介

add_subdirectory 是 CMake 命令之一，用于在当前 CMakeLists.txt 文件中引入另一个子目录的 CMake 构建。这样，你可以在一个项目中组织多个子项目或子模块的构建。

基本语法

基本的语法是：

add_subdirectory(path/to/another_directory)

这里的 path/to/another_directory 是要包含的子目录的路径。这个命令会让 CMake 去处理指定路径下的 CMakeLists.txt 文件，以构建和配置该子目录的内容。

举例

目录结构

project_root/
|-- CMakeLists.txt
|-- src/
|   |-- main.cpp
|-- include/
|   |-- my_library/
|       |-- header1.h
|-- subproject/
|   |-- CMakeLists.txt
|   |-- sub_main.cpp

根目录CMakeLists

在 project_root/CMakeLists.txt 中，可以使用 add_subdirectory 引入 subproject：

# project_root/CMakeLists.txt

# 指定项目名称
project(YourProjectName)

# 创建你的目标
add_executable(your_target_name src/main.cpp)

# 引入子目录
add_subdirectory(subproject)

# 链接到子目录中的目标（如果有的话）
target_link_libraries(your_target_name PRIVATE subproject_target)

子目录CMakeLists

在 subproject/CMakeLists.txt 中，你可以定义和构建子目录的内容：

# subproject/CMakeLists.txt

# 子目录中的项目
add_library(subproject_target sub_main.cpp)

# 设置子目录的头文件目录
target_include_directories(subproject_target PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/../include)

在这个例子中，add_subdirectory 用于将 subproject 目录引入到 project_root 的构建中。

这样，你就可以在一个项目中管理多个子项目或模块，并且它们之间可以共享头文件和库。