automake连载---关于两个文件configure.in和Makefile.am的编写

不念不忘少年蓝@ 2022-08-23 13:47 178阅读 0赞

automake主要通过编辑Makefile.am来控制它的行为，下面就常用的三个Makefile.am配置做出说明。

## 1.1. autotools的工作原理 ##

autotools最终是为了生成**Makefile**，为此，需要使用到autotools系列工具的如下几个命令：

l autoscan

l aclocal

l autoheader

l autoconf

l automake

另外，还需要有两类输入文件：configure.in和Makefile.am。其中，configure.in是用来生成configure脚本的，configure脚本的作用主要有两个：检测系统的环境，生成Makefile。而Makefile.am则是生成Makefile的参数，它们之间是一一对应的。一般来说，在一个工程中每个目录下都会有一个Makefile来管理当前目录下的文件。所以，基本上每个目录中都需要编写一个Makefile.am，来描述当前目录下生成的Makefile的行为。

有了生成工具和输入文件，下面来看一下生成Makefile的流程，如下图所示：

需要说明的是autoscan工具的使用，autoscan检测当前目录下的所有文件，生成一个configure.scan，这个文件可以作为configure.in文件的雏形，在它的基础上稍做修改就可以作为configure.in文件来使用。所以，autoscan工具只需要在工程创建时运行一次即可。

下面就来具体介绍两个输入文件的编写规则：

## 1.2. 编写Makefile.am ##

### 1.2.1. Makefile.am规则 ###

Makefile.am写起来相对简单，有共有5类规则，如下表

表1.2.1 Makefile.am中的规则

<table> 
 <tbody> 
 <tr> 
 <td style="background:rgb(217,217,217)"> 文件类型 </td> 
 <td style="background:rgb(217,217,217)"> 书写格式 </td> 
 </tr> 
 <tr> 
 <td> 可执行文件 </td> 
 <td> bin_PROGRAMS&nbsp;=&nbsp;foo foo_SOURCES&nbsp;=&nbsp;xxx.c&nbsp;xxxx.c foo_LDADD&nbsp;=&nbsp; foo_LDFLAGS&nbsp;=&nbsp; foo_DEPENDENCIES&nbsp;=&nbsp; </td> 
 </tr> 
 <tr> 
 <td> 静态库 </td> 
 <td> lib_LIBRARIES&nbsp;=&nbsp;foo.a foo_a_SOURCES&nbsp;=&nbsp;xxx.c&nbsp;xxxx.c foo_a_LDADD&nbsp;=&nbsp; foo_a_LIBADD&nbsp;=&nbsp; foo_a_LDFLAGS&nbsp;=&nbsp; </td> 
 </tr> 
 <tr> 
 <td> 动态库 </td> 
 <td> lib_LTLIBRARIES&nbsp;=&nbsp;foo.la foo_la_SOURCES&nbsp;=&nbsp;xxx.c&nbsp;xxxx.c foo_la_LDADD&nbsp;=&nbsp; foo_la_LIBADD&nbsp;=&nbsp; foo_la_LDFLAGS&nbsp;= </td> 
 </tr> 
 <tr> 
 <td> 头文件 </td> 
 <td> include_HEADERS&nbsp;=&nbsp;foo.h noinst_HEADERS&nbsp;=&nbsp;foo2.h </td> 
 </tr> 
 <tr> 
 <td> 数据文件 </td> 
 <td> data_DATA&nbsp;=&nbsp;data1&nbsp;data2 </td> 
 </tr> 
 </tbody> 
</table>

其中，生成动态库的同时还会自动生成一个静态库，所以在一般情况下都不直接使用静态库规则。

Makefile.am中还有一些可以直接使用的全局变量，表示所有目标所共享的一些属性，见下表：

表1.2.2 Makefile.am中的变量

<table> 
 <tbody> 
 <tr> 
 <td style="background:rgb(217,217,217)"> 变量 </td> 
 <td style="background:rgb(217,217,217)"> 含义 </td> 
 </tr> 
 <tr> 
 <td> INCLUDES </td> 
 <td> 编译时所需头文件 </td> 
 </tr> 
 <tr> 
 <td> LDADD </td> 
 <td> 链接时所需链接的库文件 </td> 
 </tr> 
 <tr> 
 <td> LDFLAGS </td> 
 <td> 链接时的选项 </td> 
 </tr> 
 <tr> 
 <td> AM_CXXFLAGS </td> 
 <td> 编译.cpp文件时的选项 </td> 
 </tr> 
 <tr> 
 <td> AM_CFLAGS </td> 
 <td> 编译.c文件时的选项 </td> 
 </tr> 
 <tr> 
 <td> EXTRA_DIST </td> 
 <td> 除源代码和一些默认的文件以外，其它需要打如发布包.tar.gz中的文件 </td> 
 </tr> 
 <tr> 
 <td> SUBDIRS </td> 
 <td> 在处理本目录之前要递归处理的子目录 </td> 
 </tr> 
 <tr> 
 <td> top_srcdir </td> 
 <td> 工程源码的最顶层目录 </td> 
 </tr> 
 <tr> 
 <td> top_builddir </td> 
 <td> 工程目标文件的最顶层目录 </td> 
 </tr> 
 </tbody> 
</table>

有了以上的规则和变量，我们可以完成最基本的Makefile.am编写，但在某些情况下，我们需要定义一些变量来控制工程中某些目标的生成：比如库的版本号是不断变化的，需要定义一个变量来指代。Makefile.am可以使用宏替换来实现这种功能，可以通过以下方式来引用一个宏：

@宏名@

这个宏的的定义是在configure.in中的，在1.3.节中会介绍它的定义方法。

现在Makefile.am中所需要了解的规则和语法已经介绍完了，下面介绍一下如何使用这些规则来具体生成一个库和可执行程序。

### 1.2.2. 库的生成 ###

要生成一个库，需要在Makefile.am中加入一套动态库规则(见表1.2.1)，如现在要用hello1.cpp和hello2.cpp两个源文件生成动态库libhello.so，库的版本为1.0.10，库需要额外连接一个叫做libworld.so的库，我们可以这样写：

lib\_LTLIBRARIES = hello.la

hello\_la\_SOURCES = hello1.cpp hello2.cpp

hello\_la\_LIBADD = -lworld

hello\_la\_LDFLAGS = -version-info 1.0.10

可以看到，在LIBADD规则中链接库文件的方法与使用g++编译时的相同。但LDFLAGS规则中的属性就没有见过了。实际上，这个参数是传给libtool生成库时使用的，除了\-version-info这个参数之外，LDFLAGS编译库时还会经常使用下面两个参数：

l -avoid-version 生成不带版本号的库

l -all-static 生成为静态库

### 1.2.3. 可执行文件的生成 ###

要生成一个可执行文件，需要加入一套可执行文件的规则(见表1.2.1)，与生成动态库的规则很类似。下面我们要使用源文件main.cpp生成可执行文件main，该可执行文件需要链接上面生成的库libhello.so，我们可以这样写：

bin\_PROGRAMS = main

main\_ SOURCES = main.cpp

main\_ LDADD = -lhello

main\_LDFLAGS = -I./include

## 1.3. 编写configure.in文件 ##

与*[Makefile][]*.am相比，configure.in文件写起来更复杂，因为configure.in文件中可以使用的资源要远多与Makefile.am。但通常情况下，我们都可以借助autoscan工具帮助我们生成一个configure.in的模版，在此基础上再完善就可以了。所以，实际上我们只需要在configure.in中修改以下两个参数就可以了：

AC\_INIT(package\_name, package\_version, owner\_email)

AC\_CONFIG\_FILES(\[makefile1\_path

makefile2\_path\])

AC\_INIT()选项中指明了工程的名字，当前工程的版本号，工程所有者的邮箱。

AC\_CONFIG\_FILES()中指明了所有要生成的Makefile的相对路径，由于每个Makefile都需要一个Makefile.am作参数，所以该选项中Makefile的数量和路径应与当前工程中Makefile.am的状态一致。

在经过上面的修改之后，一个configure.in文件就基本可以使用了，但通常情况下，我们需要对它进行更多的配置。

### 1.3.1. 在configure.in中定义外部变量 ###

在configure.in中定义变量与写shell脚本时定义变量的语法相同，如我们要定义一个值为nihao的变量hello，我们可以这样写：

hello=nihao

但使用这个变量的方法就有些不同了，比如我们要将hello这个变量赋给hi这个变量，我们可以这样写：

hi=”$hello”

如果这个变量需要被外部引用的话(如在1.2.1节中提到的Makefile.am引用configure.in中定义的变量)，需要一个额外的选项来完成，如我们要将hello定义为外部变量，可以写成：