首页 > 代码库 > 从头开始写项目Makefile(四):伪目标

从头开始写项目Makefile(四):伪目标

【版权声明:转载请保留出处:blog.csdn.net/gentleliu。Mail:shallnew at 163 dot com】

一般情况下,Makefile都会有一个clean目标,用于清除编译过程中产生的二进制文件。我们在第一节的Makefile就用到了这个 clean目标,该目标没有任何依赖文件,并且该目标对应的命令执行后不会生产clean文件。

像这种特点目标,它的规则所定义的命令不是去创建文件,而仅仅通过make指定目标来执行一些特定系统命令或其依赖为目标的规则(如all),称为伪目标。

一个Makefile一般都不会只有一个伪目标,如果按Makefile的“潜规则”以及其约定俗成的名字来说的话,在较大的项目的Makefile中比较常用的为目标有这些:

all:执行主要的编译工作,通常用作缺省目标,放在最前面。

Install:执行编译后的安装工作,把可执行文件、配置文件、文档等分别拷到不同的安装目录。

clean:删除编译生成的二进制文件。

distclean:删除除源文件之外的所有中间生成文件,如配置文件,文档等。

tags:为vim等编辑器生成tags文件。

help:打印当前Makefile的帮助信息,比如有哪些目标可以有make指定去执行。

等。

 

make处理Makefile时,首先读取所有规则,建立关系依赖图。然后从缺省目标(第一个目标)或指定的目标开始执行。像clean,tags这样的目标一般不会作为缺省目标,也不会跟缺省目标有任何依赖关系,所以 make 无法生成它的依赖关系和决定它是否要执行。所以要执行这样的目标时,必须要显示的指定make该目标。就像前面我们清楚便已产生的中间二进制文件一样,需要显示执行命令:make clean。

伪目标也可以作为默认目标(如all),并且可以为其指定依赖文件。

我们先将version 1.0的Makefile完善下,我们可以加入帮助信息,tags等功能。

# A common Makefile for c programs, version 1.1

# Copyright (C) 2014 shallnew \at 163 \dot com

 

CFLAGS += -g -Wall -Werror -O2

CPPFLAGS += -I. -I./inc

LDFLAGS += -lpthread

 

# SRC_OBJ = $(patsubst %.c, %.o, $(wildcard *.c))

SRC_FILES = $(wildcard *.c)

SRC_OBJ = $(SRC_FILES:.c=.o)

SRC_BIN = target_bin

 

all : $(SRC_BIN)

 

$(SRC_BIN) : $(SRC_OBJ)

>---$(CC) -o $@ $^ $(LDFLAGS)

 

obj : $(SRC_OBJ)

 

tags:

>---ctags -R

 

help:

>---@echo "===============A common Makefile for cprograms=============="

>---@echo "Copyright (C) 2014 liuy0711 \at 163 \dotcom"

>---@echo "The following targets are support:"

>---@echo

>---@echo " all             - (==make) compile and link"

>---@echo " obj             - just compile, without link"

>---@echo " clean           - clean target"

>---@echo " distclean       - clean target and otherinformation"

>---@echo " tags            - create ctags for vim editor"

>---@echo " help            - print help information"

>---@echo

>---@echo "To make a target, do 'make [target]'"

>---@echo "========================= Version 1.1======================="

 

# clean target

clean:

>---$(RM) $(SRC_OBJ) $(SRC_BIN) $(SRC_BIN).exe

 

distclean:

>---$(RM) $(SRC_OBJ) $(SRC_BIN) $(SRC_BIN).exe tags *~

 

make会把执行的命令打印在屏幕上,如果我们不想把命令打印在屏幕上,只显示命令结果时,直接在命令前面加上符号“@”就可以实现。如上面help目标一样,只显示命令结果。一般我们会在make时都会输出“Compiling xxx.c…”,不输出编译时的命令。我们在后面写Makefile时可以模仿。

如果当前目录下存在一个和伪目标同名的文件时(如clean),此时如果执行命令make clean后出现如下结果:

# touch clean

# make clean

make: `clean' is up to date.

#

这是因为clean文件没有依赖文件,make认为目标clean是最新的不会去执行规则对应的命令。为了解决这个问题,我们可以明确地将该目标声明为伪目标。将一个目标声明为伪目标需要将它作为特殊目标.PHONY”的依赖。如下:

.PHONY : clean

这条规则写在clean:规则的后面也行,也能起到声明clean是伪目标的作用

这样修改一下之前Makefile,将所有伪目标都作为.PHONY的依赖:

.PHONY : all obj tag help clean disclean

这样在当前目录下存在文件clean时执行:

# make clean

rm -f debug.o ipc.o main.o timer.o tools.o target_bin target_bin.exe

#


发现问题解决。

最后,给出今天最终的Makefile:

# A common Makefile for c programs, version 1.1                                                                                                                                          

# Copyright (C) 2014 shallnew \at 163 \dot com

 

CFLAGS += -g -Wall -Werror -O2

CPPFLAGS += -I. -I./inc

LDFLAGS += -lpthread

 

# SRC_OBJ = $(patsubst %.c, %.o, $(wildcard *.c))

SRC_FILES = $(wildcard *.c)

SRC_OBJ = $(SRC_FILES:.c=.o)

SRC_BIN = target_bin

 

all : $(SRC_BIN)

 

$(SRC_BIN) : $(SRC_OBJ)

>---$(CC) -o $@ $^ $(LDFLAGS)

 

obj : $(SRC_OBJ)

 

tag:

>---ctags -R

 

help:

>---@echo "===============A common Makefile for cprograms=============="

>---@echo "Copyright (C) 2014 liuy0711 \at 163 \dotcom"

>---@echo "The following targets are support:"

>---@echo

>---@echo " all             - (==make) compile and link"

>---@echo " obj             - just compile, without link"

>---@echo " clean           - clean target"

>---@echo " distclean       - clean target and other information"

>---@echo " tags            - create ctags for vim editor"

>---@echo " help            - print help information"

>---@echo

>---@echo "To make a target, do 'make [target]'"

>---@echo "========================= Version 1.1======================="

 

# clean target

clean:

>---$(RM) $(SRC_OBJ) $(SRC_BIN) $(SRC_BIN).exe

 

distclean:

>---$(RM) $(SRC_OBJ) $(SRC_BIN) $(SRC_BIN).exe tags *~

 

.PHONY : all obj tag help clean disclean