在GNU make管理的项目中萌萌地处理头文件依赖

以下要说的显然是C语言的项目。

当然可以考虑用其他工具替代make,比如SCons和CMake,或者auto tools什么的,但很多时候手写Makefile还是非常干净利索,爽快好用的,尤其在项目比较小的时候。

规模一旦扩大,确实写Makefile就有点费劲了。比较突出的一个问题是对头文件的依赖。make自己是没有办法处理的,必须要借助编译器。

以下会列举三种常见的Makefile写法。后两种处理了对头文件的依赖,推荐使用最后一种。

项目结构

说下演示用的项目,只包含三个代码文件,结构如下:

.
├── bar.c
├── bar.h
├── foo.c
└── Makefile

bar.h

#ifndef _BAR_H_
#define _BAR_H_

void bar(void);

#endif

bar.c

#include <stdio.h>

void bar(void)
{
    printf("bar!\n");
}

foo.c

#include <stdio.h>
#include "bar.h"

int main()
{
    printf("foo -> ");
    bar();
    return 0;
}

1. 不考虑头文件依赖的Makefile

如果不处理对头文件的依赖,可以写出类似下面这样的“万能Makefile”,做做小东西无往不利。
缺陷是头文件修改了以后不能自动重新编译,需要不断make clean && make

TARGET := foo
CC := gcc
LDLIBS := -lm

SRCS := $(wildcard *.c)
OBJS := $(SRCS:.c=.o)

.PHONY: all clean

all: $(TARGET)

$(TARGET): $(OBJ)

clean:
    rm -f $(OBJ) $(TARGET)

2. gcc + sed

这是一种应该抛弃的方案,详细的步骤分解可以看这篇文章Autodependencies with GNU make

简要概括下,就是利用gcc的选项-M-MM,来生成依赖文件。(-M包括对系统头文件的依赖,-MM包括。下面要说的-MD-MMD也是一样的关系。)生成的依赖文件还需要用脚本做一些修改,以保证后期修改代码之后,依赖文件能够重新生成

烦人的地方就是用脚本修改依赖文件,有这样改的:

%.o: %.c
    gcc -c $(CFLAGS) $*.c -o $*.o
    gcc -MM $(CFLAGS) $*.c > $*.d
    @cp -f $*.d $*.d.tmp
    @sed -e 's/.*://' -e 's/\\$$//' < $*.d.tmp | fmt -1 | \
      sed -e 's/^ *//' -e 's/$$/:/' >> $*.d
    @rm -f $*.d.tmp

也有这样改的:

%.d: %.c
    @set -e; rm -f $@; \
    $(CC) -M $(CPPFLAGS) $< > $@.$$$$; \
    sed 's,\($*\)\.o[ :]*,\1.o $@ :,g' < $@.$$$$ > $@; \
    rm -f $@.$$$$

需要抛弃的原因不言而喻。。。

3. MMD萌萌的

目前最好的方案,是利用gcc的选项-MMD自动生成依赖文件。这个早该普及的方法其实没那么多人知道,经常见到有人在死记sed命令。其实gcc早就提供更好的方式了。只要加上萌萌的-MMD选项,会在编译的过程中顺便生成依赖文件。没有手动修改依赖文件的必要,依赖文件总能正确地重新生成

就是像下面这样写:

TARGET := foo
CC := gcc
LDLIBS := -lm
CFLAGS := -MMD -MP

SRCS := $(wildcard *.c)
OBJS := $(SRCS:.c=.o)
DEPS := $(SRCS:.c=.d)

.PHONY: all clean

all: $(TARGET)

$(TARGET): $(OBJS)

-include $(DEPS)

clean:
    rm -f $(OBJS) $(DEPS) $(TARGET)

可以和前面的“万能Makefile”对比一下:

只是简单添加了几行。要注意-include $(DEPS)不能放在all规则之前,all必须是第一个规则嘛。

还有要提一下的是选项-MP,它的作用是为头文件生成这样的依赖规则:

bar.h:

空的,没有依赖,没有动作,但并不是没有作用。如果没有这个规则,万一误删了bar.h,或者改名了,而foo.c忘了改,make会这样提示

勉强能接受?可要是加上-MP选项,提前生成了上面那个空的规则,make会继续执行,然后让编译器给出更准确的错误信息:

所以没事还是把-MP加上吧。。。

本文同步自:http://suosuopuo.com/2015/01/01/makefile-dependencies/

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。

相关推荐


迭代器模式(Iterator)迭代器模式(Iterator)[Cursor]意图:提供一种方法顺序访问一个聚合对象中的每个元素,而又不想暴露该对象的内部表示。应用:STL标准库迭代器实现、Java集合类型迭代器等模式结构:心得:迭代器模式的目的是在不获知集合对象内部细节的同时能对集合元素进行遍历操作
高性能IO模型浅析服务器端编程经常需要构造高性能的IO模型,常见的IO模型有四种:(1)同步阻塞IO(BlockingIO):即传统的IO模型。(2)同步非阻塞IO(Non-blockingIO):默认创建的socket都是阻塞的,非阻塞IO要求socket被设置为NONBLOCK。注意这里所说的N
策略模式(Strategy)策略模式(Strategy)[Policy]意图:定义一系列算法,把他们封装起来,并且使他们可以相互替换,使算法可以独立于使用它的客户而变化。应用:排序的比较方法、封装针对类的不同的算法、消除条件判断、寄存器分配算法等。模式结构:心得:对对象(Context)的处理操作可
访问者模式(Visitor)访问者模式(Visitor)意图:表示一个作用于某对象结构中的各元素的操作,它使你在不改变各元素的类的前提下定义作用于这些元素的新操作。应用:作用于编译器语法树的语义分析算法。模式结构:心得:访问者模式是要解决对对象添加新的操作和功能时候,如何尽可能不修改对象的类的一种方
命令模式(Command)命令模式(Command)[Action/Transaction]意图:将一个请求封装为一个对象,从而可用不同的请求对客户参数化。对请求排队或记录请求日志,以及支持可撤消的操作。应用:用户操作日志、撤销恢复操作。模式结构:心得:命令对象的抽象接口(Command)提供的两个
生成器模式(Builder)生成器模式(Builder)意图:将一个对象的构建和它的表示分离,使得同样的构建过程可以创建不同的表示。 应用:编译器词法分析器指导生成抽象语法树、构造迷宫等。模式结构:心得:和工厂模式不同的是,Builder模式需要详细的指导产品的生产。指导者(Director)使用C
设计模式学习心得《设计模式:可复用面向对象软件的基础》一书以更贴近读者思维的角度描述了GOF的23个设计模式。按照书中介绍的每个设计模式的内容,结合网上搜集的资料,我将对设计模式的学习心得总结出来。网络上关于设计模式的资料和文章汗牛充栋,有些文章对设计模式介绍生动形象。但是我相信“一千个读者,一千个
工厂方法模式(Factory Method)工厂方法模式(Factory Method)[Virtual Constructor]意图:定义一个用于创建对象的接口,让子类决定实例化哪一个类,使一个类的实力化延迟到子类。应用:多文档应用管理不同类型的文档。模式结构:心得:面对同一继承体系(Produc
单例模式(Singleton)单例模式(Singleton)意图:保证一个类只有一个实例,并提供一个访问它的全局访问点。应用:Session或者控件的唯一示例等。模式结构:心得:单例模式应该是设计模式中最简单的结构了,它的目的很简单,就是保证自身的实例只有一份。实现这种目的的方式有很多,在Java中
装饰者模式(Decorator)装饰者模式(Decorator)[Wrapper]意图:动态的给一个对象添加一些额外的职责,就增加功能来说,比生成子类更为灵活。应用:给GUI组件添加功能等。模式结构:心得:装饰器(Decorator)和被装饰的对象(ConcreteComponent)拥有统一的接口
抽象工厂模式(Abstract Factory)抽象工厂模式(Abstract Factory)[Kit]意图:提供一个创建一系列相关或相互依赖对象的接口,而无须指定他们具体的类。应用:用户界面工具包。模式结构:心得:工厂方法把生产产品的方式封装起来了,但是一个工厂只能生产一类对象,当一个工厂需要生
桥接模式(Bridge)桥接模式(Bridge)[Handle/Body]意图:将抽象部分与它的实现部分分离,使他们都可以独立的变化。应用:不同系统平台的Windows界面。模式结构:心得:用户所见类体系结构(Window派生)提供了一系列用户的高层操作的接口,但是这些接口的实现是基于具体的底层实现
适配器模式(Adapter)适配器模式(Adapter)[Wrapper]意图:将类的一个接口转换成用户希望的另一个接口,使得原本由于接口不兼容而不能一起工作的类可以一起工作。应用:将图形类接口适配到用户界面组件类中。模式结构:心得:适配器模式一般应用在具有相似接口可复用的条件下。目标接口(Targ
组合模式(Composition)组合模式(Composition)意图:将对象组合成树形结构以表示“部分-整体”的层次结构,使得用户对单个对象和组合对象的使用具有一致性。应用:组合图形、文件目录、GUI容器等。模式结构:心得: 用户(Client)通过抽象类(Component)提供的公用接口统一
原型模式(Prototype)原型模式(Prototype)意图:用原型实例制定创建对象的种类,并且通过拷贝这些原型创建新的对象。应用:Java/C#中的Clonable和IClonable接口等。模式结构:心得:原型模式本质上就是对象的拷贝,使用对象拷贝代替对象创建的原因有很多。比如对象的初始化构
什么是设计模式一套被反复使用、多数人知晓的、经过分类编目的、代码 设计经验 的总结;使用设计模式是为了 可重用 代码、让代码 更容易 被他人理解、保证代码 可靠性;设计模式使代码编制  真正工程化;设计模式使软件工程的 基石脉络, 如同大厦的结构一样;并不直接用来完成代码的编写,而是 描述 在各种不同情况下,要怎么解决问题的一种方案;能使不稳定依赖于相对稳定、具体依赖于相对抽象,避免引
单一职责原则定义(Single Responsibility Principle,SRP)一个对象应该只包含 单一的职责,并且该职责被完整地封装在一个类中。Every  Object should have  a single responsibility, and that responsibility should be entirely encapsulated by t
动态代理和CGLib代理分不清吗,看看这篇文章,写的非常好,强烈推荐。原文截图*************************************************************************************************************************原文文本************
适配器模式将一个类的接口转换成客户期望的另一个接口,使得原本接口不兼容的类可以相互合作。
策略模式定义了一系列算法族,并封装在类中,它们之间可以互相替换,此模式让算法的变化独立于使用算法的客户。