makefile常用编译选项

我们习惯创建一个环境变量文件Inc.mk来定义常用的变量

CC = gcc
CXX = g++ -std=c++11
AR ?= ar
ARFLAGS = -scurv
RANLIB ?= ranlib

CFLAGS ?=
CXXFLAGS ?=
INCLUDE ?=
LDFLAGS ?=

CFLAGS   += -Wall -g -fPIC -pipe -Wl,-z -Wl,defs -DDEBUG
CXXFLAGS += -Wall -g -fPIC -pipe -Wl,-z -Wl,defs -DDEBUG

%.o: %.cpp 
	$(CXX) $(CXXFLAGS) $(INCLUDE) -c $<

%.o: %.c
	$(CC) $(CFLAGS) $(INCLUDE) -c $<

ar命令：

-s 创建归档索引（等同ranlib）

-c 如果必须创建库，请不要发出警告

-u 仅替换比当前存档内容更新的文件

-r 替换现有文件或将新文件插入存档

-v 详细说明

ar -s其实等同于ranlib，由于早期linux系统ar只是单纯打包多个.o文件到.a静态库，而不处理.o的符号表，所以需要ranlib来生成链接所需要的符号信息。现在其实不需要第二步ranlib。

编译选项：

-w 关闭所有警告信息

-Wall 提供有用的警告信息

-Werror 警告信息变成错误，必须处理

-g 产生调试信息，给调试器用，可以用-g3这个级别可以调试宏；如果调试器是gdb，建议使用-ggdb或者-ggdb3

-fPIC 是生成动态库使用的，编译器就输出位置无关目标码，适用于动态连接，即使分支需要大范围转移

-pipe 编译会有几个阶段，每个阶段生成临时文件给下一个阶段使用，使用这个选项避免了文件读写而使用管道在内存中进行

-Wl,-z -Wl,defs 链接编辑器生成共享库输出文件时，允许在链接编辑结束时仍存在未定义符号。此缺省行为允许共享库从将其定义为依赖性的动态可执行文件导入符号。-z defs选项强制在存在任何未定义符号的情况下生成致命错误

-DDEBUG 相当于定义了宏DEBUG，代码中可以用#ifdef DEBUG来控制调试输出信息等

现在来看下正文Makefile文件

include ../Inc.mk

DIR_MODULES=crypto \
            net

SRC := $(wildcard *.cpp)
OBJS := $(patsubst %.cpp, %.o, $(SRC))
SO_NAME = libcomm.so
SO_BIN = $(LIB_DIR)/$(SO_NAME)
A_NAME = libcomm.a
A_BIN = $(LIB_DIR)/$(A_NAME)

INCLUDE += -I$(XML_INC) 
LDFLAGS += -L$(LIB_DIR) -ltinyxml2

all : clean $(SO_BIN) $(A_BIN)
	@for dir in $(DIR_MODULES); \
	do \
		make -C $$dir; \
		echo; \
	done

$(SO_BIN) : $(OBJS)
	$(CXX) $(CXXFLAGS) -shared -Wl,-soname,$(SO_NAME) -o $@ $^ $(LDFLAGS)

$(A_BIN) : $(OBJS)
	$(AR) $(ARFLAGS) $@ $?
	$(RANLIB) $@

clean :
	@for dir in $(DIR_MODULES); \
	do \
		make -C $$dir clean; \
		echo; \
	done
	rm -rf $(OBJS) $(SO_BIN) $(A_BIN)

静态库的生成一般是两步：

ar -scurv libcomm.a *.o

ranlib libcomm.a

这是早期linux做法，现在可以省去ranlib这一步

动态库的生成需要用到-shared

-Wl,-soname 是为了提高新老版本库的兼容性，通过soname指定我们所希望的库版本

include ../Inc.mk

SRC := $(wildcard *.cpp)
OBJS := $(patsubst %.cpp, %.o, $(SRC))
BIN = $(BIN_DIR)/server

INCLUDE += -I$(COMM_INC) -I$(XML_INC)
LDFLAGS += -L$(LIB_DIR) -ltinyxml2 -lcomm

all : clean $(BIN)

$(BIN) : $(OBJS)
	$(CXX) $(CXXFLAGS) -Wl,--export-dynamic -Wl,-rpath=$(LIB_DIR) -o $@ $^ $(LDFLAGS)

clean :
	rm -rf $(OBJS) $(BIN)

-Wl,--export-dynamic此时链接器产生可执行文件时会将所有全局符号导出到动态符号表。如果在创建动态链接的可执行文件不加-Wl,--export-dynamic选项，则它所export的动态符号仅仅包括在链接时动态对象所用到的。因为dlopen是自行加载动态库，并不存在与可执行文件动态符号解析的过程，所以如果dlopen加载的动态库使用了主模块中定义的函数，则会出现找不到符号的情况。默认链接器在产生可执行文件时，只会将那些链接时被其他共享模块引用到的符号放到动态符号表中，这样可以减少动态符号表的大小，也就是说，在共享模块中反向引用主模块中的符号时，只有那些在链接时被共享模块引用到的符号才会被导出，（主模块的符号表中依赖的共享模块主模块才会去链接，否则不会去链接，不被链接的模块引用了主模块的符号就不会被导出到动态符号表中，导致运行时报错）。但是使用--export-dynamic参数后由于将所有的全局符号导出到动态符号表中导致可执行程序会变大。

-Wl,-rpath 是为了指定我们链接的库路径，就不需要再去修改LD_LIBRARY_PATH变量了

这里我们看到每个Makefile文件都include ../Inc.mk

1. 在Inc.mk中，我们定义了固定的几个参数，gcc，g++还有编译选项等，在Makefile中include之后就可以直接使用，但是INCLUDE和LDFLAGS我们并没有固定，而是在Makefile中自定义，因为它们要引用的头文件，库文件都是各取所需。

2. 在Inc.mk中，我们定义了.c生成.o和.cpp生成.o的规则，在Makefile中include之后就可以直接使用了，所以我们在Makefile中只需要写.o生成可执行文件的规则就行了，生成可执行文件需要包含的头文件INCLUDE和需要链接的库LDFLAGS我们自定义，就配合完美了。