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文件名默认Makefilemakefile.也可以指定文件: make -f rules.txt或者make --file=rules.txt

makefile语法定义

 :  
[tab]  

如果前置条件满足,执行命令构建目标

  • 目标是必须的
  • 前置条件和命令对可选的,但是两个必须至少存在一个 (只有目标没有前置条件和命令也是可以的,只不过没有意义

目标

目标可以是文件,也可以是某个操作的名字

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

自动变量

  1. @`就指 foo

  2. $< 代指第一个前置条件

  3. $? 代指比目标更新的所有前置条件 空格分割

  4. $^ 代指所有前置条件

  5. $* 代指匹配符%匹配的部分

  6. $(@D)$(@F)指向目标的目录名和文件名

  7. $($( 指向 $<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

  1. shell函数

    srcfiles := $(shell echo src/{00..99}.txt)
    
  2. wildcard 函数

    srcfiles := $(wildcard src/*.txt)
    
  3. subst函数 文本替换

    $(subst from,to,text)
    

你可能感兴趣的:(makefile教程)