automake使用

 

antuomake 流程圖:linux

http://blog.csdn.net/houwei544/article/details/8185916 這個教程不錯shell

https://www.ibm.com/developerworks/cn/linux/l-makefile/
使用antuomake工具方法:
以程序add.c爲例:
準備條件:先makedir一個目錄,把須要的add.c文件放入到目錄中
Ubantu下 安裝:sudo apt-get install automake vim

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.ui

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報告地址(通常爲軟件做者郵#件地址)。this

AC_CONFIG_SRCDIR([add.c])
#AC_CONFIG_SRCDIR宏用來偵測所指定的源碼文件是否存在,來肯定源碼目錄的有效性。此#處爲當前目錄下的hello.c。spa

AC_CONFIG_HEADERS([config.h])
#AC_CONFIG_HEADER宏用於生成config.h文件,以便autoheader使用。操作系統

# Checks for programs.
AC_PROG_CC
#AC_PROG_CC用來指定編譯器,若是不指定,選用默認gcc。.net

# 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文件
一、help 查看全部選項

二、--prefix = PEWFIX 輸入安裝目錄前綴.如: ./configure --prefix=/usr/local/bin

三、編譯器選項,如: CFLAGS=「-Wall -g」 ./configure LDFLAGS=「-L libpath–l libname -static」 ./configure CC=「arm-linux-gcc」 ./configure
四、--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"的 文件.PACKAGE和VERSION,是 咱們在 configure.in中定義的 AM_INIT_AUTOMAKE(PACKAGE, VERSION).make distcheck  生成發佈軟件包並對其進行測試檢查,以肯定發佈包的正確性.

相關文章
相關標籤/搜索