Makefile使用

语法规则

目标 : 依赖
	命令

• 目标：要生成的文件，一个文件中可以有多个目标
• 依赖：即目标文件依赖于哪些文件或者哪些目标
• 命令：即生成目标文件需要执行的命令（每条命令之前必须有一个tab保持缩进，一些编辑工具默认tab为4个空格，会造成Makefile语法错误）。

编译规则

1. 输入 make 命令
2. make 会在当前目录下找名字叫 Makefile 或makefile的文件
3. 如果找到，它会找文件中的第一个目标，并把该目标作为终极目标。
4. 如果终极目标文件不存在，或是终极目标所依赖的文件修改时间要比终极目标文件新，那么，他就会执行后面所定义的命令来生成终极目标文件。
5. 如果终极目标所依赖的文件也不存在，那么make会在当前文件中找目标为依赖文件的规则，如果找到则再根据那一个规则生成依赖文件。
6. 依次类推，直到生成终极目标文件
7. 如果一个规则没有被终极目标直接或间接关联，那么该规则的命令将不会被自动执行，只能使用 make 目标名称 进行执行

//main.c
#include <stdio.h>

int main(void){
	printf("hello word!\n");
	retrun 0;
}

#makefile

# main 依赖于 main.o
main:main.o
	# 根据 main.o 链接生成 main 可执行文件
	gcc main.o -o main
	
# main.o 依赖于 main.c
main.o:main.c
	# 根据 main.c 编译生成 main.o
	gcc -c main.c -o main.o

变量

变量定义不能定义在语法规则中的命令中，需要定义在规则之前

//定义变量（变量名习惯使用大写）
VALUE_TEST = test

//引用变量
$(VALUE_TEST) 或者 ${VALUE_TEST}

内置变量

变量名	变量说明
AR	打包函数，默认命令为"ar"
AS	汇编编译，默认命令为"as"
CC	C语言编译，默认命令为"cc"
CXX	C++语言编译，默认命令为"g++"
CPP	C语言预处理命令，默认为"$(CC) -E”
RM	删除文件命令，默认为"rm -f"
ARFLGS	打包程序AR的参数
ASFLAGS	汇编语言编译器参数
CFLAGS	C语言编译参数
CXXFLAGS	C++语言编译器参数
LDFLAGS	链接器参数

自动化变量

自动化变量	说明
$@	规则中的⽬标。当⼀个规则中有多个⽬标时，则指的是其中任何造成命令被运⾏的⽬标。
$<	规则中的第⼀个依赖条件，如果没有依赖文件时使用会报错
$^	规则中的所有依赖条件，如果没有依赖文件时使用会报错

A B:C D
	echo "\$$@ = $@"
	echo "\$$< = $<"
	echo "\$$^ = $^"
C D
	echo "\$$@ = $@"
	
#执行 make 命令，则终极目标是 A，根据依赖关系需要分别生成 C、D、A 规则的目标，输出如下：
$@ = C
$@ = D
$@ = A
$< = C
$^ = C D

#执行 make D 命令，则终极目标为D，输出如下：
$@ = D

赋值

• 简单赋值 :=

#最终输出 Y 的值为 a，X 的值为 b

X := a
Y := $(X)
X := b

• 递归赋值 =

#最终输出 Y 的值为 b，X 的值为 b

X = a
Y = $(X)
X = b

• 条件赋值 ?=：如果变量未定义，则使用符号中的值定义变量。如果该变量已经赋值，则该赋值语句无效
• 追加赋值 +=：原变量用空格隔开的方式追加一个新值

流程控制

判断条件	说明
ifdef	判断是否存在该变量
ifndef	判断是否不存在该变量
ifeq	判断是否相等
ifneq	判断是否不相等

• 语法规则

判断条件
	命令
endif

判断条件
	命令1
else
	命令2
endif

判断条件1
	命令1
else 判断条件2
	命令2
else
	命令3
endif

• 示例

//判断是否有值，有值为true，没有为false
ifdef VARIABLE-NAME
	message = "VARIABLE-NAME is defined"
endif

//判断参数是否相等，相等则为true，否则为false
ifeq (ARG1, ARG2)
ifeq 'ARG1' 'ARG2'

//示例
ifeq($(CC),gcc)
    libs=$(libs_for_gcc)
else
    libs=$(normal_libs)
endif

内置函数

函数调用很像变量的使用，也是以$来标识的，其语法如下：$(<function> <arguments> )或是${<function> <arguments>}

函数	说明
$(shell <command>) 或者 \command`	执行shell命令
$( subst <source>,<new>,<text>)	把字符串 中的 替换为，返回替换过的字符串
$( patsubst <pattern>,<replacement>,<text>)	和 subst 类似，只是 subst 是字符替换，patsubst 是模式替换（即可以使用通配符%）
$(strip <text>)	去除 中的空格，并返回去除后字符串
$(findstring <text>,<elem>)	在字符串 中查找 字符串是否存在，如果找到，返回 字符串, 否则返回空字符串
$(filter <elem1 elem2...>,<text>)	条件过滤，返回符合条件的元素
$(filter-out <elem1 elem2...>,<text>)	条件过滤，返回不符合条件的元素
$(wildcard *.x)	获取当前目录下所有 .x 的文件
$(notdir <elem elem...>)	获取文件列表的文件名
$(dir <elem1 elem2...>)	获取文件列表的文件夹路径
$(suffix <elem1 elem2...>)	获取文件列表的文件后缀（没有后缀则返回空字符串）
$(basename <elem1 elem2...>)	获取文件列表的文件前缀
$(addsuffix <suffix>,<elem1 elem2...>)	把后缀 加到 中的每个单词后面
$(addprefix <prefix>, <elem1 elem2...>)	把前缀 加到 中的每个单词前面

shell

# 如下输出为 A B makefile

all：
	`touch A`
	`touch B`
	echo $(shell <shell command>)

subst

# 如下示例输出为 hello word?
A := hello world!
all:
	@echo ${subst !,?,$(A)}

patsubst

# 如下示例输出为 A.o B.o
all:
	@echo ${patsubst %.c,%.o,A.c B.c}

dir

# 如下示例输出为 A/ /test/B/ ./
all:
	@echo $(dir A/A.mk /test/B/B.mk C.mk)

notdir

# 如下示例输出为 A.mk B.mk
all:
	@echo $(dir A/A.mk /test/B/B.mk /test/C/)

隐含规则

main:main.o
	gcc main.o -o main
	
main.o:main.c
	gcc -c main.c -o main.o

如上示例，可以简写为：

main:main.o
	gcc main.o -o main

这是因为 make 会调用隐含规则，把 .o 的目标的依赖文件置成 .c，并使用C的编译命令cc –c $(CFLAGS) [.c]来生成.o的目标

其他

通配符

• %：一般用于模式匹配，例如%.o表示匹配所有的.o文件
• *：一般用于所有，例如*.o是表示所有的.o文件

静态模式

<targets...>: <target-pattern>: <prereq-patterns ...>
	<commands>

• targets 定义了一系列的目标文件，可以有通配符。是目标的一个集合。
• target-parrtern 是指明了targets的模式，也就是的目标集模式。
• prereq-parrterns 是目标的依赖模式，它对target-parrtern形成的模式再进行一次依赖目标的定义。

objects = foo.o bar.o
all: $(objects)
	
$(objects): %.o: %.c
	$(CC) -c $(CFLAGS) $< -o $@

如上示例，指明了目标从$object中获取，%.o表明要所有以.o结尾的目标，也就是foo.o bar.o，而依赖模式%.c则取模式%.o的%，也就是“foo bar”，并为其加下.c的后缀。展开后如下所示：

foo.o : foo.c
	$(CC) -c $(CFLAGS) foo.c -o foo.o
bar.o : bar.c
	$(CC) -c $(CFLAGS) bar.c -o bar.o

命令规则

• 不用前缀：输出执行的命令以及命令执行的结果, 出错的话停止执行
• 前缀 @：只输出命令执行的结果, 出错的话停止执行
• 前缀 -：命令执行有错的话, 忽略错误, 继续执行

命令包

#定义命令包
define <command-name>
command
...
endef

#使用命令包
$(command-name)

#如下示例输出：hello word!

define printHello
@echo "hello word!"
endef

all:
	$(printHello)

伪目标

通常情况下，目标会被识别文件，导致会触发一些隐式编译规则。有时为了避免这种情况，需要标识目标为伪目标，即不对应相应的文件，并且不会被识别为顶层目标。

.PHONE：clean
clean:
	rm -rf *.o

关闭回显

#makefile中会打印每行命令，通过如下方式关闭回显

@echo "clean done!"

参考

• makefile详解
• makefile 完美教程
• makefile教程