構建規(guī)則都寫在Makefile文件里面,要學會如何Make命令,就必須學會如何編寫Makefile文件。
Makefile文件由一系列規(guī)則(rules)構成。每條規(guī)則的形式如下。
<target> : <prerequisites>
[tab] <commands>
上面第一行冒號前面的部分,叫做"目標"(target),冒號后面的部分叫做"前置條件"(prerequisites);第二行必須由一個tab鍵起首,后面跟著"命令"(commands)。
"目標"是必需的,不可省略;"前置條件"和"命令"都是可選的,但是兩者之中必須至少存在一個。
每條規(guī)則就明確兩件事:構建目標的前置條件是什么,以及如何構建。下面就詳細講解,每條規(guī)則的這三個組成部分。
一個目標(target)就構成一條規(guī)則。目標通常是文件名,指明Make命令所要構建的對象,比如上文的 a.txt 。目標可以是一個文件名,也可以是多個文件名,之間用空格分隔。
除了文件名,目標還可以是某個操作的名字,這稱為"偽目標"(phony target)。
clean:
rm *.o
上面代碼的目標是clean,它不是文件名,而是一個操作的名字,屬于"偽目標 ",作用是刪除對象文件。
$ make clean
但是,如果當前目錄中,正好有一個文件叫做clean,那么這個命令不會執(zhí)行。因為Make發(fā)現(xiàn)clean文件已經(jīng)存在,就認為沒有必要重新構建了,就不會執(zhí)行指定的rm命令。
為了避免這種情況,可以明確聲明clean是"偽目標",寫法如下。
.PHONY: clean
clean:
rm *.o temp
聲明clean是"偽目標"之后,make就不會去檢查是否存在一個叫做clean的文件,而是每次運行都執(zhí)行對應的命令。像.PHONY這樣的內置目標名還有不少,可以查看手冊。
如果Make命令運行時沒有指定目標,默認會執(zhí)行Makefile文件的第一個目標。
$ make
上面代碼執(zhí)行Makefile文件的第一個目標。
前置條件通常是一組文件名,之間用空格分隔。它指定了"目標"是否重新構建的判斷標準:只要有一個前置文件不存在,或者有過更新(前置文件的last-modification時間戳比目標的時間戳新),"目標"就需要重新構建。
result.txt: source.txt
cp source.txt result.txt
上面代碼中,構建 result.txt 的前置條件是 source.txt 。如果當前目錄中,source.txt 已經(jīng)存在,那么make result.txt
可以正常運行,否則必須再寫一條規(guī)則,來生成 source.txt 。
source.txt:
echo "this is the source" > source.txt
上面代碼中,source.txt后面沒有前置條件,就意味著它跟其他文件都無關,只要這個文件還不存在,每次調用make source.txt
,它都會生成。
$ make result.txt
$ make result.txt
上面命令連續(xù)執(zhí)行兩次make result.txt
。第一次執(zhí)行會先新建 source.txt,然后再新建 result.txt。第二次執(zhí)行,Make發(fā)現(xiàn) source.txt 沒有變動(時間戳晚于 result.txt),就不會執(zhí)行任何操作,result.txt 也不會重新生成。
如果需要生成多個文件,往往采用下面的寫法。
source: file1 file2 file3
上面代碼中,source 是一個偽目標,只有三個前置文件,沒有任何對應的命令。
$ make source
執(zhí)行make source
命令后,就會一次性生成 file1,file2,file3 三個文件。這比下面的寫法要方便很多。
$ make file1
$ make file2
$ make file3
命令(commands)表示如何更新目標文件,由一行或多行的Shell命令組成。它是構建"目標"的具體指令,它的運行結果通常就是生成目標文件。
每行命令之前必須有一個tab鍵。如果想用其他鍵,可以用內置變量.RECIPEPREFIX聲明。
.RECIPEPREFIX = >
all:
> echo Hello, world
上面代碼用.RECIPEPREFIX指定,大于號(>)替代tab鍵。所以,每一行命令的起首變成了大于號,而不是tab鍵。
需要注意的是,每行命令在一個單獨的shell中執(zhí)行。這些Shell之間沒有繼承關系。
var-lost:
export foo=bar
echo "foo=[$$foo]"
上面代碼執(zhí)行后(make var-lost
),取不到foo的值。因為兩行命令在兩個不同的進程執(zhí)行。一個解決辦法是將兩行命令寫在一行,中間用分號分隔。
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]"
更多建議: