Makefile 实际用例分析（三） ------- 是用GUN automake 处理自己的工程

梦里梦外; 2022-09-19 00:21 102阅读 0赞

前面两篇已经说过了自己怎么去为一个工程写makefile：

[第一篇][Link 1]

[第二篇][Link 2]

现在这一篇说的是怎么使用GNU的工具去写一个符合开源标准的Makefile呢！

首先我觉你应该参考：

[Automake][]

[Autoconf][]

这里就一步一步来解释：依然使用之前两篇中的例子ir\_tree！

还是先看看我的文件布局是怎么样的！

顶层文件夹：相比之前多了Makefile.am和configure.ac文件，还有四个辅助文件( 顾名思义，我就不多说了 )：

AUTHORS、

ChangeLog、

NEWS、

README

![Center][]

然后src文件夹中：相比之前多了一个Makefile.am文件

![Center 1][]

lib里面：注意，这一次，我是将静态库放在这里一起make出来，而不是之前make好，然后在调用！

所有看lib中内容：

![Center 2][]

也有一个Makefile.am,是为了生成libnew.a而需要的！

include文件夹中：还是和以前一样

![Center 3][]

OK，基本结构说完了，然后需要说的是这些新增加的文件的意义！！！

configure.ac文件是为了生成configure文件需要的！

Makefile.am是为了生成makefile.in文件需要的

最后又configure和Makefile.in一起生成Makefile文件！！！！

关于这个自动生成的流程，看下面这个图：**来自维基百科**

![Center 4][]

前提，你安装了automake和autoconf

好，我解释一下：

1：

autoscan这是一个命令，需在你的源文件的文件夹下执行，然后会生成一个configure.scan的模板文件，这个模板是configure.ac模板，所以，将configure.scan改名为configure.ac，然后开始修改！注意configure.ac其实就是一些M4 宏，AC开头代表Autoconf使用，AM开头代表Automake使用。

注意：我们不要去畏惧这个文件，虽然很多开源软件中的configure.ac写的比较复杂，但是我们需要时刻认识到一点是：这只不过是一个环境检测文件，检测你的代码版本，检测代码文件是否存在，检测哪些头文件是否存在，检测你需要的库是否存在，检验是否支持这样的类型数据，检测...

所以随便由你写！对于具体的你的需求，然后需要使用什么M4宏来处理！具体的这些宏，你可以去官方网站查看手册！

2：

好了，假如我们已经写好了configure.ac( 后面具体会说！ )，那么下一步干嘛呢，我们需要aclocal命令执行以下，看看是否需要M4的支持！如果需要会生成：

![Center 5][]

如果没有生成aclocal.m4，那么也没什么，说明不需要这个而已。

3：

关于autoheader命令，为了一个配置头文件通常是config.h而需要的，如果你不需要，直接省略！不要执行这个命令，但是注意在configure.ac中就不要去检测这个config.h的头文件了！否则报错哦！

4：

好了，下面就是需要自己写非常中的Makefile.am文件了！

Makefile.am到底是什么呢？也不要畏惧，只不过是指示生成什么样的东西，生成.o还是.a，还是一个binary？

然后是怎么生成，其实不需要说怎么生成，只需要将这个文件的依赖文件写出来就OK了！！！其实很easy！

对于Makefile.am文件，一般顶层文件肯定有一个，然后在你的源文件中肯定有一个，用于指示怎么生成最终的binary，然后就是你的库生成文件夹中肯定有一个，为了指示怎么生成.a或者.so的库！

所以Makefile.am文件真的很简单，就是这样指示生成文件而已。。。对于复杂的Makefile.am，是因为考虑了很多条件，但是根本的本质还是一样的！

5：

OK，假如我们已经将所有.am文件生成好了，下面干嘛呢！

下面执行autoconf生成configre文件

6：

然后再使用automake -a生成Makefile.in文件，GOOG！好了！我们基本快要大功告成了！

7：

下面是我们最熟悉最熟悉的：

./configure

make

make install

都是可以执行了~~~~~

上面说的就是总体的一个流程！

\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#

下面，我们就结合ir\_tree的实例一起来简单的写一个！

\*\*\*\*\*\*\* 温馨提示：我下面直接在后面注释习惯不好，可能会编译出错，所有如果你使用了，那么轻删除或者将这些注释换行

>>> configure.ac

\#                                               -\*- Autoconf -\*-  
\# Process this file with autoconf to produce a configure script.  
  
AC\_PREREQ(2.59)                                       \# 这里是工具版本号，不关心  
AC\_INIT(ir\_tree, 1.0, \*\*\*\*\*\*\*\*@gmail.com)     \# AC\_INIT：指示可执行名称 + 版本号 + BUG-report              
AC\_CONFIG\_SRCDIR(\[src/test.c\])               \# AC\_CONFIG\_SRCDIR：为了检验源文件是否缺失，你可以检测所有的                                                                       \# 文件，这里为了示意，检查一个

AM\_CONFIG\_HEADER(config.h)                 \# 这里为了检查头文件config.h，如果你不需要，就不需要检查  
AM\_INIT\_AUTOMAKE(ir\_tree,1.0)                \# 这一句可以不需要，也是指示可执行名称 + 版本号   
  
  
\# Checks for programs.                                \# 下面检验一些系统程序是否存在  
AC\_PROG\_CC                                             \# 检验CC(就是c语言编译程序)是否存在  
\# 如果你是要的C++，那么AC\_PROG\_CXX，所有你需要什么，到uanfang手册去查找就OK了！  
  
\# Checks for libraries.                                  \# 检查一些库（包括系统库和你引入的库）  
AC\_CHECK\_LIB(\[m\], \[sqrt\])                         \# 这里检查数学库-lm

\# 其实AC\_CHECK\_LIB的完整格式是：AC\_CHECK\_LIB(\[lib\], \[func\],\[if\_exist\_action\], \[not\_exist\_action\])

\# 后面的func是你使用到的函数名

AC\_PROG\_RANLIB                                    \# 这里的意义是：当你使用了静态库的时候，需要这一句

\# 如果你使用了共享库，那么使用AC\_PROG\_LIBTOOL  
  
\# Checks for header files.                           \# 下面检查一些头文件，只检查你认为需要检查的即可！然后查手册！  
\#AC\_HEADER\_STDC                                  
\#AC\_CHECK\_HEADERS(\[float.h malloc.h stdlib.h\])  
  
\# Checks for typedefs, structures, and compiler characteristics.    \# 下面检查一些类型定义是否允许  
\#AC\_C\_CONST  
  
\# Checks for library functions.                  \# 下面检查一些库函数是否合理  
\#AC\_FUNC\_MALLOC                              \# 检查malloc函数  
AC\_CHECK\_FUNCS(\[pow sqrt\])             \# 检查pow和sqrt函数  
                                                                 \# 哪些你需要的你自己肯定知道，然后查手册，放进了检查就OK了~  
  
\# 下面是很重要的！

\# 就是最终输出哪些文件，由上面的结构知道，有几个Makefile.am就几个Makefile，那么输出文件自然如下！

\#  
AC\_OUTPUT(\[  
  Makefile   
  src/Makefile   
  lib/Makefile  
\])

好了configure.ac，即环境检测文件写好了，那么下面就是一层一层的Makefile.am文件了

>>> 先看顶层的 Makefile.am

特别的简单：

AUTOMAKE\_OPTIONS=foreign       \# 这里是一个automake的选项，foreign  ，具体的可以查一下，不是很重要  
SUBDIRS=lib src                               \# 注意这个SUBDIRS就很重要的，这里指示所有的子Makefile.am所在的目录，

\#  然后执行的时候会一次去执行！注意是：SUBDIRS不是SUBDIR！！！

\# 由上面的文件分布可以看到，lib中是生成libnew.a库的Makefile.am，src中是

\# 生成最终的可执行需要的Makefile.am。所以有两个子文件!!!   
CURRENTPATH=$(shell /bin/pwd)   \# 指示当前路径   
INCLUDES=-I$(CURRENTPATH)/include

\# 注意：这个include是为了指示src中头文件之外的其他头文件所在地目录！需要export到后面的子Makefile.am中去！  
export INCLUDES                             \# 导出！！

>>> 现在进入lib中看Makefile.am:

AUTOMAKE\_OPTIONS=foreign     \# 不多说  
  
noinst\_LIBRARIES=libnew.a           \# 注意这里是生成库文件，那么就是XXXX\_LIBRARIES  
                                                        \# noinst即not install的缩写，所以无需安装这个库，当然你可以指示安装  
libnew\_a\_SOURCES=new.c           \# 注意前面的命名：‘.’要换成'\_'，指示源文件！

\# 注意这里有一个隐藏条件：就是上层Makefile.am传递下来的INCLUDES，在这里面也是有使用的，不然无法找到所需头文件的！

所以这个Makefile.am基本就是指示需要生成什么，然后这个生成文件的依赖文件是什么，如此而已！！！

>>> 然后在进入src中看看Makefile.am：

bin\_PROGRAMS=ir\_tree     \# 这个是最终生成的binary名称：使用bin\_PROGRAMS  
  
ir\_tree\_SOURCES=card.c card.h index.c index.h node.c rect.c split\_l.c split\_l.h test.c  \# 指示依赖的源文件

ir\_tree\_LDADD=$(top\_srcdir)/lib/libnew.a    \# 指示依赖的库文件( 其实是链接的时候需要增加的信息 )

\# 注意这里不需要指示-lm，因为我们在configure.ac中已经检查，

\# 那么需要的时候，自动添加（其实系统库都会自己添加）

\# 解释top\_srcdir：就是顶层文件夹目录

ir\_tree\_LDFLAGS=-D\_GNU\_SOURCE       \#这是一个链接FLAG，表示需要用生成.deps依赖文件  
  
DEFS+=-D\_GNU\_SOURCE

OK，所有的多讲完了，那么最重要的还是需要理解Makefile.am和configure.ac的作用！

不要畏惧，自己想添加什么就添加什么！

OK，

下面你就可以:

执行之前说的那些命令：

aclocal

acheader

autoconf

automake -a

./configure

make

OK... 看看运行结果对不对吧。。。

如果你需要这个工程，同样免费下载：[ir-tree][]

[Link 1]: http://blog.csdn.net/shanshanpt/article/details/17198413
[Link 2]: http://blog.csdn.net/shanshanpt/article/details/17199695
[Automake]: http://www.gnu.org/software/automake/
[Autoconf]: http://www.gnu.org/software/autoconf/
[Center]: /images/20220828/e8aa2e7ff3cd43e8888942226423d4df.png
[Center 1]: /images/20220828/bc6a180227c4416c80e4957c4d257a9c.png
[Center 2]: /images/20220828/fbbd0a0d7b994467abedb984878119d5.png
[Center 3]: /images/20220828/e98190a214e54d6bbe6c803ae823c64c.png
[Center 4]: /images/20220828/d38251fa86704c98aba9e000db17a58d.png
[Center 5]: /images/20220828/d7cd541d134545189922c14a1d727cce.png
[ir-tree]: http://download.csdn.net/detail/shanshanpt/6678621