如何根据configure.ac和Makefile.am为开源代码产生当前平台的Makefile

时间 2019-11-14

标签如何根据 configure.ac configure makefile.am makefile 开源代码产生当前平台栏目 C&C++ 繁體版

原文原文链接

//根据configure.in和Makefile.am生成makefile的步骤，基于UBUNTU 12.04

1.autoscan （可选）

2.aclocal

3.autoconf

4.autoheader（可选）

5.libtoolize --automake --copy --debug --force（可选）

6.automake --add-missing

7.autoreconf –f –i –Wall,no–obsolete（可选）

8../configure

简单的方式：html

若是拿到的工程文件中，没有Makefile文件，而只有configure.in和Makefile.am文件，咱们是不可以直接进行编译的，必须在UBUNTU等Linux系统下，根据configure.in和Makefile.am文件生成编译所需的Makefile文件。具体操做步骤以下：
一、执行autoscan，而后执行aclocal，产生aclocal.m4文件
aclocal是一个perl 脚本程序，它的定义是：“aclocal – create aclocal.m4 by scanning configure.ac”。 aclocal根据configure.in文件的内容，自动生成aclocal.m4文件。而aclocal.m4文件中，包含了生成configure文件所必须的宏。
二、执行autoconf，生成configure文件
autoconf会根据configure.in和aclocal.m4文件，生成configure文件。其实，autoconf就是把configure.in和aclocal.m4文件中定义的内容，变成检查系统特性、环境变量、软件必须的参数的shell脚本。
三、执行automake命令，产生Makefile.in
具体命令为：automake –add-missing
automake会根据Makefile.am文件产生一些文件，包含最重要的Makefile.in。前面所生成的configure，会根据Makefile.in文件，来生成最终的Makefile文件。
四、执行configure命令，生成Makefile文件
这样，就产生了编译所须要的Makefile文件。运行make，便可编译。linux

复杂点的方式：git

为一个项目源文件生成makefile并make的步骤以下：github

操做在包含源文件的项目目录下进行。shell

(1)运行autoscan，生成文件configure.scan
(2)修改configure.scan，更名为configure.in
(3)运行autoheader，生成文件configure.h.in（如今通常改成configure.ac）
(4)运行libtoolize，生成ltmain.sh
(5)运行allocal，生成aclocal.m4
(6)运行autoconf，生成configure
(7)运行automake，生成makefile.in，每一个包含makefile.am的子目录都生成makefile.in。automake -a选项能够补齐文件config.guess，config.sub，install-sh，missing，depcomp
(8)运行./configure，生成config.status，config.h，makefile
(9)运行make，生成中间文件对象文件，库文件，最后生成可执行文件
(10)运行make install，相应的可执行文件，库文件，头文件拷贝到系统相应位置。

configure运行ui

configure是一个shell脚本文件，由autoconf生成，它自动为源码包配置编译链接选项，适应不一样的硬件平台和POSIX操做系统，输出所须要的Makefile。this

configure主管检查你的系统，把结果存放到config.status中，config.status根据它的检查结果实际执行正确的动做。spa

configure检查与系统相关的一系列变量，这些变量存储到文件config.status中，供makefile调用。这些变量包括编译链接时须要的程序，这些程序在系统中的位置（目录），调用这些程序的选项，好比编译器的目录，编译器的选项-g是否支持等。configure能猜出它运行的系统的规范名字cpu–vendor–os，它经过运行脚本文件config.guess输出变量uname来猜出。configure能识别不少系统名字的别名，它经过运行脚本文件config.sub把系统名字变成规范名字。操作系统

make运行debug

makefile.am对makefile的影响：它根据SUBDIRS = add sub让make递归进入每一个子目录处理子目录的Makefile。根据main_LDADD = add/libadd.la sub/libsub.la为main链接libadd.la和libsub.la库。

configure.in对makefile的影响：

根据AC_PROG_LIBTOOL让libtool完成编译链接工做。

根据AC_CONFIG_HEADERS([config.h])只需传递预处理宏-DHAVE_CONFIG_H给编译器。

makefile中不少与系统相关的信息都是经过变量获取的，这些变量以前已经由configure检查好存放在config.status里面，预处理宏存放在config.h里面。好比咱们要用到的编译器CC，编译器选项CFLAGS等。makefile中的变量完成替换后，开始实际执行命令，它会递归执行每个子目录下的makefile，生成对象文件，链接库文件，最后链接成可执行文件。

交叉编译 Cross-compiling

Q：为别的平台编译可执行程序怎么作？

交叉编译就是在目前的平台上为别的目标平台生成可执行程序或库。能够在运行configure时经过–build，–host，–target参数实现交叉编译。

例如:

1	./configure --build=i686-pc-linux-gnu --host=m68k-coff

–build=build-type ：configure和compile软件包的系统类型。默认状况等于config.guess给出的系统类型

–host=host-type ：运行软件包的系统类型。默认状况等于build类型

–target=target-type ：不多用，默认状况等于host类型。

交叉编译时，若是编译器，链接器，汇编器名字不是以host_type为前缀，configure都会发出警告。

要搭建交叉变异环境，如交叉编译用的编译器，链接器，汇编器跟本地的不同，通常以host_type为前缀，如arm-pc-linux-gcc。

安装目录

Q：make install时，文件都安装到哪里去了？

prefix：安装目录的前缀。默认状况下/usr/local 。

bindir：安装时拷贝可执行文件到此目录。默认状况下/usr/local/bin 。

includir：安装时拷贝头文件到此目录。默认状况下/usr/local/include 。

libdir：安装时拷贝库文件到此目录。默认状况下/usr/local/libs 。

定制本身的安装目录，能够–prefix 和 –exec-prefix 给configure。

例如：./configure –prefix=/usr 。

Configure，Makefile.am, Makefile.in, Makefile文件之间关系

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

1.autoscan (autoconf): 扫描源代码以搜寻普通的可移植性问题，好比检查编译器，库，头文件等，生成文件configure.scan,它是configure.ac的一个雏形。

your source files --- [autoscan*] --- [configure.scan] --- configure.ac

2.aclocal (automake):根据已经安装的宏，用户定义宏和acinclude.m4文件中的宏将configure.ac文件所须要的宏集中定义到文件 aclocal.m4中。aclocal是一个perl 脚本程序，它的定义是：“aclocal - create aclocal.m4 by scanning configure.ac”

user input files optional input process output files

================ ============== ======= ============

acinclude.m4 - - - - -.

.-------,

configure.ac -------------------------|aclocal|

{user macro files} --| |------- aclocal.m4

`-------'

3.autoheader(autoconf): 根据configure.ac中的某些宏，好比cpp宏定义，运行m4，声称config.h.in

user input files optional input process output files

================ ============== ======= ============

aclocal.m4 - - - - - - - .

.----------,

configure.ac ------------------------|autoheader|----- autoconfig.h.in

`----------'

4.automake: automake将Makefile.am中定义的结构创建Makefile.in，而后configure脚本将生成的Makefile.in文件转换为Makefile。若是在configure.ac中定义了一些特殊的宏，好比AC_PROG_LIBTOOL，它会调用libtoolize，不然它会本身产生config.guess和config.sub

user input files optional input processes output files

================ ============== ========= ============

.--------,

| | - - -- COPYING

| | - - -- INSTALL

| |------- install-sh

| |------- missing

|automake|------- mkinstalldirs

configure.ac ------------------------| |

Makefile.am ------------------------| |------- Makefile.in

| |------- stamp-h.in

.---+ | - - -- config.guess

| | | - - -- config.sub

| `------+-'

| | - - - -- config.guess

|libtoolize| - - - -- config.sub

| |--------- ltmain.sh

| |--------- ltconfig

`----------'

5.autoconf:将configure.ac中的宏展开，生成configure脚本。这个过程可能要用到aclocal.m4中定义的宏。

user input files optional input processes output files

================ ============== ========= ============

aclocal.m4 ,autoconfig.h.in - - - - - - -.

.--------,

configure.ac ------------------------|autoconf|------- configure

6. ./configure的过程

.-------------- [config.cache]

configure* --------------------------+-------------- config.log

[config.h.in] -. v .--- [autoconfig.h]

+-------> config.status* -+

Makefile.in ---' `--- Makefile

7. make过程

[autoconfig.h] -+--- make* ---- 程序

Makefile ---'

----------

config.site - - --| |

config.cache - - --|configure| - - -- config.cache

| +-,

`-+-------' |

| |----- config.status

config.h.in --------|config- |----- config.h

Makefile.in --------| .status|----- Makefile

| |----- stamp-h

| +--,

.-+ | |

| `------+--' |

ltmain.sh --------|ltconfig|-------- libtool

| | |

`-+------' |

|config.guess|

| config.sub |

`------------'

----------

Makefile -------| |

config.h -------| make |

{project sources} -----------------| |--------- {project targets}

.-+ +--,

| `--------' |

| libtool |

| missing |

| install-sh |

|mkinstalldirs|

`-------------'

针对上面提到的各个命令,咱们再作些详细的介绍

//http://www.laruence.com/2009/11/18/1154.html

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

错误处理：

When try to configure an open source code, I get error like this :

configure: error: cannot find install-sh, install.sh, or shtool in “.” “./..” “./../..”

<pre>

autoreconf –f –i –Wall,no–obsolete

./configure

</pre>

“Libtool library used but ‘LIBTOOL’ is undefined”

<pre>sudo apt-get install autoconf
sudo apt-get install automake
sudo apt-get install libtool

从新执行aclocal/autoheader</pre>

required file build/ltmain.sh' not found

$ automake --add-missing .... configure.in:18: required file build/ltmain.sh’ not found
….
解决方案(libtoolize配置便可)：

$libtoolize –version-libtoolize (GNU libtool) 1.4.2…..$libtoolize –automake –copy –debug –force

如何根据configure.ac和Makefile.am为开源代码产生当前平台的Makefile

Configure，Makefile.am, Makefile.in, Makefile文件之间关系

针对上面提到的 各个命令,咱们再作些详细的介绍

//http://www.laruence.com/2009/11/18/1154.html

“Libtool library used but ‘LIBTOOL’ is undefined”

针对上面提到的各个命令,咱们再作些详细的介绍