makefile 之标准demo

makefile 之标准demo

作者：良许Linux
链接：https://www.zhihu.com/question/55488701/answer/600769671
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。

我来分享一个我们公司的案例，为了不泄露公司隐私，作了一些修改。这篇文章首发于我的公众号：良许Linux，欢迎关注，回复1024有惊喜哦。1. 前言本教程展示了一个比较完整的企业项目级别的Makefile文件，包括了：版本号、动态库、宏定义等内容。2. 程序展示本例程的程序目录结构在企业项目中经常见到，即：所有.c文件全部放在一个src目录中，所有.h文件放一个.h目录中，生成的目标独立放在一个output目录中（动态生成）。源代码可以从在公众号里回复mk4获取。目录结构如下：

源程序为：

//fun1.h  
void fun1();  
​
​
//fun1.c  
void fun1()  
{  
    printf("this is fun1\n");  
}  
​
​
//fun2.h  
void fun2();  
​
​
//fun2.c  
void fun2()  
{  
    printf("this is fun2\n");  
}  
​
​
//dylib.h  
void dynamic_lib_call();  
​
​
//main.c  
int main()  
{  
    printf("hello world\n");  
    fun1();  
    fun2();  
​
#ifdef _MACRO  
    printf("macro test\n");  
#endif  
    dynamic_lib_call();  
}  

Makefile文件为：VERSION = 1.0.0     #程序版本号  
​
SOURCE = $(wildcard ./src/*.c)  #获取所有的.c文件  
OBJ = $(patsubst %.c, %.o, $(SOURCE))   #将.c文件转为.o文件  
INCLUDES = -I./h    #头文件路径  
​
LIBS = -ldylib      #库文件名字  
LIB_PATH = -L./lib  #库文件地址  
​
DEBUG = -D_MACRO    #宏定义  
CFLAGS = -Wall -c   #编译标志位  
​
TARGET = app  
CC = gcc  
​
$(TARGET): $(OBJ)     
    @mkdir -p output/   #创建一个目录，用于存放已编译的目标  
    $(CC) $(OBJ) $(LIB_PATH) $(LIBS) -o output/$(TARGET).$(VERSION)  
​
%.o: %.c  
    $(CC) $(INCLUDES) $(DEBUG) $(CFLAGS) $< -o $@  
​
.PHONY: clean  
clean:  
    rm -rf $(OBJ) output/   

库文件说明：库文件名称为libdylib.so，里面只有一个函数：dynamic_lib_call()，它就输出一句话：this is a function in dynamic library。
3. Makefile所包含内容3.1 程序版本软件开发过程中，会产生多个版本程序，通常会在程序末尾加上版本号后缀。

3.1 VERSION = 1.0.0 #定义  
$(CC) $(OBJ) $(LIB_PATH) $(LIBS) -o output/$(TARGET).$(VERSION) #使用  

3.2 头文件由于.c文件与.h文件分开在不同目录下，所以应指定头文件路径。INCLUDES = -I./h 
3.3 宏定义在代码调试的过程中，我们通常会加个宏定义来控制此段代码是否被编译，比如：#ifdef _MACRO  
    printf("macro test\n");  
#endif  

具体的宏我们可不定义在代码里，可在Makefile里指定，比如：

DEBUG = -D_MACRO    #定义  
$(CC) $(INCLUDES) $(DEBUG) $(CFLAGS) $< -o $@    #使用  
3.4 编译选项当编译选项较多时，我们通常会把它单独拿出来，比如：CFLAGS = -Wall -c       #定义  
$(CC) $(INCLUDES) $(DEBUG) $(CFLAGS) $< -o $@    #使用  
3.5 库代码里如果要使用到库，我们可以将库名字和路径分别拿出来，比如：LIBS = -ldylib          #库文件名字  
LIB_PATH = -L./lib      #库文件地址  
$(CC) $(OBJ) $(LIB_PATH) $(LIBS) -o output/$(TARGET).$(VERSION) #使用  
3.6 output目录如果不想把生成的程序与源文件混在一起，可将生成的程序单独放在一个output目录，比如：$(TARGET): $(OBJ)  
        @mkdir -p output/       #创建一个目录，用于存放已编译的目标  
        $(CC) $(OBJ) $(LIB_PATH) $(LIBS) -o output/$(TARGET).$(VERSION)  

4. 编译执行结果