一个通用的Makefile （转）

1. src/a/a.c
   
2. src/b/b.c
   
3. src/main.c

1. build/a/a.o 和a.d
   
2. build/b/b.o 和b.d
   
3. build/main.o 和main.d

1. ......
   
2. TARGETMAIN = testmk
   
3.  
4. OBJECTDIR        = build
   
5. VPATH                = $(shell ls -AxR ./src|grep ":"|grep -v "\.svn"|tr -d ‘:‘)
   
6. SOURCEDIRS = $(VPATH)
   
7.  
8. # search source file in the current dirs
   
9. SOURCES = $(foreach subdir,$(SOURCEDIRS),$(wildcard $(subdir)/*.c))
   
10. SRCOBJS = $(patsubst %.c,%.o,$(SOURCES))
    
11. BASE_FILES = $(notdir $(TMSRCOBJS))
    
12. BUILDOBJS = $(BASE_FILES:%=$(OBJECTDIR)/%)
    
13.  
14. all:$(TARGETMAIN)
    
15.  
16. $(TARGETMAIN) :$(BUILDOBJS)
    
17.         $(CC) $(CFLAGS) -o $@ -c $<
    
18.     @$(STRIP) --strip-unneeded $(TARGETMAIN)
    
19.  
20. ......
    
21. $(OBJECTDIR)/%.o: %.c $(DEPS_DIR) 
    
22.         @$(CC) $(CPPFLAGS) $(CFLAGS) -o $@ -c $<

1. #声明伪目标，防止Makefile去生成all等
   
2. .PHONY = all install clean
   
3.  
4. #定义路径变量，所有.c文件和所有非公开的.h应该放在src下，所有需要的.a文件放在lib
   
5. #下，所有公开的.h（比如生成库文件的时候）或者多个.c公用的.h放在include文件夹下
   
6. #global directory defined
   
7. TOPDIR = $(shell pwd)
   
8. SRCDIR         = $(TOPDIR)/src
   
9. LIBDIR = $(TOPDIR)/lib
   
10. OBJECTDIR = $(TOPDIR)/build
    
11. INCLUDEDIR = $(TOPDIR)/include
    
12.  
13. #定义交叉编译环境变量，当需要编译arm/mips等平台应用程序/库的时候修改它
    
14. #cross compile tools defined 
    
15. CROSS_COMPILE = 
    
16. AS = $(CROSS_COMPILE)as
    
17. LD = $(CROSS_COMPILE)ld
    
18. CC = $(CROSS_COMPILE)gcc
    
19. CPP = $(CC) -E
    
20. AR = $(CROSS_COMPILE)ar
    
21. NM = $(CROSS_COMPILE)nm
    
22. STRIP = $(CROSS_COMPILE)strip
    
23. RANLIB     = $(CROSS_COMPILE)ranlib
    
24.  
25. #本机相关的命令，一般无需修改
    
26. #local host tools defined
    
27. CP        := cp
    
28. RM        := rm
    
29. MKDIR    := mkdir
    
30. SED        := sed
    
31. FIND    := find
    
32. MKDIR    := mkdir
    
33. XARGS    := xargs
    
34.  
35. #目标名称，这里我们给出了三种常用的目标格式：目标文件，静态库和共享库
    
36. #target name
    
37. TARGETMAIN     = testmk
    
38. TARGETLIBS     = libmk.a
    
39. TARGETSLIBS    = libmk.so
    
40.  
41. #所有源码文件的路径被放入SOURCEDIRS，所有.c源码文件（含路径）放入SOURCES
    
42. #.c .o and .d files defined
    
43. VPATH             = $(shell ls -AxR $(SRCDIR)|grep ":"|grep -v "\.svn"|tr -d ‘:‘)
    
44. SOURCEDIRS    = $(VPATH)
    
45. SOURCES     = $(foreach subdir,$(SOURCEDIRS),$(wildcard $(subdir)/*.c))
    
46.  
47. #所有目标文件.o（含路径）放入BUILDOBJS，注意它们的路径已经是build了。
    
48. SRCOBJS             = $(patsubst %.c,%.o,$(SOURCES))
    
49. BUILDOBJS = $(subst $(SRCDIR),$(OBJECTDIR),$(SRCOBJS))
    
50.  
51. #所有.d依赖文件放入DEPS
    
52. DEPS            = $(patsubst %.o,%.d,$(BUILDOBJS))
    
53.  
54. #注意-MD，是为了生成.d文件后，构造对.h的依赖
    
55. #external include file define
    
56. CFLAGS    = -O2 -Wall -MD $(foreach dir,$(INCLUDEDIR),-I$(dir))
    
57. ARFLAGS = rc
    
58.  
59. #special parameters for app
    
60. CFLAGS    +=
    
61.  
62. #LDFLAGS指明所有-llibxx，libxx.a应该放到lib下，当然也可以添加.so。Xlinker是为了
    
63. #在提供多个.a时，未知它们之间的依赖顺序时，自动查找依赖顺序
    
64. #c file compile parameters and linked libraries
    
65. CPPFLAGS = 
    
66. LDFLAGS     =
    
67. XLDFLAGS = -Xlinker "-(" $(LDFLAGS) -Xlinker "-)"
    
68. LDLIBS         += -L $(LIBDIR) 
    
69.  
70. #如果要生成.a或者.so，那么不要将main函数所在的.c放入src。另外添加$(TARGETLIBS) 
    
71. #或$(TARGETSLIBS)到all中
    
72. #defaut target:compile the currrent dir file and sub dir 
    
73. all: $(TARGETMAIN)
    
74.  
75. #for .h header files dependence
    
76. -include $(DEPS)
    
77.  
78. $(TARGETMAIN) :$(BUILDOBJS)
    
79.     @$(CC) $(subst $(SRCDIR),$(OBJECTDIR),$^) $(CPPFLAGS) $(CFLAGS) $(XLDFLAGS) -o $@ $(LDLIBS) 
    
80.     @$(STRIP) --strip-unneeded $(TARGETMAIN)
    
81.  
82. $(TARGETLIBS) :$(BUILDOBJS)
    
83.     @$(AR) $(ARFLAGS) $@ $(BUILDOBJS)
    
84.     @$(RANLIB) $@
    
85.  
86. $(TARGETSLIBS) :$(BUILDOBJS)
    
87.     @$(CC) -shared $(subst $(SRCDIR),$(OBJECTDIR),$^) $(CPPFLAGS) $(CFLAGS) $(XLDFLAGS) -o $@ $(LDLIBS)
    
88.  
89. #这里是Makefile的核心，根据%中的内容，查找src路径下对应的.c，注意到$@和$<自动
    
90. #变量的取值，首先查看路径build/xx是否存在，不存在则创建，然后我们尝试将$@中的src
    
91. #替换为build，这样所有的.o和.d都将被创建到对应的build下了。
    
92. $(OBJECTDIR)%.o: $(SRCDIR)%.c
    
93.     @[ ! -d $(dir $(subst $(SRCDIR),$(OBJECTDIR),$@)) ] & $(MKDIR) -p $(dir $(subst $(SRCDIR),$(OBJECTDIR),$@))
    
94.     @$(CC) $(CPPFLAGS) $(CFLAGS) -o $(subst $(SRCDIR),$(OBJECTDIR),$@) -c $<
    
96. #添加安装的路径
    
97. intall:
    
98.  
99. clean:
    
100.     @$(FIND) $(OBJECTDIR) -name "*.o" -o -name "*.d" | $(XARGS) $(RM) -f
     
101.     @$(RM) -f $(TARGETMAIN) $(TARGETLIBS) $(TARGETSLIBS)

经测试，完全满足了要求，虽然不是完美无缺，但是对于通常的工程项目，是绰绰有余了，欢迎大家指正，以便改善。

   另外对于Makefile的理解，个人认为可以分成几个部分：依赖关系，自定义变量和自动变量以及Makefile提供的相关函数。理解了它们，对写出结构良好，通用性强的Makefile会有大的帮助，虽然现在有了automake，但是研究一下Makefile的写法还是有收获的。

   附件testmk.rar中提供了一个完整的测试程序，目录如下：

  在linux下解压开后运行命令一下命令，可以根据需要定制Makefile。

1. #make            // 当前目录下生成testmk
2. #make libmk.a    // 当前目录下生成libmk.a
3. #make libmk.so    // 当前目录下生成libmk.so

   参考资料：

1. 跟我一起写Makefile（通俗易懂，易于理解）
2. GNU make中文手册（内容很全，是对GNU makefile手册的完全翻译，做手册参考）

   思考：

    根据Makefile的依赖原理，似乎应该使用一个树类型的结构，a依赖b,c等，b又依赖其他的文件，但是不能反方向依赖（否则为死循环），但是d可以同时依赖b,c，所以不是简单的树形结构，应该是一个图，另外依赖是有方向性的，所以应该是一个有向图结构的实现，不知道对不对？

# A generic template Makefile
# Author Red_Liu lli_njupt@163.com v0.1
#
# This file is a(part of) free software; you can redistribute it 
# and/or modify it under the terms of the GNU General Public License
# as published by the Free Software Foundation; either version 2, or 
# (at your option) any later version.

.PHONY = all install clean

#global directory defined
TOPDIR       = $(shell pwd)
SRCDIR         = $(TOPDIR)/src
LIBDIR      = $(TOPDIR)/lib
OBJECTDIR    = $(TOPDIR)/build
INCLUDEDIR   = $(TOPDIR)/include

#cross compile tools defined 
CROSS_COMPILE ?= 
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
RANLIB     = $(CROSS_COMPILE)ranlib

#local host tools defined
CP        := cp
RM        := rm
MKDIR    := mkdir
SED        := sed
FIND    := find
MKDIR    := mkdir
XARGS    := xargs

#target name
TARGETMAIN  = testmk
TARGETLIBS     = libmk.a
TARGETSLIBS = libmk.so

#FILE‘ INFOMATION COLLECT
VPATH             = $(shell ls -AxR $(SRCDIR)|grep ":"|grep -v "\.svn"|tr -d ‘:‘)
SOURCEDIRS    = $(VPATH)

#search source file in the current dir
SOURCES      = $(foreach subdir,$(SOURCEDIRS),$(wildcard $(subdir)/*.c))
SRCOBJS             = $(patsubst %.c,%.o,$(SOURCES))
BUILDOBJS = $(subst $(SRCDIR),$(OBJECTDIR),$(SRCOBJS))
DEPS            = $(patsubst %.o,%.d,$(BUILDOBJS))

#external include file define
CFLAGS    = -O2 -Wall -MD $(foreach dir,$(INCLUDEDIR),-I$(dir))
ARFLAGS = rc

#special parameters for apps
CFLAGS    +=

#c file compile parameters and linked libraries
CPPFLAGS    = 
LDFLAGS        =
XLDFLAGS   = -Xlinker "-(" $(LDFLAGS) -Xlinker "-)"
LDLIBS         += -L $(LIBDIR) 

#defaut target:compile the currrent dir file and sub dir 
all:  $(TARGETMAIN)

#for .h header files dependence
-include $(DEPS)

$(TARGETMAIN) :$(BUILDOBJS)
    @$(CC) $(subst $(SRCDIR),$(OBJECTDIR),$^) $(CPPFLAGS) $(CFLAGS) $(XLDFLAGS) -o $@ $(LDLIBS) 
    @$(STRIP)  --strip-unneeded $(TARGETMAIN)

$(TARGETLIBS) :$(BUILDOBJS)
    @$(AR) $(ARFLAGS) $@ $(BUILDOBJS)
    @$(RANLIB) $@

$(TARGETSLIBS) :$(BUILDOBJS)
    @$(CC) -shared $(subst $(SRCDIR),$(OBJECTDIR),$^) $(CPPFLAGS) $(CFLAGS) $(XLDFLAGS) -o $@ $(LDLIBS)

$(OBJECTDIR)%.o: $(SRCDIR)%.c
    @[ ! -d $(dir $(subst $(SRCDIR),$(OBJECTDIR),$@)) ] & $(MKDIR) -p $(dir $(subst $(SRCDIR),$(OBJECTDIR),$@))
    @$(CC) $(CPPFLAGS) $(CFLAGS) -o $(subst $(SRCDIR),$(OBJECTDIR),$@) -c $<

intall:

clean:
    @$(FIND) $(OBJECTDIR) -name "*.o" -o -name "*.d" | $(XARGS) $(RM) -f
    @$(RM) -f $(TARGETMAIN) $(TARGETLIBS) $(TARGETSLIBS)