[Erlang_Question34]erlang.mk的源码阅读1-入门makefile

通过erlang.mk项目，掌握基本的makefile语法，可以自己定制makefile。

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”程序所做的 就是当目标程序需要更新时执行规则所定义的命令。

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

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

3. 实战(build erlang.mk项目)

下面通过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. 另外有一些变量名只包含了一个或者很少的几个特殊的字符(符号)。称它们为 自动化变量。像“$<”、“[email protected]”、“$?”、“$*” 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表示返回值为1awk ‘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最终需要更新或者创建的目标）。

4. erlang.mk build 自定义项目

4.1 core.mk负责做什么？

　　

core.mk的源代码（点这里），一起来过一遍里面定义各种变量时使用到的makefile知识 ：P

$(MAKEFILE_LIST)
 make 程序在读取多个 makefile 文件时,包括由环境变量“MAKEFILES”指定、 命令行指令、当前工作下的默认的以及使用指示符“include”指定包含的,在对这些文件进行解析执行之前make读取的文件名将会被自动依次追加到变量 “MAKEFILE_LIST”的定义域中 
ERLANG_MK_FILENAME := $(realpath 　　　　$(lastword $(MAKEFILE_LIST)))
 
$(lastword $(MAKEFILE_LIST))
 取最后一个word :内置函数   
$(realpath $(lastword $(MAKEFILE_LIST)))
 表示把路径转为绝对路径（. .. ~转化为具体的路径)   
@
 当前目标名字（The file name of the target.) 
verbose_0 = @ 
$(verbose_$(V))
变量名也可以使用拼接的方式，

谨记：变量只是简单的文本展开

 
V?=0verbose = $(verbose_$(V))
 
ifneq

　　

 条件判断语句 
ifeq ($(PLATFORM),)UNAME_S := $(shell uname -s)
 
export 　　
 把一个变量export，Tell make whether or not to export a particular variable to child processes. 
export PLATFORM
::

双冒号规则中,当依赖文件比目标更新时。规则将会被执行。对于一个没有依 赖而只有命令行的双冒号规则,当引用此目标时,规则的命令将会被无条件执 行。而普通规则,当规则的目标文件存在时,此规则的命令永远不会被执行(目 标文件永远是最新的)。

当同一个文件作为多个双冒号规则的目标时。这些不同的规则会被独立的处理, 而不是像普通规则那样合并所有的依赖到一个目标文件

 
all:: deps   $(verbose) $(MAKE) --no-print-directory app   $(verbose) $(MAKE) --no-print-directory rel

#这个也是终极目标！出现在mk中的第一个目标！
 
define name   multi commandendef

在使用指示符“define”定义一个多行的变量或者命令包时,其定义体 (“define”和“endef”之间的内容)会被完整的展开到 Makefile 中引用此变量的地方 (包含定义体中的注释行);make 在引用此变量的地方对所有的定义体进行处理,决 定是注释还是有效内容。

 
define core_http_get   wget --no-check-certificate -O $(1) $(2)|| rm $(1)endef#调用
$(call core_http_get,$(ELVIS),$(ELVIS_URL))








内置函数可以参考这里。


在core.mk里面有一个有意思的功能：它使用 make erlang.mk 会自动更新到最新版本的erlang.mk。


erlang-mk:
    git clone https://github.com/ninenines/erlang.mk $(ERLANG_MK_BUILD_DIR)
    if [ -f $(ERLANG_MK_BUILD_CONFIG) ]; then cp $(ERLANG_MK_BUILD_CONFIG) $(ERLANG_MK_BUILD_DIR); fi
    cd $(ERLANG_MK_BUILD_DIR) && $(MAKE)
    cp $(ERLANG_MK_BUILD_DIR)/erlang.mk ./erlang.mk
    rm -rf $(ERLANG_MK_BUILD_DIR)


基本上*.mk都是这个套路，接下来进入正题：


4.2 erlang.mk到底怎么build自定义项目的？


上一节已讲到makefile的入口：终极目标是all， 一切都是从这里开始的。


#core.mk
all:: deps
    $(verbose) $(MAKE) --no-print-directory app
    $(verbose) $(MAKE) --no-print-directory rel
#deps.mk
ifneq ($(SKIP_DEPS),)
deps::
else
deps:: $(ALL_DEPS_DIRS)
ifneq ($(IS_DEP),1)
    $(verbose) rm -f $(ERLANG_MK_TMP)/deps.log
endif
    $(verbose) mkdir -p $(ERLANG_MK_TMP)
    $(verbose) for dep in $(ALL_DEPS_DIRS) ; do         if grep -qs ^$$dep$$ $(ERLANG_MK_TMP)/deps.log; then             echo -n;         else             echo $$dep >> $(ERLANG_MK_TMP)/deps.log;             if [ -f $$dep/GNUmakefile ] || [ -f $$dep/makefile ] || [ -f $$dep/Makefile ]; then                 $(MAKE) -C $$dep IS_DEP=1 || exit $$?;             else                 echo "ERROR: No Makefile to build dependency $$dep.";                 exit 1;             fi         fi     done
endif

#erlc.mk
ifeq ($(wildcard ebin/test),)
app:: app-build
else
app:: clean app-build
endif


你只要认真看看这三个mk就可以理清他们是怎么工作的，完全不需要再新了解规则！


感觉这里还是很有意思的，准备下次再画个图理理！这周就先到这里吧。


周未愉快 ～


5. 参考文档


5.1 erlang.mk github地址


5.2 makefile中文手册


5.3 makefile quick reference


6. Todo:


0.erlang.mk如何组织依赖关系？


1.如何并行编译（如何控制并行的先后顺序）？


2.如何调试makefile?


3.makefile的命令行小技巧？


4.如何给erlang.mk加自定义的功能？


--------------------------------------------------------------------------------------------------------------------------------------------------


一次编译成功～～




 
				


				
时间： 2025-01-31 00:27:50 

		


		


	

	
	

		


		
[Erlang_Question34]erlang.mk的源码阅读1-入门makefile的相关文章


								

		

			

                CI框架源码阅读笔记3 全局函数Common.php
			

		

		

									

				从本篇开始,将深入CI框架的内部,一步步去探索这个框架的实现.结构和设计. Common.php文件定义了一系列的全局函数(一般来说,全局函数具有最高的加载优先权,因此大多数的框架中BootStrap引导文件都会最先引入全局函数,以便于之后的处理工作). 打开Common.php中,第一行代码就非常诡异: if ( ! defined('BASEPATH')) exit('No direct script access allowed'); 上一篇(CI框架源码阅读笔记2 一切的入口 index			

		

	

				

		

			

                淘宝数据库OceanBase SQL编译器部分 源码阅读--生成逻辑计划
			

		

		

									

				body, td { font-family: tahoma; font-size: 10pt; } 淘宝数据库OceanBase SQL编译器部分 源码阅读--生成逻辑计划 SQL编译解析三部曲分为:构建语法树,生成逻辑计划,指定物理执行计划.第一步骤,在我的上一篇博客淘宝数据库OceanBase SQL编译器部分 源码阅读--解析SQL语法树里做了介绍,这篇博客主要研究第二步,生成逻辑计划. 一. 什么是逻辑计划?我们已经知道,语法树就是一个树状的结构组织,每个节点代表一种类型的语法含义.如			

		

	

				

		

			

                JDK部分源码阅读与理解
			

		

		

									

				本文为博主原创,允许转载,但请声明原文地址:http://www.coselding.cn/article/2016/05/31/JDK部分源码阅读与理解/ 不喜欢重复造轮子,不喜欢贴各种东西.JDK代码什么的,让整篇文章很乱...JDK源码谁都有,没什么好贴的...如果你没看过JDK源码,建议打开Eclipse边看源码边看这篇文章,看过的可以把这篇文章当成是知识点备忘录... JDK容器类中有大量的空指针.数组越界.状态异常等异常处理,这些不是重点,我们关注的应该是它的一些底层的具体实现,这篇			

		

	

				

		

			

                如何阅读Java源码 阅读java的真实体会
			

		

		

									

				刚才在论坛不经意间,看到有关源码阅读的帖子.回想自己前几年,阅读源码那种兴奋和成就感(1),不禁又有一种激动. 源码阅读,我觉得最核心有三点:技术基础+强烈的求知欲+耐心. 说到技术基础,我打个比方吧,如果你从来没有学过Java,或是任何一门编程语言如C++,一开始去啃<Core Java>,你是很难从中吸收到营养的,特别是<深入Java虚拟机>这类书,别人觉得好,未必适合现在的你. 虽然Tomcat的源码很漂亮,但我绝不建议你一开始就读它.我文中会专门谈到这个,暂时不展开. 强烈			

		

	

				

		

			

                Memcache-Java-Client-Release源码阅读（之七）
			

		

		

									

				一.主要内容 本章节的主要内容是介绍Memcache Client的Native,Old_Compat,New_Compat三个Hash算法的应用及实现. 二.准备工作 1.服务器启动192.168.0.106:11211,192.168.0.106:11212两个服务端实例. 2.示例代码: String[] servers = { "192.168.0.106:11211", "192.168.0.106:11212" }; SockIOPool pool =			

		

	

				

		

			

                源码阅读笔记 - 1 MSVC2015中的std::sort
			

		

		

									

				大约寒假开始的时候我就已经把std::sort的源码阅读完毕并理解其中的做法了,到了寒假结尾,姑且把它写出来 这是我的第一篇源码阅读笔记,以后会发更多的,包括算法和库实现,源码会按照我自己的代码风格格式化,去掉或者展开用于条件编译或者debug检查的宏,依重要程度重新排序函数,但是不会改变命名方式(虽然MSVC的STL命名实在是我不能接受的那种),对于代码块的解释会在代码块前(上面)用注释标明. template<class _RanIt, class _Diff, class _Pr> in			

		

	

				

		

			

                JDK 源码 阅读 - 2 - 设计模式 - 创建型模式
			

		

		

									

				A.创建型模式 抽象工厂(Abstract Factory) javax.xml.parsers.DocumentBuilderFactory DocumentBuilderFactory通过FactoryFinder实例化具体的Factory. 使用例子: DocumentBuilderFactory docBuilderFactory = DocumentBuilderFactory.newInstance(); DocumentBuilder docBuilder = docBuilder			

		

	

				

		

			

                CI源码阅读
			

		

		

									

				CodeIgniter源码分析 http://calixwu.com/2014/11/codeigniter-yuanmafenxi.html CI框架源码阅读笔记 http://www.cnblogs.com/ohmygirl/p/4052686.html			

		

	

				

		

			

                《java.util.concurrent 包源码阅读》13 线程池系列之ThreadPoolExecutor 第三部分
			

		

		

									

				这一部分来说说线程池如何进行状态控制,即线程池的开启和关闭. 先来说说线程池的开启,这部分来看ThreadPoolExecutor构造方法: public ThreadPoolExecutor(int corePoolSize, int maximumPoolSize, long keepAliveTime, TimeUnit unit, BlockingQueue<Runnable> workQueue, ThreadFactory threadFactory, RejectedExecut