Linux下多文件夹编写Makefile详解

-Werror     @Take warning as error handling 

子目录下面的Makefile编写是最简单的，最重要的是编写顶层目录下的Makefile和Makefile.build。

本程序的Makefile分为3类:

1. 顶层目录的Makefile
2. 顶层目录的Makefile.build
3. 各级子目录的Makefile


一、各级子目录的Makefile：
   它最简单，形式如下：
obj-y += file.o
obj-y += subdir/
   
   "obj-y += file.o"表示把当前目录下的file.c编进程序里，
   "obj-y += subdir/"表示要进入subdir这个子目录下去寻找文件来编进程序里，是哪些文件由subdir目录下的Makefile决定。


注意: "subdir/"中的斜杠"/"不可省略

二、顶层目录的Makefile：
   它除了定义obj-y来指定根目录下要编进程序去的文件、子目录外，主要是定义工具链、编译参数、链接参数──就是文件中用export导出的各变量。

三、顶层目录的Makefile.build：
   这是最复杂的部分，它的功能就是把某个目录及它的所有子目录中、需要编进程序去的文件都编译出来，打包为built-in.o
 
四、怎么使用这套Makefile：
1．把顶层Makefile, Makefile.build放入程序的顶层目录
2．修改顶层Makefile
2.1 修改工具链
2.2 修改编译选项、链接选项
2.3 修改obj-y决定顶层目录下哪些文件、哪些子目录被编进程序
2.4 修改TARGET，这是用来指定编译出来的程序的名字

3. 在各一个子目录下都建一个Makefile，形式为：
obj-y += file1.o
obj-y += file2.o
obj-y += subdir1/
obj-y += subdir2/

4. 执行"make"来编译，执行"make clean"来清除，执行"make distclean"来彻底清除
   

下面我用一个简单的事例来说明，在源代码中我会解释一些命令。   

我目录下面有add，sub，input，include4个文件夹，分别实现求和，求差，输入一个值，头文件声明。这四个文件夹下面的Makefile都按照obj-y += file.o  obj-y += subdir/格式写的，这个非常简单，下面重点介绍根目录下面的Makefile和Makefile.build。

Makefile编写如下

CROSS_COMPILE = arm-linux-                  /* 下面定义的是一些链接命令，方便使用 */
AS = $(CROSS_COMPILE)as   
LD = $(CROSS_COMPILE)ld
CC = $(CROSS_COMPILE)gcc
CPP = $(CC) -E
AR = $(CROSS_COMPILE)ar
NM = $(CROSS_COMPILE)nm


STRIP = $(CROSS_COMPILE)strip
OBJCOPY = $(CROSS_COMPILE)objcopy    
OBJDUMP = $(CROSS_COMPILE)objdump


export AS LD CC CPP AR NM               /* 导出这些变量方便使用，固定格式不用去深究它 */
export STRIP OBJCOPY OBJDUMP

CFLAGS := -Wall -O2 -g
CFLAGS += -I $(shell pwd)/include        /* 指定编译过程中自己写的头文件路径 */


LDFLAGS := -lm -lfreetype -lts -lpthread    /* 编译过程所使用的链接选项，这个程序是用不到的，如果你编译出错就把这一行去掉，因为你没有安装这些库文件，写出来是为了统一格式。 */

export CFLAGS LDFLAGS     /* 还是导出变量 */

TOPDIR := $(shell pwd)     /* 顶层目录的路径 */
export TOPDIR
export CFLAGS LDFLAGS     

TARGET := exec  /* 指定输出文件名上面都是固定格式，变化如下几个文件，或者改变上面的链接库和头文件路径 */

obj-y += main.o   /* 底层目录下的文件 */
obj-y += add/       /* 子目录的名字 */
obj-y += sub/
obj-y += input/

all : 
make -C ./ -f $(TOPDIR)/Makefile.build
$(CC) $(LDFLAGS) -o $(TARGET) built-in.o

clean:
rm -f $(shell find -name "*.o")
rm -f $(TARGET)

distclean:
rm -f $(shell find -name "*.o")
rm -f $(shell find -name "*.d")
rm -f $(TARGET)

下面是Makefile.build文件的编写

PHONY := __build
__build:

obj-y :=
subdir-y :=
include Makefile

__subdir-y := $(patsubst %/,%,$(filter %/, $(obj-y)))  /* 进入子目录 */
subdir-y += $(__subdir-y)

subdir_objs := $(foreach f,$(subdir-y),$(f)/built-in.o)   /* 寻找文件 */

cur_objs := $(filter-out %/, $(obj-y))
dep_files := $(foreach f,$(cur_objs),.$(f).d)
dep_files := $(wildcard $(dep_files))

ifneq ($(dep_files),)     /* 文件依赖 */
  include $(dep_files)
endif

PHONY += $(subdir-y)

__build : $(subdir-y) built-in.o

$(subdir-y):
make -C $@ -f $(TOPDIR)/Makefile.build  

built-in.o : $(cur_objs) $(subdir_objs)
$(LD) -r -o $@ $^

dep_file = [email protected]

%.o : %.c
$(CC) $(CFLAGS) -Wp,-MD,$(dep_file) -c -o $@ $<

.PHONY : $(PHONY)

到此为止我们就讲完了，我会把源码上传上传上来，当你要改变你的文件的时候，你只需修改文件名字和连接口，头文件路径就可以了，基本格式是不变的。文件下载路径：请点击这里！

如果提示找不到连接库直接把那个找不到的链接库选项去掉。