一个通用的Makefile

原文地址:一个通用的Makefile 作者:lli_njupt

   据 http://bbs.chinaunix.net/thread-2300778-1-1.html 的讨论,发现还是有很多人在问通用Makefile的问题,这里做一个总结。也作为以后的参考。
 
    笔者在写程序的时候会遇到这样的烦恼:一个项目中可能会有很多个应用程序,而新建一个应用程序则所有的Makefile都要重写一遍,虽然可以部分的粘帖复制,但还是感觉应该找到更好的解决途径;另外当一个应用程序中包含多个文件夹时通常要在每个目录下创建一个Makefile,当有数十个文件夹时,要创建如此多的Makefile也是不胜其烦。那么为什么不用automake呢,诚然,对于一个很大的工程来说使用automake是一个很好的选择,但是对于一个新手或者一个小的应用程序来说使用它有两个弊端:或多或少阻碍对于Makefile的理解和书写;没有必要,编译出了差错难以从全局把握。
 
    在某次项目中,发现了一个比较好的Makefile,所有生成的.o .d文件均位于build下,而源码位于src下,条理清晰,无论添加多少文件夹,只需要一个Makefile就可以搞定。但是很快发现一个问题,当src下不同文件夹下有重名的文件.c时,事情很糟糕,后者会覆盖前者的.o文件。那么开始考虑以下问题:
 
    只是用一个Makefile如何动态改变.o生成路径呢?比如一个源码目录为src, 其中包含两个目录a和b,分别又包含a.c 和b.c,在src目录下有一Makefile,a和b中没有单独的Makefile。

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

    如何写Makefile使临时文件.o .d(之所以需要生成.d,是因为头文件依赖,后面会提到)等自动生成到

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

   通常可以做到所有临时文件都生成到build下,如下规则:

 
  1. ......
  2. TARGETMAIN = testmk

  3. OBJECTDIR        = build
  4. VPATH                = $(shell ls -AxR ./src|grep ":"|grep -"\.svn"|tr -':')
  5. SOURCEDIRS = $(VPATH)

  6. # search source file in the current dirs
  7. SOURCES = $(foreach subdir,$(SOURCEDIRS),$(wildcard $(subdir)/*.c))
  8. SRCOBJS = $(patsubst %.c,%.o,$(SOURCES))
  9. BASE_FILES = $(notdir $(TMSRCOBJS))
  10. BUILDOBJS = $(BASE_FILES:%=$(OBJECTDIR)/%)

  11. all:$(TARGETMAIN)

  12. $(TARGETMAIN) :$(BUILDOBJS)
  13.         $(CC) $(CFLAGS) -o $@ -c $<
  14.     @$(STRIP) --strip-unneeded $(TARGETMAIN)

  15. ......
  16. $(OBJECTDIR)/%.o: %.c $(DEPS_DIR) 
  17.         @$(CC) $(CPPFLAGS) $(CFLAGS) -o $@ -c $<
  
   根据上面的问题分析,SOURCEDIRS中为src中所有的目录(包括./src),SOURCES中保存了所有的相对当前路径的.c文件,比如./src/a/a.c。SRCOBJS使用函数patsubst将SOURCES中所有.c文件的后缀替换为.o。$(TARGETMAIN)也即testmk依赖于$(BUILDOBJS),BUILDOBJS变量由SRCOBJS生成,只是所有的src路径被subst函数替换为了build,比如./src/a/a.o,则替换为了./build/a.o,我们看到在匹配$(OBJECTDIR)/%.o: %.c规则的时候,%将代表文件名main, a,b等,也即./build/a.o依赖于a.c。
  
    $@变量代表了生成的目标文件,由目标./build/a/a.o决定,$<为对应于依赖,由%.c决定,也即a.c,那么Makefile如何知道a.c对应src/a/a.c呢,这和VPATH变量有关。如果定义了VPATH这个变量,那么make就会在当当前目录找不到的情况下,到VPATH指定的目录中去查找文件了。
 
    最终build下会生成a.o,b.o和main.o,并且链接为testmk可执行文件。
 
    这是我们最终通用makefile的雏形,但是会当src下不同文件夹有重名文件的.c时,生成.o就会冲突,那么如何解决呢,我们看到$@和$<分别代表了目标集和依赖集,而目标集由%决定,.c由VPATH决定,那么我们只要改变%或者$@和$<变量就可以,$@和$<被称为自动变量,但是并不意味着我们不能动态改变它。这里给出最终的解决方案:
 
  
  1. #声明伪目标,防止Makefile去生成all等
  2. .PHONY = all install clean

  3. #定义路径变量,所有.c文件和所有非公开的.h应该放在src下,所有需要的.a文件放在lib
  4. #下,所有公开的.h(比如生成库文件的时候)或者多个.c公用的.h放在include文件夹下
  5. #global directory defined
  6. TOPDIR = $(shell pwd)
  7. SRCDIR         = $(TOPDIR)/src
  8. LIBDIR = $(TOPDIR)/lib
  9. OBJECTDIR = $(TOPDIR)/build
  10. INCLUDEDIR = $(TOPDIR)/include

  11. #定义交叉编译环境变量,当需要编译arm/mips等平台应用程序/库的时候修改它
  12. #cross compile tools defined 
  13. CROSS_COMPILE = 
  14. AS = $(CROSS_COMPILE)as
  15. LD = $(CROSS_COMPILE)ld
  16. CC = $(CROSS_COMPILE)gcc
  17. CPP = $(CC) -E
  18. AR = $(CROSS_COMPILE)ar
  19. NM = $(CROSS_COMPILE)nm
  20. STRIP = $(CROSS_COMPILE)strip
  21. RANLIB     = $(CROSS_COMPILE)ranlib

  22. #本机相关的命令,一般无需修改
  23. #local host tools defined
  24. CP        := cp
  25. RM        := rm
  26. MKDIR    := mkdir
  27. SED        := sed
  28. FIND    := find
  29. MKDIR    := mkdir
  30. XARGS    := xargs

  31. #目标名称,这里我们给出了三种常用的目标格式:目标文件,静态库和共享库
  32. #target name
  33. TARGETMAIN     = testmk
  34. TARGETLIBS     = libmk.a
  35. TARGETSLIBS    = libmk.so

  36. #所有源码文件的路径被放入SOURCEDIRS,所有.c源码文件(含路径)放入SOURCES
  37. #..and .d files defined
  38. VPATH             = $(shell ls -AxR $(SRCDIR)|grep ":"|grep -"\.svn"|tr -':')
  39. SOURCEDIRS    = $(VPATH)
  40. SOURCES     = $(foreach subdir,$(SOURCEDIRS),$(wildcard $(subdir)/*.c))

  41. #所有目标文件.o(含路径)放入BUILDOBJS,注意它们的路径已经是build了。
  42. SRCOBJS             = $(patsubst %.c,%.o,$(SOURCES))
  43. BUILDOBJS = $(subst $(SRCDIR),$(OBJECTDIR),$(SRCOBJS))

  44. #所有.d依赖文件放入DEPS
  45. DEPS            = $(patsubst %.o,%.d,$(BUILDOBJS))

  46. #注意-MD,是为了生成.d文件后,构造对.h的依赖
  47. #external include file define
  48. CFLAGS    = -O2 -Wall -MD $(foreach dir,$(INCLUDEDIR),-I$(dir))
  49. ARFLAGS = rc

  50. #special parameters for app
  51. CFLAGS    +=

  52. #LDFLAGS指明所有-llibxx,libxx.a应该放到lib下,当然也可以添加.so。Xlinker是为了
  53. #在提供多个.a时,未知它们之间的依赖顺序时,自动查找依赖顺序
  54. #c file compile parameters and linked libraries
  55. CPPFLAGS = 
  56. LDFLAGS     =
  57. XLDFLAGS = -Xlinker "-(" $(LDFLAGS) -Xlinker "-)"
  58. LDLIBS         += -L $(LIBDIR) 

  59. #如果要生成.a或者.so,那么不要将main函数所在的.c放入src。另外添加$(TARGETLIBS) 
  60. #或$(TARGETSLIBS)到all中
  61. #defaut target:compile the currrent dir file and sub dir 
  62. all: $(TARGETMAIN)

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

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

  68. $(TARGETLIBS) :$(BUILDOBJS)
  69.     @$(AR) $(ARFLAGS) $@ $(BUILDOBJS)
  70.     @$(RANLIB) $@

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

  73. #这里是Makefile的核心,根据%中的内容,查找src路径下对应的.c,注意到$@和$<自动
  74. #变量的取值,首先查看路径build/xx是否存在,不存在则创建,然后我们尝试将$@中的src
  75. #替换为build,这样所有的.o和.d都将被创建到对应的build下了。
  76. $(OBJECTDIR)%.o: $(SRCDIR)%.c
  77.     @[ ! -d $(dir $(subst $(SRCDIR),$(OBJECTDIR),$@)) ] & $(MKDIR) -p $(dir $(subst $(SRCDIR),$(OBJECTDIR),$@))
  78.     @$(CC) $(CPPFLAGS) $(CFLAGS) -o $(subst $(SRCDIR),$(OBJECTDIR),$@) -c $<
  79. #添加安装的路径
  80. intall:

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

 

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

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

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

  1. |-- build
  2. |-- include
  3. | `-- hello.h
  4. |-- lib
  5. |-- Makefile
  6. `-- src
  7.     |-- a
  8.     | `-- a.c
  9.     |-- b
  10.     | `-- b.c
  11.     `-- main.c

  12. 6 directories, 5 files

 

  在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,所以不是简单的树形结构,应该是一个图,另外依赖是有方向性的,所以应该是一个有向图结构的实现,不知道对不对?

   附件: testmk.rar      

  • 2
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
程序Makefile分为3类: 1. 顶层目录的Makefile 2. 顶层目录的Makefile.build 3. 各级子目录的Makefile 一、各级子目录的Makefile: 它最简单,形式如下: EXTRA_CFLAGS := CFLAGS_file.o := obj-y += file.o obj-y += subdir/ "obj-y += file.o" 表示把当前目录下的file.c编进程序里, "obj-y += subdir/" 表示要进入subdir这个子目录下去寻找文件来编进程序里,是哪些文件由subdir目录下的Makefile决定。 "EXTRA_CFLAGS", 它给当前目录下的所有文件(不含其下的子目录)设置额外的编译选项, 可以不设置 "CFLAGS_xxx.o", 它给当前目录下的xxx.c设置它自己的编译选项, 可以不设置 注意: 1. "subdir/"中的斜杠"/"不可省略 2. 顶层Makefile中的CFLAGS在编译任意一个.c文件时都会使用 3. CFLAGS EXTRA_CFLAGS CFLAGS_xxx.o 三者组成xxx.c的编译选项 二、顶层目录的Makefile: 它除了定义obj-y来指定根目录下要编进程序去的文件、子目录外, 主要是定义工具链前缀CROSS_COMPILE, 定义编译参数CFLAGS, 定义链接参数LDFLAGS, 这些参数就是文件中用export导出的各变量。 三、顶层目录的Makefile.build: 这是最复杂的部分,它的功能就是把某个目录及它的所有子目录中、需要编进程序去的文件都编译出来,打包为built-in.o 详细的讲解请看视频。 四、怎么使用这套Makefile: 1.把顶层Makefile, Makefile.build放入程序的顶层目录 在各自子目录创建一个空白的Makefile 2.确定编译哪些源文件 修改顶层目录和各自子目录Makefile的obj-y : obj-y += xxx.o obj-y += yyy/ 这表示要编译当前目录下的xxx.c, 要编译当前目录下的yyy子目录 3. 确定编译选项、链接选项 修改顶层目录Makefile的CFLAGS,这是编译所有.c文件时都要用的编译选项; 修改顶层目录Makefile的LDFLAGS,这是链接最后的应用程序时的链接选项; 修改各自子目录下的Makefile: "EXTRA_CFLAGS", 它给当前目录下的所有文件(不含其下的子目录)设置额外的编译选项, 可以不设置 "CFLAGS_xxx.o", 它给当前目录下的xxx.c设置它自己的编译选项, 可以不设置 4. 使用哪个编译器? 修改顶层目录Makefile的CROSS_COMPILE, 用来指定工具链的前缀(比如arm-linux-) 5. 确定应用程序的名字: 修改顶层目录Makefile的TARGET, 这是用来指定编译出来的程序的名字 6. 执行"make"来编译,执行"make clean"来清除,执行"make distclean"来彻底清除
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值