井號(#)在Makefile中表示注釋。
# 這是注釋
result.txt: source.txt
# 這是注釋
cp source.txt result.txt # 這也是注釋
正常情況下,make會打印每條命令,然后再執(zhí)行,這就叫做回聲(echoing)。
test:
# 這是測試
執(zhí)行上面的規(guī)則,會得到下面的結(jié)果。
$ make test
# 這是測試
在命令的前面加上@,就可以關(guān)閉回聲。
test:
@# 這是測試
現(xiàn)在再執(zhí)行make test
,就不會有任何輸出。
由于在構(gòu)建過程中,需要了解當(dāng)前在執(zhí)行哪條命令,所以通常只在注釋和純顯示的echo命令前面加上@。
test:
@# 這是測試
@echo TODO
通配符(wildcard)用來指定一組符合條件的文件名。Makefile 的通配符與 Bash 一致,主要有星號()、問號(?)和 [...] 。比如, .o 表示所有后綴名為o的文件。
clean:
rm -f *.o
Make命令允許對文件名,進行類似正則運算的匹配,主要用到的匹配符是%。比如,假定當(dāng)前目錄下有 f1.c 和 f2.c 兩個源碼文件,需要將它們編譯為對應(yīng)的對象文件。
%.o: %.c
等同于下面的寫法。
f1.o: f1.c
f2.o: f2.c
使用匹配符%,可以將大量同類型的文件,只用一條規(guī)則就完成構(gòu)建。
Makefile 允許使用等號自定義變量。
txt = Hello World
test:
@echo $(txt)
上面代碼中,變量 txt 等于 Hello World。調(diào)用時,變量需要放在 $( ) 之中。
調(diào)用Shell變量,需要在美元符號前,再加一個美元符號,這是因為Make命令會對美元符號轉(zhuǎn)義。
test:
@echo $$HOME
有時,變量的值可能指向另一個變量。
v1 = $(v2)
上面代碼中,變量 v1 的值是另一個變量 v2。這時會產(chǎn)生一個問題,v1 的值到底在定義時擴展(靜態(tài)擴展),還是在運行時擴展(動態(tài)擴展)?如果 v2 的值是動態(tài)的,這兩種擴展方式的結(jié)果可能會差異很大。
為了解決類似問題,Makefile一共提供了四個賦值運算符 (=、:=、?=、+=),它們的區(qū)別請看StackOverflow。
VARIABLE = value
# 在執(zhí)行時擴展,允許遞歸擴展。
VARIABLE := value
# 在定義時擴展。
VARIABLE ?= value
# 只有在該變量為空時才設(shè)置值。
VARIABLE += value
# 將值追加到變量的尾端。
Make命令提供一系列內(nèi)置變量,比如,$(CC) 指向當(dāng)前使用的編譯器,$(MAKE) 指向當(dāng)前使用的Make工具。這主要是為了跨平臺的兼容性,詳細的內(nèi)置變量清單見手冊。
output:
$(CC) -o output input.c
Make命令還提供一些自動變量,它們的值與當(dāng)前規(guī)則有關(guān)。主要有以下幾個。
(1)$@
$@指代當(dāng)前目標(biāo),就是Make命令當(dāng)前構(gòu)建的那個目標(biāo)。比如,make foo
的 $@ 就指代foo。
a.txt b.txt:
touch $@
等同于下面的寫法。
a.txt:
touch a.txt
b.txt:
touch b.txt
(2)$<
$< 指代第一個前置條件。比如,規(guī)則為 t: p1 p2,那么$< 就指代p1。
a.txt: b.txt c.txt
cp $< $@
等同于下面的寫法。
a.txt: b.txt c.txt
cp b.txt a.txt
(3)$?
$? 指代比目標(biāo)更新的所有前置條件,之間以空格分隔。比如,規(guī)則為 t: p1 p2,其中 p2 的時間戳比 t 新,$?就指代p2。
(4)$^
$^ 指代所有前置條件,之間以空格分隔。比如,規(guī)則為 t: p1 p2,那么 $^ 就指代 p1 p2 。
**(5)$***
$ 指代匹配符 % 匹配的部分, 比如% 匹配 f1.txt 中的f1 ,$ 就表示 f1。
(6)$(@D) 和 $(@F)
$(@D) 和 $(@F) 分別指向 $@ 的目錄名和文件名。比如,$@是 src/input.c,那么$(@D) 的值為 src ,$(@F) 的值為 input.c。
(7)$(<D) 和 $(<F)
$(<D) 和 $(<F)
分別指向 $< 的目錄名和文件名。
所有的自動變量清單,請看手冊。下面是自動變量的一個例子。
dest/%.txt: src/%.txt
@[ -d dest ] || mkdir dest
cp $< $@
上面代碼將 src 目錄下的 txt 文件,拷貝到 dest 目錄下。首先判斷 dest 目錄是否存在,如果不存在就新建,然后,$< 指代前置文件(src/%.txt), $@ 指代目標(biāo)文件(dest/%.txt)。
Makefile使用 Bash 語法,完成判斷和循環(huán)。
ifeq ($(CC),gcc)
libs=$(libs_for_gcc)
else
libs=$(normal_libs)
endif
上面代碼判斷當(dāng)前編譯器是否 gcc ,然后指定不同的庫文件。
LIST = one two three
all:
for i in $(LIST); do \
echo $$i; \
done
# 等同于
all:
for i in one two three; do \
echo $i; \
done
上面代碼的運行結(jié)果。
one
two
three
Makefile 還可以使用函數(shù),格式如下。
$(function arguments)
# 或者
${function arguments}
Makefile提供了許多內(nèi)置函數(shù),可供調(diào)用。下面是幾個常用的內(nèi)置函數(shù)。
(1)shell 函數(shù)
shell 函數(shù)用來執(zhí)行 shell 命令
srcfiles := $(shell echo src/{00..99}.txt)
(2)wildcard 函數(shù)
wildcard 函數(shù)用來在 Makefile 中,替換 Bash 的通配符。
srcfiles := $(wildcard src/*.txt)
(3)subst 函數(shù)
subst 函數(shù)用來文本替換,格式如下。
$(subst from,to,text)
下面的例子將字符串"feet on the street"替換成"fEEt on the strEEt"。
$(subst ee,EE,feet on the street)
下面是一個稍微復(fù)雜的例子。
comma:= ,
empty:=
# space變量用兩個空變量作為標(biāo)識符,當(dāng)中是一個空格
space:= $(empty) $(empty)
foo:= a b c
bar:= $(subst $(space),$(comma),$(foo))
# bar is now `a,b,c'.
(4)patsubst函數(shù)
patsubst 函數(shù)用于模式匹配的替換,格式如下。
$(patsubst pattern,replacement,text)
下面的例子將文件名"x.c.c bar.c",替換成"x.c.o bar.o"。
$(patsubst %.c,%.o,x.c.c bar.c)
(5)替換后綴名
替換后綴名函數(shù)的寫法是:變量名 + 冒號 + 后綴名替換規(guī)則。它實際上patsubst函數(shù)的一種簡寫形式。
min: $(OUTPUT:.js=.min.js)
上面代碼的意思是,將變量OUTPUT中的后綴名 .js 全部替換成 .min.js 。
更多建議: