海阔凭鱼跃天高任鸟飞Autoconf介绍

1、海阔凭鱼跃海阔凭鱼跃 天高任鸟飞天高任鸟飞 Autoconf Autoconf介绍介绍李俊良2010/08/18内容大纲内容大纲l学习目的lAutoconf介绍lAutoconf框架图lAutoconf流程lAutoconf优化lAutoconf小结lFAQ学习目的学习目的l如何方便在linux系统上写c/c+等工程的一种技巧，从而提高工程化的能力；l方便的阅读理解开源代码；l容易理解掌握整个工程源码的架构；l写出优秀而漂亮的代码框架。Autoconf介绍介绍l 今天我们一起来了解一下关于自动化编译的神秘面纱。l 无论是在Linux还是在Unix环境中，make都是一个非常重要的编译命令。l

2、可以通过查阅make的帮助文档来手工编写Makefile，当然我们更愿意自动生成Makefile。l 要想了解更多的自动化编译的知识，不仅仅要熟悉Makefile的语法，还要熟悉m4规则。l 实践还证明：光靠这些规则理论是不够的，我们要学会在实践中创造规则、完善理论。Autoconf框架图框架图Autoconf流程流程-如何写如何写configure.inl 在开始antoconf之前，了解一下Autoconf依赖于: Bash, Coreutils, Diffutils, Grep, M4, Make, Perl, Sed.l autoscan程序可以用来为软件包创建configure.in

3、文件。autoscan在以命令行参数中指定的目录为根（如果未给定参数，则以当前目录为根）的目录树中检查源文件。它为通常的轻便问题搜索源文件，并且为那个包创建一个 configure.scan文件，这个文件就是configure.in的前身。l autoscan程序是perl语言写的。l 将configure.scan文件重命名成configure.in或者configure.ac，并编辑之。l configure.in文件中的内容都是以AC_INIT开头，以AC_OUTPUT结束。Autoconf流程流程-如何写如何写configure.inl confiugre.in文件的一般布局 AC_I

4、NIT 测试程序 测试函数库 测试头文件 测试类型定义 测试结构 测试编译器特性 测试库函数 测试系统调用 AC_OUTPUTAutoconf流程流程-如何写如何写configure.in宏宏含义含义AC_INIT(FILE)用来检查源代码所在的路径。AM_INIT_AUTOMAKE(PACKAGE, VERSION)这个宏是必须的，它描述了我们将要生成的软件包的名字及其版本号：PACKAGE是软件包的名字，VERSION是版本号。当你使用make dist命令时，它会给你生成一个类似helloworld-1.0.tar.gz的软件发行包，其中就有对应的软件包的名字和版本号。AC_PROG_C

5、C检查系统所用的C编译器。AC_CHECK_LIB (library, function, action-if-found, action-if-not-found, other-libraries)该宏用来检查lib库中是否存在指定的函数。当测试成功时，执行shell命令action_if_found或者action_if_found当为空时，在输出变量LIBS中添加-llib。 action_if_not_found把-lother_libs选项传给link命令。AC_OUTPUT要输出的Makefile的名字。AC_LANG_CPLUSPLUS对C+语言的支持。AC_PROG_LIBTO

6、OL对libtool工具的支持。AC_CHECK_HEADERS检查系统中或环境路径中是否存在指定的头文件，和AC_CHECK_LIB一样支持条件语句。AC_CHECK_FUNCS检查library functions，和AC_CHECK_LIB一样支持条件语句。Autoconf流程流程-如何编写如何编写m4文件文件l m4是传统Unix的宏处理的安装启动的应用，其对应的是.m4文件记录了很多无法理解的宏。l 详细的介绍见官方网站：/software/m4/l M4文件定义的宏一般需要在configure.in文件中调用，使用aclocal来进行解析l acl

7、ocal也是一个perl脚本程序，aclocal根据configure.in文件的内容，自动生成aclocal.m4文件。l .m4文件很有趣，很多gcc无法完成的工作，m4可以方便的帮助完成；特别是环境依赖、系统移植性等方面。Autoconf流程流程-如何编写如何编写m4文件文件lM4文件的写法貌似shell脚本，不过更多的是宏的写法，比如定义一个宏：AC_DEFUNl其他常用的宏：AC_ARG_ENABLEAC_ARG_WITHAM_CONDITIONALAC_SUBSTAS_IFAutoconf流程流程-autoheaderl负责生成config.h.in文件。l该工具通常会从“acco

8、nfig.h”文件中复制用户附加的符号定义，因此此处没有附加符号定义，所以不需要创建“acconfig.h”文件。Autoconf流程流程-如何编写如何编写automakel automake要用的脚本配置文件是Makefile.am，用户需要自己创建相应的文件。之后，automake工具转换成Makefile.in。l automake有相对应的一些参数可以配置，比如-a等等可执行文件可执行文件静态库静态库测试文件测试文件noinst_PROGRAMS = foofoo_SOURCES =foo_LDADD =foo_LDFLAGS =foo_DEPENDENCIES =noinst_LIB

9、RARIES = libfoo.afoo_a_SOURCES =foo_a_LDADD =foo_a_LIBADD =foo_a_LDFLAGS = check_PROGRAMS = dofoodofoo_SOURCES = dofoo_LDADD =TESTS_ENVIRONMENT = TESTS = $(check_PROGRAMS)Autoconf流程流程-如何编写如何编写automakel 目前automake支持三种目录层次：flat、shallow和deep。 Flat指的是所有文件都位于同一个目录中u就是所有源文件、头文件以及其他库文件都位于当前目录中，且没有子目录。Termu

10、tils就是这一类。 shallow指的是主要的源代码都储存在顶层目录，其他各个部分则储存在子目录中。u就是主要源文件在当前目录中，而其它一些实现各部分功能的源文件位于各自不同的目录。Automake本身就是这一类。 deep指的是所有源代码都被储存在子目录中；顶层目录主要包含配置信息。u就是所有源文件及自己写的头文件位于当前目录的一个子目录中，而当前目录里没有任何源文件。 GNU cpio和GNU tar就是这一类。Yahoo的ydm、dcp等工程也属于这一类。l flat类型是最简单的，deep类型是最复杂的。但是实际工程中我们经常用到的是deep类型的。Autoconf流程流程-如何编写

11、如何编写automakel Makefile.am中尽量使用相对路径，系统预定义了两个基本路径： $(top_srcdir) 工程最顶层目录，用于引用源程序； $(top_builddir) 定义了生成目标文件上最上层目录，用于引用.o等编译出来的目标文件。l Makefile.am中也类似于m4一样，定义了很多的宏，比如：l includedir 头文件的路径，等同于-I；也可以使用libfooincludedir指定特定的库引用的头文件路径；l include_HEADERS 定义需要安装的头文件，也可以libfooinclude_HEADERS来指定特定的库需要安装的头文件；一般和lib

12、fooincludedir结合使用；Autoconf流程流程-如何编写如何编写automakel data_DATA 需要安装数据文件l AUTOMAKE_OPTIONS 由于GNU对自己发布的软件有严格的规范，比如必须附带许可证声明文件COPYING等，否则automake执行时会报错。automake提供了三种软件等级：foreign、gnu和gnits，让用户选择采用，默认等级为gnu。在本例使用foreign等级，它只检测必须的文件。l bin_PROGRAMS或lib_LIBRARIES 定义要产生的执行文件名。如果要产生多个执行文件，每个文件名用空格隔开。 对于可执行文件和静态库类

13、型，如果只想编译，不想安装到系统中，可以用 noinst_PROGRAMS代替bin_PROGRAMS，noinst_LIBRARIES代替lib_LIBRARIES。Autoconf流程流程-如何编写如何编写automakelMakefile.am还可以支持pkgconfig，对于pc文件也有相应的宏的定义：lpcdatadirpc文件的安装目录lpcdata_DATA安装的pcdata的文件名称Autoconf流程流程-如何编写如何编写automakel Makefile.am还提供了一些全局变量供所有的目标体使用：l INCLUDES 链接时所需要的头文件l LDADD 链接时所需要的库

14、文件l LDFLAGS 链接时所需要的库文件选项标志l EXTRA_DIST 源程序和一些默认的文件将自动打入.tar.gz包，其它文件若要进入.tar.gz包可以用这种办法，比如配置文件，数据文件等等。l SUBDIRS 在处理本目录之前要递归处理哪些子目录Autoconf流程流程-如何编写如何编写automakel AM_LDFLAGS 同LDFLAGS一样，只是AM_ LDFLAGS优先加载；l AM_CPPFLAGS(AM_CFLAGS) 同CPPFLAGS一样，只是AM_CPPFLAGS优先加载；l AM_CXXFLAGS 同CXXFLAGS一样，只是AM_CXXFLAGS优先加载；

15、l CLEANDIRS 需要删除的目录l MOSTLYCLEANFILES 需要删除的文件Autoconf流程流程autoconflautoconf是一个用于生成可以自动地配置软件源码包，用以适应多种UNIX类系统的shell脚本工具，其中autoconf需要用到 m4，便于生成脚本。l通过configure.in和aclocal.m4文件，使用autoconf生成configure文件，很复杂的configure文件吧！l运行configure文件，生成了我们要的Makefile文件Autoconf优化优化-rpm方案方案l 我们知道，创建一个rpm包，需要用到一个spec文件，来注明rpm

16、包的生成信息。l 在工程项目中一般通常解决方法是在文件的根目录放一个*.spec.in（用来生成spec文件）或spec文件，这里我结合了.rpmmacros采用了生成spec文件的方式： # define rpm build root RPMBUILDTOPDIR = $(shell unset RPMBUILDTOPDIR; if -f $HOME/.rpmmacros ; then export RPMBUILDTOPDIR=grep _topdir $HOME/.rpmmacros|awk print $2; else export RPMBUILDTOPDIR=/usr/src/re

17、dhat; fi; echo $RPMBUILDTOPDIR;)Autoconf优化优化-rpm方案方案l 下面的这些有点像Makefile吧，但是这个是在Makefile.am文件中： .PHONY: rpm rpm: dist PACKAGE.spec$(RM) $RPMBUILDTOPDIR/SOURCES/$(distdir).tar.gz$(RM) $RPMBUILDTOPDIR/SPECS/PACKAGE.spec$(LN_S) pwd/$(distdir).tar.gz $RPMBUILDTOPDIR/SOURCES$(LN_S) pwd/PACKAGE.spec $RPMBUI

18、LDTOPDIR/SPECSrpmbuild -ba $RPMBUILDTOPDIR/SPECS/PACKAGE.specl 这样就可以通过make rpm命令来生成rpm了，值得注意的是如果没有在.rpmmacros文件内指定_topdir，则需要sudo权限来根据系统变量来生成rpm。Autoconf小结小结-补充补充lLibtool工具添加需要注意libtoolize步骤l针对CFLAGS和CXXFLAGS对默认GNU的编译选项的更改l针对一个lib可以拆分成两个libldata_DATA需要指定datadir变量的位置lAC_HEADER_STDC等宏的合理添加lmake dist 等各种包的打法lautoreconf的使用Autoconf小结小结-FAQl 依赖的其他项目是从代码编译的，同时他们的makefile是自己写的一套 其他项目从代码进行编译的话，可以一次性把编译好的lib和头文件放到你工程下的lib和include目录下，而不是你每次修改自己工程的源文件都需要make一下其他的项目。 我们的目