当前时区为 UTC + 8 小时



发表新帖 回复这个主题  [ 7 篇帖子 ] 
作者 内容
1 楼 
 文章标题 : Linu中configure/makefile的文章--能弄懂一些参数
帖子发表于 : 2008-11-12 10:17 

注册: 2007-04-01 17:55
帖子: 38
地址: 中国大陆
送出感谢: 0 次
接收感谢: 1
本文教你如何使用autoconf、automake等来制作一个以源代码形式(.tar.gz)发布的软件、并可在执行configure时使用自定义参数。

一、概述和基础知识

  在Linux下得到一个以源代码形式发布的包(一般为.tar.gz或.tar.bz2格式),我们可以用 ./confiugure、make、make install来编译安装,其中在运行./configure的时候还可以根据自己的需要加入不同的参数(可用./configure --help来查看参数表)。

  先说说执行./configure后会生成什么东西?运行后系统会根据用户的实际情况生成config.h和多个Makefile。其中Makefile是运行make时所用的模板;而config.h则会以宏(Marco)的形式记录用户的自定义参数,编译器可以根据config.h来对源代码进行预编译(pre-compile),从而生成个性化的执行档。


二、我们的“软件”

  现在我们可以动手设计一个自己的“软件”了,为了更切合实际,将使用多个源程序,首先建立一个目录tt,用来放我们的东西,然后在tt下建立一个src目录,一般来说源代码都放在src中(好像已经成为一个不成文的规矩了:P)。整体架构如下:
  <tt>
   |-configure.in
   |-Makefile.am
   |-acconfig.h
   |-<src>
     |-tt.c
     |-qq.c
     |-qq.h
     |-Makefile.am

※说明:
1. configure.in 这是最重要的文档,整个安装过程都靠它来主导。
2. Makefile.am automake会根据它来生成Makefile.in,再由./configure 把Makefile.in变成最终的Makefile,一般来说在顶级目录和各个子目录都应该有一个Makefile.am
3. acconfig.h autoheader会根据它来生成config.h.in,再由./configure 把config.h.in变成最终的config.h
4. tt.c qq.c qq.h 这是我们的源程序。

※源代码内容:

tt.c

#include <stdio.h>
#include <qq.h>

#ifdef HAVE_CONFIG_H
#include <config.h>
#endif

int main(void)
{
int a = 23;

printf( "Hello, I am teacher(%d), pls tell me your names!\n", a );

#ifdef POPO
printf("My name is PoPo!\n");
#endif

qq();

return 0;
}



qq.c

#include <stdio.h>
#include <qq.h>

#ifdef HAVE_CONFIG_H
#include <config.h>
#endif

void qq(void)
{
printf("My name is QQ\n");

#ifdef POPO
printf("QQ: Hey PoPo, long time no see.\n");
#endif
}



qq.h

#ifndef __QQ__
#define __QQ__

void qq(void);

#endif




※运行流程:
 1. 首先老师来点名。
 2. 如果PoPo有来的话,将会报出自己的名字。
 3. 接著轮到QQ报到,如果PoPo有来的话,QQ会向PoPo问好。

  显然易见,PoPo是否出席,完全取决于POPO这个宏(Macro)有否被定义,我们只要在编译前决定要不要定义它,就能实现不同的效果。

  如果config.h存在的话,编译时Makefile会把宏HAVE_CONFIG_H传给编译器,所以如果没有定义HAVE_CONFIG_H 的话,我们的程序不应该把config.h include进去。


三、制作流程

请按照以下的执行顺序一步一步做:

第一步 编写configure.in

  生成configure.in的方法有两个,一个是自己从零开始写,另一个方法是用autoscan,执行autoscan后会生成configure.scan,其中包含了一些模板内容,使用时只要把名字改成.in就可以。

  configure.in中使用的命令有两种,一种是以AC开头,表示是由autoconf提供,另一种是以AM开头,代表由automake提供。

  在configure.in我们可以完成很多检测动作,比如检查编译所需的程式、头文件、库等等,总之功能是十分强大,不过我们这里只检测了编译器和头文件,详细用法请看 GNU Manuals Online

  以"dnl"为首的行为注释行(代码中绿色部份)。


configure.in

dnl 初始化autoconf,参数为入口函数所在的文件
AC_INIT(src/tt.c)

dnl 初始化automake,参数为软件名称及版本号
AM_INIT_AUTOMAKE(tt, 0.1.0)

dnl 告诉automake我们所用的配置文件,一般为config.h
AM_CONFIG_HEADER(config.h)

dnl 这里是实现自定义参数的部份,见下面的说明
AC_ARG_ENABLE(popo, [ --enable-popo PoPo is present],,enable_popo=no)
if test "$enable_popo" = yes ; then
echo "PoPo is here!"
AC_DEFINE(POPO)
else
echo "PoPo isn't here!"
fi

dnl 检测编译器
AC_PROG_CC

dnl 检测Standard C的头文件
AC_HEADER_STDC

dnl 输出文件,一般来说顶级目录和各子目录都应有Makefile输出
AC_OUTPUT(Makefile src/Makefile)




  ./configure的自定义参数有两种,一种是开关式(--enable-XXX或--disable-XXX),另一种是开放式,即后面要填入一串字符(--with-XXX=yyyy)参数。
  上述代码中用的是开关式,第一个参数是参数名,第二个是说明(执行"./configure --help"后所显示出来的内容),最后一个参数是默认值。一般来说默认值和用户提示应该是互斥的,即默认值是no的话,应提示用户用enable进行修改,反之亦然。
  从上面的代码中可以看到,如果$enable_popo为yes的话,就用AC_DEFINE来定义POPO这个宏(Macro),否则就不定义,我们在这里所使用到的宏,一定要在acconfig.h中声明。

第二步 运行aclocal 在tt目录下运行aclocal,将会生成aclocal.m4。

第三步 编写acconfig.h

  在configure.in中使用到的宏(Macro),都应该在这个文件声明,一般用#undef来声明。

acconfig.h

#undef POPO




第四步 运行autoheader

  运行autoheader后会根据configure.in、acconfig.h和系统预设的acconfig.h来生成config.h.in。

第五步 编写Makefile.am

  一般来说,在顶级目录和各子目录都应有一个Makefile.am。


Makefile

AUTOMAKE_OPTIONS = foreign
SUBDIRS = src



  第一行是告诉automake不要检测目录中是否存在AUTHORS、README等文件。
  第二行是告诉automake处理src这个子目录。


src/Makefile

AUTOMAKE_OPTIONS = foreign
bin_PROGRAMS = tt
tt_SOURCES = tt.c qq.c qq.h



  第一行作用同前。
  第二行是目标执行档的名称。
  第三行是生成tt这个执行档所需的所有源程序和头文件名称。

第六步 运行automake

  接著可以执行automake了,在命令行下输入
    automake -a 和
    automake -a src/Makefile
  使用"automake -a"或"automake --add-missing",会自动将install.sh、mkinstalldirs等文件补齐,否则会出错,切记!

第七步 运行autoconf

  最后,可以执行autoconf了,完成后将会生成最终的configure!


四、编译&测试

  用默认值编译:
[root@chiosoft tt]# ./configure
Checking for ......
PoPo isn't here!
Checking for ......

[root@chiosoft tt]# make
......

[root@chiosoft tt]# src/tt
Hello, I am teacher(23), pls tell me your names!
My name is QQ



  默认状态下,我们没有定义宏POPO,所以./configure时输出"PoPo isn't here!",运行时也只有QQ来报到。

  再看看这个:
[root@chiosoft tt]# ./configure --help
......
--enable and --with options recognized:
 --enable-popo PoPo is present

[root@chiosoft tt]# ./configure --enable-popo
Checking for ......
PoPo is here!
Checking for ......

[root@chiosoft tt]# make
......

[root@chiosoft tt]# src/tt
Hello, I am teacher(23), pls tell me your names!
My name is PoPo!
My name is QQ
QQ: Hey PoPo, long time no see.



  可以看到./configure时输出"PoPo is here!",执行结果也完全不一样!

  此外,我们也可以用make install来安装,预设是安装至/usr/local/bin下,当然,这些都是可以修改的。


五、生成发布包tarball

  好了,至今为止,我们的小软件已经测试完毕,可以发布了,在tt下有很多文件,有的是我们自己写的,也有些是编译时生成的临时档案,到底哪些需要打包到发行包中呢?当然你可以自己一个一个文件挑选,但用automake生成的Makefile提供了几个极方便的功能给我们。

  我们可以用make dist或make distcheck来生成相应的tarball,其中后者还会帮我们测试发布包能否正常工作,所以个人推荐使用make distcheck。

  看到了吧?发布包tt-0.1.0.tar.gz已经放到tt下了,有没有留意,这里用的软件名及版本号正是 configure.in中AM_INIT_AUTOMAKE所带的两个参数!现在你可以试试把它解压安装了。


_________________
Anyting is possible!!!


页首
 用户资料  
 
2 楼 
 文章标题 : Re: Linu中configure/makefile的文章--能弄懂一些参数
帖子发表于 : 2008-11-12 13:00 
头像

注册: 2008-10-21 11:17
帖子: 79
送出感谢: 0 次
接收感谢: 0 次
沙发,不错。感谢楼住。


_________________
http://thinkerx.tk/


页首
 用户资料  
 
3 楼 
 文章标题 : Re: Linu中configure/makefile的文章--能弄懂一些参数
帖子发表于 : 2008-11-12 13:06 
头像

注册: 2006-04-12 20:05
帖子: 8495
地址: 杭州
送出感谢: 0 次
接收感谢: 8
支持~ :em11


_________________
关注我的blog: ε==3


页首
 用户资料  
 
4 楼 
 文章标题 : Re: Linu中configure/makefile的文章--能弄懂一些参数
帖子发表于 : 2008-12-13 19:44 

注册: 2008-12-11 18:34
帖子: 2
送出感谢: 0 次
接收感谢: 0 次
强烈支持,多好的帖子啊!超赞,收藏啦! :em11


页首
 用户资料  
 
5 楼 
 文章标题 : Re: Linu中configure/makefile的文章--能弄懂一些参数
帖子发表于 : 2008-12-15 22:25 

注册: 2008-07-15 14:14
帖子: 27
送出感谢: 0 次
接收感谢: 0 次
好东西!顶楼主!!!


_________________
learn linux,enjoy linux


页首
 用户资料  
 
6 楼 
 文章标题 : Re: Linu中configure/makefile的文章--能弄懂一些参数
帖子发表于 : 2008-12-17 22:57 

注册: 2008-12-09 20:29
帖子: 39
送出感谢: 0 次
接收感谢: 0 次
好东西,支持楼主~~~~~~~~~~


页首
 用户资料  
 
7 楼 
 文章标题 : Re: Linu中configure/makefile的文章--能弄懂一些参数
帖子发表于 : 2008-12-18 0:36 
头像

注册: 2008-07-21 9:44
帖子: 2371
地址: 深圳
送出感谢: 0 次
接收感谢: 0 次
强帖,收藏
学习了…… :em11


页首
 用户资料  
 
显示帖子 :  排序  
发表新帖 回复这个主题  [ 7 篇帖子 ] 

当前时区为 UTC + 8 小时


在线用户

正在浏览此版面的用户:Yahoo [Bot] 和 2 位游客


不能 在这个版面发表主题
不能 在这个版面回复主题
不能 在这个版面编辑帖子
不能 在这个版面删除帖子
不能 在这个版面提交附件

前往 :  
本站点为公益性站点,用于推广开源自由软件,由 DiaHosting VPSBudgetVM VPS 提供服务。
我们认为:软件应可免费取得,软件工具在各种语言环境下皆可使用,且不会有任何功能上的差异;
人们应有定制和修改软件的自由,且方式不受限制,只要他们自认为合适。

Powered by phpBB © 2000, 2002, 2005, 2007 phpBB Group
简体中文语系由 王笑宇 翻译