makefile的详细使用说明

Makefile

1.Makefile的使用

1 .基本格式

targets : prerequisties
[tab键]command

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

2 .Makefile 规则

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

3 .伪目标
为了避免 target 和 Makefile 同级目录下 文件/文件夹 重名的这种情况，我们可以使用一个特殊的标记 .PHONY 来显式地指明一个目标是 “伪目标”，向 make 说明，不管是否有这个文件/文件夹，这个目标就是 “伪目标”

.PHONY : clean

    
clean:
    rm -f *.o

在这个例子中，clean 就是一个伪目标。执行 make clean 命令时，Make 会执行 *rm -f .o 命令，而不是试图寻找名为 clean 的文件或检查文件的时间戳来确定是否需要重新构建。

2.Makefile 的变量

1. 变量的定义

cpp := src/main.cpp 
obj := objs/main.o

2 .变量的引用

• 可以用 () 或 {}

cpp := src/main.cpp 
obj := objs/main.o

$(obj) : ${cpp}
	@g++ -c $(cpp) -o $(obj)

compile : $(obj)

3. 预定义变量

• $@: 目标(target)的完整名称
• $<: 第一个依赖文件（prerequisties）的名称
• $^: 所有的依赖文件（prerequisties），以空格分开，不包含重复的依赖文件

cpp := src/main.cpp 
obj := objs/main.o

$(obj) : ${cpp}
	@g++ -c $< -o $@
	@echo $^

compile : $(obj)
.PHONY : compile

3.Makefile 的常用函数

函数调用，很像变量的使用，也是以 “$” 来标识的，其语法如下：

$(fn, arguments) or ${fn, arguments}

• fn: 函数名
• arguments: 函数参数，参数间以逗号 , 分隔，而函数名和参数之间以“空格”分隔

1. shell

$(shell <command> <arguments>)

• 名称：shell 命令函数 —— shell
• 功能：调用 shell 命令 command
• 返回：函数返回 shell 命令 command 的执行结果

# shell 指令，src 文件夹下找到 .cpp 文件
cpp_srcs := $(shell find src -name "*.cpp") 
# shell 指令, 获取计算机架构
HOST_ARCH := $(shell uname -m)

2. subst

$(subst <from>,<to>,<text>)

• 名称：字符串替换函数——subst
• 功能：把字串 中的 字符串替换成
• 返回：函数返回被替换过后的字符串

cpp_srcs := $(shell find src -name "*.cpp")
cpp_objs := $(subst src/,objs/,$(cpp_objs))

3. patsubst

$(patsubst <pattern>,<replacement>,<text>)

• 名称：模式字符串替换函数 —— patsubst
• 功能：通配符 %，表示任意长度的字串，从 text 中取出 patttern， 替换成 replacement
• 返回：函数返回被替换过后的字符串

cpp_srcs := $(shell find src -name "*.cpp") #shell指令，src文件夹下找到.cpp文件
cpp_objs := $(patsubst %.cpp,%.o,$(cpp_srcs)) #cpp_srcs变量下cpp文件替换成 .o文件

4 foreach

$(foreach <var>,<list>,<text>)

• 名称：循环函数——foreach。
• 功能：把字串中的元素逐一取出来，执行 包含的表达式
• 返回： 所返回的每个字符串所组成的整个字符串（以空格分隔）

library_paths := /datav/shared/100_du/03.08/lean/protobuf-3.11.4/lib \
                 /usr/local/cuda-10.1/lib64

library_paths := $(foreach item,$(library_paths),-L$(item))

I_flag := $(include_paths:%=-I%)

5. dir

$(dir <names...>)

• 名称：取目录函数——dir。
• 功能：从文件名序列中取出目录部分。目录部分是指最后一个反斜杠（“/”）之前
  的部分。如果没有反斜杠，那么返回“./”。
• 返回：返回文件名序列的目录部分。
• 示例：

$(dir src/foo.c hacks)    # 返回值是“src/ ./”。

makefile文件实例：

cpp_srcs := $(shell find src -name *.cpp)
cpp_objs := $(patsubst src/%.cpp,objs/%.o,$(cpp_srcs))

# 你的头文件所在文件夹路径（建议绝对路径）
include_paths := 
I_flag        := $(include_paths:%=-I%)


objs/%.o : src/%.cpp
	@mkdir -p $(dir $@)
	@g++ -c $^ -o $@ $(I_flag)

workspace/exec : $(cpp_objs)
	@mkdir -p $(dir $@)
	@g++ $^ -o $@ 

run : workspace/exec
	@./$<

debug :
	@echo $(I_flag)

clean :
	@rm -rf objs

.PHONY : debug run