GNU/Linux通用Makefile模板

prc

本文提供一个在GNU/Linux环境下通用的智能Makefile模板，用户可以将其引入到自己的工程当中。即使用户对此
Makefile的工作原理不甚了解，但是只需要修改少数几个关键变量，就可以满足不同的应用需求。


1. 使用环境
GNU make 3.8.1或者以上版本
sed
gcc/binutils
cygwin或者Linux

2. 关键变量
CROSS_COMPILE：交叉编译器前缀
OPTIMIZE：关于优化的编译参数
WARNINGS：关于warning的编译参数
DEFS：    关于宏定义的编译参数
EXTRA_CFLAGS：其它的编译参数
$(OPTIMIZE) $(WARNINGS) $(DEFS) $(EXTRA_CFLAGS)共同构成了传给gcc的编译参数。

INC_DIR：头文件目录
SRC_DIR：源文件目录（当前目录.是被默认包含的）
OBJ_DIR：object文件的输出目录
EXTRA_SRC：源文件列表
EXCLUDE_FILES：exclude文件列表

SUFFIX：源文件的后缀名
TARGET：最终的目标程序名
TARGET_TYPE：目标程序的类型。
可以定义的类型为：ar（static library），so（shared library）和app（application）。

最终Makefile的行为是：
在$(SRC_DIR)定义的每个目录中查找后缀为$(SUFFIX)的文件，并加上$(EXTRA_SRC)中的文件，然后排除掉
$(EXCLUDE_FILES)中的文件，获得本工程定义的源文件列表。对于每一个源文件，编译生成的一个.o文件和一个.d文件
（依赖文件），放在$(OBJ_DIR)目录下。最终生成的目标文件为$(TARGET)。
此Makefile已经充分考虑到文件之间的依赖关系，即，如果某个头文件发生改变，当运行make的时候，所有依赖于它的
源文件都将被重新编译。

附件是一个例子，演示了如何处理不同目录，如何处理不同目标类型，以及如何exclude文件。
example.rar (3.39 KB, 下载次数: 1072)

2011-06-17 16:52 上传

点击文件名下载附件
Example

1. 
   
2. ###############################################################################
   
3. #
   
4. # A smart Makefile template for GNU/LINUX programming
   
5. #
   
6. # Author: PRC (ijkxyz AT msn DOT com)
   
7. # Date:   2011/06/17
   
8. #
   
9. # Usage:
   
10. #   $ make           Compile and link (or archive)
    
11. #   $ make clean     Clean the objectives and target.
    
12. ###############################################################################
    
13. 
    
14. CROSS_COMPILE =
    
15. OPTIMIZE := -O2
    
16. WARNINGS := -Wall -Wno-unused -Wno-format
    
17. DEFS     :=
    
18. EXTRA_CFLAGS :=
    
19. 
    
20. INC_DIR   =
    
21. SRC_DIR   =
    
22. OBJ_DIR   =
    
23. EXTRA_SRC =
    
24. EXCLUDE_FILES =
    
25. 
    
26. SUFFIX       = c cpp cc cxx
    
27. TARGET       :=
    
28. #TARGET_TYPE  :=
    
29. TARGET_TYPE  :=
    
30. #TARGET_TYPE  :=
    
31. 
    
32. 
    
33. #####################################################################################
    
34. #  Do not change any part of them unless you have understood this script very well  #
    
35. #  This is a kind remind.                                                           #
    
36. #####################################################################################
    
37. 
    
38. #FUNC#  Add a new line to the input stream.
    
39. define add_newline
    
40. $1
    
41. 
    
42. endef
    
43. 
    
44. #FUNC# set the variable `src-x' according to the input $1
    
45. define set_src_x
    
46. src-$1 = $(filter-out $4,$(foreach d,$2,$(wildcard $d/*.$1)) $(filter %.$1,$3))
    
47. 
    
48. endef
    
49. 
    
50. #FUNC# set the variable `obj-x' according to the input $1
    
51. define set_obj_x
    
52. obj-$1 = $(patsubst %.$1,$3%.o,$(notdir $2))
    
53. 
    
54. endef
    
55. 
    
56. #VAR# Get the uniform representation of the object directory path name
    
57. ifneq ($(OBJ_DIR),)
    
58. prefix_objdir  = $(shell echo $(OBJ_DIR)|sed 's:\(\./*\)*::')
    
59. prefix_objdir := $(filter-out /,$(prefix_objdir)/)
    
60. endif
    
61. 
    
62. GCC      := $(CROSS_COMPILE)gcc
    
63. G++      := $(CROSS_COMPILE)g++
    
64. SRC_DIR := $(sort . $(SRC_DIR))
    
65. inc_dir = $(foreach d,$(sort $(INC_DIR) $(SRC_DIR)),-I$d)
    
66. 
    
67. #--# Do smart deduction automatically
    
68. $(eval $(foreach i,$(SUFFIX),$(call set_src_x,$i,$(SRC_DIR),$(EXTRA_SRC),$(EXCLUDE_FILES))))
    
69. $(eval $(foreach i,$(SUFFIX),$(call set_obj_x,$i,$(src-$i),$(prefix_objdir))))
    
70. $(eval $(foreach f,$(EXTRA_SRC),$(call add_newline,vpath $(notdir $f) $(dir $f))))
    
71. $(eval $(foreach d,$(SRC_DIR),$(foreach i,$(SUFFIX),$(call add_newline,vpath %.$i $d))))
    
72. 
    
73. all_objs = $(foreach i,$(SUFFIX),$(obj-$i))
    
74. all_srcs = $(foreach i,$(SUFFIX),$(src-$i))
    
75. 
    
76. CFLAGS       = $(EXTRA_CFLAGS) $(WARNINGS) $(OPTIMIZE) $(DEFS)
    
77. TARGET_TYPE := $(strip $(TARGET_TYPE))
    
78. 
    
79. ifeq ($(filter $(TARGET_TYPE),so ar app),)
    
80. $(error Unexpected TARGET_TYPE `$(TARGET_TYPE)')
    
81. endif
    
82. 
    
83. ifeq ($(TARGET_TYPE),so)
    
84. CFLAGS  += -fpic -shared
    
85. LDFLAGS += -shared
    
86. endif
    
87. 
    
88. PHONY = all .mkdir clean
    
89. 
    
90. all: .mkdir $(TARGET)
    
91. 
    
92. define cmd_o
    
93. $(obj-$1): $2%.o: %.$1  $(MAKEFILE_LIST)
    
94.         $(GCC) $(inc_dir) -Wp,-MT,$@ -Wp,-MMD,$@.d $(CFLAGS) -c -o $@ $<
    
95. 
    
96. endef
    
97. $(eval $(foreach i,$(SUFFIX),$(call cmd_o,$i,$(prefix_objdir))))
    
98. 
    
99. ifeq ($(TARGET_TYPE),ar)
    
100. $(TARGET): AR := $(CROSS_COMPILE)ar
     
101. $(TARGET): $(all_objs)
     
102.         rm -f $@
     
103.         $(AR) rcvs $@ $(all_objs)
     
104. else
     
105. $(TARGET): LD = $(if $(strip $(src-cpp) $(src-cc) $(src-cxx)),$(G++),$(GCC))
     
106. $(TARGET): $(all_objs)
     
107.         $(LD) $(LDFLAGS) $(all_objs) -o $@
     
108. endif
     
109. 
     
110. .mkdir:
     
111.         @if [ ! -d $(OBJ_DIR) ]; then mkdir -p $(OBJ_DIR); fi
     
112. 
     
113. clean:
     
114.         rm -f $(prefix_objdir)*.o $(TARGET)
     
115. 
     
116. -include $(patsubst %.o,%.o.d,$(all_objs))
     
117. 
     
118. .PHONY: $(PHONY)
     

复制代码

Moreagain

炬力的老伙计，确实不错

南宫绝峰

请问一下，如果要编译与线程有关的内容，需要参数-lpthread。应该在哪个地方添加-lpthread这个参数

colorash

LDFLAGS += -lpthread

南宫绝峰

回复 4# colorash
按照你的方法修改，依然报错：
url.c.text+0x32): undefined reference to `pthread_join'
url.c.text+0x4: undefined reference to `pthread_create'


   

叶叶叶Yeah

哈哈，学习一下！

bigxhome

多谢lz了，一直不会写makefile，有了这个模板就可以好好学习下了

bigxhome

回复 1# prc
头文件中如果使用语句
#ifndef
#define

#endif
在make的时候会不通过，lz测试过么

   

prc

common_Makefile.7z (3.32 KB, 下载次数: 228)

2013-09-30 10:33 上传

点击文件名下载附件
Common Makefile Template

＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
升级版本。与之前版本相比，有如下改动：

1.  在objdir中生成与source相似的目录树，防止不同source目录下同名的源文件生成的obj文件相互覆盖。
2.  在编译过程中，默认显示短命令。可以通过变量设置切换为显示长命令。
3.  用户可自扩展编译规则。

＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
模板中用到的可配置的变量列表：

DEFINES:              定义编译参数，一般用-U或者-D进行宏定义。
EXTRA_CFLAGS：  定义其它的编译参数

inc-y:   头文件搜索目录
src-y:   源文件列表。其中以/结尾的表示目录，其它的表示文件。
SOURCE_SUFFIXES:  源文件后缀名。在src-y指定的目录中搜索以$(SOURCE_SUFFIXES)为后缀的文件，加入到源文件列表中。

例如：
src-y = dir1/ dir2/ file9.c
SOURCE_SUFFIXES := c cpp
最终形成的源文件列表为： dir1/*.c dir1/*.cpp dir2/*.c dir2/*.cpp file9.c

obj-y: 加入连接的obj文件列表。通常这些obj文件不通过源文件编译产生。

ucmd_X: 自定义后缀名为X的源文件的编译规则。

EXCLUDE_FILES: 不参与编译的源文件列表。

OBJECT_DIR：obj文件的输出目录。

LIBS：连接时需要的lib文件。

LDFLAGS：连接参数。

OBJECT_SUFFIX:  obj文件的后缀名
DEPEND_SUFFIX: depend文件的后缀名

TARGET: 整个工程最终产生的target文件名。
TARGET_TYPE: $(TARGET)类型。
TARGET_DEPENDS: $(TARGET)的依赖。

CENTRALIZED_SINGLE_DEPEND_FILE: 将所有依赖关系集中生成到同一个depend文件中。默认是每个obj产生一个单独的depend文件。

VERBOSE_COMMAND: 编译过程中显示完整的命令。

iwojima

我也贴个我的makefile
http://blog.csdn.net/sakaue/article/details/9979315