Autoconf/automake step by step

Autoconf/automake 在开源社区里，它的重要性可以说不下于gcc，目前除了Xfree86外，几乎所有的开源项目都使用Autoconf/automake，甚至Xfree86的开发人员已经计划抛弃imake，而采用Autoconf/automake作为工程管理工具了。

Autoconf/automake冗长的手册让我犯晕。虽然我曾耐着性子浏览过一遍，但是决大部分内容，在日常工作根本用不上。加上建立工程的机会并不多，等到下一次要建立时，上次学到的知识早忘光了，还得去看手册，真是麻烦。

大多数时候，我更需要的是step by step的指南，只有在特殊情况下，要使用Autoconf/automake的高级功能时候，我才愿意去查手册。最近刚好建过几个工程，记个笔记吧，以便下次查阅。

一、建立可执行文件工程。

l 前提：

项目目录：helloworld

源文 件：helloworld/src/helloworld.c

l 用autoscan产生configure.in的框架：

[root@linux helloworld]# autoscan

[root@linux helloworld]# mv configure.scan configure.in

打开configure.in，我们可以看到：

# -*- Autoconf -*- # Process this file with autoconf to produce a configure script. AC_PREREQ(2.59) AC_INIT(FULL-PACKAGE-NAME, VERSION, BUG-REPORT-ADDRESS) AC_CONFIG_SRCDIR([src/helloworld.c]) AC_CONFIG_HEADER([config.h]) # 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

这个文件并不能直接使用，要做几处修改才行。

AC_INIT的参数要换成实际的参数。

AC_OUTPUT中要指明实际要生成的文件。

增加automake的初始化宏。

我们把它修改为：

# Process this file with autoconf to produce a configure script. AC_PREREQ(2.59) AC_INIT(helloworld, 0.1, jim@jim.com) AC_CONFIG_SRCDIR([src/helloworld.c]) AC_CONFIG_HEADER([config.h]) AM_INIT_AUTOMAKE(helloworld, 0.1) # 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 src/Makefile ])

l 建立根顶层目录中的Makefile.am，用SUBDIRS指明子目录。

SUBDIRS=src

l 建立src目录中的Makefile.am，这里我们生成的可执行文件名为helloworld，安装目录为${prefix}/bin。如果只想编译，不想安装到系统中，可以用noinst_PROGRAMS代替bin_PROGRAMS。

bin_PROGRAMS=helloworld helloworld_SOURCES=helloworld.c

l 在顶层目录中建立几个空文件。

[root@linux helloworld]# touch NEWS README ChangeLog AUTHORS

l 拷贝automake必要的文件。

[root@linux helloworld]# cp -f /usr/share/automake-1.9/depcomp .

[root@linux helloworld]# cp -f /usr/share/automake-1.9/compile .

l 建立autogen.sh

#!/bin/bash aclocal autoheader autoconf automake -a ./configure

[root@linux helloworld]# chmod 755 autogen.sh

l 测试一下

[root@linux helloworld]# ./autogen.sh ;make;make install

OK了

二、建立共享库工程。

l 前提：

项目目录：helloworld

源文 件：helloworld/src/helloworld.c

头文 件：helloworld/src/helloworld.h

l 用autoscan产生configure.in的框架：

[root@linux helloworld]# autoscan

[root@linux helloworld]# mv configure.scan configure.in

打开configure.in，我们可以看到：

# -*- Autoconf -*- # Process this file with autoconf to produce a configure script. AC_PREREQ(2.59) AC_INIT(FULL-PACKAGE-NAME, VERSION, BUG-REPORT-ADDRESS) AC_CONFIG_SRCDIR([src/helloworld.c]) AC_CONFIG_HEADER([config.h]) # 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

这个文件并不能直接使用，要做几处修改才行。

AC_INIT的参数要换成实际的参数。

AC_OUTPUT中要指明实际要生成的文件。

增加automake的初始化宏。

增加libtool检查。

我们把它修改为：

# -*- Autoconf -*- # Process this file with autoconf to produce a configure script. AC_PREREQ(2.59) AC_INIT(helloworld, 0.1, jim@jim.com) AC_CONFIG_SRCDIR([src/helloworld.c]) AC_CONFIG_HEADER([config.h]) AM_INIT_AUTOMAKE(helloworld, 0.1) # Checks for programs. AC_PROG_CC AC_LIBTOOL_DLOPEN AC_PROG_LIBTOOL # Checks for libraries. # Checks for header files. # Checks for typedefs, structures, and compiler characteristics. # Checks for library functions. AC_OUTPUT([ Makefile src/Makefile ])

l 建立根顶层目录中的Makefile.am，用SUBDIRS指明子目录。

SUBDIRS=src

l 建立src目录中的Makefile.am，这里我们生成的共享文件名为libhelloworld.la，安装目录为${prefix}/lib，头文件安装到${prefix}/include/helloworld/。

lib_LTLIBRARIES = libhelloworld.la libhelloworld_la_SOURCES=helloworld.c libhelloworld_la_CFLAGS=-I./ libhelloworld_la_LDFLAGS= helloworldincludedir=$(includedir)/helloworld helloworldinclude_HEADERS= helloworld.h

l 在顶层目录中建立几个空文件。

[root@linux helloworld]# touch NEWS README ChangeLog AUTHORS

l 拷贝automake和libtool必要的文件。

[root@linux helloworld]# cp -f /usr/share/automake-1.9/depcomp .

[root@linux helloworld]# cp -f /usr/share/automake-1.9/compile .

[root@linux helloworld]# cp -f /usr/share/libtool/ltmain.sh .

l 建立autogen.sh

#!/bin/bash aclocal autoheader autoconf automake -a ./configure

[root@linux helloworld]# chmod 755 autogen.sh

l 测试一下

[root@linux helloworld]# ./autogen.sh ;make;make install

OK了