makefile教程
基于Make 命令教程 - 阮一峰的网络日志 (ruanyifeng.com)总结,可以将make看作一个自顶向下的构建工具
一个makefile例子
# 文件名就是makefile,没有后缀
# 如果存在b.txt和c.txt,就把两者内容输出到a.txt
a.txt: b.txt c.txt
cat b.txt c.txt > a.txt
在makefile相同目录下执行make
可查看效果
makefile文件名默认Makefile
或makefile
.也可以指定文件: make -f rules.txt
或者make --file=rules.txt
makefile语法定义
<target> : <prerequisites>
[tab] <commands>
如果前置条件满足,执行命令构建目标
- 目标是必须的
- 前置条件和命令对可选的,但是两个必须至少存在一个 (只有目标没有前置条件和命令也是可以的,只不过没有意义
目标
目标可以是文件,也可以是某个操作的名字
clean:
rm *.o
运行make clean
可以执行这个操作:
-
如果文件存在,会输出执行的指令
rm *.o
-
如果当前目录不存在.o文件,make会报错提示
rm *.o rm: *.o: No such file or directory make: *** [clean] Error 1
如果make检测到当前目录中存在clean文件,就不会执行clean操作,因此最好标明clean是个操作
.PHONY: clean
clean:
rm *.o temp
- makefile未指定文件时,默认寻找Makefile or makefile
- make没有执行目标时,默认运行Makefile的第一个目标
前置条件
前置条件通常是一组文件名,用空格分割,指定了目标是否重新构建的标准:只要有一个前置文件不存在,或者有过更新(前置文件的修改时间晚于目标文件),目标就需要重新构建
result.txt: source.txt
cp source.txt result.txt
如果当前目录没有source.txt,make会首到makefile的下面去寻找有没有生成source.txt的目标
result.txt: source.txt
cp source.txt result.txt
source.txt:
echo "this is the source" > source.txt
命令
命令行首默认必须是一个tab键!!!,如果测试过程有报错记得检查下,如果想替换,可用.RECIPEPREFIX替换(对整个文件生效 (The .RECIPEPREFIX is only supported since 3.82
.RECIPEPREFIX = >
all:
> echo Hello, world
每条命令都在单独的shell中执行,这些shell没有关联,也没有继承关系
var-lost:
export foo=bar
echo "foo=[$$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]"
语法
#
表示注释
正常情况下,make会打印每条命令,即使注释也会打印,在命令前面加@可以关闭打印
test:
# 这是测试
@# 这是测试,不会打印出来
通配符
用来指定一组符合条件的文件名,与bash类似 * ? [...]
允许对文件名进行模式匹配,匹配符是%
下面的命令将 file1.c 编译为file1.o
%.o: %.c
允许使用 = 自定义变量
txt = Hello world
test:
@echo $(txt)
调用shell变量,需要两个$$,因为make命令会使$转义
变量支持引用
v1 = $(v2)
为了区分生效时间,分成四类 gnu make - What is the difference between the GNU Makefile variable assignments =, ?=, := and +=? - Stack Overflow
VARIABLE = value
# 在执行时扩展,允许递归扩展。
VARIABLE := value
# 在定义时扩展。
VARIABLE ?= value
# 只有在该变量为空时才设置值。
VARIABLE += value
# 将值追加到变量的尾端。
内置变量
$(CC)指向当前编译器
$(MAKE)指向当前make工具
详细如表 https://www.gnu.org/software/make/manual/html_node/Implicit-Variables.html
自动变量
-
@`就指 foo
-
$< 代指第一个前置条件
-
$? 代指比目标更新的所有前置条件 空格分割
-
$^ 代指所有前置条件
-
$* 代指匹配符%匹配的部分
-
$(@D)
和$(@F)
指向目标的目录名和文件名 -
$(<D)
和$(<F)
指向$<
de 的目录名和文件名
https://www.gnu.org/software/make/manual/html_node/Automatic-Variables.html
判断和循环 与bash相同
ifeq ($(CC),gcc)
libs=$(libs_for_gcc)
else
libs=$(normal_libs)
endif
函数格式
$(function arguments)
# 或者
${function arguments}
内置函数
https://www.gnu.org/software/make/manual/html_node/Functions.html
-
shell函数
srcfiles := $(shell echo src/{00..99}.txt)
-
wildcard 函数
srcfiles := $(wildcard src/*.txt)
-
subst函数 文本替换
$(subst from,to,text)