【Makefile】Makefile语法学习笔记

语法规则

目标 ... : 依赖 ...
	命令1
	命令2
	...

Makefile的核心规则,类似于一位厨神做菜,目标就是做好一道菜,那么所谓的依赖就是各种食材,各种厨具等等,然后需要厨师好的技术方法类似于命令,才能作出一道好菜。

同时这些依赖也有可能此时并不存在,需要现场制作,或者是由其他厨师做好,那么这个依赖就成为了其他规则的目标,该目标也会有他自己的依赖和命令。这样就形成了一层一层递归依赖组成了Makefile文件。

Makefile并不会关心命令是如何执行的,仅仅只是会去执行所有定义的命令,和我们平时直接输入命令行是一样的效果。

1、目标即要生成的文件。如果目标文件的更新时间晚于依赖文件更新时间,则说明依赖文件没有改动,目标文件不需要重新编译。否则会进行重新编译并更新目标文件。

2、默认情况下Makefile的第一个目标为终极目标。

3、依赖:即目标文件由哪些文件生成。

4、命令:即通过执行命令由依赖文件生成目标文件。注意每条命令之前必须有一个tab保持缩进,这是语法要求(会有一些编辑工具默认tab为4个空格,会造成Makefile语法错误)。

5、all:Makefile文件默认只生成第一个目标文件即完成编译,但是我们可以通过all 指定所需要生成的目标文件。

变量

$:符号表示取变量的值,当变量名多于一个字符时,使用"()"
$@:指代当前的target,表示生成的目标文件
$<:代表第一个依赖文件,指代prerequisites(依赖条件)
$^:指代prerequisites中的所有项,以空格分隔
$?:指代prerequisites中比目标文件的时间戳更新的那些文件
$(@D)和$(@F)对$@拆解得到的编译目标存放的目录和编译目标的纯文件名
$(<D)和$(<F)同上,只不过是$<拆解得到的目录和纯文件名

SRC = $(wildcard *.c)
OBJ = $(patsubst %.c,%.o,$(SRC))

ALL:hello.out

hello.out:$(OBJ)
	gcc &< -o $@

$(OBJ):$(SRC)
	gcc -c $< -o $@

变量赋值

1."="是最普通的等号,在Makefile中容易搞错赋值等号,使用"="进行赋值,变量的值是整个Makefile中最后被指定的值。

VIR_A = A
VIR_B = $(VIR_A) B
VIR_A = AA

经过上面赋值后,最后VIR_B的值是AA B,而不是A B。

2.":="表示直接赋值,赋予当前位置的值。

VIR_A := A
VIR_B := $(VIR_A) B
VIR_A := AA

最后BIR_B的值是A B,即根据当前位置进行赋值。因此相当于“=”,“:=”才是真正意义上的直接赋值

3、" ?= " 表示如果该变量没有被赋值,赋值予等号后面的值。

4、" += "和平时写代码的理解是一样的,表示将符号后面的值添加到前面的变量上

VARIABLE = value  # 在执行时扩展,允许递归扩展
VARIABLE := value # 在定义时就扩展(和Mathematica的逻辑相反)
VARIABLE ?= value # 只有在该变量为空时才设置值
VARIABLE += value # 将值追加到变量的尾端

预定义变量

CC:c编译器的名称,默认值为cc。cpp c预编译器的名称默认值为$(CC) -E

CC = gcc

回显问题,Makefile中的命令都会被打印出来。如果不想打印命令部分 可以使用@去除回显

@echo "clean done!"

函数

通配符

匹配目录下所有.c文件,并将其赋值给SRC变量

SRC = $(wildcard ./*.c)

这个函数有三个参数,意思是去除SRC中的所有值,然后将.c替换为.o最后赋值给OBJ变量。

OBJ = $(patsubst %.c,%.o,$(SRC))

示例:如果目录下有很多个.c 源文件,就不需要写很多条规则语句了,而是可以像下面这样写

SRC = $(wildcard *.c)
OBJ = $(patsubst %.c, %.o, $(SRC))
 
ALL: hello.out
 
hello.out: $(OBJ)
        gcc $(OBJ) -o hello.out
 
$(OBJ): $(SRC)
        gcc -c $(SRC) -o $(OBJ)

这里先将所有.c 文件编译为 .o 文件,这样后面更改某个 .c 文件时,其他的 .c 文件将不在编译,而只是编译有更改的 .c 文件,可以大大提高大项目中的编译速度。

伪目标

伪目标只是一个标签,clean是个伪目标没有依赖文件,只有用make来调用时才会执行

当目录下有与make 命令 同名的文件时 执行make 命令就会出现错误。

解决办法就是使用伪目标

SRC = $(wildcard *.c)
OBJ = $(patsubst %.c, %.o, $(SRC))
 
ALL: hello.out
 
hello.out: $(OBJ)
        gcc $(OBJ) -o hello.out
 
$(OBJ): $(SRC)
        gcc -c $(SRC) -o $(OBJ)

clean:
	rm -rf $(OBJ) hello.out

.PHONE:clean ALL

通常也会把ALL设置成伪目标

Makefile约定俗称的一些伪目标如下

  • all 通常是最终目标,其功能一般是执行其它所有的目标,编译整个项目
  • clean 通常是删除所有在编译过程中,被make创建的文件,也包括最终的可执行文件
  • install 通常是安装已在本地编译好的程序,其实就是把目标可执行文件(或者库文件和附带的头文件)拷贝到指定的位置

流程控制

比如if结构:

DEBUG ?= 1
ifeq (${DEBUG},1)
	CFLAGS = -g3 -Wall -DDEBUG
	BIN_DIR = bin/debug
else
	CFLAGS = -O2 -DDEBUG
	BIN_DIR = bin/release
endif

在上面这个例子中,如果make自带了DEBUG的定义就使用,否则DEBUG使用默认值1,然后进入if语句,根据DEBUG的值分别进入一个分支,设置编译选项CFLAGES个目录BIN_DIR。

同样的还有for循环结构:

LIST = one two thread
all:
	for i in $(LIST); do \
		echo $$i;    \
	done

嵌套执行Makefile

在一些大工程中,会把不同模块或不同功能的源文件放在不同的目录中,我们可以在每个目录中都写一个该目录的Makefile这有利于让我们的Makefile变的更加简洁,不至于把所有东西全部写在一个Makefile中。

在子目录subdir目录下有个Makefile文件,来指明这个目录下文件的编译规则。外部总Makefile可以这样写

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

定义$(MAKE)宏变量的意思是,也许我们的make需要一些参数,所以定义成一个变量比较有利于维护。两个例子意思都是先进入"subdir"目录,然后执行make命令

我们把这个Makefile叫做总控Makefile,总控Makefile的变量可以传递到下级的Makefile中,但是不会覆盖下层Makefile中所定义的变量,除非指定了 "-e"参数。

如果传递变量到下级Makefile中,那么可以使用这样的声明

export

如果不想让某些变量传递到下级Makefile,可以使用

unexport
export variable = value
等价于
variable = value
export variable
等价于
export variable := value
等价于
variable := value
export variable
如果需要传递所有变量,那么只要一个export就行了。后面什么也不用跟,表示传递所有变量

指定头文件路径

一般都是通过" -I "(大写i)来指定,假设头文件在:

/home/develop/include

则可以通过-I指定:

-I /home/develop/include

将该目录添加到头文件搜索路径中

在Makefile中则可以这样写:

CFLAGS=-I/home/develop/include

然后在编译的时候,引用CFLAGS即可,如下

yourapp:*.c
    gcc $(CFLAGS) -o yourapp

指定链接库文件

与上面指定头文件类似只不过使用的是" -L "来指定

LDFLAGS=-L/usr/lib -L/path/to/your/lib

告诉链接器要链接哪些库文件,使用" -l "(小写L)如下:

LIBS = -lpthread -liconv

Makefile实例

工程目录如下:

1698200759116

f1

f1.c

#include "../include/myinclude.h"                                                                            

void print1()  
{  
	printf("Message f1.c\n");  
	return;  
} 

Makefile

../$(OBJS_DIR)/f1.o:f1.c
	@$(CC) -c $< -o $@

f2

f2.c

#include "../include/myinclude.h"                                                                            

void print2()  
{  
	printf("Message f1.c\n");  
	return;  
} 

Makefile

../$(OBJS_DIR)/f2.o:f2.c
	@$(CC) -c $^ -o $@

main

main.c

#include "../include/myinclude.h"                                                                                          
 
int main(int argc, char const *argv[])
{
    print1();  
	print2();  
    return 0;
}

Makefile

../$(OBJS_DIR)/main.o:main.c
	@$(CC) -c $^ -o $@

include

#include <stdio.h>
void print1() ;
void print2() ;

根目录Makefile

# 预编译定义
CC=gcc
# 预定义编译目录
SUBDIRS = f1 \
		  f2 \
		  main \
		  obj

# 预定义目标
OBJS=f1.o f2.o main.o
BIN=myapp
BIN_DIR=bin
OBJS_DIR=obj

# 传递预定义参数
export CC OBJS BIN OBJS_DIR BIN_DIR

all:CHECK_DIR $(SUBDIRS)
CHECK_DIR:
	@mkdir -p $(BIN_DIR)
$(SUBDIRS):ECHO
	@make -C $@

ECHO:
	@echo $(SUBDIRS)
	@echo begin compile

clean:
	@$(RM) $(OBJS_DIR)/*.o
	@rm -rf $(BIN_DIR)

Make编译log

1698201303273

参考文章:

Makefile入门(超详细一文读懂) - 知乎 (zhihu.com)

posted @ 2023-10-25 16:16  Emma1111  阅读(38)  评论(0编辑  收藏  举报