erlang.mk和makefile语法剖析

Posted 2020-09-26 天之草

1. makefile 基本规则:

1. 所有的源文件没有被编译过,则对各个源文件进行编译并进行链接,生成最后的可执行程序;
2. 每一个在上次执行make之后修改过的源代码文件在本次执行make时将会 被重新编译;
3. 头文件在上一次执行make之后被修改。则所有包含此头文件的源文件在本次执行 make 时将会被重新编译。

2. 基本格式:

TARGET... : PREREQUISITES... 
　　COMMAND
　　...

2.1 target(目标)通常是最后需要生成的文件名或者为了实现这个目的而必需的中间过程文件名。

      也可以是一个make执行的动作的名称,如目标“clean”：伪目标（phony target）。

2.2 PREREQUISITES(依赖条件) 生成规则目标所需要的文件名列表。通常一个目标依赖于一个或者多个文件。

2.3 COMMAND(命令行) 任意的shell命令或者是可在shell下执行的程序。

　　它限定了make执行这条规则时所需要的动作。可以有多个命令行,每一条命令占一行。

注意:每一个命令行必须以[Tab]字符开始,[Tab]字符告诉 make 此行是一个命令行,make程序本身并不关心命令是如何工作的,对目标文件的更新需要你在规则描述中提供正确的命令。

“make”程序所做的 就是当目标程序需要更新时执行规则所定义的命令。

建议：单目标,多依赖。就是说尽量要做到一个规则中只存在一 个目标文件,可有多个依赖文件。尽量避免使用多目标,单依赖的方式 。

最神奇的就是这三个元素都可以使用变量，变量又可以使用通配符展开。

 

下面通过erlang.mk这个项目自己的build过程来了解一下最基本makefile的工作步骤：

##makefile
BUILD_CONFIG_FILE ?= $(CURDIR)/build.config
BUILD_CONFIG = $(shell sed "s/\\#.*//" $(BUILD_CONFIG_FILE))

ERLANG_MK = erlang.mk
ERLANG_MK_VERSION = $(shell git describe --tags --dirty)

.PHONY: all check

all:
awk \'FNR==1 && NR!=1{print ""}1\' $(patsubst %,%.mk,$(BUILD_CONFIG)) \\
| sed \'s/^ERLANG_MK_VERSION = .*/ERLANG_MK_VERSION = $(ERLANG_MK_VERSION)/\' > $(ERLANG_MK)

ifeq ($(p),)
check:
$(MAKE) -C test
else
check:
$(MAKE) -C test pkg-$(p)
endif

以上是根据build.config生成给我们项目自己使用的erlang.mk文件 (注意这个并不在build自定义项目，而只是生成erlang.mk,然后用它来build我们自定义的项目)，它包括了变量赋值.引用,特殊变量 伪目标，终极目标， 条件语句：

3.1 变量

1. Makefile 中变量和函数的展开(除规则命令行中的变量和函数以外),是在 make 读取 makefile 文件时进行的,这里的变量包括了使用“=”定义和使用指示符 “define”定义的。
2. 变量可以用来代表一个文件名列表、编译选项列表、程序运行的选项参数列表、 搜索源文件的目录列表、编译输出的目录列表和所有我们能够想到的事物。
3. 变量名是不包括“:”、“#”、“=”、前置空白和尾空白的任何字符串。 
4. 变量名是大小写敏感的。
5. 另外有一些变量名只包含了一个或者很少的几个特殊的字符(符号)。称它们为 自动化变量。像“$<”、“$@”、“$?”、“$*” 2. 变量的赋值

3.1.1 递归展开式变量

语法：VAR  ＝ Value

BUILD_CONFIG = $(shell sed "s/\\#.*//" $(BUILD_CONFIG_FILE))

使用此风格的变量定义,可能会由于出现变量的递归定义而导致make陷入到无限的变量展开过程中,最终使 make 执行失败。如下：

CFLAGS = $(CFLAGS) –O

这种风格的变量定义中如果使用了函数,那么包含在变量值中的 函数总会在变量被引用的地方执行(变量被展开时)。

3.1.2 直接展开式变量  

语法  VAR := Value
变量值中对其他量或者函数的引用在定义变量时被展开(对变量进行替换)

x := foo 
y := $(x) bar 
x := later
# 就等价于: 
y := foo bar
 x := later

 3.1.3 ?= 操作符

 BUILD_CONFIG_FILE ?= $(CURDIR)/build.config　

只有此变量在之前没有赋值的情况下才会对这个变量进行赋值。

正因为变量只是简单的宏展开，且所有的makefile都是先从头到尾先计算好更新规则后，一次性从终极目标（第一个目标）开始执行的。所以在erlang.mk中才必须core的部分写在编译前面（因为core中定义了大量与编译erl相关的参数）。

3.2 变量的引用

$(BUILD_CONFIG)    
#或
${BUILD_CONFIG}

3.3 特殊的变量

$(CURDIR) 此变量代表 make 的工 作目录。当使用“-C”选项进入一个子目录后,此变量将被重新赋值。总之,如果在 Makefile 中没有对此变量进行显式的赋值操作,那么它代表 make 的工作目录。
$(MAKE) 用于递归展开make时MAKE可以带不一样的参数，比如MAKE := /bin/make 在另一个目录就是MAKE := /bin/make -t
3.4 伪目标 
语法 ：target不是一个真正的文件名
使用.phony:all check 的原因：避免 目录中有一个文件叫all或check,强制说明这个是伪目标。
3.5 命令行
在 Makefile 中书写在同一行中的多个命令属于一个完整的 shell 命令行,书写在独立行的一条命令是一个独立的 shell 命令行。
如果想在同一个shell中运行多条命令，应该用 \\ 连接各个命令。让它成为一行命令。
3.6. 条件语句：

ifeq($(p),)
check:
$(MAKE) -C test
else
check:
$(MAKE) -C test pkg-$(p)
endif 

3.7 shell 命令：

#把BUILD_CONFIG_FILE里面的所有注释去掉。
sed \'s/pattern/replace_string\' FileName
sed "s/\\#.*//" $(BUILD_CONFIG_FILE) 

#表示在除了第一个文件croe/core.mk外，其它的文件第一行都要先加一个空行。1表示返回值为1
awk \'BEGIN{print "start"} pattern{ commands} END{print "end"} file
awk \'FNR==1 && NR!=1{print ""}1\' $(patsubst %,%.mk,$(BUILD_CONFIG)) 
#展开后：
awk \'FNR==1 && NR!=1{print ""}1\' core/core.mk index/*.mk core/index.mk core/deps.mk plugins/protobuffs.mk core/erlc.mk core/docs.mk core/test.mk plugins/asciidoc.mk plugins/bootstrap.mk plugins/c_src.mk plugins/ci.mk plugins/ct.mk plugins/dialyzer.mk plugins/edoc.mk plugins/elvis.mk plugins/erlydtl.mk plugins/escript.mk plugins/eunit.mk plugins/relx.mk plugins/shell.mk plugins/triq.mk plugins/xref.mk plugins/cover.mk

awk特殊变量：
　NR:表示记录数量，在执行过程中对应于当前行号
　FNR:表示单个文件的当前行号，在多个文件中不会累加，NR会累加。
3.8 make 内置函数

patsubst %, %.mk,$(BUILD_CONFIG))

把BUILD_CONFIG里面的第行都加上.mk结尾。patsubst是makefile的一个内部函数。

3.9 终极目标

默认的情况下,make执行的是Makefile中的第一个规则,此规则的第一个目标称 之为“最终目的”或者“终极目标”(就是一个Makefile最终需要更新或者创建的目标）。

 

摘抄博客：http://www.cnblogs.com/zhongwencool/p/erlang_mk.html