[转]makefile文件的编写规则及实例

 
1.一个简单的makefile例子
 
假设一个程序有两个文件file1.c,file2.c,每个文件都包含head.h,生成file可执行文件
 
file:file1.o file2.o                  附属行(文件的依存关系)
    gcc -o file1.o file2.o            命令行
file1.o:file1.c head.h
    gcc -c file1.c
file2.o:file2.c head.h
    gcc -c file2.c
 
从file最终的目标文件开始倒推,依次列出文件的依存关系,make在执行时:
 
(1)判断file可执行文件是否存在,若不存在,则执行命令行,向下寻找依存关系
(2)若file存在,则检查依靠文件,是否存在更新,若存在更新则执行命令行,若没有更新则给出提示:
    make:'file' is up to date.
 
2.makefile中的宏定义及内部变量
 
宏定义:
OBJS = file1.o file2.o
CC = gcc
CFLAGS = -wall -O -g
 
引用:
file:$(OBJS)
    $(CC) $(OBJS) -o file
file1.o:file1.c head.h
    $(CC) $(FLAGS) -c file1.c  
file2.o:file2.c head.h
    $(CC) $(FLAGS) -c file2.c
 
内部变量: 
$@:当前规则的目的文件名
$<:依靠列表中的第一个依靠文件
$^:整个依靠列表
 
file:$(OBJS)
    $(CC) $^ -o $@
file1.o:file1.c head.h
    $(CC) $(FLAGS) -c $< -o $@
file2.o:file2.c head.h
    $(CC) $(FLAGS) -c $< -o $@
 
"$(CC) $(FLAGS) -c $< -o $@"是隐含规则,可以不写,默认使用此规则
 
3.假象
 
假设一个项目要生成两个可执行文件file1和file2,这两个文件是相与独立的,则在makefile开始处:
 
all:file1 file2
 
make总是假设all要生成,去检查它的依赖文件
 
4.清除由make产生的文件
 
clean:
    rm *.o
    rm file
 
执行:
make clean
则会清除由make生成的*.o和file文件
如果有clean文件存在,则清除不会执行(因clean没有可依赖的文件,永远是最新的)
 
使用PHONY目标,避免同名文件相冲突,不会检查clean文件存在与否,都要执行清除操作
 
.PHONY : clean
clean:

rm *.o

    rm file
 
5.makefile函数
 
搜索当前目录,生成由*.c结尾的文件列表,wildcard--函数名
SOURCE = $(wildcard *.c)
 
用%.o替换$(SOURCE)中的%.c文件
OBJS = $(patsubst %.c,%.O,$(SOURCE))
 
6.产生新规则
 
SOURCE = $(wildcard *.c)
depends:$(SOURCE)
    gcc -M $(SOURCE) > depends
 
(为每一个.c文件产生规则,c文件和相关头文件为依靠)
在makefile文件中:
include depends
 
7.一个有效的makefile文件
 
可以完成大部分我们所需要的依靠检查,不用做太多的修改就可用在大多数项目里
功能:搜索当前目录,寻找源码文件,放入SOURCE变量里,利用patsubst产生目标文件(*.o)
 
CC = gcc
CFLAGS = -Wall -O -g
 
SOURCE = $(wildcard *.c,*.cc)
OBJS = $(patsubst %.c,%.o,$(patsubst,%.cc,%.o,$(SOURCE)))
 
file:$(OBJS)
    $(CC) $^ -o $@
用默认规则产生目标文件(*.o)
 
 
 

1:编译可执行程序。2:编译lib库 3:编译so库
本博针对上面三种目的各自写出了makefile模版,希望对大家有所帮助。
一.编译可执行程序
当前目录下制定文件编译成可执行文件(连接外部库的话只需要更改INC和LIB即可)

CXX =  g++ 
TARGET =  bitmaploctest
C_FLAGS +=  - g - Wall
LIB_FLAGS =  - pthread
all:  $(TARGET)
bitmaploctest:  bitmaploctest.o bitmaploc.o file_lock.o
    $(CXX) - o $@ $^  $(LIB_FLAGS) $(LIB) $(C_FLAGS)
.cpp.o: 
    $(CXX) - c - o $* .o $(INC) $(C_FLAGS) $* .cpp
.cc.o: 
    $(CXX) - c - o $* .o $(INC) $(C_FLAGS) $* .cc
clean: 
    - rm - f * .o $(TARGET)

二.编译成lib库
当前目录下指定文件编译成lib库(一般lib库在编译的时候不会将使用的外部库编译进来,而是等编译成可执行程序时或者.so时)

INC_DIR=  ./ 
SRC_DIR=  ./ 
OBJ_DIR=  ./ 
LIB_DIR=  ./ 
H_DIR=  ./ 
OBJ_EXT=  .o
CXXSRC_EXT=  .cpp
CSRC_EXT=  .c
LIB_EXT=  .a
H_EXT=  .h
OBJECTS =  $(OBJ_DIR)bitmaploc$(OBJ_EXT) \
          $(OBJ_DIR)file_lock$(OBJ_EXT)
LIB_TARGET =  $(LIB_DIR)libbitmaploc$(LIB_EXT)
$(OBJ_DIR)% $(OBJ_EXT):  $(SRC_DIR)% $(CXXSRC_EXT)
    @echo
    @echo “Compiling $<  == >  $@…”
    $(CXX) $(INC) $(C_FLAGS) - c $<  - o $@
    $(OBJ_DIR)% $(OBJ_EXT):  $(SRC_DIR)% $(CSRC_EXT)
    @echo
    @echo “Compiling $<  == >  $@…”
    $(CC) - I./  $(INC) $(C_FLAGS) - c $<  - o $@
    all: $(LIB_TARGET)
    $(LIB_TARGET):  $(OBJECTS)
    all:  $(OBJECTS)
    @echo
    $(AR) rc $(LIB_TARGET) $(OBJECTS)
    @echo “ok”
clean: 
    rm - f $(LIB_TARGET) $(OBJECTS)

三.编译成so库
当前目录下指定文件编译成so库(必须将所有引用的外部库都编译进来)

CC =  gcc
CXX =  g++ 
CFLAGS  =  - Wall - pipe - DDEBUG - D_NEW_LIC - g - D_GNU_SOURCE - shared - D_REENTRANT
LIB     =  - lconfig - ldl - lrt - L../ ../ lib - lttc - g
INCLUDE =  - I../ spp_inc
OO    =  service.o tinystr.o tinyxml.o tinyxmlerror.o tinyxmlparser.o uin_conf.o stat.o
TARGETS =  ../ ../ lib/ libRanch.so
all:  $(TARGETS)
    stat: tool_stat.cpp
    $(CXX) $(INCLUDE) tool_stat.cpp - o tool_stat stat.o tinystr.o tinyxml.o tinyxmlerror.o tinyxmlparser.o - g
    cp tool_stat ../ ../ bin
    $(TARGETS):  $(OO)
    $(CXX) $(CFLAGS) $(INCLUDE) $(OO) - o $@ $(LIBDIR) $(LIB)
.c.o: 
    $(CC)  $(CFLAGS) - c $(INCLUDE) $< 
    echo $@
.cpp.o: 
    $(CXX) $(CFLAGS) - c $(INCLUDE) $< 
    echo $@
    % : % .c
    $(CC) $(CFLAGS) - o $@ $<  $(OO) $(LDFLAGS)
    echo $@
clean: 
    rm - f * .o
    rm - f $(TARGETS)
    rm - f tool_stat

 
 

CC=cc -g
PROC=proc
 
CFLAGS=-DPRECOMP -I$(ORACLE_HOME)/precomp/public \
        -I$(ORACLE_HOME)/xdk/include -I.
FLAGS= -D_ALL_SOURCE=1 -D_LINUX -g  -I../../incl -D_GNU_SOURCE -D_IS_EAB=1 -D__USE_GNU=1 -D__GCC_296 -I/usr/include/libxml2 -I../csrc -I../../csrc/ -DPOSIX=1 -DLINUX

LIBHOME=$(ORACLE_HOME)/lib

LLIBSQL= `cat $(LIBHOME)/sysliblist` \
         `cat $(LIBHOME)/ldflags` \

-lclntsh

LIBS= -L$(LIBHOME) $(LLIBSQL) -lmylib
 
.SUFFIXES: .sqc .c .o
%.c:%.sqc
        $(PROC) $(PROCPLSFLAGS) iname=$^ hold_cursor=yes
%.o:%.c
        $(CC) -c $(FLAGS) $(LIBS) $^
 
test:test.o test1.o test1.o
        cc -o $@ $(FLAGS) $(LIBS) $^
        rm -rf $^

haha:test.o test1.o test1.o
        @echo "+="$+
        @echo "?="$?
        @echo "^="$^
        @echo "<="$<
        @echo "@="$@
        @echo "*="$*
        @echo "%="$%

2.说明

2.1一般makefile编写有3个步骤

   1.宏定义。主要功能是定义一些宏变量已替代较长的编译支持信息。一般情况下针对编译所需要得.h头文 件,.a/.so的库文件路径。比如例子中的CFLAGS是oracle预编译需要数据库支持的头文件路径。LIBHOME是oracle环境编译需要数 据库库文件路径。

       2.源文件之间的相互依赖关系。列出需要产生目标文件编译依赖的文件。比如例子中的test目标,其产生时会检测(test.o test1.o test1.o)这些依赖文件的变化,如果依赖文件有变化会自动先编译依赖文件。

       3.可执行的命令.即针对目标关系,所作出的编译行为。比如test其检测完依赖文件后执行(cc -o $@ $(CFLAGS) $(LIBS) $^)编译链接产生目标执行文件test.

4.宏使用时用(),{}来确认宏名称例如${LIB}加{}会查找LIB的宏内容,$LIB会查找L的宏内容。

2.2 :常用编译项说明

1. -I:制定头文件搜索的路径

2. -L:连接需要的库文件路径

3.–l:连接需要的库文件(比如:libmylib.so写作 –lmylib)

2.3: 自动化变量说明:

$+ :所有的依赖文件,以空格分开,并以出现的先后为序,可能包含重复的依赖文件。

$?:所有的依赖文件,以空格分开,这些依赖文件的修改日期比目标的创建日期晚

$^ :所有的依赖文件,以空格分开,不包含重复的依赖文件。
$< :第一个依赖文件的名称。 
$@ :目标的完整名称。

$* :不包含扩展名的目标文件名称。
$% :如果目标是归档成员,则该变量表示目标的归档成员名称。

具体对照使用以上makefile,执行make haha得到如下对照信息:

$ makehaha

test.otest1.o test1.o

test.otest1.o

test.otest1.o

test.o

haha

2.4:后缀规则:

.SUFFIXES:.sqc .c .o制定新的后缀规则。(%.c:%.sqc),(%.o:%.c)即规则行为。就是将所有.sqc转为.c,.c再转为.o。

.c.o:等价于%.o:%.c

3.注意:

分行符\后面不能再有其他任何内容。

对齐行最好采用^I(tab键)

注释符号#

include包含编译文件

1. 概述

Makefile,what??很多windows程序可能都没听说过
简单的说,Makefile是Unix/Linux环境下描述了整个工程的编译、连接等规则 的文件 ,其主要包括三点: 
1) 工程中的哪些源文件需要编译以及如何编译 
2) 依赖库以及库所在的位置 
3) 想得到什么:可执行文件?静态库?动态库? 
项目中,我们会有很多源文件、头文件、依赖库文件、配置文件等等,通过Makefile定义规则来制定编译顺序,编译规则,编译依赖,甚至更复杂的功能,将极大的方便我们的开发,其最大的好处就是”自动化编译“,通过‘make’就可以方便的进行整个项目的编译工作。

2. 编译链接

从源码到可执行文件,具体步骤: 
源码--->预处理--->编译--->汇编--->链接 
我们常常把预处理、编译和汇编三个阶段统称为编译阶段,在这个阶段,编译器会检查程序语法、函数与变量是否声明等。 
经过编译之后,unix/linux下,将得到.o文件(一般来说,每个源文件都能生成一个对应的.o文件),即object file(windows下即.obj文件),.o不能直接运行,我们需要将其合成可执行文件,这个过程就叫链接。在链接过程,链接器会在所有的.o文件 中找寻函数的实现,如果找不到,则会报链接错误。

3.Makefile规则

Makefile只有一个规则:

target: prerequisites
command

target:即目标,它可以是可执行文件、可以是.o文件,也可以是一个标签,简单的说,它就是你要做的事情。
prerequisites:生成target所需要的条件,它可以是一个文件,也可以是另外一个target
command:具体执行的命令

解释如下:target这个目标依赖于prerequisites中的文件,其生成规则定义在command中。
更简单一点表达:如果prerequisites中任何一个文件的时间要比target文件更新的话,command所定义的命令就会执行。

eg:
=====makefile=====
#第一个规则
test: main.o hello.o
gcc main.o hello.o –o test

#第二个规则
main.o: main.c
gcc –c main.c

#第三个规则
hello.o: hello.c hello.h
gcc –c hello.c

#第四个规则
clean :
rm –rf *.o
rm –rf test
=====makefile=====

第一个规则:
test就是target, main.o和hello.o是prerequisites,'gcc main.o hello.o –o test’是command。
即:要生成test,就需要有main.o和hello.o,如果main.o或者hello.o文件的时间比test新(或者test文件不存在),则会执行命令’gcc main.o hello.o –o test’,

第二个规则:
target是main.o,main.c是prerequisites,’gcc –c main.c’是command
即:要生成test,就需要main.c,如果main.c文件的时间比main.o新,则会执行’gcc –c main.c’

第三个规则和第二个规则类似

第四个规则:
这里,target是clean,此处,clean并不是一个文件,而是一个动作的名字,它的执行,需要显示的在make命令后制定,例如,此处执行 ‘make clean’,将调用其后的command,即‘rm –rf *.o rm –rf test’,另外,此处没有prerequisites,即任何时候都执行command

我们来看下如果执行'make'会做什么:

1、make会在当前目录下找名字叫“Makefile”或“makefile”的文件。
2、如果找到,它会找文件中的第一个目标文件(target),在上面的例子中,他会找到“test”这个文件,并把这个文件作为最终的目标文件。
3、如果test文件不存在,或是test所依赖的后面的[.o]文件的文件修改时间要比test这个文件新,那么,他就会执行后面所定义的命令来生成test这个文件。
4、如果test所依赖的.o文件存在,那么make会在当前文件中找目标为.o文件的依赖性,如果找到则再根据那一个规则生成.o文件。
5、依次类推,直到生成的所有的target都是最新的。

用户如果执行'make clean',由于其后面没有依赖,则执行command所定义的命令。

如果我们修改了代码main.c,然后执行‘make’,由于main.c时间比main.o新,那么main.o会重新编译生成,由于main.o文件的时间比test新,那么test也会重新生成。

上一篇:Makefile简单编写实例


下一篇:一个简单的makefile文件编写