makefile中进行宏定义并传递给源代码

makefile是liunx 平台下c、c++开发必不可的工具，掌握一些makefile的技巧对于项目编译构建有很大的帮助，本篇文章主要记录一下makefile中进行宏定义并传递给源代码的使用技巧，主要传递了一个code_version变量，变量是通过git命令获取commit id，通过宏定义传递给源码，在源码中可以获取commit id，可以作为code的版本信息，这对于频繁release的项目很重要，可以确认一些so的版本是否匹配。

1 工程目录结构

建立的demo工程目录结构如下所示：

├── include
│   └── common.h
├── main_dir
│   ├── main.c
│   └── makefile
├── makefile
├── obj
│   ├── function.o
│   └── main.o
├── readme.txt
└── sub_dir
    ├── function.c
    └── makefile

2 顶层目录makefile解读

顶层目录makefile：

CC = gcc
CFLAGS = -g -Wall -O 
export TARGET = demo

export OBJ = function.o main.o
export BUILD_PATH = $(PWD)
export SUBDIR = main_dir sub_dir
export OBJDIR = $(BUILD_PATH)

export code_version = $(shell (git rev-parse --short HEAD))
export code_branch = $(shell (git branch))
export code_date= $(shell (git log -1 --format=%cd ))

$(info $(code_version))
$(info $(code_branch))
$(info $(code_date))

all:sub_target $(TARGET)

$(TARGET):$(OBJ) 
	$(CC) $^ -o $(OBJDIR)/$@ 
	@echo "-------build target success-------"

sub_target:
	@echo "-------start build sub dir-------"
	make -C main_dir
	make -C sub_dir
	@echo "-------build sub dir end-------"

clean:
	rm -rf $(OBJDIR)/*.o $(TARGET) 

顶层makefile目标是编译demo可以执行程序，编译demo需要依赖main_dir和sub_dir编译出的function.o 和main.o，并且编译function.o 和main.o时将其存放至obj文件夹，这样方便项目管理。顶层目录中还通过shell 命令定义了code_version变量，这样项目中其他makefile 就可以使用该变量了，这也是makefile之间传递变量的一种方式。

2 main_dir目录源码解读

main_dir 目录有一个main.c 和一个makefile文件，main.c 中内容入下：

#include <stdio.h>
#include "../include/common.h"

int main()
{
    printf("code version: %s\n", CODE_VERSION);
    printf("main IN\n");

    int sum = add(5, 6);
    printf("sum = %d \n",sum);

    printf("main OUT\n");
    return 0;
}

里面主要调用了一个add函数，add 函数的声明在include/common.h，实现在sub_dir/function.c，common.h中内容很简单，只做了add函数声明：

int add (int a, int b);

main函数中还打印了CODE_VERSION这个宏，这个宏在common.h和main.c中都没有定义，而是在编译的时候通过makefile定义的，main_dir 中makefile内容入下：

CFLAGS += -DCODE_VERSION=\"$(code_version)\"

$(OBJDIR)/main.o:main.c
	$(CC) $(CFLAGS) -c $^ -o $@

其中：

CFLAGS += -DCODE_VERSION=\"$(code_version)\"

就是定义了CODE_VERSION这个宏，并且宏的内容是顶层makefile中传递的变量，此外，makefile中定义字符串宏时需要使用转义字符。

3 sub_dir目录源码解读

sub_dir 目录包含了一个function.c文件和一个makefile，function.c中就是add函数实现：

#include <stdio.h>
#include "../include/common.h"

int add (int a, int b)
{
    return a+b;
}

sub_dir 中makefile内容：

$(OBJDIR)/function.o:function.c
	$(CC) $(CFLAGS) -c $^ -o $@

4 效果验证

在顶层目录执行make命令进行编译:

make

编译结果如下：

运行程序：

./demo

结果如下：

可以看到CODE_VERSION有被正确印出来。
实验代码git 地址：https://github.com/zhenghaiyang123/makefile_demo.git