玩转Makefile | 企业项目Makefile实例

0. 相关阅读

    玩转Makefile | 系列综述

    玩转Makefile | 基础入门

    玩转Makefile | 四步教你从零开始写Makefile

    玩转Makefile | 企业项目Makefile实例

    玩转Makefile | 编译有共用文件的多个程序

    玩转Makefile | 一次编译多个目标

 

1. 前言

本教程展示了一个比较完整的企业项目级别的Makefile文件，包括了：版本号、动态库、宏定义等内容。

 

2. 程序展示

本例程的程序目录结构在企业项目中经常见到，即：所有.c文件全部放在一个src目录中，所有.h文件放一个.h目录中，生成的目标独立放在一个output目录中（动态生成）。

      源代码可以从这里获取。

目录结构如下：

源程序为：

//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 程序版本

软件开发过程中，会产生多个版本程序，通常会在程序末尾加上版本号后缀。

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. 编译执行结果

 

---------------

码字不易，点个赞再走呗~

我是良许，世界500强外企 Linux 开发工程师，专业生产 Linux 干货。欢迎关注我的公众号「良许Linux」，回复「1024」获取最新最全的技术资料，回复「入群」进入高手如云技术交流群；提供永久免费 CSDN 资料下载服务。