cmake的使用方法: 将源文件组织到不同的目录

发布于:2024-05-04 ⋅ 阅读:(157) ⋅ 点赞:(0)

一.  简介

前面几篇文章学习了cmake工具针对单个 .c文件的编译方法。

cmake针对含有多个 .c文件的工程的使用编译。cmake工程编译是如何实现编译生成库文件。

本文学习一下另一种情况:当源文件组织到不同的目录下时,cmake工具该如何编译工程。

二.  cmake的使用方法:  将源文件组织到不同的目录

1.  工程目录

前面的多个.c文件的工程中,我们已经加入了多个源文件,但是这些源文件都是放在同一个目录下,这样还是不太正规。

我们应该将这些源文件按照类型、功能、模块给它们放置到不同的目录下,于是笔者将工程源码进行了整理。于是我这里将工程源码进行了整理,当前目录结构如下所示:

在工程目录下,我们创建了 src 和 libhello 目录,并将 hello.c 和 hello.h 文件移动到 libhello 目录下,将 main.c 文件移动到 src 目录下,并且在顶层目录、libhello 目录以及 src 目录下都有一个 CMakeLists.txt 文件。
CMakeLists.txt 文件的数量从 1 个一下变成了 3 个,顿时感觉到有点触不及防!还好每一个都不复杂!
我们来看看每一个 CMakeLists.txt 文件的内容。

(1) 顶层CMakeLists.txt 文件

顶层CMakeLists.txt 文件内容如下:

cmake_minimum_required(VERSION 3.16.3) #cmake版本号
project(HELLO)             #设置工程名
add_subdirectory(libhello) #告诉cmake,去子目录查找新的CMakeLists.txt并解析
add_subdirectory(src)      #告诉cmake,去子目录查找新的CMakeLists.txt并解析

(2) src 目录下的 CMakeLists.txt

src 目录下的 CMakeLists.txt 文件内容如下:
include_directories(${PROJECT_SOURCE_DIR}/libhello)  #设置头文件路径
add_executable(hello main.c) #生成目标文件名
target_link_libraries(hello libhello) #设置所链接的库文件

(3)  libhello 目录下的 CMakeLists.txt

libhello 目录下的 CMakeLists.txt文件内容如下:

add_library(libhello hello.c) #设置生成的库文件名+所需的源文件
#重新设置库文件名
set_target_properties(libhello PROPERTIES OUTPUT_NAME "hello") 

三个 CMakeLists.txt文件分析:

顶层 CMakeLists.txt 中使用了 add_subdirectory 命令,该命令告诉 cmake 去子目录中寻找新的
CMakeLists.txt 文件并解析它;
而在 src 的 CMakeList.txt 文件中,新增加了 include_directories 命令用来指明头文件所在的路径,并且使用到了 PROJECT_SOURCE_DIR 变量,该变量指向了一个路径,从命名上可知, 该变量表示工程源码的目录。

三.   cmake 编译工程

和前面一样,进入到 build 目录下进行构建、编译,即进入工程根目录下输入如下命令:
cd build/
cmake ../
make
工程目录为:
├── build
│ ├── libhello
│ │ └── libhello.a
│ └── src
│ └── hello
├── CMakeLists.txt
├── libhello
│ ├── CMakeLists.txt
│ ├── hello.c
│ └── hello.h
└── src
 ├── CMakeLists.txt
 └── main.c

最终会在 build文件目录下生成可执行文件 hello(build/src/hello)和库文件 libhello.a(build/libhello/libhello.a)。

hello可执行文件所在目录: /build/src/

libhello.o库文件所在目录:/build/libhello/

运行 hello可执行程序:

可以看出,可执行程序正常运行。


网站公告

今日签到

点亮在社区的每一天
去签到