構建規則都寫在Makefile文件里面,要學會如何Make命令,就必須學會如何編寫Makefile文件。
[TOC]
## 2.1 概述
Makefile文件由一系列規則(rules)構成。每條規則的形式如下。
~~~
<target> : <prerequisites>
[tab] <commands>
~~~
上面第一行冒號前面的部分,叫做"目標"(target),冒號后面的部分叫做"前置條件"(prerequisites);第二行必須由一個tab鍵起首,后面跟著"命令"(commands)。
"目標"是必需的,不可省略;"前置條件"和"命令"都是可選的,但是兩者之中必須至少存在一個。
每條規則就明確兩件事:構建目標的前置條件是什么,以及如何構建。下面就詳細講解,每條規則的這三個組成部分。
## 2.2 目標(target)
一個目標(target)就構成一條規則。目標通常是文件名,指明Make命令所要構建的對象,比如上文的 a.txt 。目標可以是一個文件名,也可以是多個文件名,之間用空格分隔。
除了文件名,目標還可以是某個操作的名字,這稱為"偽目標"(phony target)。
~~~
clean:
rm *.o
~~~
上面代碼的目標是clean,它不是文件名,而是一個操作的名字,屬于"偽目標 ",作用是刪除對象文件。
~~~
$ make clean
~~~
但是,如果當前目錄中,正好有一個文件叫做clean,那么這個命令不會執行。因為Make發現clean文件已經存在,就認為沒有必要重新構建了,就不會執行指定的rm命令。
為了避免這種情況,可以明確聲明clean是"偽目標",寫法如下。
~~~
.PHONY: clean
clean:
rm *.o temp
~~~
聲明clean是"偽目標"之后,make就不會去檢查是否存在一個叫做clean的文件,而是每次運行都執行對應的命令。像.PHONY這樣的內置目標名還有不少,可以查看[手冊](http://www.gnu.org/software/make/manual/html_node/Special-Targets.html#Special-Targets)。
如果Make命令運行時沒有指定目標,默認會執行Makefile文件的第一個目標。
~~~
$ make
~~~
上面代碼執行Makefile文件的第一個目標。
## 2.3 前置條件(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]"
~~~