层级目录结构的Makefile编写方法.
0.前言
假如现在有这样一个目录结构:
要怎么实现简洁的自动化编译呢？
现在我想要实现的效果
1.在*目录,直接make即可编译整个工程.
2.可以很方便的在Makefile中添加或过滤掉只有我想编译的目录或不需要编译的目录.
3.新添加的模块,只需要直接编写本模块的Makefile即可,其余地方不需要改动.
4.将所有输出的目标文件和可执行文件,定向输出到指定目录(如out/bin;out/obj)
因为新建的工程,暂且就这些基本功能,如果还有没实现的好目标,再继续添加.
接下来一个一个目标的看看怎么实现.
1.如何编译整个工程
想要编译整个工程,那么所有需要编译的目录都要能够编译.
最简单的方法：依依编译每一个需要的目录.
如：
WIFI := wifi
BLUETOOTH := bluetooth
all:
cd $(WIFI); make
cd $(BLUETOOTH); make
很直观，但是每个目录写一遍，就是每添加一个模块，你都得在Makefile里面加一句，写起来内容偏多.
另一种递归的编译层层目录.
要这么做,首先需要获得每层目录下的目录名:
GET_SUBDIRS1 := $(shell find . -maxdepth 1 -type d)
GET_SUBDIRS2 := $(basename $(patsubst ./%,%,$(GET_SUBDIRS1)))
SUBDIRS := $(GET_SUBDIRS2)
之后在每层目录make -C 进入目录编译即可
all : $(SUBDIRS)
$(SUBDIRS) : ECHO
$(MAKE) -C $@
ECHO :
@echo "Compiling " $(SUBDIRS) "..."
2.过滤每层不需要编译的目录
有些不需要编译的目录,像include,env,document
进去make会因为找不到make停止编译.
所以我们需要在每层目录过滤掉所有不需要编译的目录.
这里我们可以设置一个通用的Makefile环境文件,如Makefile.env
OBJOUT := $(ROOT_DIR)/out/obj/
EXEOUT := $(ROOT_DIR)/out/bin/
INCLUDE_DIR := $(ROOT_DIR)/source/include
MAKE := make
CC := gcc
GET_SUBDIRS1 := $(shell find . -maxdepth 1 -type d)
GET_SUBDIRS2 := $(basename $(patsubst ./%,%,$(GET_SUBDIRS1)))
GET_SUBDIRS3 := $(filter-out $(EX_INCLUDE),$(GET_SUBDIRS2))
SUBDIRS := $(GET_SUBDIRS3)
之后再每层的Makefile将Makefile.env包含进来,并里面配置一个EX_INCLUDE变量进行过滤.
顶层目录Makefile:
CUR_DIR := $(shell pwd)
#ROOT_DIR := $(ROOT_DIRS)
SOURCE_DIR := $(CUR_DIR)/source
MAKEFILE_PARA := $(SOURCE_DIR)/Makefile.env
EX_INCLUDE := PlatformHeandle out document env
include $(MAKEFILE_PARA)
all : $(SUBDIRS)
$(SUBDIRS) : ECHO
$(MAKE) -C $@
ECHO :
@echo "Compiling " $(SUBDIRS) "..."
其余层的Makefile均是这样编写,只需要改一下Makefile.env的路径.
3将所有输出文件定向输出.
这个比较简单吧,只要知道根目录,然后直接在编译的时候输出到指定目录即可.
all: $(TARGET)
$(TARGET) : $(OBJ)
$(CC) $(CFLAGS) $(OBJOUT)$^ -o $(EXEOUT)$@
@echo "Compiling" $@ "end\n"
%.o : %.c
@echo "Compiling" $< "..."
$(CC) $(CFLAGS) -c $^ -o $(OBJOUT)$@
%.o : %.cpp
@echo "Compiling" $< "..."
$(CC) $(CFLAGS) -c $^ -o $(OBJOUT)$@
那么问题来了,底层的Makefile怎么知道根目录呢.
上一级Makefile中的变量,底层Makefile是不知道的.
1.最呆的方法,写死的,每一层Makefile都来个相对根目录深度的../：
ROOT_DIR = ../../../
2.通过配置一个都知道的系统环境,我在env/env.sh里面声明.
当然,env.sh 还可以干一些其他事,如创建out下的输出目录.
ROOT_DIRS=$(pwd)
export ROOT_DIRS
mkdir -p @{ROOT_DIRS}/out/bin
mkdir -p @{ROOT_DIRS}/out/obj
之后只要在根目录 source ./env/env.sh 即可,然后在Makefile里面取它.
ROOT_DIR := $(ROOT_DIRS)
SOURCE_DIR := $(ROOT_DIR)/source
MAKEFILE_PARA := $(SOURCE_DIR)/Makefile.para
EX_INCLUDE :=
这样即实现了这个工程简便的自动化编译了,以后也能很快捷的修改.
如果有什么不足的地方或者更好的方法欢迎提出.