如何根據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」

針對上面提到的各個命令,咱們再作些詳細的介紹