Makefile第五课：Makefile介绍

Posted 2023-03-31 爱听歌的周童鞋

目录

• Makefile基本格式、规则、伪目标
• • 前言
  • 1.基本格式
  • 2.Makefile规则
  • 3.伪目标
  • 总结

Makefile基本格式、规则、伪目标

前言

学习杜老师推荐的Makefile教程视频，链接。记录下个人学习笔记，仅供自己参考。

之前有转载过杜老师的从零Makefile落地算法大项目文章，感兴趣的可以看看。

本课程主要讲解Makefile的基本格式、规则和伪目标。

• GNU Make 官方网站：https://www.gnu.org/software/make/
• GNU Make 官方文档下载地址：https://www.gnu.org/software/make/manual/
• Makefile Tutorial：https://makefiletutorial.com/

1.基本格式

targets : prerequisties
[tab键]command

• target(生成项)：目标文件，可以是 OjectFile，也可以是执行文件，还可以是一个标签（Label），对于标签这种特性，在后续的“伪目标”章节中会有叙述。
• prerequisite(依赖项)：要生成那个 target 所需要的文件或是目标。
• command：是 make 需要执行的命令

示例如下：

debug :
	@echo hello

当在终端执行make时会打印 hello ，@符号表示让命令在执行时不显示在终端上。通常在Makefile中来隐藏一些自动化构建过程中的详细信息，让终端上的输出更加简洁明了。如果不加@则终端上打印如下内容：

echo hello
hello

2.Makefile规则

• make 会在当前目录下找到一个名字叫 Makefile 或 makefile 的文件
• 如果找到，它会找文件中第一个目标文件（target），并把这个文件作为最终的目标文件
• 如果 target 文件不存在，或是 target 文件依赖的 .o 文件(prerequities)的文件修改时间要比 target 这个文件新，就会执行后面所定义的命令 command 来生成 target 这个文件
• 如果 target 依赖的 .o 文件（prerequisties）也存在，make 会在当前文件中找到 target 为 .o 文件的依赖性，如果找到，再根据那个规则生成 .o 文件

3.伪目标

Makefile中的伪目标指的是那些不对应实际文件的目标，它们只是一些在Makefile中定义的命令的结合，用于执行一些特定的操作或者一些构建过程中的辅助操作。(from ChatGPT)

伪目标的出现是为了避免与实际文件同名的情况，例如，我们可能定义了一个名为clean的目标，用于清除生成的文件，但是如果我们的项目中也有一个名为clean的文件，那么Make工具就无法区分是否要执行清除操作还是编译这个文件。同时伪目标也可以实现一些辅助性质的任务，比如清理目标、打印帮助信息等。

伪目标在Makefile中的定义通常使用.PHONY来标识，例如：

clean :
	rm -rf *.o

.PHONY : clean

上面的Makefile文件中，定义了一个名为clean的伪目标，它的作用是删除当前目录下的所有.o文件。通常使用.PHONY标识，make命令就知道clean是一个伪目标，不会将其作为实际文件进行检查和编译。

总结

本次课程于我而言主要学习到了伪目标，即只需要完成命令不对应生成实际文件的目标，如debug、clean等等。

《GNU_makefile》第五章——为规则书写命令

1.

　　使用make的命令行参数-n或--just-print，make会只显示要执行的命令，不执行，这样方便调试makefile。

2.执行命令

　　每写一行命令，make会fork出一个shell进程来执行该命令，如果要让shell连续执行多条语句，使用 ; 链接命令。

　　SHELL环境变量指定make使用的shell程序.

3.并发执行

　　使用命令行选项-j指定make最多fork多少个shell进程去执行命令。

4.命令执行的错误

　　命令执行错误返回非0，make放弃对后续命令的执行。

　　使用 -，让make忽略命令执行错误。

　　如： -rm *.o

5.

6.递归执行命令

subsystem:
    cd subdir && $(MAKE)
其等价于规则：
subsystem:
    $(MAKE) -C subdir

　　make只将 命令定义变量（如 CFLAGS），环境变量（export xxx）传递给子make。

　　export 的一个变量或函数的引用，会被立即展开。

Y = Z
export X=$(Y)

　　不带任何参数的 export 指示符，会将所有变量传递给子make，但不但任何参数的unexport没有任何意义。

　　在多级make中，变量 MAKELEVEL 代表了调用深度，最上层为0，依次加1

Main 目录下的 Makefile 清单如下：
#maindir Makefile
………
………
.PHONY :test
test:
    @echo “main makelevel = $(MAKELEVEL)”
    @$(MAKE) –C subdir dislevel
#subdir Makefile
………..
………..
.PHONY : test
test :
    @echo “subdir makelevel = $(MAKELEVEL)”
在 maindir 目录下执行“ make test”。将显式如下信息：
main makelevel = 0
make[1]: Entering directory `/…../ subdir ‘
subdir makelevel = 1
make[1]: Leaving directory `/…../ subdir ‘

这个变量主要用在条件测试指令中。例如：我们可以通过测试此变量的值来决定是
否执行递归方式的 make 调用或者其他方式的 make 调用。我们希望一个子目录必须被
上层 make 调用才可以执行此目录下的 Makefile，而不允许直接在此目录下执行 make。
我们可以这样实现：
.......
ifeq ($(MAKELEVEL),0)
all : msg
else
all : other
endif
……
…...
msg:
@echo ”Can not make in this directory!”

　　命令行参数之所以可以传递给子make，是因为命令行参数借助环境变量MAKEFLAGS传递。

        “-C”、“ -f”、“ -o”和“ -W”。 这些命令行选项是不会被赋值给变量“ MAKEFLAGS”的 

　　-j虽然会被传递，但子make和主控make会进行通信，保证整个进程数不超过-j设置的值。

　　当不希望MAKEFLAGS传递给子make，可以将其置空

subsystem:
    cd subdir && $(MAKE) MAKEFLAGS=

 

7.定义命令包

　　命令包和C语言中的宏一样。

　　如

define run-yacc
yacc $(firstword $^)
mv y.tab.c $@
endef

　　命令包的使用，命令包在运行阶段被展开，和宏一样，是完全替换

foo.c : foo.y
    $(run-yacc)

--》
foo.c : foo.y
    yacc $(firstword $^)
    mv y.tab.c $@

　　在$(run-yacc)前一个tab，导致命令包每个命令前都加一个tab