目录结构
编译工具 make
make 命令的工作原理就是读取当前目录下的 makefile 文件(文本文件,没有扩展名,是一个纯粹的主文件名 makefile ,然后根据 makefile 文件中定义的规则把项目源代码进行编译、链接直至生成可执行程序。
makefile 文件的编写规划:
(1)根目录下放3个文件。
① makefile。编译整个项目的入口脚本,编译项目从这里开始,固定不变,起总体控制作用。
include config.mk
all:
#-C是指定目录
#make -C signal
#可执行文件应该放最后
#make -C app
#用shell命令for搞,shell里边的变量用两个$
@for dir in $(BUILD_DIR); \
do \
make -C $$dir; \
done
clean:
#-rf:删除文件夹,强制删除
rm -rf app/link_obj app/dep nginx
rm -rf signal/*.gch app/*.gch
② config.mk。 配置脚本,被 makefile 包含。当增加一些新的项目目录时,一般只需要修改这个脚本。单独分离出来的目的就是应付一些可变得内容,所以,一般变动的内容都放在这里。
#定义项目编译的根目录,通过export把某个变量声明为全局的[其他文件中可以用],这里获取当前这个文件所在的路径作为根目录;
#BUILD_ROOT = /mnt/hgfs/linux/nginx
export BUILD_ROOT = $(shell pwd)
#定义头文件的路径变量
export INCLUDE_PATH = $(BUILD_ROOT)/_include
#定义我们要编译的目录
BUILD_DIR = $(BUILD_ROOT)/signal/ \
$(BUILD_ROOT)/app/
#编译时是否生成调试信息。GNU调试器可以利用该信息
export DEBUG = true
③ common.mk。 最重要,最核心的编译脚本,定义 makefile 的编译规则、依赖规则等,通用性强,各子目录都用到这个脚本来实现子目录中扩展名为.c 的C语言编程文件的编译。
#.PHONY:all clean
ifeq ($(DEBUG),true)
#-g是生成调试信息。GNU调试器可以利用该信息
CC = gcc -g
VERSION = debug
else
CC = gcc
VERSION = release
endif
#CC = gcc
# $(wildcard *.c)表示扫描当前目录下所有.c文件
#SRCS = nginx.c ngx_conf.c
SRCS = $(wildcard *.c)
#OBJS = nginx.o ngx_conf.o 这么一个一个增加.o太麻烦,下行换一种写法:把字符串中的.c替换为.o
OBJS = $(SRCS:.c=.o)
#把字符串中的.c替换为.d
#DEPS = nginx.d ngx_conf.d
DEPS = $(SRCS:.c=.d)
#可以指定BIN文件的位置,addprefix是增加前缀函数
#BIN = /mnt/hgfs/linux/nginx
BIN := $(addprefix $(BUILD_ROOT)/,$(BIN))
#定义存放obj文件的目录,目录统一到一个位置才方便后续链接,不然整到各个子目录去,不好链接
#注意下边这个字符串,末尾不要有空格等否则会语法错误
LINK_OBJ_DIR = $(BUILD_ROOT)/app/link_obj
DEP_DIR = $(BUILD_ROOT)/app/dep
#-p是递归创建目录,没有就创建,有就不需要创建了
$(shell mkdir -p $(LINK_OBJ_DIR))
$(shell mkdir -p $(DEP_DIR))
#我们要把目标文件生成到上述目标文件目录去,利用函数addprefix增加个前缀
#处理后形如 /mnt/hgfs/linux/nginx/app/link_obj/ngx_signal2.o /mnt/hgfs/linux/nginx/app/link_obj/ngx_signal.o
# := 在解析阶段直接赋值常量字符串【立即展开】,而 = 在运行阶段,实际使用变量时再进行求值【延迟展开】
# /mnt/hgfs/linux/nginx/app/link_obj/nginx.o /mnt/hgfs/linux/nginx/app/link_obj/ngx_conf.o
OBJS := $(addprefix $(LINK_OBJ_DIR)/,$(OBJS))
DEPS := $(addprefix $(DEP_DIR)/,$(DEPS))
#找到目录中的所有.o文件(编译出来的)
LINK_OBJ = $(wildcard $(LINK_OBJ_DIR)/*.o)
#因为构建依赖关系时app目录下这个.o文件还没构建出来,所以LINK_OBJ是缺少这个.o的,我们 要把这个.o文件加进来
LINK_OBJ += $(OBJS)
#-------------------------------------------------------------------------------------------------------
#make找第一个目标开始执行[每个目标[就是我们要生成的东西],其实都是定义一种依赖关系],目标的格式为:
#目标:目标依赖【可以省略】
# 要执行的命令【可以省略】
#如下这行会是开始执行的入口,执行就找到依赖项$(BIN)去执行了,同时,这里也依赖了$(DEPS),这样就会生成很多.d文件了
all:$(DEPS) $(OBJS) $(BIN)
#这里是诸多.d文件被包含进来,每个.d文件里都记录着一个.o文件所依赖哪些.c和.h文件。内容诸如 nginx.o: nginx.c ngx_func.h
#我们做这个的最终目的说白了是,即便.h被修改了,也要让make重新编译我们的工程,否则,你修改了.h,make不会重新编译,那不行的
#有必要先判断这些文件是否存在,不然make可能会报一些.d文件找不到
ifneq ("$(wildcard $(DEPS))","") #如果不为空,$(wildcard)是函数【获取匹配模式文件名】,这里 用于比较是否为""
include $(DEPS)
endif
#----------------------------------------------------------------1begin------------------
#$(BIN):$(OBJS)
$(BIN):$(LINK_OBJ)
@echo "------------------------build $(VERSION) mode--------------------------------!!!"
#一些变量:$@:目标, $^:所有目标依赖
# gcc -o 是生成可执行文件
$(CC) -o $@ $^
#----------------------------------------------------------------1end-------------------
#----------------------------------------------------------------2begin-----------------
#%.o:%.c
$(LINK_OBJ_DIR)/%.o:%.c
# gcc -c是生成.o目标文件 -I可以指定头文件的路径
#如下不排除有其他字符串,所以从其中专门把.c过滤出来
#$(CC) -o $@ -c $^
$(CC) -I$(INCLUDE_PATH) -o $@ -c $(filter %.c,$^)
#----------------------------------------------------------------2end-------------------
#----------------------------------------------------------------3begin-----------------
#我们现在希望当修改一个.h时,也能够让make自动重新编译我们的项目,所以,我们需要指明让.o依赖于.h文件
#那一个.o依赖于哪些.h文件,我们可以用“gcc -MM c程序文件名” 来获得这些依赖信息并重定向保存到.d文件中
#.d文件中的内容可能形如:nginx.o: nginx.c ngx_func.h
#%.d:%.c
$(DEP_DIR)/%.d:%.c
#gcc -MM $^ > $@
#.d文件中的内容形如:nginx.o: nginx.c ngx_func.h ../signal/ngx_signal.h,但现在的问题是我们的.o文件已经放到了专门的目录
# 所以我们要正确指明.o文件路径这样,对应的.h,.c修改后,make时才能发现,这里需要用到sed文本处理工具和一些正则表达式语法,不必深究
#gcc -MM $^ | sed 's,\(.*\)\.o[ :]*,$(LINK_OBJ_DIR)/\1.o:,g' > $@
#echo 中 -n表示后续追加不换行
echo -n $(LINK_OBJ_DIR)/ > $@
# gcc -MM $^ | sed 's/^/$(LINK_OBJ_DIR)&/g' > $@
# >>表示追加
gcc -I$(INCLUDE_PATH) -MM $^ >> $@
#上行处理后,.d文件中内容应该就如:/mnt/hgfs/linux/nginx/app/link_obj/nginx.o: nginx.c ngx_func.h ../signal/ngx_signal.h
#----------------------------------------------------------------4begin-----------------
#----------------------------------------------------------------nbegin-----------------
#clean:
#rm 的-f参数是不提示强制删除
#可能gcc会产生.gch这个优化编译速度文件
# rm -f $(BIN) $(OBJS) $(DEPS) *.gch
#----------------------------------------------------------------nend------------------
(2)每个子目录下都有一个名为 makefile 的文件,这些 makefile 文件中,都会包含根目录下的 common.mk 文件,从而实现每个子目录下的扩展名为 .c 的C语言编程文件的编译。