由于cmake内容较多,篇幅较长,为了不让人疲倦,分成了多篇博客,全部博客链接如下
cmake简洁教程 - 第一篇_YZF_Kevin的博客-CSDN博客
cmake简洁教程 - 第二篇_YZF_Kevin的博客-CSDN博客
cmake简洁教程 - 第三篇_YZF_Kevin的博客-CSDN博客
cmake简洁教程 - 第四篇_cmake全局变量_YZF_Kevin的博客-CSDN博客
cmake简洁教程 - 第五篇_YZF_Kevin的博客-CSDN博客
这是博客cmake简洁教程的第二篇,主要介绍如何使用cmake编译多个源文件,以及如何编译多目录下的源文件
第一小节:如何使用cmake编译多个源文件
接上篇博客,但这次我们又添加了fun1.c, fun1.h, fun2.c, fun2.h 四个文件,现在目录如下图
其中func1.h, func1.c文件内容如下(分别是函数func1()的声明和实现,只有一个printf打印)
#pragma once
void func1();
#include <stdio.h>
#include "func1.h"
void func1()
{
printf("this is func1() \n");
}
其中func2.h, func2.c文件内容如下(分别是函数func2()的声明和实现,只有一个printf打印)
#pragma once
void func2();
#include <stdio.h>
#include "func2.h"
void func2()
{
printf("this is func2() \n");
}
其中main.c文件内容如下(包含头文件后,分别调用了函数func1() 和 函数func2())
#include <stdio.h>
#include "func1.h"
#include "func2.h"
int main(void)
{
printf("Hello World\n");
func1();
func2();
return 0;
}
我们编辑CMakeLists.txt文件,内容如下
cmake_minimum_required (VERSION 3.5)
project (demo)
add_executable(main main.c func1.c func2.c)
重点:add_executable()命令中指明要使用的源文件是main.c, fun1.c, fun2.c
好了,我们再依次执行命令 cmake . 和命令 make ,可以看到目标文件就被编译出来了,如下图
执行命令 ./main 可以看到,如我们预料,成功调用了func1() 和 func2()
依次类推,如果我们需要编译100个源文件,那就需要在add_executable()命令中添加所有的源文件
更可怕的是一旦我们新加了代码文件,就要修改CMakeLists.txt文件并重新生成makefile才能生成可执行文件
这个做法太low了,有没有比较优雅的方法呢?有!
新命令 aux_source_directory(dir var)
意思是把目录 dir 里面的所有源文件(即.c和.cpp文件)都放在变量 var 中
好了,我们改造上面这个例子,重新编辑CMakeLists.txt文件,内容如下
cmake_minimum_required (VERSION 3.5)
project (demo)
aux_source_directory(. SRC_FILES)
add_executable(main ${SRC_FILES})
注意:
第3行的意思是把当前目录的所有源文件都放在变量SRC_FILES中
第4行的意思是编译目标文件main时,使用的源文件是变量SRC_FILES表示的源文件列表
重新执行命令 cmake . 和 make ,依然可以成功,如下图
因为aux_source_directory(dir var) 是把指定目录下的所有源文件都加入到了变量var中,如果我们不想编译某些源文件呢?
还有一个set命令,例如
set( SRC_FILES main.c testFunc1.c testFunc.c)
意思是给把3个源文件(main.c testFunc1.c testFunc.c)赋给变量 SRC_FILES,接下来正常使用变量 SRC_FILES 即可,还是上面的例子,改造如下
cmake_minimum_required (VERSION 3.5)
project (demo)
set (SRC_FILES main.c func1.c func2.c)
add_executable(main ${SRC_FILES})
重新执行命令 cmake . make ./main,一样可以成功执行
第二小节:如何使用cmake编译多个目录
上一小节我们讲解了如何使用cmake编译多个文件,但这些文件都是同一个目录的,属于比较理想的情况。实际上工程很可能会根据功能的不同而放在不同的目录,这样便于查找
类似下面的架构图(func1.h和func1.c放在子目录func1;func2.h和func2.c放在子目录func2中)
这种情况下,该如何写CMakeLists.txt? 其实也很简单,如下
cmake_minimum_required (VERSION 2.8)
project (demo)
include_directories (func1 func2)
aux_source_directory (func1 SRC_LIST1)
aux_source_directory (func2 SRC_LIST2)
add_executable (main main.c ${SRC_LIST1} ${SRC_LIST2})
这里解释下
第3行:include_directories (func1 func2) 的意思是把子目录fun1,func2包含进工程,如果不写这行,那么代码中包含func1.h时就只能写"func1/func1.h",不太雅观
第4行,5行就简单了,把对应目录的源文件放在变量中
第6行编译命令,需要注意的是这里属于混合用法,既可以指定源文件main.c,也可以指定变量代表的源文件,中间用空格分隔即可
我们依次执行命令 cmake . make ./main,可以看到依然可以执行成功
本篇总结(2个新命令,1个旧命令的新用法)
旧命令新用法
add_executable(main main.c func1.c func2.c) 有多个源文件时,多个源文件中间用空格分开
add_executable(main SRC_FILES ) 使用指定变量 SRC_FILES代表的源文件来编译可执行文件
新命令
1. aux_source_directory(dir var) 把目录dir里面的所有源文件(即.c和.cpp文件)都放在变量 var 中
2. set( SRC_FILES main.c testFunc1.c testFunc.c) 把指定源文件赋给变量 SRC_FILES
3. include_directories (func1 func2) 指定多个目录作为工程的头文件搜索路径,多个路径中间用空格分开
下一篇我们将会讲解更“正规”的cmake用法