zoukankan      html  css  js  c++  java
  • automake使用

    antuomake 流程图:

    http://blog.csdn.net/houwei544/article/details/8185916 这个教程不错

    https://www.ibm.com/developerworks/cn/linux/l-makefile/
    使用antuomake工具方法:
    以程序add.c为例:
    准备条件:先makedir一个目录,把需要的add.c文件放入到目录中
    Ubantu下 安装:sudo apt-get install automake

    1.在add.c所在的目录下通过autoscan命令生成autoscan.log configure.scan .
    Autoscan工具用来扫描源代码以搜寻一般的可移植性问题,比如检查编译器、库和头文件等,并创建configure.scan文件,它会在给定目录及其子目录树中检查源文件,若没有给出目录,就在当前目录及其子目录树中进行检查。
    configure.ac (sometimes also named: configure.in) is an input file for autoconf.

    vim configure.scan 内容如下:

    #####################################################################################################
    # -*- Autoconf -*-
    # Process this file with autoconf to produce a configure script.

    AC_PREREQ([2.69]) #autoscan 工具版本号2.69
    AC_INIT([FULL-PACKAGE-NAME], [VERSION], [BUG-REPORT-ADDRESS])
    # AC_INIT宏用来定义软件的名称和版本等信息,”FULL-PACKAGE-NAME”为软件包名称,#”VERSION”为软件版本号,”BUG-REPORT-ADDRESS”为BUG报告地址(一般为软件作者邮#件地址)。

    AC_CONFIG_SRCDIR([add.c])
    #AC_CONFIG_SRCDIR宏用来侦测所指定的源码文件是否存在,来确定源码目录的有效性。此#处为当前目录下的hello.c。

    AC_CONFIG_HEADERS([config.h])
    #AC_CONFIG_HEADER宏用于生成config.h文件,以便autoheader使用。

    # Checks for programs.
    AC_PROG_CC
    #AC_PROG_CC用来指定编译器,如果不指定,选用默认gcc。

    # Checks for libraries.

    # Checks for header files.

    # Checks for typedefs, structures, and compiler characteristics.

    # Checks for library functions.

    AC_CONFIG_FILES([Makefile])
    AC_OUTPUT

    #AC_OUTPUT用来设定 configure 所要产生的文件,如果是makefile,configure会把它检查出来的结果带入makefile.in文件产生合适的makefile。使用Automake时,还需要一些其他的参数,这些额外的宏用aclocal工具产生。

    ####################################################################################################

    修改configure.scan 为configure.in或者configure.ac内容如下:
    # -*- Autoconf -*-
    # Process this file with autoconf to produce a configure script.

    AC_PREREQ([2.69]) //automake版本
    AC_INIT(add, 1.0 ,277538911@qq.com) //设置软件包信息
    AM_INIT_AUTOMAKE(add, 1.0) //这个需要手动添加,它是automake必备的宏
    AC_CONFIG_SRCDIR([add.c]) //源文件名
    #AC_CONFIG_HEADERS([config.h])//config.h 文件, 这个地方我们不需要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_CONFIG_FILES([Makefile]) //要输出的文件名
    AC_OUTPUT
    ####################################################

    2.同步骤一运行aclocal命令:会生成如下文件
    aclocal.m4 add.c autom4te.cache autoscan.log configure.in
    //aclocal程序来生成你的 aclocal.m4  ,aclocal根据configure.in文件的 内容,自动生成aclocal.m4文件,aclocal是 一个perl 脚本程序
    //注意:如果只有autom4te.cache 没有aclocal.m4可能忘记了贴加宏 AM_INIT_AUTOMAKE(add, 1.0)这个需要手动添加,它是automake必备的宏

    3.运行autoconf命令生成执行文件configure
     autoconf 是 用来生成自动配置软件源代码脚本(configure)的 工具,configure脚本能独立于autoconf运行,且在 运行的 过程中,不需要用户的 干预.

    4.新建Makefile.am文件(第四部会根据工程的不同,编写的makefile.am内容有所不同)

    (1)以add.c单独的文件为例子 ,Makefile.am内容如下
    编辑:
    cat Makefile.am

    AUTOMAKE_OPTIONS=foreign //软件等级

    bin_PROGRAMS=add //可执行文件名

    add_SOURCES=add.c //源文件名

    automake会根据你写的 Makefile.am来自动生成Makefile.in.

    其中:

    AUTOMAKE_OPTIONS为设置Automake的选项。由于GNU对自己发布的软件有严格的规范,比如必须附带许可证声明文件COPYING等,否则Automake执行时会报错。Automake提供了3种软件等级:foreign、gnu和gnits,供用户选择,默认等级为gnu。本例使需用foreign等级,它只检测必须的文件。

    bin_PROGRAMS定义要产生的执行文件名。如果要产生多个执行文件,每个文件名用空格隔开。

    add_SOURCES定义”add”这个执行程序所需要的原始文件。如果”add”这个程序是由多个原始文件所产生的,则必须把它所用到的所有原始文件都列出来,并用空格隔开。例如:若目标体”add”需要”add.c”、”add.h”两个依赖文件,则定义add_SOURCES=add.c add.h。

    (2)工程中如果含有文件夹,程序用到了静态库,或者动态库 ,就有一些区别(每个目录下都必须有 Makefile.am 文件,Makefile.am内容不同 ,configure.in文件的内容也有所不同

    (1)为顶层目录创建Makefile.am文件

    在Makefile.am文件中贴加内容:

    AUTOMAKE_OPTIONS=foreign

    #指示automake代码级别,默认级别为gnu,GNU规定自由软件发布必 NEWS/README/AUTHORS/ChangeLog说明文件,这里将级别降为foreign,从而 避免准备这些文件.

    SUBDIRS=src inc

    #指定需要处理的子目录,如果要处理多个子目录,以空格隔开.这里只 有src inc

    ROOTDIR=$(shell /bin/pwd)

    #利用pwd取得当前路径

    export INCLUDES=-I$(ROOTDIR)/inc

    #指定头文件所在路径,并导出供子目录Makefile.am使用

    bin_PROGRAMS=target

    #指定要产生的执行文件名

    target_SOURCES=main.c   xxx1.c   xxx2.c

    #指定产生执行文件需要的源文件,如果有多个,以空格隔开

    target_LDADD=$(ROOTDIR)/src/libname.a

    #(利用src创建静态库) 或者 LIBS+=... 增加链接库

    ######################################

    Automake制作静态库makefile:

    以为 src inc 目录文件为例:里面有源文件student.c class.c   student.h  class.h

    1.在主文件夹下写Makefile.am

    AUTOMAKE_OPTIONS=foreign

    SUBDIRS= src inc #需要处理的子目录,多个以空格分开

    ROOTDIR=$(shell /bin/pwd)

    INCLUDES=-I$(ROOTDIR)/inc #指定头文件所在路径,并导出供子目录Makefile.am使用

    export INCLUDES #使之变成全局变量

    bin_PROGRAMS=my_test #生成的目标文件

    my_test_SOURCES=main.c #指定产生执行文件需要的源文件,如果有多个,以空格隔开

    my_test_LDADD=$(ROOTDIR)/src/libmy_test.a(自己定义的静态库名称) #把src中的文件变成静态库的方式

    2.在src源文件下写Makefile.am

    noinst_LIBRARIES=libmy_test.a(自己定义的静态库名称)               #这里的libmy_test.a与主目录下的Makefile.am 一致

    libmy_test_a_SOURCES= class.c student.c    #说明libmy_test.a由哪几个源文件产生的

    3.在inc头文件下写Makefile.am

    EXTRA_DIST=class.h  student.h   #EXTRA_DIST表示用来定义要额外打包的文件名称

    4.准备autoconf必需的配置文件configure.in 将configure.scan更名为configure.in,并对脚本进行如下修改

    (1)修改AC_INIT宏,指定软件包名称/版本/bug报告地址

    (2)加入automake必需的宏AM_INIT_AUTOMAKE()

    (3)屏蔽AC_CONFIG_HEADER宏

    (4)由于我们将要把src目录内的源文件编译成静态库,需要加入AC_PROG_RANLIB宏  

    如果程序用到了其他的系统静态库 

    #########################################

    (2)、在src子目录创建Makefile.am文件

    noinst_LIBRARIES=libname.a (自己定义的静态库名)

    #在src子目录生成静态库libname.a,以便顶层目录主文件链接使用

    libname_a_SOURCES(与库名对应)=src1.c src2.c(对应.c文件名)

    #产生静态库libname.a需要的源文件,以空格隔开

    (3)、在inc目录增Makefile.am

    EXTRA_DIST=inc1.h inc2.h (对应.h文件名)

    #EXTRA_DIST表示用来定义要额外打包的文件名称

     (4)configure.in 文件也需要做相应的修改

     ——————————————————————————————————————————————————————————————

    5.运行:automake --add-missing #-add-missing 自动贴加缺少的选项

    运行完成后会显示如下文件:
    guigu@guigu:~/work/automake_test$ ls
    aclocal.m4 autoscan.log configure.in Makefile.am
    add.c compile depcomp Makefile.in
    autom4te.cache configure install-sh missing

    6.执行configure生成makefile

    configure 作为编译配置脚本,有大量选项可供不同编译需求,这些选项直 接作用到最终生成的Makefile文件
    1、help 查看所有选项

    2、--prefix = PEWFIX 输入安装目录前缀.如: ./configure --prefix=/usr/local/bin

    3、编译器选项,如: CFLAGS=“-Wall -g” ./configure LDFLAGS=“-L libpath–l libname -static” ./configure CC=“arm-linux-gcc” ./configure
    4、--host 指定软件运行的系统平台 如:嵌入式arm-linux通常用 --host=arm-linux ./configure --host=arm-linux

    生成完成makefile后可以对make命令执行下列操作

    make
    make clean
    make dist
    make install
    make distclean 把makefile都会删掉 需要再次执行./congigure命令生成makefile命令
    make uninstall



    .深入浅出

      针对上面提到的 各个命令,我们再做些详细的 介绍.
      1. autoscan
      autoscan是 用来扫描源代码目录生成configure.scan文件的 .autoscan
    可以用目录名做为参数,但如果你不使用参数的 话,那么autoscan将认为使用的是当前目录.
    autoscan将扫描你所指定目录中的 源文件,并创建configure.scan文件.
      2. configure.scan
      configure.scan包含了系统配置的 基本选项,里面都是 一些宏定义.我们需要将它改名为
    configure.in
      3. aclocal
      aclocal是 一个perl 脚本程序.aclocal根据configure.in文件的 内容
    ,自动生成aclocal.m4文件.aclocal的 定义是 :"aclocal - create
    aclocal.m4 by scanning configure.ac".
      4. autoconf
      autoconf是 用来产生configure文件的 .configure是 一个脚本,它能设置
    源程序来适应各种不同的操作系统平台,并且根据不同的 系统来产生合适的 Makefile,从而可以使
    你的源代码能在不同的操作系统平台上被编译出来.
      configure.in文件的 内容是 一些宏,这些宏经过autoconf 处理后会变成检查系统
    特性.环境变量.软件必须的 参数的 shell脚本.configure.in文件中的 宏的 顺序并没
    有规定,但是 你必须在 所有宏的 最前面和最后面分别加上AC_INIT宏和AC_OUTPUT宏.
      在 configure.ini中:
      #号表示注释,这个宏后面的 内容将被忽略.
      AC_INIT(FILE)
      这个宏用来检查源代码所在 的 路径.
    AM_INIT_AUTOMAKE(PACKAGE, VERSION)
       这个宏是 必须的 ,它描述了我们将要生成的 软件包的 名字及其版本号:PACKAGE是软件包
    的名字,VERSION是 版本号.当你使用make dist命令时,它会给你生成一个类似
    helloworld-1.0.tar.gz的 软件发行包,其中就有对应的 软件包的 名字和版本号.
    AC_PROG_CC
      这个宏将检查系统所用的 C编译器.
    AC_OUTPUT(FILE)
      这个宏是 我们要输出的 Makefile的 名字.
      我们在 使用automake时,实际上还需要用到其他的 一些宏,但我们可以用aclocal 来帮
    我们自动产生.执行aclocal后我们会得到aclocal.m4文件.
      产生了configure.in和aclocal.m4 两个宏文件后,我们就可以使用autocon
    f来产生configure文件了.
      5. Makefile.am
      Makefile.am是 用来生成Makefile.in的 ,需要你手工书写.Makefile.
    am中定义了一些内容:
    AUTOMAKE_OPTIONS
      这个是 automake的 选项.在 执行automake时,它会检查目录下是 否存在 标准
    GNU软件包中应具备的各种文件,例如AUTHORS.ChangeLog.NEWS等文件.
    我们将其设置成foreign时,automake会改用一般软件包的 标准来检查.
    bin_PROGRAMS
      这个是 指定我们所要产生的 可执行文件的 文件名.如果你要产生多个可执行文件,
    那么在各个名字间用空格隔开.
    helloworld_SOURCES
      这个是 指定产生"helloworld"时所需要的 源代码.如果它用到了多个源文件,
    那么请使用空格符号将它们隔开.比如需要helloworld.h,helloworld.c那么请写成:
    helloworld_SOURCES= helloworld.h helloworld.c.
      如果你在 bin_PROGRAMS定义了多个可执行文件,则对应每个可执行文件都要定义相对的
    filename_SOURCES.
      6. automake
      我们使用automake --add-missing来产生Makefile.in.
      选项--add-missing的 定义是 "add missing standard files
    to package",它会让automake加入一个标准的 软件包所必须的 一些文件.
      我们用automake产生出来的 Makefile.in文件是 符合GNU Makefile惯例
    的 ,接下来我们只要执行configure这个shell 脚本就可以产生合适的 Makefile 文
    件了.
      7. Makefile
      在 符合GNU Makefiel惯例的 Makefile中,包含了一些基本的 预先定义的 操作:

    make
      根据Makefile编译源代码,连接,生成目标文件,可执行文件.
    make clean
      清除上次的 make命令所产生的 object文件(后缀为".o"的 文件)及可执行文件.
    make install
      将编译成功的 可执行文件安装到系统目录中,一般为/usr/local/bin目录.
    make dist
      产生发布软件包文件(即distribution package).这个命令将会将可执行文件及相关
    文件打包成一个tar.gz压缩的 文件用来作为发布软件的 软件包.
      它会在 当前目录下生成一个名字类似"PACKAGE-VERSION.tar.gz"的 文件.PA
    CKAGE和VERSION,是 我们在 configure.in中定义的 AM_INIT_AUTOM
    AKE(PACKAGE, VERSION).
    make distcheck
      生成发布软件包并对其进行测试检查,以确定发布包的正确性.

  • 相关阅读:
    让php更快提供文件下载
    设计模式 03 设计模式分类
    针对配置文件操作 PHP最常用的四个ini函数
    查找算法
    排序算法
    设计模式 01 统一建模语言基础知识
    关于div和css的一些好习惯
    数据结构的基本概念
    HTML特殊转义字符对照列表
    .htaccess 详解
  • 原文地址:https://www.cnblogs.com/yuankaituo/p/5169883.html
Copyright © 2011-2022 走看看