《海阔凭鱼跃天高任鸟飞Autoconf介绍说明》由会员分享,可在线阅读,更多相关《海阔凭鱼跃天高任鸟飞Autoconf介绍说明(25页珍藏版)》请在金锄头文库上搜索。
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.lautoscan程序可以用来为软件包创建configure.in文件。auto
3、scan在以命令行参数中指定的目录为根(如果未给定参数,则以当前目录为根)的目录树中检查源文件。它为通常的轻便问题搜索源文件,并且为那个包创建一个 configure.scan文件,这个文件就是configure.in的前身。lautoscan程序是perl语言写的。l将configure.scan文件重命名成configure.in或者configure.ac,并编辑之。lconfigure.in文件中的内容都是以AC_INIT开头,以AC_OUTPUT结束。Autoconf流程流程-如何写如何写configure.inlconfiugre.in文件的一般布局AC_INIT测试程序测试函数库
4、测试头文件测试类型定义测试结构测试编译器特性测试库函数测试系统调用AC_OUTPUTAutoconf流程流程-如何写如何写configure.in宏宏含义含义AC_INIT(FILE)用来检查源代码所在的路径。AM_INIT_AUTOMAKE(PACKAGE, VERSION)这个宏是必须的,它描述了我们将要生成的软件包的名字及其版本号:PACKAGE是软件包的名字,VERSION是版本号。当你使用make dist命令时,它会给你生成一个类似helloworld-1.0.tar.gz的软件发行包,其中就有对应的软件包的名字和版本号。AC_PROG_CC检查系统所用的C编译器。AC_CHECK
5、_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_LIBTOOL对libtool工具的支持。AC_CH
6、ECK_HEADERS检查系统中或环境路径中是否存在指定的头文件,和AC_CHECK_LIB一样支持条件语句。AC_CHECK_FUNCS检查library functions,和AC_CHECK_LIB一样支持条件语句。Autoconf流程流程-如何编写如何编写m4文件文件lm4是传统Unix的宏处理的安装启动的应用,其对应的是.m4文件记录了很多无法理解的宏。l详细的介绍见官方网站:http:/www.gnu.org/software/m4/lM4文件定义的宏一般需要在configure.in文件中调用,使用aclocal来进行解析laclocal也是一个perl脚本程序,aclocal根
7、据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该工具通常会从“acconfig.h”文件中复制用户附加的符号定义,因此此处
8、没有附加符号定义,所以不需要创建“acconfig.h”文件。Autoconf流程流程-如何编写如何编写automakelautomake要用的脚本配置文件是Makefile.am,用户需要自己创建相应的文件。之后,automake工具转换成Makefile.in。lautomake有相对应的一些参数可以配置,比如-a等等可执行文件可执行文件静态库静态库测试文件测试文件noinst_PROGRAMS = foofoo_SOURCES =foo_LDADD =foo_LDFLAGS =foo_DEPENDENCIES =noinst_LIBRARIES = libfoo.afoo_a_SOURC
9、ES =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就是所有源文件、头文件以及其他库文件都位于当前目录中,且没有子目录。Termutils就是这一类。shallow指的是主要的源代码都储存在
10、顶层目录,其他各个部分则储存在子目录中。u就是主要源文件在当前目录中,而其它一些实现各部分功能的源文件位于各自不同的目录。Automake本身就是这一类。deep指的是所有源代码都被储存在子目录中;顶层目录主要包含配置信息。u就是所有源文件及自己写的头文件位于当前目录的一个子目录中,而当前目录里没有任何源文件。 GNU cpio和GNU tar就是这一类。Yahoo的ydm、dcp等工程也属于这一类。lflat类型是最简单的,deep类型是最复杂的。但是实际工程中我们经常用到的是deep类型的。Autoconf流程流程-如何编写如何编写automakelMakefile.am中尽量使用相对路径
11、,系统预定义了两个基本路径:$(top_srcdir) 工程最顶层目录,用于引用源程序;$(top_builddir) 定义了生成目标文件上最上层目录,用于引用.o等编译出来的目标文件。lMakefile.am中也类似于m4一样,定义了很多的宏,比如:lincludedir头文件的路径,等同于-I;也可以使用libfooincludedir指定特定的库引用的头文件路径;linclude_HEADERS定义需要安装的头文件,也可以libfooinclude_HEADERS来指定特定的库需要安装的头文件;一般和libfooincludedir结合使用;Autoconf流程流程-如何编写如何编写au
12、tomakeldata_DATA需要安装数据文件lAUTOMAKE_OPTIONS由于GNU对自己发布的软件有严格的规范,比如必须附带许可证声明文件COPYING等,否则automake执行时会报错。automake提供了三种软件等级:foreign、gnu和gnits,让用户选择采用,默认等级为gnu。在本例使用foreign等级,它只检测必须的文件。lbin_PROGRAMS或lib_LIBRARIES定义要产生的执行文件名。如果要产生多个执行文件,每个文件名用空格隔开。对于可执行文件和静态库类型,如果只想编译,不想安装到系统中,可以用 noinst_PROGRAMS代替bin_PROGR
13、AMS,noinst_LIBRARIES代替lib_LIBRARIES。Autoconf流程流程-如何编写如何编写automakelMakefile.am还可以支持pkgconfig,对于pc文件也有相应的宏的定义:lpcdatadirpc文件的安装目录lpcdata_DATA安装的pcdata的文件名称Autoconf流程流程-如何编写如何编写automakelMakefile.am还提供了一些全局变量供所有的目标体使用:lINCLUDES链接时所需要的头文件lLDADD链接时所需要的库文件lLDFLAGS链接时所需要的库文件选项标志lEXTRA_DIST源程序和一些默认的文件将自动打入.t
14、ar.gz包,其它文件若要进入.tar.gz包可以用这种办法,比如配置文件,数据文件等等。lSUBDIRS在处理本目录之前要递归处理哪些子目录Autoconf流程流程-如何编写如何编写automakelAM_LDFLAGS同LDFLAGS一样,只是AM_ LDFLAGS优先加载;lAM_CPPFLAGS(AM_CFLAGS)同CPPFLAGS一样,只是AM_CPPFLAGS优先加载;lAM_CXXFLAGS同CXXFLAGS一样,只是AM_CXXFLAGS优先加载;lCLEANDIRS需要删除的目录lMOSTLYCLEANFILES需要删除的文件Autoconf流程流程autoconflaut
15、oconf是一个用于生成可以自动地配置软件源码包,用以适应多种UNIX类系统的shell脚本工具,其中autoconf需要用到 m4,便于生成脚本。l通过configure.in和aclocal.m4文件,使用autoconf生成configure文件,很复杂的configure文件吧!l运行configure文件,生成了我们要的Makefile文件Autoconf优化优化-rpm方案方案l我们知道,创建一个rpm包,需要用到一个spec文件,来注明rpm包的生成信息。l在工程项目中一般通常解决方法是在文件的根目录放一个*.spec.in(用来生成spec文件)或spec文件,这里我结合了.r
16、pmmacros采用了生成spec文件的方式:# define rpm build rootRPMBUILDTOPDIR = $(shell unset RPMBUILDTOPDIR; if -f $HOME/.rpmmacros ; then export RPMBUILDTOPDIR=grep _topdir $HOME/.rpmmacros|awk print $2; else export RPMBUILDTOPDIR=/usr/src/redhat; fi; echo $RPMBUILDTOPDIR;)Autoconf优化优化-rpm方案方案l下面的这些有点像Makefile吧,但是
17、这个是在Makefile.am文件中:.PHONY: rpmrpm: 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 $RPMBUILDTOPDIR/SPECSrpmbuild -ba $RPMBUILDTOPDIR/SPECS/PACKAGE.specl这样就可以通过make rp
18、m命令来生成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是自己写的一套其他项目从
19、代码进行编译的话,可以一次性把编译好的lib和头文件放到你工程下的lib和include目录下,而不是你每次修改自己工程的源文件都需要make一下其他的项目。我们的目的并不是让别人遵从我们的想法,而是宣扬我们的想法是多么的好,甚至你有更好的想法,我们会一起改进autoconf。lmake的时候发生的错误有时候奇奇怪怪的,比如链接起来了其他代码片段一般在make出现错误了,可以从错误代码原因进行分析,只要你遵守“游戏规则”,是不会产生链接到其它的代码片段的。l这个autoconf如何和java源码一起编译我们可以写Makefile.am,方法如同写Makefile一样,把java里面的编译器,比
20、如ant包含进 来,完成我们的make过程即可。Autoconf小结小结-FAQl执行./configure时候出现循环等问题请重新执行aclocal;autoheader;libtoolize -force;automake -a; autoreconf一系列命令,然后./configure,如果make再出现问题,请make clean后再次make。l怎么确定不需要执行aclocal等一系列命令一般来说,修改configure.in(ac)或增加(减少)m4文件都需要进行执行aclocal等一系列命令,其他比如修改Makefile.am等不需要执行。l我不会用autoconf,也不会写makefile学,除非你不想用c/c+。l用的多了,经常会碰到一些问题,该找谁?Google和gnu的网站l我曾经碰到的一些不好的现象和值得优化的建议:http:/ YOU!