多目录工程的CmakeLists.txt编写(自动添加多目录下的文件)

本文详细介绍如何使用CMakeLists.txt文件配置一个包含多个源文件的简单C/C++项目。项目由main.cpp调用hello.cpp和world.cpp中的函数实现。通过两种方式添加源文件:自动搜索目录与手动指定。此外,还介绍了如何设置头文件路径和链接库。

实现类似于vs中工程的CMakeLists.txt的编写。功能为main.cpp调用hello.cpp 的hello()函数,world.cpp的world()函数。使用自动添加多目录下的文件

1.工程目录如下

这里写图片描述

2.主函数main.cpp

#include <stdio.h>
#include "hello.h"
#include "world.h"
int main()
{
    hello();
    world();
    return 0;
}

3.顶层CMakeLists.txt

cmake_minimum_required(VERSION 2.8)
project(helloworld)

# Add the source in project root directory
aux_source_directory(. DIRSRCS)
# Add header file include directories
include_directories(./ ./hello ./world)
# Add block directories
add_subdirectory(hello)
add_subdirectory(world)
# Target
add_executable(helloworld ${DIRSRCS})
target_link_libraries(helloworld hello world)

4.hello文件夹

CMakeLists.txt

aux_source_directory(. DIR_HELLO_SRCS)
add_library(hello ${DIR_HELLO_SRCS})

hello.cpp

#include "hello.h"
void hello()
{
    printf("hello\n");
}

hello.h

#ifndef HELLO_H
#define HELLO_H
#include <stdio.h>
void hello();
#endif

5.world文件夹

CMakeLists.txt

aux_source_directory(. DIR_WORLD_SRCS)
add_library(world ${DIR_WORLD_SRCS})

world.cpp

#include "world.h"
void world()
{
    printf("world\n");
}

world.h

#ifndef WORLD_H
#define WORLD_H
#include <stdio.h>
void world();
#endif

6.手动添加目录下的文件顶层CMakeLists.txt

手动添加目录下的文件顶层CMakeLists.txt 如下:注意,下面方式手动添加的话要把子目录的CMakeList.txt删除掉。

cmake_minimum_required(VERSION 2.8.3)
project (helloworld)
# Add header file include directories
include_directories(./hello ./world)
# Add block directories
set(HELLO_SRC hello/hello.cpp)
set(WORLD_SRC world/world.cpp)
# Target
add_executable(helloworld main.cpp ${HELLO_SRC} ${WORLD_SRC})
在为包含个嵌套文件夹的大型项目编写 `CMakeLists.txt` 时,需要遵循模块化和可维护的设计原则。CMake 提供了灵活的机制来管理目录结构,包括使用 `add_subdirectory()`、`target_include_directories()` 和 `target_link_libraries()` 等命令。 ### 基本结构 通常,一个大型项目的 CMake 结构可以分为以下几个部分: 1. **根目录中的 `CMakeLists.txt`**:用于定义全局变量、编译器选项以及引入子模块。 2. **每个子目录中的 `CMakeLists.txt`**:负责定义该目录下的目标(如库或可执行文件)及其依赖关系。 #### 根目录示例 ```cmake cmake_minimum_required(VERSION 3.14) project(MyLargeProject VERSION 1.0 LANGUAGES CXX) # 设置默认构建类型为 Release if(NOT CMAKE_CONFIGURATION_TYPES AND NOT CMAKE_BUILD_TYPE) set(CMAKE_BUILD_TYPE "Release" CACHE STRING "Choose the type of build." FORCE) set_property(CACHE CMAKE_BUILD_TYPE PROPERTY STRINGS "Debug" "Release" "RelWithDebInfo") endif() # 添加目录 add_subdirectory(src) add_subdirectory(libs) ``` #### 子目录中的 `CMakeLists.txt` 示例 假设 `src/` 目录包含主程序,而 `libs/` 包含个库模块: ```cmake # src/CMakeLists.txt add_executable(myapp main.cpp) # 链接来自 libs 的库 target_link_libraries(myapp PRIVATE mylib) # 添加文件路径 target_include_directories(myapp PRIVATE ${PROJECT_SOURCE_DIR}/include) ``` ```cmake # libs/CMakeLists.txt add_subdirectory(mylib) ``` ```cmake # libs/mylib/CMakeLists.txt add_library(mylib STATIC mylib.cpp) # 导出头文件给其他模块使用 target_include_directories(mylib PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}) ``` ### 使用 `FetchContent` 或 `find_package` 引入外部依赖 对于第三方库,可以通过 `FetchContent` 下载并集成到项目中,或者使用 `find_package()` 查找系统已安装的库: ```cmake include_directories(${PROJECT_SOURCE_DIR}/external/include) FetchContent_Declare( googletest GIT_REPOSITORY https://github.com/google/googletest.git GIT_TAG release-1.11.0 ) FetchContent_MakeAvailable(googletest) ``` ### 配置支持与缓存变量 为了提高构建效率,可以利用 CMake 的缓存变量功能,避免重复配置: ```cmake option(ENABLE_TESTS "Build unit tests" ON) if(ENABLE_TESTS) enable_testing() add_subdirectory(tests) endif() ``` ### 模块化设计与命名空间 对于非常大的项目,建议使用命名空间来组织目标名称,防止命名冲突。例如: ```cmake add_library(myproject::utilities STATIC utils.cpp) target_include_directories(myproject::utilities PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}) ``` 这样可以在其他模块中以 `myproject::utilities` 的形式引用该库。 ### 完整性与可扩展性 确保所有源文件都通过 `target_sources()` 明确添加到目标中,并使用 `file(GLOB ...)` 谨慎处理自动扫描源文件的方式。显式列出源文件有助于版本控制和构建稳定性[^2]。 此外,合理使用 `configure_file()` 来生成配置头文件,将构建信息注入到代码中,提升跨平台兼容性。 ---
评论 3
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

火星机器人life

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值