小型C/C++项目的makefile编写
【前言】在我所接触到的Linux嵌入式开发中，大多使用的是C语言，采用makefile文件对源文件进行编译后生成可执行文件。本文即从个人经历上介绍小型的C项目如何编写makefile文档。
一、gcc命令
从目的上看，gcc命令和makefile的功能是一样，即是把源文件编译后生成可执行文件或.o二进制文件。gcc命令中有许多的额外的参数，本文仅介绍以下几种最简单和常用的方法：
有helloworld.c文件如下：
#include <stdio.h>
int main()
{
printf(“helloworld!\n”);
return 0;
}
使用如下gcc命令，将在同一文件目录下生成a.out可执行文件，在terminal中运行该文件即可在屏幕中打印出helloworld!：
$ gcc helloworld.c
使用如下gcc命令，将在同一文件目录下生成helloworld.o二进制文件，它可以被用来连接文件：
$ gcc -c helloworld.c
如果要生成特定名称的可执行文件，可以使用如下gcc命令，它将生成helloworld可执行文件，区别于a.out可执行文件，在termianl执行它可以打印出helloworld!：
$ gcc helloworld.c -o helloworld
以上三种gcc命令，主要区别是参数不同，-c和-o的区别在于，-c只编译不连接，故只生成.o的二进制文件，-o即指定名称输出可执行文件。对于单个或者几个的源文件，使用gcc命令即可，但是一旦文件具有依赖关系，gcc命令的执行顺序是需要规定的，否则无法顺序编译项目，这是gcc命令的缺点，而makefile区别于gcc命令的地方正在于它能规定好文件间的依赖关系，以及加入依赖的库文件和头文件。
如果要引用其它目录下的头文件，其gcc命令如下，采用-I的参数：
$ gcc -I /ycl/include/ helloworld.c -o helloworld
如果要引用其它的目录下的库文件，如libmlib.so，其gcc命令如下，采用-L的参数：
$ gcc -L /ycl/lib –lmlib helloworld.c -o helloworld
二、makefile简要语法
makefile的用处是告诉编辑器，本项目以怎样的规则进行编译和链接，运行make命令需要makfile文件作为支撑。
要弄明白makefile，其关键是理解它的核心语法（源自博文http://blog.csdn.net/liang13664759/article/details/1771246 ）：
target … : prerequisites …
command
…
…
target也就是一个目标文件，可以是Object File，也可以是执行文件。还可以是一个标签（Label），对于标签这种特性，在后续的“伪目标”章节中会有叙述。
prerequisites就是，要生成那个target所需要的文件或是目标。
command也就是make需要执行的命令。（任意的Shell命令）
这是一个文件的依赖关系，也就是说，target这一个或多个的目标文件依赖于prerequisites中的文件，其生成规则定义在command中。说白一点就是说，prerequisites中如果有一个以上的文件比target文件要新的话，command所定义的命令就会被执行。这就是Makefile的规则。也就是Makefile中最核心的内容。
示例代码如下：
复制代码
CXX = g++
CXXFLAGS = -O2 -g -Wall -fmessage-length=0
CFLAGS = pkg-config --cflags lcm
LDFLAGS=pkg-config --libs lcm
-lpthread
OBJS = DSRC_module.o
LCMHandler.o
UDPHandler.o
TARGET = DSRC_module
$(TARGET): $(OBJS)
$(CXX) -o $@ $^
(CXX) $(CFLAGS) -I. -o $@ -c $<
LCMHandler.o: LCMHandler.cpp
$(CXX) $(CFLAGS) -I. -o $@ -c $<
UDPHandler.o: UDPHandler.cpp
$(CXX) $(CFLAGS) -I. -o $@ -c $<
all: $(TARGET)
clean:
rm -f $(OBJS) $(TARGET)
复制代码
示例代码中出现了变量，makefile中变量采用
(TARGET)即表示DSRC_module。该makefile的目的是生成名为DSRC_ module的可执行文件，即
(OBJS)所代表的DSRC_module.o、LCMHandler.o、UDPHandler.o三个文件。由于这三个文件都未生成，故针对每一个文件都需要进行编译生成，所以有三个.o文件为目标的makefile语句。
文中特殊字符说明如下： ^–所有的依赖文件， @代表DSRC_module.cpp，$<代表第一个依赖文件，也就是DSRC_module.cpp。
DSRC_module.o: DSRC_module.cpp
$(CXX) $(CFLAGS) -I. -o $@ -c $<
三、makefile编写
使用装用CDT插件的eclipse可以直接生成helloworld项目的makefile项目，makefile内容如下：
复制代码
CXXFLAGS = -O2 -g -Wall -fmessage-length=0
OBJS = example.o
LIBS =
TARGET = example
$(TARGET): $(OBJS)
$(CXX) -o $(TARGET) $(OBJS) $(LIBS)
all: $(TARGET)
clean:
rm -f $(OBJS) $(TARGET)
复制代码
其中CXXFLAGS是编译参数变量，CXX是makefile内置变量，CXX默认表示g++（C++编译器）。这个makefile的有两个功能：①编译代码，将example.c编译成example.o并链接成example可执行文件；②清除项目，当项目需要重新编译或整理时，使用make clean命令即可清除生的OBJS和TARGET变量中的名称。
在上述代码中，之所以依赖文件没有.c文件，这是因为此处使用了makefile的自动推导功能，只要依赖关系中有.o文件，它会自动添加同名称的.c文件作为依赖文件，并由 (CXX) -o example.c。
$(TARGET): $(OBJS)
$(CXX) -o $(TARGET) $(OBJS) $(LIBS)
基于上述的makefile文件，如果此时需要添加新的.c和.h文件，则改变OBJS的内容即可，比如填加test.c文件，则代码如下（注意test.o前的不能加空格，需用tab键）：
复制代码
CXXFLAGS = -O2 -g -Wall -fmessage-length=0
OBJS = example.o
test.o
LIBS =
TARGET = example
$(TARGET): $(OBJS)
$(CXX) -o $(TARGET) $(OBJS) $(LIBS)
all: $(TARGET)
clean:
rm -f $(OBJS) $(TARGET)
复制代码
如果需要添加头文件，那么注意尽量不要使用makefile的自动推导功能，否则可能找不到头文件，则只需添加和修改如下代码：
复制代码
CXXFLAGS = -O2 -g -Wall -fmessage-length=0
OBJS = example.cpp
test.cpp
HEADER_DIR = -I/home/duser/dot3
LIBS =
TARGET = example
$(TARGET): $(OBJS)
$(CXX) -o $(TARGET) $(OBJS) $(LIBS)
all: $(TARGET)
clean:
rm -f $(TARGET)
$(TARGET): $(OBJS)
$(CXX) $(HEADER_DIR) $(OBJS) -o $(TARGET) $(LIBS)
复制代码
如果需要添加库文件，需要两个变量，LDFLAGS—相当于库所在路径，LIBS—要链接的库文件。则只需添加和修改如下代码：
LDFLAGS += -L/lib
LIB += -ltest
$(TARGET): $(OBJS)
$(CXX) $(HEADER_DIR) $(OBJS) -o $(TARGET) $(LIBS)
(LIBS)
标签: C++, makefile, gcc