Makefile 的使用

2020-10-30 10:39:29 浏览数 (1)

在 Linux 中使用 make 命令来编译程序,特别是大程序;而 make 命令所执行的动作依赖于 Makefile 文件。最简单的 Makefile 文件如下:

代码语言:javascript复制
hello: hello.c
gcc -o hello hello.c
clean:
rm -f hello

将上述 4 行存为 Makefile 文件(注意必须以 Tab 键缩进第 2、4 行,不能以空格键缩进),放入 01_hello目录下,然后直接执行 make 命令即可编译程序,执行“make clean”即可清除编译出来的结果。

make 命令根据文件更新的时间戳来决定哪些文件需要重新编译,这使得可以避免编译已经编译过的、没有变化的程序,可以大大提高编译效率。

要想完整地了解 Makefile 的规则,请参考《GNU Make 使用手册》,以下仅粗略介绍。

3.1 配套视频内容大纲

3.1.1 Makefile 规则与示例

参考文档:gunmake.htm

① 为什么需要 Makefile 怎么高效地编译程序? 想达到什么样的效果?请参考 Visual Studio:修改源文件或头文件,只需要重新编译牵涉到的文件, 就可以重新生成 APP

② Makefile 其实挺简单 一个简单的 Makefile 文件包含一系列的“规则”,其样式如下:

代码语言:javascript复制
目标(target)…: 依赖(prerequiries)…
<tab>命令(command)

如果“依赖文件”比“目标文件”更加新,那么执行“命令”来重新生成“目标文件”。命令被执行的 2 个条件:依赖文件比目标文件新,或是 目标文件还没生成。

③ 先介绍 Makefile 的 2 个函数 A. $(foreach var,list,text) 简单地说,就是 for each var in list, change it to text。 对 list 中的每一个元素,取出来赋给 var,然后把 var 改为 text 所描述的形式。

例子:

代码语言:javascript复制
objs := a.o b.o
dep_files := $(foreach f, $(objs), .$(f).d) // 最终 dep_files := .a.o.d .b.o.d

B. $(wildcard pattern) pattern 所列出的文件是否存在,把存在的文件都列出来。 例子:

代码语言:javascript复制
src_files := $( wildcard *.c) // 最终 src_files 中列出了当前目录下的所有.c` 文件

④ 一步一步完善 Makefile 第 1 个 Makefile,简单粗暴,效率低:

代码语言:javascript复制
test : main.c sub.c sub.h
gcc -o test main.c sub.c

第 2 个 Makefile,效率高,相似规则太多太啰嗦,不支持检测头文件:

代码语言:javascript复制
test : main.o sub.o
gcc -o test main.o sub.o

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

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

clean:
rm *.o test -f

第 3 个 Makefile,效率高,精炼,不支持检测头文件:

代码语言:javascript复制
test : main.o sub.o
gcc -o test main.o sub.o
%.o : %.c
gcc -c -o $@ $<
clean:
rm *.o test -f

第 4 个 Makefile,效率高,精炼,支持检测头文件(但是需要手工添加头文件规则):

代码语言:javascript复制
test : main.o sub.o
gcc -o test main.o sub.o

%.o : %.c
gcc -c -o $@ $<

sub.o : sub.h

clean:
rm *.o test -f

第 5 个 Makefile,效率高,精炼,支持自动检测头文件:

代码语言:javascript复制
objs := main.o sub.o

test : $(objs)
gcc -o test $^

# 需要判断是否存在依赖文件
# .main.o.d .sub.o.d
dep_files := $(foreach f, $(objs), .$(f).d)
dep_files := $(wildcard $(dep_files))

# 把依赖文件包含进来
ifneq ($(dep_files),)
 include $(dep_files)
endif

%.o : %.c
gcc -Wp,-MD,.$@.d -c -o $@ $<

clean:
rm *.o test -f

distclean:
rm $(dep_files) *.o test -f

3.1.2 通用 Makefile 的使用

我参考 Linux 内核的 Makefile 编写了一个通用的 Makefile,它可以用来编译应用程序: ① 支持多个目录、多层目录、多个文件; ② 支持给所有文件设置编译选项; ③ 支持给某个目录设置编译选项; ④ 支持给某个文件单独设置编译选项; ⑤ 简单、好用。 使用 git 下载本教程的文档后,下列目录中就有说明和示例:

代码语言:javascript复制
01_all_series_quickstart
04_嵌入式 Linux 应用开发基础知识source5_general_Makefile

3.1.3 通用 Makefile 的解析

① 零星知识点 A. make 命令的使用: 执行 make 命令时,它会去当前目录下查找名为“Makefile”的文件,并根据它的指示去执行操作,生成第一个目标。

我们可以使用“-f”选项指定文件,不再使用名为“Makefile”的文件,比如:

代码语言:javascript复制
make -f Makefile.build

我们可以使用“-C”选项指定目录,切换到其他目录里去,比如:

代码语言:javascript复制
make -C a/ -f Makefile.build 

我们可以指定目标,不再默认生成第一个目标:

代码语言:javascript复制
make -C a/ -f Makefile.build other_target

B. 即时变量、延时变量: 变量的定义语法形式如下:

代码语言:javascript复制
A = xxx // 延时变量
B ?= xxx // 延时变量,只有第一次定义时赋值才成功;如果曾定义过,此赋值无效
C := xxx // 立即变量
D  = yyy // 如果 D 在前面是延时变量,那么现在它还是延时变量;
// 如果 D 在前面是立即变量,那么现在它还是立即变量

在 GNU make 中对变量的赋值有两种方式:延时变量、立即变量。 上图中,变量 A 是延时变量,它的值在使用时才展开、才确定。比如:

代码语言:javascript复制
A = $@
test:
@echo $A

上述 Makefile 中,变量 A 的值在执行时才确定,它等于 test,是延时变量。

如果使用“A := @ ” , 这 是 立 即 变 量 , 这 时 @”,这是立即变量,这时 @”,这是立即变量,这时@为空,所以 A 的值就是空。

C. 变量的导出(export): 在编译程序时,我们会不断地使用“make -C dir”切换到其他目录,执行其他目录里的 Makefile。如果想让某个变量的值在所有目录中都可见,要把它 export 出来。

比如“CC = $(CROSS_COMPILE)gcc”,这个 CC 变量表示编译器,在整个过程中都是一样的。定义它之后,要使用“export CC”把它导出来。

D. Makefile 中可以使用 shell 命令: 比如:

代码语言:javascript复制
TOPDIR := $(shell pwd)

这是个立即变量,TOPDIR 等于 shell 命令 pwd 的结果。 E. 在 Makefile 中怎么放置第 1 个目标: 执行 make 命令时如果不指定目标,那么它默认是去生成第 1 个目标。 所以“第 1 个目标”,位置很重要。有时候不太方便把第 1 个目标完整地放在文件前面,这时可以在文件的前面直接放置目标,在后面再完善它的依赖与命令。比如:

代码语言:javascript复制
First_target: // 这句话放在前面
.... // 其他代码,比如 include 其他文件得到后面的 xxx 变量
First_target : $(xxx) $(yyy) // 在文件的后面再来完善
command

F. 假想目标: 我们的 Makefile 中有这样的目标:

代码语言:javascript复制
clean:
rm -f $(shell find -name "*.o")
rm -f $(TARGET)

如果当前目录下恰好有名为“clean”的文件,那么执行“make clean”时它就不会执行那些删除命令。

这时我们需要把“clean”这个目标,设置为“假想目标”,这样可以确保执行“make clean”时那些删除命令肯定可以得到执行。

使用下面的语句把“clean”设置为假想目标:

代码语言:javascript复制
.PHONY : clean

G. 常用的函数:

i. $(foreach var,list,text) 简单地说,就是 for each var in list, change it to text。 对 list 中的每一个元素,取出来赋给 var,然后把 var 改为 text 所描述的形式。

例子:

代码语言:javascript复制
objs := a.o b.o
dep_files := $(foreach f, $(objs), .$(f).d) // 最终 dep_files := .a.o.d .b.o.d

ii. $(wildcard pattern) pattern 所列出的文件是否存在,把存在的文件都列出来。 例子:

代码语言:javascript复制
src_files := $( wildcard *.c) // 最终 src_files 中列出了当前目录下的所有.c 文件

iii. $(filter pattern…,text) 把 text 中符合 pattern 格式的内容,filter(过滤)出来、留下来。 例子:

代码语言:javascript复制
obj-y := a.o b.o c/ d/
DIR := $(filter %/, $(obj-y)) //结果为:c/ d/

iv. $(filter-out pattern…,text) 把 text 中符合 pattern 格式的内容,filter-out(过滤)出来、扔掉。 例子:

代码语言:javascript复制
obj-y := a.o b.o c/ d/
DIR := $(filter-out %/, $(obj-y)) //结果为:a.o b.o

vi. $(patsubst pattern,replacement,text) 寻找text’中符合格式pattern’的字,用replacement’替换它们。pattern’和`replacement’中可以使用通配符。 比如:

代码语言:javascript复制
subdir-y := c/ d/
subdir-y := $(patsubst %/, %, $(subdir-y)) // 结果为:c d

② 通用 Makefile 的设计思想 A. 在 Makefile 文件中确定要编译的文件、目录,比如:

代码语言:javascript复制
obj-y  = main.o
obj-y  = a/

“Makefile”文件总是被“Makefile.build”包含的。

B. 在 Makefile.build 中设置编译规则,有 3 条编译规则: i. 怎么编译子目录? 进入子目录编译:

代码语言:javascript复制
$(subdir-y):
make -C $@ -f $(TOPDIR)/Makefile.build

ii. 怎么编译当前目录中的文件?

代码语言:javascript复制
%.o : %.c
$(CC) $(CFLAGS) $(EXTRA_CFLAGS) $(CFLAGS_$@) -Wp,-MD,$(dep_file) -c -o $@ $<

iii. 当前目录下的.o 和子目录下的 built-in.o 要打包起来:

代码语言:javascript复制
built-in.o : $(cur_objs) $(subdir_objs)
$(LD) -r -o $@ $^

C. 顶层 Makefile 中把顶层目录的 built-in.o 链接成 APP:

代码语言:javascript复制
$(TARGET) : built-in.o
$(CC) $(LDFLAGS) -o $(TARGET) built-in.o

③ 情景演绎

本节下面的内容中不需要看,这是为写书《嵌入式 Linux 应用开发完全手册 升级版》而准备的。结合3.0 节看视频就可以了。

3.2 Makefile 规则

一个简单的 Makefile 文件包含一系列的“规则”,其样式如下:

代码语言:javascript复制
目标(target)…: 依赖(prerequiries)…
<tab>命令(command)

目标(target)通常是要生成的文件的名称,可以是可执行文件或 OBJ 文件,也可以是一个执行的动作名称,诸如clean

依赖是用来产生目标的材料(比如源文件),一个目标经常有几个依赖。

命令是生成目标时执行的动作,一个规则可以含有几个命令,每个命令占一行。

注意:每个命令行前面必须是一个 Tab 字符,即命令行第一个字符是 Tab。这是容易出错的地方。

通常,如果一个依赖发生了变化,就需要规则调用命令以更新或创建目标。但是并非所有的目标都有依赖,例如,目标“clean”的作用是清除文件,它没有依赖。

规则一般是用于解释怎样和何时重建目标。make 首先调用命令处理依赖,进而才能创建或更新目标。

当然,一个规则也可以是用于解释怎样和何时执行一个动作,即打印提示信息。

一个 Makefile 文件可以包含规则以外的其他文本,但一个简单的 Makefile 文件仅仅需要包含规则。虽然真正的规则比这里展示的例子复杂,但格式是完全一样的。

对于上面的 Makefile,执行“make”命令时,仅当 hello.c 文件比 hello 文件新,才会执行命令“armlinux-gcc –o hello hello.c”生成可执行文件 hello;如果还没有 hello 文件,这个命令也会执行。

运行“make clean”时,由于目标 clean 没有依赖,它的命令“rm -f hello”将被强制执行。

3.3 Makefile 文件里的赋值方法

变量的定义语法形式如下:

代码语言:javascript复制
immediate = deferred
immediate ?= deferred
immediate := immediate
immediate  = deferred or immediate
define immediate
deferred
endef

在 GNU make 中对变量的赋值有两种方式:延时变量、立即变量。区别在于它们的定义方式和扩展时的方式不同,前者在这个变量使用时才扩展开,意即当真正使用时这个变量的值才确定;后者在定义时它的值就已经确定了。使用=?=定义或使用 define 指令定义的变量是延时变量;使用:=定义的变量是立即变量。需要注意的一点是,?=仅仅在变量还没有定义的情况下有效,即?=被用来定义第一次出现的延时变量。

对于附加操作符 =,右边变量如果在前面使用(:=)定义为立即变量则它也是立即变量,否则均为延时变量。

3.4 Makefile 常用函数

函数调用的格式如下:

代码语言:javascript复制
$(function arguments) 

这里function是函数名,arguments是该函数的参数。参数和函数名之间是用空格或 Tab 隔开, 如果有多个参数,它们之间用逗号隔开。这些空格和逗号不是参数值的一部分。 内核的 Makefile 中用到大量的函数,现在介绍一些常用的。

3.4.1 字符串替换和分析函数

(1)$(subst from,to,text) 在文本text中使用to替换每一处from。 比如:

代码语言:javascript复制
$(subst ee,EE,feet on the street) 

结果为fEEt on the strEEt。 (2)$(patsubst pattern,replacement,text) 寻找text中符合格式pattern的字,用replacement替换它们。patternreplacement 中可以使用通配符。

比如:

代码语言:javascript复制
$(patsubst %.c,%.o,x.c.c bar.c)

结果为:x.c.o bar.o

(3)(strip string) 去掉前导和结尾空格,并将中间的多个空格压缩为单个空格。 比如: (strip a b c ) 结果为a b c。

(4)(findstring find,in) 在字符串in中搜寻find,如果找到,则返回值是find,否则返回值为空。 比如: (findstring a,a b c)

(5)$(filter pattern…,text) 返回在text中由空格隔开且匹配格式pattern...的字,去除不符合格式pattern...的字。 比如:

代码语言:javascript复制
$(filter %.c %.s,foo.c bar.c baz.s ugh.h) 

结果为foo.c bar.c baz.s

(6)$(filter-out pattern…,text) 返回在text中由空格隔开且不匹配格式pattern...的字,去除符合格式pattern...的字。它 是函数 filter 的反函数。 比如:

代码语言:javascript复制
$(filter %.c %.s,foo.c bar.c baz.s ugh.h) 

结果为ugh.h

(7)$(sort list) 将list中的字按字母顺序排序,并去掉重复的字。输出由单个空格隔开的字的列表。 比如:

代码语言:javascript复制
$(sort foo bar lose) 

返回值是bar foo lose

3.4.2 文件名函数

(1)$(dir names…) 抽取names...中每一个文件名的路径部分,文件名的路径部分包括从文件名的首字符到最后一个斜 杠(含斜杠)之前的一切字符。 比如:

代码语言:javascript复制
$(dir src/foo.c hacks)

结果为src/ ./

(2)$(notdir names…) 抽取names...中每一个文件名中除路径部分外一切字符(真正的文件名)。 比如:

代码语言:javascript复制
$(notdir src/foo.c hacks) 

结果为foo.c hacks

(3)$(suffix names…) 抽取names...中每一个文件名的后缀。 比如:

代码语言:javascript复制
$(suffix src/foo.c src-1.0/bar.c hacks) 

结果为.c .c

(4)$(basename names…) 抽取names...中每一个文件名中除后缀外一切字符。 比如:

代码语言:javascript复制
$(basename src/foo.c src-1.0/bar hacks) 

结果为src/foo src-1.0/bar hacks

(5)$(addsuffix suffix,names…) 参数names...是一系列的文件名,文件名之间用空格隔开;suffix 是一个后缀名。将 suffix(后缀) 的值附加在每一个独立文件名的后面,完成后将文件名串联起来,它们之间用单个空格隔开。 比如:

代码语言:javascript复制
$(addsuffix .c,foo bar) 

结果为foo.c bar.c

(6)$(addprefix prefix,names…) 参数names是一系列的文件名,文件名之间用空格隔开;prefix 是一个前缀名。将 preffix(前缀) 的值附加在每一个独立文件名的前面,完成后将文件名串联起来,它们之间用单个空格隔开。 比如:

代码语言:javascript复制
$(addprefix src/,foo bar) 

结果为src/foo src/bar

(7)$(wildcard pattern) 参数pattern是一个文件名格式,包含有通配符(通配符和 shell 中的用法一样)。函数 wildcard 的 结果是一列和格式匹配的且真实存在的文件的名称,文件名之间用一个空格隔开。 比如若当前目录下有文件 1.c、2.c、1.h、2.h,则:

代码语言:javascript复制
c_src := $(wildcard *.c) 

结果为1.c 2.c

3.4.3 其他函数

(1)$(foreach var,list,text) 前两个参数,varlist将首先扩展,注意最后一个参数text此时不扩展;接着,list 扩展所得的每个字,都赋给var变量;然后text引用该变量进行扩展,因此text每次扩展都不 相同。

函数的结果是由空格隔开的textlist中多次扩展后,得到的新list,就是说:text 多次扩展的字串联起来,字与字之间由空格隔开,如此就产生了函数 foreach 的返回值。

下面是一个简单的例子,将变量files的值设置为 dirs中的所有目录下的所有文件的列表:

代码语言:javascript复制
dirs := a b c d
files := $(foreach dir,$(dirs),$(wildcard $(dir)/*))

这里text是(wildcard (dir)/*),它的扩展过程如下: ① 第一个赋给变量 dir 的值是a,扩展结果为(wildcard a/*); ② 第二个赋给变量 dir 的值是b,扩展结果为(wildcard b/*); ③ 第三个赋给变量 dir 的值是c,扩展结果为

代码语言:javascript复制
files := $(wildcard a/* b/* c/* d/*) 

(2)$(if condition,then-part[,else-part]) 首先把第一个参数‘condition’的前导空格、结尾空格去掉,然后扩展。如果扩展为非空字符串,则条件‘condition’为‘真’;如果扩展为空字符串,则条件‘condition’为‘假’。

如果条件‘condition’为‘真’,那么计算第二个参数‘then-part’的值,并将该值作为整个函数 if的值。

如果条件‘condition’为‘假’,并且第三个参数存在,则计算第三个参数‘else-part’的值,并将该值作为整个函数 if 的值;如果第三个参数不存在,函数 if 将什么也不计算,返回空值。

注意:仅能计算‘then-part’和‘else-part’二者之一,不能同时计算。这样有可能产生副作用(例如函数 shell 的调用)。

(3) ( o r i g i n v a r i a b l e ) 变 量 ‘ v a r i a b l e ’ 是 一 个 查 询 变 量 的 名 称 , 不 是 对 该 变 量 的 引 用 。 所 以 , 不 能 采 用 ‘ (origin variable) 变量‘variable’是一个查询变量的名称,不是对该变量的引用。所以,不能采用‘ (originvariable)变量‘variable’是一个查询变量的名称,不是对该变量的引用。所以,不能采用‘’和圆括号的格式书写该变量,当然,如果需要使用非常量的文件名,可以在文件名中使用变量引用。

函数 origin 的结果是一个字符串,该字符串变量是这样定义的:

‘undefined’ :如果变量‘variable’从没有定义; ‘default’ :变量‘variable’是缺省定义; ‘environment’ :变量‘variable’作为环境变量定义,选项‘-e’没有打开; ‘environment override’:变量‘variable’作为环境变量定义,选项‘-e’已打开; ‘file’ :变量‘variable’在 Makefile 中定义; ‘command line’ :变量‘variable’在命令行中定义; ‘override’ :变量‘variable’在Makefile 中用 override 指令定义; ‘automatic’ :变量‘variable’是自动变量

(4)$(shell command arguments) 函数 shell 是 make 与外部环境的通讯工具。函数 shell 的执行结果和在控制台上执行‘command arguments’的结果相似。不过如果‘command arguments’的结果含有换行符(和回车符),则在函数 shell的返回结果中将把它们处理为单个空格,若返回结果最后是换行符(和回车符)则被去掉。

比如当前目录下有文件 1.c、2.c、1.h、2.h,则:

代码语言:javascript复制
c_src := $(shell ls *.c)

结果为‘1.c 2.c’

《Makefile 介绍》这小节可以在阅读内核、bootloader、应用程序的 Makefile 文件时,作为手册来查询。下面以 options 程序的 Makefile 作为例子进行演示,Makefile 的内容如下:

代码语言:javascript复制
File: Makefile
01 src := $(shell ls *.c)
02 objs := $(patsubst %.c,%.o,$(src))
03 
04 test: $(objs)
05 gcc -o $@ $^
06
07 %.o:%.c
08 gcc -c -o $@ $<
09 
10 clean:
11 rm -f test *.o

上述 Makefile 中 @ 、 @、 @、^、 < 称 为 自 动 变 量 。 <称为自动变量。 <称为自动变量。@表示规则的目标文件名; 表 示 所 有 依 赖 的 名 字 , 名 字 之 间 用 空 格 隔 开 ; ^表示所有依赖的名字,名字之间用空格隔开; 表示所有依赖的名字,名字之间用空格隔开;<表示第一个依赖的文件名。‘%’是通配符,它和一个字符串中任意个数的字符相匹配。

options 目录下所有的文件为 main.c,Makefile,sub.c 和 sub.h,下面一行行地分析: ① 第 1 行 src 变量的值为‘main.c sub.c’。 ② 第 2 行 objs 变量的值为‘main.o sub.o’,是 src 变量经过 patsubst 函数处理后得到的。 ③ 第 4 行实际上就是:

代码语言:javascript复制
test : main.o sub.o

目标 test 的依赖有二:main.o 和 sub.o。开始时这两个文件还没有生成,在执行生成 test 的命令之前先将 main.o、sub.o 作为目标查找到合适的规则,以生成 main.o、sub.o。

④ 第 7、8 行就是用来生成 main.o、sub.o 的规则: 对于 main.o 这个规则就是:

代码语言:javascript复制
main.o:main.c
gcc -c -o main.o main.c

对于 sub.o 这个规则就是:

代码语言:javascript复制
sub.o:sub.c
gcc -c -o sub.o sub.c

这样,test 的依赖 main.o 和 sub.o 就生成了。

⑤ 第 5 行的命令在生成 main.o、sub.o 后得以执行。

在 options 目录下第一次执行 make 命令可以看到如下信息:

代码语言:javascript复制
gcc -c -o main.o main.c
gcc -c -o sub.o sub.c
gcc -o test main.o sub.o

然后修改 sub.c 文件,再次执行 make 命令,可以看到如下信息:

代码语言:javascript复制
gcc -c -o sub.o sub.c
gcc -o test main.o sub.o

可见,只编译了更新过的 sub.c 文件,对 main.c 文件不用再次编译,节省了编译的时间。

0 人点赞