makefile 中每个目标的定义格式
<target> : <prerequisites>
[tab] <commands>
前置条件(prerequisites)
前置条件通常是一组文件名,之间用空格分隔。它指定了"目标"是否重新构建的判断标准:只要有一个前置文件不存在,或者有过更新(前置文件的last-modification时间戳比目标的时间戳新),"目标"就需要重新构建。
result.txt: source.txt cp source.txt result.txt
上面代码中,构建 result.txt 的前置条件是 source.txt 。如果当前目录中,source.txt 已经存在,那么
make result.txt
可以正常运行,否则必须再写一条规则,来生成 source.txt 。source.txt: echo "this is the source" > source.txt
上面代码中,source.txt后面没有前置条件,就意味着它跟其他文件都无关,只要这个文件还不存在,每次调用
make source.txt
,它都会生成。$ make result.txt $ make result.txt
上面命令连续执行两次
make result.txt
。第一次执行会先新建 source.txt,然后再新建 result.txt。第二次执行,Make发现 source.txt 没有变动(时间戳晚于 result.txt),就不会执行任何操作,result.txt 也不会重新生成。如果需要生成多个文件,往往采用下面的写法。
source: file1 file2 file3
上面代码中,source 是一个伪目标,只有三个前置文件,没有任何对应的命令。
$ make source
执行
make source
命令后,就会一次性生成 file1,file2,file3 三个文件。这比下面的写法要方便很多。$ make file1 $ make file2 $ make file3
2.4 命令(commands)
命令(commands)表示如何更新目标文件,由一行或多行的Shell命令组成。它是构建"目标"的具体指令,它的运行结果通常就是生成目标文件。
每行命令之前必须有一个tab键。如果想用其他键,可以用内置变量.RECIPEPREFIX声明。
.RECIPEPREFIX = > all: > echo Hello, world
上面代码用.RECIPEPREFIX指定,大于号(>)替代tab键。所以,每一行命令的起首变成了大于号,而不是tab键。
需要注意的是,每行命令在一个单独的shell中执行。这些Shell之间没有继承关系。
var-lost: export foo=bar echo "foo=[$$foo]"
上面代码执行后(
make var-lost
),取不到foo的值。因为两行命令在两个不同的进程执行。一个解决办法是将两行命令写在一行,中间用分号分隔。var-kept: export foo=bar; echo "foo=[$$foo]"
另一个解决办法是在换行符前加反斜杠转义。
var-kept: export foo=bar; \ echo "foo=[$$foo]"
最后一个方法是加上
.ONESHELL:
命令。.ONESHELL: var-kept: export foo=bar; echo "foo=[$$foo]"
目标变量
作用是使变量的作用域仅限于这个目标(target), 而不像之前例子中定义的变量, 对整个Makefile都有效.
语法:echo "building " $$subdir; /
- <target ...> :: <variable-assignment>
- <target ...> :: override <variable-assignment> (override作用参见 变量覆盖的介绍)
示例:
# Makefile 内容 SRCS := programA.c programB.c programC.c target1: TARGET1-SRCS := programD.c target1: @echo "SRCS: " $(SRCS) @echo "SRCS: " $(TARGET1-SRCS) target2: @echo "SRCS: " $(SRCS) @echo "SRCS: " $(TARGET1-SRCS) # bash中执行make $ make target1 SRCS: programA.c programB.c programC.c SRCS: programD.c $ make target2 <-- target2中显示不了 $(TARGET1-SRCS) SRCS: programA.c programB.c programC.c SRCS:
MAKEFILE中的命令包 类似函数
命令包有点像是个函数, 将连续的相同的命令合成一条, 减少 Makefile 中的代码量, 便于以后维护.
语法:
define <command-name> command ... endef
示例:
# Makefile 内容 define run-hello-makefile @echo -n "Hello" @echo " Makefile!" @echo "这里可以执行多条 Shell 命令!" endef all: $(run-hello-makefile) # bash 中运行make $ make Hello Makefile! 这里可以执行多条 Shell 命令!
make在调用Shell之前先进行预处理,即展开所有Makefile的变量和函数。这些变量和函数都以$开头。
要想引用Shell自己的变量,应该以$$开头。另外要注意,Shell自己的变量是不需要括号的。
伪目标:
make的工作过程是先比较依赖文件和目标文件,只有依赖文件比目标文件新时才会执行命令
将某个目标声明为伪目标.PHONY的话就意味着伪目标是不存在真实文件的,也就是说无法比较时间,所以每次都必须执行。