Makefile构建工程设计——工程组织Makefile的嵌套

野性酷女 2022-06-07 03:49 223阅读 0赞

*  Makefile的架构分布
    
     *  顶层Makefile
     *  库文件层Makefile
     *  源码集合层Makefile
     *  模块层Makefile
 *  整个工程的编译与运行

工程由树形分布，如下所示，里面有源码和库文件源码。

ghost@ghost-machine:~/workspace/testMakefile$ tree
    .
    ├── inc
    │   ├── module_func.h
    │   └── module_system_inc
    │       └── module_system.h
    ├── Makefile（顶层）
    ├── open_source
    │   ├── inc
    │   │   ├── open_module1.h
    │   │   └── open_module2.h
    │   ├── Makefile（库文件层）
    │   ├── open_module1.c
    │   └── open_module2.c
    ├── prj
    └── src
        ├── main.c
        ├── Makefile（源码集合层）
        └── module
            ├── Makefile（模块层）
            ├── module_func.c
            └── module_system.c

# Makefile的架构分布 #

Makefile的框架分布决定着如何组织编译整个工程代码。

## 顶层Makefile ##

顶层Makefile的作用是将工程调度，先编译哪个模块，后编译哪个模块，这里的顶层Makefile先编译的是库文件的源码。

export CC = gcc
    export LIB = STATIC
    
    all:
        @echo "this is all project."
        @echo "CC=$(CC)"
        @echo "LIB=$(LIB)"
        @$(MAKE) -C ./open_source LIB=$(LIB) CC=$(CC)
        @$(MAKE) -C ./src LIB=$(LIB) CC=$(CC)
    
    clean:
        rm -rf ./prj/*.o
        $(MAKE) -C ./open_source clean
        $(MAKE) -C ./src clean

这里定义两个外部变量，通过顶层Makefile传参给其他层的Makefile  
export CC = gcc  
export LIB = STATIC

LIB的参数有两个：STATIC、DYNAMIC，代表分别编译静态库和动态库。

## 库文件层Makefile ##

库文件层的Makefile负责将所管理的源码编译成库文件调度形式给工程用，通过顶层传递的Makefile参数来决定编译动态库还是静态库。

STATICLIB = open_lib.a
    DYNAMICLIB = open_lib.so
    
    INC = -I ./inc -fPIC
    SRC = $(wildcard *.c )
    OBJ = $(patsubst %c,%o,$(SRC))
    
    FLAGE = -g -Wall $(INC)
    SHARE = -shared -o
    AR_CONFIG = ar crv
    RANLIB = ranlib
    
    all:$(OBJ)
    ifeq ($(LIB),STATIC)
        $(AR_CONFIG) $(STATICLIB) $^
        $(RANLIB) $(STATICLIB)
    else ifeq ($(LIB),DYNAMIC)
        $(CC) $(FLAGE) $(SHARE) $(DYNAMICLIB) $^
    endif
    
    .c.o:
        $(CC) $(FLAGE) -c $<
    
    clean:
        rm -f *.o
        rm -f ./$(STATICLIB)
        rm -f ./$(DYNAMICLIB)

通过ifeq和else ifeq来判断传递的参数来决定编译静态库还是动态库。

## 源码集合层Makefile ##

该Makefile具有顶层的部分功能，将不同模块目标文件以及库文件编译整合成project.o文件，对不同模块进行管理。

DIR_INC = -I../inc \
              -I../inc/module_system_inc \
              -I../open_source/inc
    SRC = $(wildcard ./*.c)
    OBJ = $(patsubst %.c,%.o,$(SRC))
    DIR = $(shell pwd)
    
    DIR_BIN = project.o
    
    MOD_SRC = $(wildcard ./module/*.c)
    MOD_OBJ = $(patsubst %.c,%.o,$(MOD_SRC))
    STATICLIB = $(wildcard $(DIR)/../open_source/*.a)
    DYNAMICLIB = $(wildcard $(DIR)/../open_source/*.so)
    CFLAGS = -g -Wall $(DIR_INC)
    
    all:$(MOD_OBJ) $(DIR_BIN)
    
    $(MOD_OBJ):$(MOD_SRC)
        @$(MAKE) -C module
    
    $(DIR_BIN):$(OBJ)
    ifeq ($(LIB),STATIC)
        $(CC) $(CFLAGS) -o ../prj/$@ $^ $(MOD_OBJ) $(STATICLIB)
    else ifeq ($(LIB),DYNAMIC)
        $(CC) $(CFLAGS) -o ../prj/$@ $^ $(MOD_OBJ) $(DYNAMICLIB)
    endif
    
    $(OBJ):$(SRC)
        $(CC) $(CFLAGS) -c $^
    
    clean:
        rm -f *.o
        $(MAKE) -C module clean

## 模块层Makefile ##

这是模块代码功能实现的部分，整个工程分布着不同的模块，各个模块都需要进行编译。

DIR_INC = -I../../inc\
              -I../../inc/module_system_inc
    DIR_SRC = $(wildcard ./*.c)
    DIR_TAR = $(patsubst %c,%o,$(DIR_SRC))
    
    CFLAGS = -g -Wall $(DIR_INC)
    
    all:$(DIR_TAR)
    
    .c.o:
        $(CC) $(CFLAGS) -c $<
    
    clean:
        rm -rf *.o

# 整个工程的编译与运行 #

顶层Makefile已经为传入的参数给定了默认值，也可以通过make来修改。

默认下编译整个工程。

ghost@ghost-machine:~/workspace/testMakefile$ make
    this is all project.
    CC=gcc
    LIB=STATIC
    make[1]: Entering directory '/home/ghost/workspace/testMakefile/open_source'
    gcc -g -Wall -I ./inc -fPIC -c open_module1.c
    gcc -g -Wall -I ./inc -fPIC -c open_module2.c
    ar crv open_lib.a open_module1.o open_module2.o
    a - open_module1.o
    a - open_module2.o
    ranlib open_lib.a
    make[1]: Leaving directory '/home/ghost/workspace/testMakefile/open_source'
    make[1]: Entering directory '/home/ghost/workspace/testMakefile/src'
    make[2]: Entering directory '/home/ghost/workspace/testMakefile/src/module'
    gcc -g -Wall -I../../inc -I../../inc/module_system_inc -c module_func.c
    gcc -g -Wall -I../../inc -I../../inc/module_system_inc -c module_system.c
    make[2]: Leaving directory '/home/ghost/workspace/testMakefile/src/module'
    gcc -g -Wall -I../inc -I../inc/module_system_inc -I../open_source/inc -c main.c
    gcc -g -Wall -I../inc -I../inc/module_system_inc -I../open_source/inc -o ../prj/project.o main.o ./module/module_func.o ./module/module_system.o /home/ghost/workspace/testMakefile/src/../open_source/open_lib.a
    make[1]: Leaving directory '/home/ghost/workspace/testMakefile/src'

执行结果

ghost@ghost-machine:~/workspace/testMakefile$ ./prj/project.o 
    test Makefile
    file=module_func.c,func=test_func1 is called.
    file=module_system.c,func=system_func is called.
    open_module1_func is called

参数传递下编译整个工程。

ghost@ghost-machine:~/workspace/testMakefile$ make CC=g++ LIB=DYNAMIC
    this is all project.
    CC=g++
    LIB=DYNAMIC
    make[1]: Entering directory '/home/ghost/workspace/testMakefile/open_source'
    g++ -g -Wall -I ./inc -fPIC -c open_module1.c
    g++ -g -Wall -I ./inc -fPIC -c open_module2.c
    g++ -g -Wall -I ./inc -fPIC -shared -o open_lib.so open_module1.o open_module2.o
    make[1]: Leaving directory '/home/ghost/workspace/testMakefile/open_source'
    make[1]: Entering directory '/home/ghost/workspace/testMakefile/src'
    make[2]: Entering directory '/home/ghost/workspace/testMakefile/src/module'
    g++ -g -Wall -I../../inc -I../../inc/module_system_inc -c module_func.c
    g++ -g -Wall -I../../inc -I../../inc/module_system_inc -c module_system.c
    make[2]: Leaving directory '/home/ghost/workspace/testMakefile/src/module'
    g++ -g -Wall -I../inc -I../inc/module_system_inc -I../open_source/inc -c main.c
    g++ -g -Wall -I../inc -I../inc/module_system_inc -I../open_source/inc -o ../prj/project.o main.o ./module/module_func.o ./module/module_system.o /home/ghost/workspace/testMakefile/src/../open_source/open_lib.so
    make[1]: Leaving directory '/home/ghost/workspace/testMakefile/src'

执行结果