主页

索引

模块索引

搜索页面

Makefile规则

Makefile文件由一系列规则(rules)构成。每条规则的形式如下:

<target> : <prerequisites>
[tab]  <commands>

1. <target>: 叫做"目标"
2. <prerequisites>: 叫做"前置条件"
    代表生成该 target 所需要的依赖项
    当有多个依赖项时,依赖项之间用空格分隔
3. <commands>: 叫做"命令"
    代表该 target 要执行的命令(可以是任意的 shell 命令)

目标(target)

可使用通配符
当有多个目标时,目标之间用空格分隔

文件名

备注

只要 targets 不存在,或 prerequisites 中有一个以上的文件比 targets 文件新,那么 command 所定义的命令就会被执行,从而产生我们需要的文件,或执行我们期望的操作。

伪目标-phony target

除了文件名,目标还可以是某个操作的名字,这称为”伪目标”(phony target):

clean:
    rm *.o

备注

上面代码的目标是clean,它不是文件名,而是一个操作的名字,属于”伪目标”。如果当前目录中,正好有一个文件叫做clean,那么这个命令不会执行,因为Make发现clean文件已经存在,就认为没有必要重新构建了,就不会执行指定的rm命令。

为了避免这种情况,可以明确声明clean是”伪目标”,写法如下:

.PHONY: clean
clean:
    rm *.o temp

备注

通过[.PHONY]声明clean是”伪目标”之后,make就不会去检查是否存在一个叫做clean的文件,而是每次运行都执行对应的命令

参考

前置条件(prerequisites)

前置条件通常是一组文件名,之间用空格分隔:

它指定了"目标"是否重新构建的判断标准:
1. 只要有一个前置文件不存在
2. 有过更新(前置文件的last-modification时间戳比目标的时间戳新),"目标"就需要重新构建

实例:

result.txt: source.txt
    cp source.txt result.txt
source.txt:
    echo "this is the source" > source.txt

连续执行两次make result.txt:

第一次执行会先新建 source.txt,然后再新建 result.txt
第二次执行,Make发现 source.txt 没有变动(时间戳晚于 result.txt)
  就不会执行任何操作,result.txt 也不会重新生成

order-only 依赖

备注

只要 prerequisites 中有任何文件发生改变,就会重新构造 target。但是有时候,我们希望只有当 prerequisites 中的部分文件改变时,才重新构造 target。

order-only prerequisites 的形式如下:

<targets> : <normal-prerequisites> | <order-only-prerequisites>
[tab]  <commands>

备注

只有第一次构造 targets 时,才会使用 order-only-prerequisites。后面即使 order-only-prerequisites 发生改变,也不会重新构造 targets。只有 normal-prerequisites 中的文件发生改变时,才会重新构造 targets。这里,符号 “|” 后面的 prerequisites 就是 order-only-prerequisites

命令(commands)

命令(commands)表示如何更新目标文件,由一行或多行的Shell命令组成:

它是构建"目标"的具体指令,它的运行结果通常就是生成目标文件

每行命令之前必须有一个tab键。如果想用其他键,可以用内置变量.RECIPEPREFIX声明:

.RECIPEPREFIX = >
all:
> echo Hello, world
// 用.RECIPEPREFIX指定,大于号(>)替代tab键
// 所以,每一行命令的起首变成了大于号,而不是tab键

注意:每行命令在一个单独的shell中执行。这些Shell之间没有继承关系:

// 有问题
var-lost:
    export foo=bar
    echo "foo=[$$foo]"

// 正确1
var-kept:
    export foo=bar; echo "foo=[$$foo]"

// 正确2
var-kept:
    export foo=bar; \
    echo "foo=[$$foo]"

// 正确3(是加上.ONESHELL:命令)
.ONESHELL:
var-kept:
    export foo=bar;
    echo "foo=[$$foo]"

主页

索引

模块索引

搜索页面