Makefile详解&实战


Makefile详解&实战

什么是Makefile

makefile是一种说明编译规则的文件,带来的好处就是==自动化编译,极大提高开发的效率==

关于编译和链接

无论是C耗时C++都需要把源文件编译成==中间件==,这个过程叫做==编译==

然后将这些大量的中间文件链接合成一个==可执行文件==,这个过程叫做==链接==

Makefile文件命名和规则

  1. 文件命名

文件命名必须是Makefile或是makefile只能是这两种

  1. Makefile规则: 文件中可以有一个或多个规则
目标 ... : 依赖 ...
    命令(shell命令)
    ...
    ...
    ...
  • 目标: 最终要生成的文件(伪目标除外),可以使.o .i .s文件,也可以是可执行文件

  • 依赖: 生成目标锁依赖的==文件==或者==目标==

  • 命令: 通过执行命令对依赖进行操作生成目标

Makefile中的掐规则一般都是为第一条规则服务的

\是换行符方便阅读

基本原理

  1. 再命令执行前会检查依赖是否存在

    a. 如果存在,执行命令

    b. 如果不存在,向下检查其他规则,检查有没有一个规则用来生成这个依赖的,如果找到了,则执行该规则中的命令

  2. 检查更新

    a.如果依赖的时间比目标时间晚,需要重新生成目标

    b.如果依赖的时间比目标早,目标不需要进行更新,对应规则中的命令就不需要执行

变量、模式匹配、函数

可以参考这个链接

Makefile支持三个通配符==* ? ~==与shell是一样的

自动变量

链接

简单使用时目标和依赖文件都是一系例的文件,那么我们如何书写一个命令来完成从不同的依赖文件生成相应的目标?因为在每一次的对模式规则的解析时,都会是不同的目标和依赖文件。自动化变量就是完成这个功能的

  • $@:表示规则中的目标文件集。在模式规则中,如果有多个目标,那么,”$@”就是匹配于目标中模式定义的集合。
  • $%:仅当目标是函数库文件中,表示规则中的目标成员名。例如,如果一个目标是”foo.a(bar.o)”,那么,”$%”就是”bar.o”,”$@”就是”foo.a”。如果目标不是函数库文件(Unix 下是[.a],Windows 下是[.lib]),那么,其值为空。
  • $<:依赖目标中的第一个目标名字。如果依赖目标是以模式(即”%”)定义的,那么”$<”将是符合模式的一系列的文件集。注意,其是一个一个取出来的。
  • $?:所有比目标新的依赖目标的集合。以空格分隔。
  • $^:所有的依赖目标的集合。以空格分隔。如果在依赖目标中有多个重复的,那个这个变量会去除重复的依赖目标,只保留一份。
  • $+:这个变量很像”$^”,也是所有依赖目标的集合。只是它不去除重复的依赖目标。
  • $*:这个变量表示目标模式中”%”及其之前的部分。如果目标是”dir/a.foo.b”,并且目标的模式是”a.%.b”,那么,”$“的值就是”dir/a.foo”。这个变量对于构造有关联的文件名是比较有较。如果目标中没有模式的定义,那么”$“也就不能被推导出,但是,如果目标文件的后缀是make所识别的,那么”$“就是除了后缀的那一部分。例如:如果目标是”foo.c”,因为”.c”是make所能识别的后缀名,所以,”$“的值就是”foo”。这个特性是GNUmake的,很有可能不兼容于其它版本的 make,所以,你应该尽量避免使用”$“,除非是在隐含规则或是静态模式中。如果目标中的后缀是 make 所不能识别的,那么”$“就是空值。
  • $(@D):表示 “$@”的 目录 部 分( 不以斜杠作 为结尾 ), 如 果”$@”值是”dir/foo.o”,那么”$(@D)”就是”dir”,而如果”$@”中没有包含斜杠的话,其值就是”.”(当前目录)。
  • $(@F):表示”$@”的文件部分,如果”$@”值是”dir/foo.o”,那么”$(@F)”就是”foo.o”,”$(@F)”相当于函数”$(notdir $@)”。
  • $(*D):和上面所述的同理,也是取文件的目录部分。对于上面的那个例子,”$(*D)”返回”dir”。
  • $(*F):和上面所述的同理,也是取文件的文件部分。对于上面的那个例子,”$(*F)”返回”foo”。
  • $(%D):表示了函数包文件成员的目录部分。这对于形同”archive(member)”形式的目标中的”member”中包含了不同的目录很有用。
  • $(%F):表示了函数包文件成员的文件部分。这对于形同”archive(member)”形式的目标中的”member”中包含了不同的目录很有用。
  • $(<D):表示依赖文件的目录部分。
  • $(<F):表示依赖文件的文件部分。
  • $(^D):表示所有依赖文件的目录部分。(无相同的)
  • $(^F):表示所有依赖文件的文件部分。(无相同的)
  • $(+D):表示所有依赖文件的目录部分。(可以有相同的)
  • $(+F):所有依赖文件的文件部分。(可以有相同的)
  • $(?D):表示被更新的依赖文件的目录部分。
  • $(?F):表示被更新的依赖文件的文件部分。
    最后,对于”$<”,为了避免产生不必要的麻烦,最好给$后面的那个特定字符都加上圆括号,比如,”$(< )”就要比”$<”要好一些。

伪目标

最早先的一个例子中,我们提到过一个“clean”的目标,这是一个“伪目标”,

clean:
    rm *.o temp

正像我们前面例子中的“clean”一样,既然我们生成了许多文件编译文件,我们也应该提供一个清除它们的“目标”以备完整地重编译而用。 (以“make clean”来使用该目标)

因为,我们并不生成“clean”这个文件。==“伪目标”并不是一个文件,只是一个标签==,由于“伪目标”不是文件,所==以make无法生成它的依赖关系和决定它是否要执行。我们只有通过显式地指明这个“目标”才能让其生效==。当然,==“伪目标”的取名不能和文件名重名==,不然其就失去了“伪目标”的意义了。

当然,为了避免和文件重名的这种情况,我们可以使用一个特殊的标记“.PHONY”来显式地指明一个目标是“伪目标”,向make说明,不管是否有这个文件,这个目标就是“伪目标”。

.PHONY : clean

只要有这个声明,不管是否有“clean”文件,要运行“clean”这个目标,只有“make clean”这样。于是整个过程可以这样写:

.PHONY : clean
clean :
    rm *.o temp

伪目标一般没有依赖的文件。但是,我们也可以为伪目标指定所依赖的文件。伪目标同样可以作为“默认目标”,只要将其放在第一个。一个示例就是,如果你的==Makefile需要一口气生成若干个可执行文件,但你只想简单地敲一个make完事,并且,所有的目标文件都写在一个Makefile中,那么你可以使用“伪目标”这个特性:==

all : prog1 prog2 prog3
.PHONY : all

prog1 : prog1.o utils.o
    cc -o prog1 prog1.o utils.o

prog2 : prog2.o
    cc -o prog2 prog2.o

prog3 : prog3.o sort.o utils.o
    cc -o prog3 prog3.o sort.o utils.o

我们知道,==Makefile中的第一个目标会被作为其默认目标==。我们声明了一个“all”的伪目标,其依赖于其它三个目标。==由于默认目标的特性是,总是被执行的==,但由于“all”又是一个伪目标,伪目标只是一个标签不会生成文件,所以不会有“all”文件产生。于是,其它三个目标的规则总是会被决议。也就达到了我们一口气生成多个目标的目的。 .PHONY : all 声明了“all”这个目标为“伪目标”。(注:这里的显式“.PHONY : all” 不写的话一般情况也可以正确的执行,这样make可通过隐式规则推导出, “all” 是一个伪目标,执行make不会生成“all”文件,而执行后面的多个目标。建议:显式写出是一个好习惯。)

随便提一句,从上面的例子我们可以看出,目标也可以成为依赖。所以,伪目标同样也可成为依赖。看下面的例子:

.PHONY : cleanall cleanobj cleandiff

cleanall : cleanobj cleandiff
    rm program

cleanobj :
    rm *.o

cleandiff :
    rm *.diff

“make cleanall”将清除所有要被清除的文件。“cleanobj”和“cleandiff”这两个伪目标有点像“子程序”的意思。我们可以输入“make cleanall”和“make cleanobj”和“make cleandiff”命令来达到清除不同种类文件的目的。

编译的过程

编译的过程分为

链接

Makefile示例

app:sub.c add.c mult.c div.c main.c
    gcc sub.c add.c mult.c div.c main.c -o app

这里生成app目标, 依赖的是.c文件 命令是gcc命令

app:sub.o add.o mult.o div.o main.o
    gcc sub.o add.o mult.o div.o main.o -o app

sub.o:sub.c
    gcc -c sub.c -o sub.o

add.o:add.c
    gcc -c add.c -o add.o

mult.o:mult.c
    gcc -c mult.c -o mult.o

div.o:div.c
    gcc -c div.c -o div.o

main.o:main.c
    gcc -c main.c -o main.o

# 依赖.o文件没有向下寻找生成.o文件的规则
#定义变量
src=sub.o add.o mult.o div.o main.o
target=app
$(target):$(src)
    $(CC) $(src) -o $(target)

sub.o:sub.c
    gcc -c sub.c -o sub.o

add.o:add.c
    gcc -c add.c -o add.o

mult.o:mult.c
    gcc -c mult.c -o mult.o

div.o:div.c
    gcc -c div.c -o div.o

main.o:main.c
    gcc -c main.c -o main.o
#定义变量
src=sub.o add.o mult.o div.o main.o
target=app
$(target):$(src)
    $(CC) $(src) -o $(target)

%.o:%.c
    $(CC) -c $< -o $@
# 使用变量和自动变量

MakeFile项目实战

主要展示makefile是如何一步步起作用的

  1. 执行cmake ..
  2. 查看cmake
src/perf_control/perf_monitor_unit/cpu_perf_monitor_unit.cc.o:
    $(MAKE) $(MAKESILENT) -f CMakeFiles/perf_control_module.dir/build.make CMakeFiles/perf_control_module.dir/src/perf_control/perf_monitor_unit/cpu_perf_monitor_unit.cc.o
.PHONY : src/perf_control/perf_monitor_unit/cpu_perf_monitor_unit.cc.o

可知make -f的含义是Read File as a make file

image-20230920114923677

  1. 找到对应的makefile中的targey
CMakeFiles/perf_control_module.dir/src/perf_control/perf_monitor_unit/cpu_perf_monitor_unit.cc.o: CMakeFiles/perf_control_module.dir/flags.make
CMakeFiles/perf_control_module.dir/src/perf_control/perf_monitor_unit/cpu_perf_monitor_unit.cc.o: /Users/bytedance/Documents/Code/PerfControlModule/src/perf_control/perf_monitor_unit/cpu_perf_monitor_unit.cc
CMakeFiles/perf_control_module.dir/src/perf_control/perf_monitor_unit/cpu_perf_monitor_unit.cc.o: CMakeFiles/perf_control_module.dir/compiler_depend.ts
// 上面是依赖, 下面是命令
    @$(CMAKE_COMMAND) -E cmake_echo_color --switch=$(COLOR) --green --progress-dir=/Users/bytedance/Documents/Code/PerfControlModule/build/CMakeFiles --progress-num=$(CMAKE_PROGRESS_1) "Building CXX object CMakeFiles/perf_control_module.dir/src/perf_control/perf_monitor_unit/cpu_perf_monitor_unit.cc.o"
    /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/c++ $(CXX_DEFINES) $(CXX_INCLUDES) $(CXX_FLAGS) -MD -MT CMakeFiles/perf_control_module.dir/src/perf_control/perf_monitor_unit/cpu_perf_monitor_unit.cc.o -MF CMakeFiles/perf_control_module.dir/src/perf_control/perf_monitor_unit/cpu_perf_monitor_unit.cc.o.d -o CMakeFiles/perf_control_module.dir/src/perf_control/perf_monitor_unit/cpu_perf_monitor_unit.cc.o -c /Users/bytedance/Documents/Code/PerfControlModule/src/perf_control/perf_monitor_unit/cpu_perf_monitor_unit.cc

这里就可以找到最终执行的命令 cmake -E是为了覆盖环境变量,最后由c++命令进行编译构建。

像${CXX_INCLUDES}的位置在下面文件中

include CMakeFiles/perf_control_module.dir/flags.make

具体内容如下

# CMAKE generated file: DO NOT EDIT!
# Generated by "Unix Makefiles" Generator, CMake Version 3.25

# compile CXX with /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/c++
CXX_DEFINES = -Dperf_control_module_EXPORTS

CXX_INCLUDES = -I/Users/bytedance/Documents/Code/PerfControlModule/src -I/Users/bytedance/Documents/Code/PerfControlModule/src/third_party/spdlog/include

CXX_FLAGS =  -isysroot /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX13.1.sdk -fPIC -std=gnu++11

文章作者: ZhongSY
版权声明: 本博客所有文章除特別声明外,均采用 CC BY 4.0 许可协议。转载请注明来源 ZhongSY !
评论
  目录