使用Automake

一.安装软件:

GUN automake:

Sudo apt-get install automake

2. GNU Autoconf

3. GNU m4

4. perl

5. GNU Libtool (如果你需要产生 shared library)

 

二. mkdir hello;cd hello

用编辑器写一个hello.c文件，

#include

int main(int argc, char** argv)

{   

     printf(“Hello, GNU!\n”);  

     return 0;

}

 

三. 用 autoscan 产生一个 configure.in 的原型，执行autoscan 后会产生一个configure.scan 的文件，可以用它作为 configure.in文件的蓝本。

 

四. 编辑 configure.scan文件，如下所示，並且改名为configure.in

#                                               -*- Autoconf -*-

# Process this file with autoconf to produce a configure script.

 

AC_INIT(hello.c)

AM_INIT_AUTOMAKE(hello,1.0)

 

# Checks for programs.

AC_PROG_CC

 

# Checks for libraries.

 

# Checks for header files.

 

# Checks for typedefs, structures, and compiler characteristics.

 

# Checks for library functions.

 

AC_OUTPUT(Makefile)

 

五. 执行 aclocal 和 Autoconf ，分別会产生 aclocal.m4 及 configure 两个文件

六.编辑 Makefile.am 文件，內容如下

AUTOMAKE_OPTIONS= foreign

bin_PROGRAMS= hello

hello_SOURCES= hello.c

七.    执行 Automake --add-missing ，Automake 会根据Makefile.am 文件产生一些文件，包含最重要的Makefile.in

% Automake --add-missing

Automake: configure.in: installing `./install-sh'

Automake: configure.in: installing `./mkinstalldirs'

Automake: configure.in: installing `./missing'

 

八.最后执行 ./configure:

九. 输入make指令就可以编译 hello.c 了

也可以使用“make clean“，”make install“，”make dist“：

 

十.相关知识:

编辑 configure.in 文件

      Autoconf 是用来产生 'configure'文件的工具。'configure' 是一个 shell script，它可以自动设定一些编译参数使程序能够条件编译以符合各种不同平台的Unix 系统。Autoconf会读取configure.in 文件然后产生'configure' 这个 shell script。

configure.in 文件内容是一系列GNU m4 的宏，这些宏经Autoconf处理后会变成检查系统特性的shell scripts。 configure.in文件中宏的顺序并没有特别的规定，但是每一个configure.in 文件必须在所有其它宏前加入 AC_INIT 宏，然后在所有其它宏的最后加上 AC_OUTPUT宏。一般可先用 autoscan 扫描原始文件以产生一个 configure.scan 文件，再对 configure.scan 做些修改成 configure.in 文件。在例子中所用到的宏如下：

dnl

      这个宏后面的内容不会被处理，可以视为注释

AC_INIT(FILE)

      该宏用来检查源代码所在路径，autoscan 会自动产生，一般无须修改它。

AM_INIT_AUTOMAKE(PACKAGE,VERSION)

      这个是使用 Automake 所必备的宏，PACKAGE 是所要产生软件的名称，VERSION 是版本编号。

AC_PROG_CC

      检查系统可用的C编译器，若源代码是用C写的就需要这个宏。

AC_OUTPUT(FILE)

      设置 configure 所要产生的文件，若是Makefile ，configure 便会把它检查出来的结果填充到Makefile.in 文件后产生合适的 Makefile。

     

      实际上，在使用 Automake 时，还需要一些其他的宏，这些额外的宏我们用 aclocal来帮助产生。执行 aclocal会产生aclocal.m4 文件，如果没有特别的用途，不需要修改它，用 aclocal 所产生的宏会告诉 Automake如何动作。

      有了 configure.in 及 aclocal.m4两个文件以后，便可以执行 Autoconf来产生 configure 文件了。

编辑Makefile.am 文件

      接下来要编辑Makefile.am 文件，Automake 会根据 configure.in 中的宏并在perl的帮助下把Makefile.am 转成 Makefile.in 文件。 Makefile.am 文件定义所要产生的目标：

AUTOMAKE_OPTIONS

      设置 Automake 的选项。Automake 主要是帮助开发 GNU 软件的人员来维护软件，所以在执行Automake 时，会检查目录下是否存在标准 GNU 软件中应具备的文件，例如 'NEWS'、'AUTHOR'、

'ChangeLog' 等文件。设置为foreign 时，Automake 会改用一般软件的标准来检查。

bin_PROGRAMS

      定义要产生的执行文件名。如果要产生多个执行文件，每个文件名用空白符隔开。

hello_SOURCES

      定义 'hello' 这个执行程序所需要的原始文件。如果 'hello'这个程序是由多个原始文件所产生，

必須把它所用到的所有原始文件都列出来，以空白符隔开。假设 'hello' 还需要 'hello.c'、'main.c'、'hello.h' 三个文件的话，则定义

       hello_SOURCES= hello.c main.c hello.h

如果定义多个执行文件，则对每个执行程序都要定义相对的filename_SOURCES。

      编辑好 Makefile.am 文件，就可以用 Automake --add-missing来产生 Makefile.in。加上 --add-missing 选项来告诉 Automake顺便加入包装一个软件所必须的文件，如果你不使用该选项，Automake可能会抱怨缺少了什么文件。Automake产生出來的 Makefile.in 文件是完全符合 GNU Makefile 惯例的，只要执行 configure这个shell

script 便可以产生合适的 Makefile 文件了。

使用 Makefile

利用 configure 所产生的 Makefile文件有几个预先设定的目标可供使用，这里只用几个简述如下：

make all

      产生设定的目标，既范例中的可执行文件。只敲入make 也可以，此时会开始编译源代码，然后连接并产生执行文件。

make clean

      清除之前所编译的可执行文件及目标文件(object file, *.o)。

make distclean

      除了清除可执行文件和目标文件以外，也把 configure 所产生的 Makefile 清除掉。 通常在发布软件前执行该命令。

make install

      将程序安装到系统中，若源码编译成功，且执行结果正确，便可以把程序安装到系统预先设定的执行文件存放路径中，若用 bin_PROGRAMS 宏的话，程序会被安装到 /usr/local/bin下。

make dist

      将程序和相关的文档包装为一个压缩文档以供发布 (distribution) 。执行完在目录下会产生一个以

PACKAGE-VERSION.tar.gz 为名称的文件。PACKAGE 和 VERSION 这两个参数是根据 configure.in 文中

AM_INIT_AUTOMAKE(PACKAGE, VERSION) 的定义。在我们的例子中会产生 'hello-1.0.tar.gz' 的文件。

make distcheck

      和 make dist 类似，但是加入检查包装以后的压缩文件是否正常，这个目标除了把程序和相关文档包装成 tar.gz 文件外，还会自动把这个压缩文件解开，执行 configure，并执行 make all ，确认编译无错误以后，方显示这个 tar.gz 文件已经准备好并可以发布了。当你看到：

==========================================

hello-1.0.tar.gz is ready for distribution

==========================================

就可以放心地发布您的软件了，检查过关的套件，基本上可以给任何具备 GNU 开发环境的人去重新编译成功。

      要注意的是，利用 Autoconf 及 Automake 所产生出來的软件套件是可以在没有安装 Autoconf 及 Automake 的环境使用的，因为 configure 是一个 shell script，它己被设计为可以在一般 Unix 的 sh 这个 shell 下执行。但是如果要修改 configure.in 及 Makefile.am 文件再产生新的 configure 及 Makefile.in 文件时就一定要有 Autoconf 及 Automake 了。

相关资料

      通常我们掌握了一些入门知识就可以开始实践了，在有新的需求时，参照相关的文档和别人的例子解决问题，在实践中不断提高。

      Autoconf 和 Automake 功能十分强大，可以从它们附带的 info 文档中找到详细的使用说明。或者您喜欢html,可以从gun站点上下载hmtl版本。你也可以从许多现有的GNU 软件或 Open Source 软件如Minigui中找到相关的 configure.in 或 Makefile.am 文件，他们是学习 Autoconf 及 Automake 更多技巧的最佳范例。