Makefile实际操作详解

最新推荐文章于 2024-06-26 10:31:31 发布

jiahaoST

最新推荐文章于 2024-06-26 10:31:31 发布

阅读量497

点赞数

分类专栏： Makefile 文章标签： Makefile

Makefile 专栏收录该内容

2 篇文章 0 订阅

订阅专栏

一、makefile 单个C文件

0.前言

从学习C语言开始就慢慢开始接触makefile，查阅了很多的makefile的资料但总感觉没有真正掌握makefile，如果自己动手写一个makefile总觉得非常吃力。所以特意借助博客总结makefile的相关知识，通过例子说明makefile的具体用法。

例说makefile分为以下几个部分，更多内容请参考【例说makefile索引博文】

1.只有单个C文件

2.含有多个C文件

3.需要包括头文件路径

4.增加宏定义

5.增加系统共享库

6.增加自定义共享库

7.一个实际的例子

【代码仓库】—— makefile-example

代码仓库位于bitbucket，可借助TortoiseHg（GUI工具）克隆代码或者在网页中直接下载zip包。

1.复习gcc指令

一个非常简单的C文件——test.c

【test.c】

[cpp] view plain copy

#include <stdio.h>
int main(void)
{
int a = 3;
int b = 2;
printf("a=%d\n",a);
printf("b=%d\n",b);
return 0;
}

【最简单方法】

gcc test.c -o test

最终生成可执行文件 test。

【执行test】

./test

【输出结果】

a=3

b=5

【不正确的写法】

请注意以下写法并不正确。

gcc -c test.c -o test

【详细步骤分解】编译——链接

无论gcc指令的参数如何变化，从源文件变为可执行文件只需要两步，第一步源文件编译为目标文件，第二步从目标文件链接为可执行文件。在最简单的指令——gcc test.c -o test中使用了一处GCC的隐含规则，所有编译和链接这两个关键步骤展现的不明显。那么下面通过指令让“不明显”变得“明显”。

【1】由c文件编译为目标文件

【写法1】

gcc -c test.c -o test.o

【写法2】——顺序可以颠倒

gcc -o test.o -c test.c

【写法3】——适当简写

可以适当简写，充分利用GCC的默认规则，*.o文件由同名的*.c文件编译得到。

gcc -c test.c

【写法4】——有点奇怪

还可以这样写，虽然看起来有点奇怪，但只执行结果却是一样的。makefile文件似乎更喜欢这种方式。

gcc -c -o test.o test.c

【2】把目标文件链接为可执行文件

【写法1】

gcc test.o -o test

【写法2】——顺序可以颠倒

顺序可以颠倒，makefile文件似乎更喜欢这种方式。

gcc -o test test.o

2.编写makefile文件

【makefile】

请替换其中的[tab]，并以代码仓库中的makefile文件为主。

[cpp] view plain copy

# 可执行文件
TARGET = test
# 依赖目标
OBJS = test.o
# 指令编译器和选项
CC=gcc
CFLAGS=-Wall -std=gnu99
$(TARGET):$(OBJS)
# @echo TARGET:$@
# @echo OBJECTS:$^
[tab]$(CC) -o $@ $^
clean:
[tab]rm -rf $(TARGET) $(OBJS)

【具体说明】

【1】TARGET=test test为最后可执行文件，linux中的可执行文件就是windows中的exe文件

【2】OBJS = test.o test.o对应test.c，利用makefile的隐含规则，test.o由test.c编译得到。

【3】CC=gcc 指定编译器为gcc

【4】CFLAGS=-Wall -std=gnu99 使能所有警告，指定编译器标准为gnu99

【5】 $(CC) -o $@ $^

$@和$^为自动化变量，$@指目标文件，此处为可执行文件test，$^指去除重复的依赖文件，此处为test.o

$(CC) -o $@ $^ 最终变化为 gcc -o test test.o。gcc -o test test.o和【详细步骤】链接部分的指令完全相同。那么makefile和gcc指令便建立了联系。

可以通过@echo指令在makefile执行过程中打印自动化变量，通过这种方式调试makefile加速错误修正。

【编译】

make clean && make

先执行make clean再执行make生成可执行文件

【控制台输出】

gcc -Wall -std=gnu99 -c -o test.o test.c

gcc -o test test.o

【分析】

若去除-Wall -std=gnu99，那么以上两句简化为

gcc -c -o test.o test.c 和编译过程方法【4】相同

gcc -o test test.o 和执行过程方法【2】相同

那么makefile和gcc指令便建立了关系，理解起来也方便多了。

3.再完善一些

【makefile】

请替换其中的[tab]，并以代码仓库中的makefile文件为主

[cpp] view plain copy

# 可执行文件
TARGET=test
# C文件
SRCS = test.c
# 目标文件
OBJS = $(SRCS:.c=.o)
# 指令编译器和选项
CC=gcc
CFLAGS=-Wall -std=gnu99
$(TARGET):$(OBJS)
# @echo TARGET:$@
# @echo OBJECTS:$^
[tab]$(CC) -o $@ $^
clean:
[tab]rm -rf $(TARGET) $(OBJS)
%.o:%.c
[tab]$(CC) $(CFLAGS) -o $@ -c $<

【变化说明】

【1】OBJS = $(SRCS:.c=.o) 变量替换函数，把所有的*.c文件替换为*.o文件。该函数和

OBJS = $(patsubst %.c,%.o,$(SRCS))具有相同效果。

【2】$<为自动化变量，指第一个目标文件，此处为test.c

替换变量和自动化变量之后：

test.o:test.c

[tab]gcc -Wall -std=gnu99 -o test.o -c test.c

4.总结

【1】gcc指令执行顺序——先编译目标文件，后链接成可执行文件

【2】自动化变量

$@ 当前规则的目标文件

$< 第一个依赖文件

$^ 去除重复的所有依赖文件

二、例说makefile 多个文件

0.前言

例说makefile分为以下几个部分，更多内容请参考【例说makefile索引博文】

1.只有单个C文件

2.含有多个C文件

3.需要包括头文件路径

4.增加宏定义

5.增加系统共享库

6.增加自定义共享库

7.一个实际的例子

【代码仓库】—— makefile-example

代码仓库位于bitbucket，可借助TortoiseHg（GUI工具）克隆代码或者在网页中直接下载zip包。

1.三个C文件

三个文件位于同一个目录中。

【test.c】

[cpp] view plain copy

#include <stdio.h>
int main(void)
{
int a = 3;
int b = 2;
printf("a=%d\n", a);
printf("b=%d\n", b);
printf("a+b=%d\n", add(a,b));
printf("a-b=%d\n", sub(a,b));
return 0;
}

【test-add.c】

[cpp] view plain copy

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

【test-sub.c】

[cpp] view plain copy

int sub(int a, int b)
{
return a-b;
}

2.复习GCC指令

多个C文件和单个C文件的处理过程相似，此时-c或-o之后可以增加多个C文件或目标文件。

【编译源文件】

gcc -c test.c test-add.c test-sub.c

【链接目标文件】

gcc -o test test.o test-add.o test-sub.o

【执行目标文件】

./test

【控制台输出】

a=3

b=2

a+b=5

a-b=1

3.编写makefile文件

【makefile】

请替换其中的[tab]，并以代码仓库中的makefile文件为主。

[cpp] view plain copy

# 指令编译器和选项
CC=gcc
CFLAGS=-Wall -std=gnu99
# 目标文件
TARGET=test
# 源文件
SRCS=test.c test-add.c test-sub.c
OBJS = $(SRCS:.c=.o)
$(TARGET):$(OBJS)
# @echo TARGET:$@
# @echo OBJECTS:$^
[tab]$(CC) -o $@ $^
clean:
[tab]rm -rf $(TARGET) $(OBJS)
%.o:%.c
[tab]$(CC) $(CFLAGS) -o $@ -c $<

【具体说明】

【1】更多说明请参考：例说makefile——单个文件

【2】相对于单个文件，此处仅修改了SRCS=test.c test-add.c test-sub.c，变量SRCS追加了多个C文件。相比单个文件的情况，仅仅修改了这一行。

【3】文件和文件之间通过空格隔开。

【执行过程】

make clean && make

【控制台输出】

rm -rf test test.o test-add.o test-sub.o

gcc -Wall -std=gnu99 -o test.o -c test.c

gcc -Wall -std=gnu99 -o test-add.o -c test-add.c

gcc -Wall -std=gnu99 -o test-sub.o -c test-sub.c

gcc -o test test.o test-add.o test-sub.o

从控制台的输出可以看出，通过make clean清除上一次的可执行文件和目标文件，然后依次编译各个C文件，最后把3个目标文件链接为最终可执行文件。

三、例说makefile 头文件查找路径

0.前言

例说makefile分为以下几个部分，更多内容请参考【例说makefile索引博文】

1.只有单个C文件

2.含有多个C文件

3.需要包括头文件路径

4.增加宏定义

5.增加系统共享库

6.增加自定义共享库

7.一个实际的例子

【代码仓库】—— makefile-example

代码仓库位于bitbucket，可借助TortoiseHg（GUI工具）克隆代码或者在网页中直接下载zip包。

1.三个C文件和三个头文件

此处的例子稍微复杂些但更接近实际情况。

文件结果如下：根目录中包含test.c makefileh和文件夹test-add和文件夹test-sub。

test.c makefile

【test-add】test-add.c test-add.h

【test-sub】test-sub.c test-sub.h

【test.c】

[cpp] view plain copy

#include <stdio.h>
#include <test-add.h>
#include <test-sub.h>
int main(void)
{
int a = 3;
int b = 2;
printf("a=%d\n", a);
printf("b=%d\n", b);
printf("a+b=%d\n", add(a,b));
printf("a-b=%d\n", sub(a,b));
return 0;
}

【test-add.c】

[cpp] view plain copy

#include <test-add.h>
int add(int a, int b)
{
return a+b;
}

【test-add.h】

[cpp] view plain copy

#ifndef __TEST_ADD
int add(int a, int b);
#endif

【test-sub.c】

[cpp] view plain copy

#include "test-sub.h"
int sub(int a, int b)
{
return a-b;
}

【test-sub.h】

[cpp] view plain copy

#ifndef __TEST_SUB
int sub(int a, int b);
#endif

2.复习gcc指令

gcc指令可通过-I前缀指定头文件路径，特别说明./代表当前路径，../代表上一级目录。

3.编写makefile

请替换其中的[tab]，并以代码仓库中的makefile文件为主。

[cpp] view plain copy

# 指令编译器和选项
CC=gcc
CFLAGS=-Wall -std=gnu99
# 目标文件
TARGET=test
SRCS = test.c \
./test-add/test-add.c \
./test-sub/test-sub.c
INC = -I./test-add -I./test-sub
OBJS = $(SRCS:.c=.o)
$(TARGET):$(OBJS)
# @echo TARGET:$@
# @echo OBJECTS:$^
[tab]$(CC) -o $@ $^
clean:
[tab]rm -rf $(TARGET) $(OBJS)
%.o:%.c
[tab]$(CC) $(CFLAGS) $(INC) -o $@ -c $<

【具体说明】

【1】相比于单个文件和多个文件的makefile，通过变量INC制定了头文件路径。头文件路径之间通过空格隔开。

【2】编译规则%.o:%.c中加入了头文件参数$(CC) $(CFLAGS) $(INC) -o $@ -c $<，那么在编译的过程中便会出现

gcc -Wall -std=gnu99 -I./test-add -I./test-sub -o test.o -c test.c。和单个文件和多个文件的makefile相比增加了头文件路径参数。

【3】SRCS变量中，文件较多时可通过“\”符号续行。

【编译】

make clean && make

【控制台输出】

rm -rf test test.o ./test-add/test-add.o ./test-sub/test-sub.o

gcc -Wall -std=gnu99 -I./test-add -I./test-sub -o test.o -c test.c

gcc -Wall -std=gnu99 -I./test-add -I./test-sub -o test-add/test-add.o -c test-add/test-add.c

gcc -Wall -std=gnu99 -I./test-add -I./test-sub -o test-sub/test-sub.o -c test-sub/test-sub.c

gcc -o test test.o test-add/test-add.o test-sub/test-sub.o

从控制台的输出可以看出，通过make clean清除上一次的可执行文件和目标文件，然后依次编译各个C文件，在编译的过程中制定了头文件路径，最后把3个目标文件链接为最终可执行文件。

四、例说makefile 增加宏定义

0.前言

例说makefile分为以下几个部分，更多内容请参考【例说makefile索引博文】

1.只有单个C文件

2.含有多个C文件

3.需要包括头文件路径

4.增加宏定义

5.增加系统共享库

6.增加自定义共享库

7.一个实际的例子

【代码仓库】—— makefile-example

代码仓库位于bitbucket，可借助TortoiseHg（GUI工具）克隆代码或者在网页中直接下载zip包。

【本例说明】

本例将说明makefile文件中如何加入宏定义。

1.gcc复习

宏定义使用前缀-D，在编译过程中可以把宏定义追加到CFLAG中。宏定义有两种相似的写法

【第一种】-D DEFINES

【第二种】-D DEFINES=CONDITION

2.源文件

使用两种不同的方式，通过宏定义包裹打印功能，分别使用#ifdef和#if

[cpp] view plain copy

#include <stdio.h>
#include <test-add.h>
#include <test-sub.h>
int main(void)
{
int a = 3;
int b = 2;
printf("a=%d\n", a);
printf("b=%d\n", b);
#ifdef TEST_ADD
printf("a+b=%d\n", add(a,b));
#endif
#if TEST_SUB
printf("a-b=%d\n", sub(a,b));
#endif
return 0;
}

3.makefile

请替换其中的[tab]，并以代码仓库中的makefile文件为主。

[cpp] view plain copy

# 指令编译器和选项
CC=gcc
CFLAGS=-Wall -std=gnu99
# 宏定义
DEFS = -DTEST_ADD -DTEST_SUB=1
CFLAGS += $(DEFS)
# 目标文件
TARGET=test
# 源文件
SRCS = test.c \
./test-add/test-add.c \
./test-sub/test-sub.c
# 头文件查找路径
INC = -I./test-add -I./test-sub
# 目标文件
OBJS = $(SRCS:.c=.o)
# 链接为可执行文件
$(TARGET):$(OBJS)
# @echo TARGET:$@
# @echo OBJECTS:$^
[tab]$(CC) -o $@ $^
clean:
[tab]rm -rf $(TARGET) $(OBJS)
# 连续动作，请清除再编译链接，最后执行
exec:clean $(TARGET)
[tab]@echo 开始执行
[tab]./$(TARGET)
[tab]@echo 执行结束
# 编译规则 $@代表目标文件 $< 代表第一个依赖文件
%.o:%.c
[tab]$(CC) $(CFLAGS) $(INC) -o $@ -c $<

4.具体说明

【1】 makefile定义头文件的方法有两种

【第一种】-D DEFINES

【第二种】-D DEFINES=CONDITION

【2】DEFS = -DTEST_ADD -DTEST_SUB=1

为了说明问题，此处使用了两种不同的写法。此时两处打印功能均被执行

【3】CFLAGS += $(DEFS)

追加到CFLAGS中，此处需要强调CFLAGS只是一个变量，可以命名为任何合法的名称，只要在编译过程中引用该参数即可。

$(CC) $(CFLAGS) $(INC) -o $@ -c $<

5.执行过程

【编译和链接】

make clean && make

【控制台输出】

rm -rf test test.o ./test-add/test-add.o ./test-sub/test-sub.o
gcc -Wall -std=gnu99 -DTEST_ADD -DTEST_SUB=1 -I./test-add -I./test-sub -o test.o -c test.c
gcc -Wall -std=gnu99 -DTEST_ADD -DTEST_SUB=1 -I./test-add -I./test-sub -o test-add/test-add.o -c test-add/test-add.c
gcc -Wall -std=gnu99 -DTEST_ADD -DTEST_SUB=1 -I./test-add -I./test-sub -o test-sub/test-sub.o -c test-sub/test-sub.c
gcc -o test test.o test-add/test-add.o test-sub/test-sub.o

从控制台的输出可以看出，在编译过程中加入了-D参数。

【执行】

a=3
b=2
a+b=5
a-b=1

最终效果和预期完全相同，makefile得到的验证。

6.总结

【1】增加宏定义的两个方法 -D DEFINES 和 -D DEFINES=CONDITION

【2】宏定义追加到CFLAG之后

五、例说makefile 增加系统共享库

0.前言

例说makefile分为以下几个部分，更多内容请参考【例说makefile索引博文】

1.只有单个C文件

2.含有多个C文件

3.需要包括头文件路径

4.增加宏定义

5.增加系统共享库

6.增加自定义共享库

7.一个实际的例子

【代码仓库】—— makefile-example

代码仓库位于bitbucket，可借助TortoiseHg（GUI工具）克隆代码或者在网页中直接下载zip包。

【本例说明】

本例将说明如何再makefile文件中增加共享库。

1.gcc复习

增加共享库使用-l前缀，请注意此处必须要小写。

【1】一定情况下，系统默认的搜索库目录位于 /usr/lib 和 lib

【2】若共享库不在系统默认库中，可通过-L参数指定目录。请注意该参数只有在链接过程有效。

2.源文件

源文件非常简单，打印sin(30)的结果。由于使用math库所以需要引入m.a共享库。

请注意，sin函数和cos函数使用弧度制；传入的参数为double类型，printf时需要使用lf前缀。

[cpp] view plain copy

#include <stdio.h>
#include <math.h>
#define PI 3.14159265
int main(void)
{
double angle = 30.00 ;
printf("sin(%.2lf)=%.2lf\n", angle, sin(angle * PI / 180));
return 0;
}

3.makefile

请替换其中的[tab]，并以代码仓库中的makefile文件为主

[cpp] view plain copy

# 指令编译器和选项
CC = gcc
CFLAGS = -Wall -std=gnu99
# 可执行文件
TARGET=test
# C文件
SRCS = test.c
# 目标文件
OBJS = $(SRCS:.c=.o)
# 库文件
DLIBS = -lm
# 链接为可执行文件
$(TARGET):$(OBJS)
# @echo TARGET:$@
# @echo OBJECTS:$^
[tab]$(CC) -o $@ $^ $(DLIBS)
clean:
[tab]rm -rf $(TARGET) $(OBJS)
# 连续动作，请清除再编译链接，最后执行
exec:clean $(TARGET)
[tab]@echo 开始执行
[tab]./$(TARGET)
[tab]@echo 执行结束
# 编译规则 $@代表目标文件 $< 代表第一个依赖文件
%.o:%.c
[tab]$(CC) $(CFLAGS) -o $@ -c $<

4.具体说明

【1】DLIBS = -lm 增加共享库。请注意实际的库全名为 libm.so。

【2】$(CC) -o $@ $^ $(DLIBS) 编译时增加共享库。请注意，共享库增加在链接过程即可，不需要在编译过程中增加。

【3】由于libm.so为系统库，所以并不需要指定路径。linux系统中共享库的默认查找路径为/lib和/usr/lib

5.执行过程

【验证】

ldd test

linux-vdso.so.1 => (0x00007fffde960000)
libm.so.6 => /lib/x86_64-linux-gnu/libm.so.6 (0x00007ffe55b18000)
libc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x00007ffe55750000)
/lib64/ld-linux-x86-64.so.2 (0x00007ffe55e38000)

从控制台的输出可以看出，成功链接了系统共享库 libm.so

【编译和链接】

make clean && make

【控制台输出】

rm -rf test test.o
gcc -Wall -std=gnu99 -o test.o -c test.c
gcc -o test test.o -lm

从控制台输出可以看出，在链接过程中加入了库文件。

【执行】

./test
sin(30.00)=0.50

执行结果正常，符合预期效果。

6.总结

【1】增加系统共享库时使用前缀-l。

【2】系统共享库不需要指定路径。

六、例说makefile 增加自定义共享库

0.前言

例说makefile分为以下几个部分，更多内容请参考【例说makefile索引博文】

1.只有单个C文件

2.含有多个C文件

3.需要包括头文件路径

4.增加宏定义

5.增加系统共享库

6.增加自定义共享库

7.一个实际的例子

【代码仓库】—— makefile-example

代码仓库位于bitbucket，可借助TortoiseHg（GUI工具）克隆代码或者在网页中直接下载zip包。

【本例说明】

本例分为两个过程，先制作一个共享库，然后在使用这个共享库。共享库采用动态链接方式，后缀为.so。

1.gcc复习

【1】gcc指令中使用共享库使用前缀-l，共享库查找目录使用-L。

【2】一般情况下DLIBS中加入共享库，而LDFLAGS中加入共享库查找目录。

2.共享库源文件

和生成共享库有关的文件位于libtest目录中，在makefile最后把共享库复制到同级的lib目录中。具体内容请参考代码仓库并复制zip包。

【libtest.h】

指定接口，给出相应声明

[cpp] view plain copy

#ifndef __LIBTEST_H
#define __LIBTEST_H
int sub(int a, int b);
int add(int a, int b);
#endif

【test-add.c】

[cpp] view plain copy

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

【test-sub.c】

[cpp] view plain copy

int sub(int a, int b)
{
return a-b;
}

3.共享库的makefile

请替换其中的[tab]，并以代码仓库中的makefile文件为主。

[cpp] view plain copy

# 指令编译器和选项
CC = gcc
CFLAGS = -Wall -std=gnu99
# 目标文件
TARGET = libtest.so
# C文件
SRCS = test-add.c test-sub.c
# 目标文件
OBJS = $(SRCS:.c=.o)
# 链接为可执行文件
$(TARGET):$(OBJS)
[tab]$(CC) -shared -o $@ $^
[tab]mv $(TARGET) ../lib
clean:
[tab]rm -rf $(TARGET) $(OBJS)
# 编译规则 $@代表目标文件 $< 代表第一个依赖文件
%.o:%.c
[tab]$(CC) $(CFLAGS) -o $@ -fPIC -c $<

【说明】

【1】目标为libtest.so，请务必以lib开头 .so结尾，在使用该共享库时系统会自动的去除lib和.so，使用时写成 -ltest。

【2】多数内容和学习笔记中的多个文件相同。

【3】在链接过程中加入 -shared参数，意为共享形式的目标文件。

【4】在编译过程中加入 -fPIC参数，意为生成和地址无关的目标文件。

【5】在链接完成之后，通过mv指令把libtest.so移动到同级的lib目录中。

【6】如果有必要，可以把libtest.so复制到/usr/lib目录中，这样使用起来会更加方便。

【验证】

ldd test

    linux-vdso.so.1 => (0x00007fffde960000)
   libm.so.6 => /lib/x86_64-linux-gnu/libm.so.6 (0x00007ffe55b18000)
   libc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x00007ffe55750000)

/lib64/ld-linux-x86-64.so.2 (0x00007ffe55e38000)

【编译和执行】

make clean && make

【控制台输出】

rm -rf libtest.so test-add.o test-sub.o
gcc -Wall -std=gnu99 -o test-add.o -fPIC -c test-add.c
gcc -Wall -std=gnu99 -o test-sub.o -fPIC -c test-sub.c
gcc -shared -o libtest.so test-add.o test-sub.o
mv libtest.so ../lib

【1】编译过程中加入了-fPIC选项。

【2】链接过程中加入-shared选项。

【3】共享库为libtest.so。

【4】最后，共享库被移动到上一级的lib目录中。

4.源文件

调用共享库指定的接口，add和sub函数。

[cpp] view plain copy