一般而言,在一个大型项目中,不同工程师负责不同模块的开发;那么问题就来了,我们怎么知道自己编写的这部分代码有没有问题,怎样进行编译?在编译环境中如何支持模块的独立编译?因为在大型项目中的代码文件成千上万,完整编译的时间较长;编写模块代码时,可通过编译检查语法错误;为了提高开发效率,需要支持指定模块的独立编译。

        解决方案便是:1、将模块名(module)作为目标名(伪目标)建立规则;2、目标(module)对应的依赖为 build build/module;3、规则中的命令进入对应的模块文件夹进行编译;4、编译结果存放于 build 文件夹下。其关键技术点是如何获取 make 命令行中指定编译的模块名,通过预定义变量:$(MAKECMDGOALS),命令行中指定的目标名(make 的命令行参数)。如下

模块独立编译的支持(十五)_模块编译

        下来我们来看看具体的 makefile 是怎样写的,将上节博客中的 pro-rule.mk 改成下面这样

.PHONY : all compile link clean rebuild $(MODULES)

DIR_PROJECT := $(realpath .)
DIR_BUILD_SUB := $(addprefix $(DIR_BUILD)/, $(MODULES))
MODULE_LIB := $(addsuffix .a, $(MODULES))
MODULE_LIB := $(addprefix $(DIR_BUILD)/, $(MODULE_LIB))

APP := $(addprefix $(DIR_BUILD)/, $(APP))

all : compile $(APP)
    @echo "Success! Target ==> $(APP)"

compile : $(DIR_BUILD) $(DIR_BUILD_SUB)
    @echo "Begin to compile ..."
    @set -e; \
    for dir in $(MODULES); \
    do \
        cd $$dir && \
        $(MAKE) all \
            DEBUG:=$(DEBUG) \
            DIR_BUILD:=$(addprefix $(DIR_PROJECT)/, $(DIR_BUILD)) \
            DIR_COMMON_INC:=$(addprefix $(DIR_PROJECT)/, $(DIR_COMMON_INC)) \
            CMD_CFG:=$(addprefix $(DIR_PROJECT)/, $(CMD_CFG)) \
            MOD_CFG:=$(addprefix $(DIR_PROJECT)/, $(MOD_CFG)) \
            MOD_RULE:=$(addprefix $(DIR_PROJECT)/, $(MOD_RULE)) && \
        cd .. ; \
    done
    @echo "Compile Success!"
    
link $(APP) : $(MODULE_LIB)
    @echo "Begin to link ..."
    $(CC) -o $(APP) -Xlinker "-(" $^ -Xlinker "-)" $(LFLAGS)
    @echo "Link Success!"
    
$(DIR_BUILD) $(DIR_BUILD_SUB) : 
    $(MKDIR) $@
    
clean : 
    @echo "Begin to clean ..."
    $(RM) $(DIR_BUILD)
    @echo "Clean Success!"
    
rebuild : clean all

$(MODULES) : $(DIR_BUILD) $(DIR_BUILD)/$(MAKECMDGOALS)
    @echo "Begin to compile $@"
    @set -e; \
    for dir in $(MODULES); \
    do \
        cd $@ && \
        $(MAKE) all \
            DEBUG:=$(DEBUG) \
            DIR_BUILD:=$(addprefix $(DIR_PROJECT)/, $(DIR_BUILD)) \
            DIR_COMMON_INC:=$(addprefix $(DIR_PROJECT)/, $(DIR_COMMON_INC)) \
            CMD_CFG:=$(addprefix $(DIR_PROJECT)/, $(CMD_CFG)) \
            MOD_CFG:=$(addprefix $(DIR_PROJECT)/, $(MOD_CFG)) \
            MOD_RULE:=$(addprefix $(DIR_PROJECT)/, $(MOD_RULE)) && \
        cd .. ; \
    done
    @echo "Compile Success!"

        我们来看看编译结果

模块独立编译的支持(十五)_自定义_02

        我们看到 common 模块已经正确编译了,而且生成相应的 common.a 文件了。我们再继续编译别的两个模块,再通过链接的命令看看可执行程序 app.out 是否可以生成

模块独立编译的支持(十五)_自定义_03

        我们看到可执行程序 app.out 已经正确生成了。那么我们看到刚才的模块编写是直接复制之前的代码,凡是涉及到复制粘贴的代码,我们得看看是否可以封装成类似于函数的形式。在 makefile 中的代码复用规则是这样的,当不同规则中的命令大量重复时,可考虑自定义函数,makefile 中的自定义函数是代码复用的一种方式。如下

模块独立编译的支持(十五)_函数_04

        具体思路就是:1、将编译模块的命令作为自定义函数的具体实现;2、函数参数为模块名,函数调用后编译参数指定的模块;3、在不同的规则中调用该函数。如下

模块独立编译的支持(十五)_自定义_05

        下面我们看看改变后的 makefile 是怎样的,将前面的 pro-rule.mk 改成下面这样

.PHONY : all compile link clean rebuild $(MODULES)

DIR_PROJECT := $(realpath .)
DIR_BUILD_SUB := $(addprefix $(DIR_BUILD)/, $(MODULES))
MODULE_LIB := $(addsuffix .a, $(MODULES))
MODULE_LIB := $(addprefix $(DIR_BUILD)/, $(MODULE_LIB))

APP := $(addprefix $(DIR_BUILD)/, $(APP))

define makemodule
    cd ${1} && \
    $(MAKE) all \
        DEBUG:=$(DEBUG) \
        DIR_BUILD:=$(addprefix $(DIR_PROJECT)/, $(DIR_BUILD)) \
        DIR_COMMON_INC:=$(addprefix $(DIR_PROJECT)/, $(DIR_COMMON_INC)) \
        CMD_CFG:=$(addprefix $(DIR_PROJECT)/, $(CMD_CFG)) \
        MOD_CFG:=$(addprefix $(DIR_PROJECT)/, $(MOD_CFG)) \
        MOD_RULE:=$(addprefix $(DIR_PROJECT)/, $(MOD_RULE)) && \
    cd .. ;
endef

all : compile $(APP)
    @echo "Success! Target ==> $(APP)"

compile : $(DIR_BUILD) $(DIR_BUILD_SUB)
    @echo "Begin to compile ..."
    @set -e; \
    for dir in $(MODULES); \
    do \
        $(call makemodule, $$dir) \
    done
    @echo "Compile Success!"
    
link $(APP) : $(MODULE_LIB)
    @echo "Begin to link ..."
    $(CC) -o $(APP) -Xlinker "-(" $^ -Xlinker "-)" $(LFLAGS)
    @echo "Link Success!"
    
$(DIR_BUILD) $(DIR_BUILD_SUB) : 
    $(MKDIR) $@
    
clean : 
    @echo "Begin to clean ..."
    $(RM) $(DIR_BUILD)
    @echo "Clean Success!"
    
rebuild : clean all

$(MODULES) : $(DIR_BUILD) $(DIR_BUILD)/$(MAKECMDGOALS)
    @echo "Begin to compile $@"
    @set -e; \
    $(call makemodule, $@)

        编译的结果是

模块独立编译的支持(十五)_模块编译_06

        我们看到 makefile 的代码已经是相当简洁了,通过对单独模块 makefile 的编写,总结如下:1、编写模块代码时可通过模块独立编译快速检查语法错误;2自动变量只能在规则的命令中使用,不能在依赖中使用;3、makefile 中的自定义函数是代码复用的一种方式;4、当不同规则中的命令大量重复时,可考虑自定义函数。


        
        欢迎大家一起来学习 makefile 语言,可以加我QQ:243343083