autotools automake autoconf libtool 笔记

来源:互联网 发布:c语言 控制台 rpg游戏 编辑:程序博客网 时间:2024/05/03 02:17

autotools automake autoconf libtool 笔记
默认安装路径为:$(prefix) = /usr/local,可以通过./configure --prefix=<new_path>的方法来覆盖。

其它的预定义目录还包括:bindir = $(prefix)/bin, libdir = $(prefix)/lib, datadir = $(prefix)/share, sysconfdir = $(prefix)/etc等等。


configure.ac的编写


最简单的configure.ac必须包含的AC_INIT (package, version, [bug-report], [tarname])、AC_CONFIG_FILES([files])、AC_OUTPUT三个宏,有用到automake的话,则必须添加 AM_INIT_AUTOMAKE和AC_PROG_CC宏。automake一般是要用到的,因为生成的configure会根据 Makefile.in生成Makefile文件,而Makefile.in可以有automake生成。

 


Makefile.am就是一系列变量的定义。Makefile的语法:变量名 = 变量值

Makefile.am的编写

1.    需要生成Makefile的目录下都要编写一个Makefile.am

2.    顶层(项目)目录的Makefile.am,可能会包含AUTOMAKE_OPTIONS = foreign 1.4这样一句。

3.    如果当前目录有其它子目录,子目录中也要生成makefile,则要包含
SUBDIRS = 子目录…,例如:SUBDIRS = src doc

4.    对于不需要安装,但是需要一起打包发布的文件,则在当前目录的Makefile.am中可以添加一句:EXTRA_DIST = 发布的文件,例如:EXTRA_DIST = purge.conf purge

5.    Makefile.am中的变量名,有统一的命名机制,一般是:安装目录_主变量。

6.    安装目录。
有些标准的安装目录可以直接使用。例:bin_PROGRAMS = hello,表示hello将被安装在$(prefix)/bin目录下。但是这些标准安装目录可能不够使用,因此我们可以自己定义所需要的安装目录。安装目录一般是省略’dir’的,例如:
htmldir = $(prefix)/html
html_DATA = automake.html
就表示automake.html将被安装在$(prefix)/html目录下。这里DATA是主变量,稍后说明。
对于不安装的文件,变量名的目录变量可写为noinst。

7.    主变量。常见的主变量有:`PROGRAMS'、`LIBRARIES'、 `LISP'、`SCRIPTS'、`DATA'、 `HEADERS'、`MANS'和`TEXINFOS'。这些主变量说明了生成的对象类型。例如,主变量PROGRAMS 保存了需要被编译和连接的程序的列表。

8.    Makefile.am的例子。
目录结构:
  purge-1.2
   |―·doc
   |     |-purge.conf
   |     |-Makefile.am
   |-·src
   |     |-purge.h
   |     |-thread.h
   |     |-…
   |     |-list.h
   |     |-debug.c
   |     |-fun.c 
   |     |-list.c
   |     |-main.c
   |     |-map.c
   |     |-parseconf.c
   |     |-purge.c
   |     |-thread.c
   |     |-Makefile.am
   |-hello-0.1.0.spec
   |-configure.ac
   |-Makefile.am
各目录下的Makefile.am文件可以编写如下:
purge-1.2目录:vi Makefile.am
    AUTOMAKE_OPTIONS = foreign 1.4
    SUBDIRS = src doc
doc目录:vi Makefile.am
    EXTRA_DIST = purge.conf
src目录:vi Makefile.am
    bin_PROGRAMS = purge
    purge_SOURCES = main.c purge.c fun.c list.c \
                     parseconf.c thread.c debug.c map.c
    purge_LDADD = -lpthread
说明:

a)      在Makefile.am也可以定义变量如:
ALL_SOURCE = main.c purge.c fun.c list.c parseconf.c thread.c debug.c map.c
purge_SOURCES = $( ALL_SOURCE)

b)      名字中除了字母、数字和下划线之外的所有字符都将用下划线代替。例如,如果你的程序被命名为sniff-glue,那么派生出的变量名将是 sniff_glue_SOURCES,而不是sniff-glue_SOURCES;库liblob.a的’_SOURCES’变量对应的变量名 为’liblob_a_SOURCES’,而不是’liblob.a_SOURCES’。

9.    注:共享库必须被安装,所以不允许使用 `noinst_LTLIBRARIES'和`check_LTLIBRARIES'。

10.  Makefile.am中configure输出变量的使用。
在configure.ac中通过宏AC_SUBST引出的变量在Makefile.am中就能被使用到。
例子:
在configure.ac中定义如下:
if test -z "$CACHE_ICP_PORT"; then
       CACHE_ICP_PORT="3130"
fi
AC_SUBST(CACHE_ICP_PORT)
在Makefile.am中通过@CACHE_ICP_PORT@格式就能引用变量CACHE_ICP_PORT。
例子:DEFAULT_ICP_PORT        = @CACHE_ICP_PORT@

 

使用automake根据Makefile.am和aclocal.m4生成Makefile.in文件,在这里使用选项“—adding- missing”可以让automake自动添加有一些必需的脚本文件,如depcomp,install-sh, missing等。

 

Makefile文件

自动生成的Makefile文件常用几个命令如下:
make all - 生成程序、库、文档等,等同于make,根据Makefile编译原始码,连接,生成目标文件,可执行文件。
make install - 安装
make install-strip -安装,去除调试符号
make uninstall - 卸载
make clean - 清除临时文件,make all 的反过程,即清除上次的make命令所产生的object文件(后缀为“.o”的文件)及可执行文件。

make dist - 创建发布包:PACKAGE-VERSION.tar.gz.

 

 

 


 

在 configure.in 中,有一些被 autoconf 宏预先定义的变量,重要的有如下几个:

    bindir:安装可执行文件的目录。

    includedir:C 头文件目录。

    infodir:info 页安装目录。

    mandir:安装手册页的目录。

    sbindir:为管理员运行该该程序提供的安装路径。

    srcdir:为 Makefile 提供的源代码路径。

    top_srcdir:源代码的最上层目录。

    LIBS:给连接程序的 -l 选项

    LDFLAGS:给连接程序的 stripping(-s)和其他一些选项。

    DEFS:给 C 编译器的 -D 选项。

    CFLAGS:给 C 编译器的 debug 和优化选项。当调用了 AC_PROG_CC 才有效。

    CPPFLAGS:头文件搜索路径(-I)和给 C 预处理器和编译器的其他选项。

    CXXFLAGS:给 C++ 编译器的 debug 和优化选项。当调用了 AC_PROG_CXX 才有效。

 

原创粉丝点击