linux下automake用法

原文鏈接：http://www.cppblog.com/gezidan/archive/2011/08/08/152772.html

此篇爲轉載好文：原文鏈接：
linux下automake用法 - Rixu Blog (日需博客) - C++博客
http://www.cppblog.com/gezidan/archive/2011/08/08/152772.html

由於原文發佈時間較早2012年，這裏在原文的基礎加點修正，以適合現在的automake版本。

作爲Linux下的程序開發人員，大家一定都遇到過Makefile，用make命令來編譯自己寫的程序確實是很方便。一般情況下，大家都是手工寫一個簡單Makefile，如果要想寫出一個符合自由軟件慣例的Makefile就不那麼容易了。

在本文中，將給大家介紹如何使用 autoconf和automake兩個工具來幫助我們自動地生成符合自由軟件慣例的Makefile，這樣就可以象常見的GNU程序一樣，只要使用“./configure”，“make”，“make install”就可以把程序安裝到Linux系統中去了。這將特別適合想做開放源代碼軟件的程序開發人員，又或如果你只是自己寫些小的Toy程序，那麼這個文章對你也會有很大的幫助。

編譯一個簡單的源文件main.c,需要自動生成一個makefile,以下是步驟：

第一步：

在/root/project/main目錄下創建一個文件main.c,其內容如下：


#include <stdio.h>

int main(int argc, char** argv)
{
	printf("Hello, Auto Makefile!\n");
	
	return 0;
}

此時狀態如下：

[root@localhost main]# pwd

/root/project/main

[root@localhost main]# ls

main.c

[root@localhost main]#

第二步：

運行 autoscan , 自動創建兩個文件： autoscan.log configure.scan

此時狀態如下：

[root@localhost main]# autoscan

[root@localhost main]# ls

autoscan.log configure.scan main.c

[root@localhost main]#

第三步：

~~修改configure.scan的文件名爲 configure.in~~
在新版本中，需要修改configure.scan的文件名爲 configure.ac
查看 configure.ac 的內容：

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

AC_PREREQ([2.69])
AC_INIT([FULL-PACKAGE-NAME], [VERSION], [BUG-REPORT-ADDRESS])
AC_CONFIG_SRCDIR([mian.c])
AC_CONFIG_HEADERS([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

解讀以上的文件：


# -*- Autoconf -*-

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

# AC_PREREQ:

# 確保使用的是足夠新的Autoconf版本。如果用於創建configure的Autoconf的版

# 本比version 要早，就在標準錯誤輸出打印一條錯誤消息並不會創建configure。

AC_PREREQ([2.69])

#

# 初始化,定義軟件的基本信息,包括設置包的全稱,版本號以及報告BUG時需要用的郵箱地址

#

AC_INIT([FULL-PACKAGE-NAME], [VERSION], [BUG-REPORT-ADDRESS])

#

# 用來偵測所指定的源碼文件是否存在，來確定源碼目錄的有效性

#

AC_CONFIG_SRCDIR([mian.c])

#

# 用於生成config.h文件，以便autoheader使用

#

AC_CONFIG_HEADERS([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.

#

# 創建輸出文件。在`configure.ac'的末尾調用本宏一次。

#

AC_CONFIG_FILES([Makefile])
AC_OUTPUT

修改動作:

1.修改AC_INIT裏面的參數: AC_INIT(main,1.0, [email protected])

~~2.添加宏AM_INIT_AUTOMAKE, 它是automake所必備的宏，也同前面一樣，PACKAGE是所要產生軟件套件的名稱，VERSION是版本編號。~~
2.新版本中 AM_INIT_AUTOMAKE 不需要指定參數 PACKAGE VERSION

~~3.在AC_OUTPUT後添加輸出文件Makefile~~
3.新版本中不需要

修改後的結果:

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

AC_PREREQ([2.69])
AC_CONFIG_SRCDIR([main.c])
AC_CONFIG_HEADERS([config.h])

AC_INIT(main, 1.0)
AM_INIT_AUTOMAKE

# 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

第四步:

運行 aclocal, 生成一個“aclocal.m4”文件和一個緩衝文件夾autom4te.cache，該文件主要處理本地的宏定義。

此時的狀態是：

[root@localhost main]# aclocal

[root@localhost main]# ls

aclocal.m4 autom4te.cache autoscan.log configure.in configure.in~ main.c

[root@localhost main]#

第五步：

運行 autoconf, 目的是生成 configure

此時的狀態是：

[root@localhost main]# autoconf

[root@localhost main]# ls

aclocal.m4 autoscan.log configure.in main.c

autom4te.cache configure configure.in~

[root@localhost main]#

第六步：

運行 autoheader，它負責生成config.h.in文件。該工具通常會從“acconfig.h”文件中複製用戶附加的符號定義，因此此處沒有附加符號定義，所以不需要創建“acconfig.h”文件。

此時的狀態是：

[root@localhost main]# autoheader

[root@localhost main]# ls

aclocal.m4 autoscan.log configure configure.in~

autom4te.cache config.h.in configure.in main.c

[root@localhost main]#

第七步：

下面即將運行 automake, 但在此之前應該做一下準備工作!

首先

創建一個 Makefile.am.這一步是創建Makefile很重要的一步，automake要用的腳本配置文件是 Makefile.am，用戶需要自己創建相應的文件。之後，automake 工具轉換成 Makefile.in。

這個Makefile.am的內容如下：


AUTOMAKE_OPTIONS=foreign

bin_PROGRAMS=main

main_SOURCES=main.c

下面對該腳本文件的對應項進行解釋。

其中的AUTOMAKE_OPTIONS爲設置automake的選項。由於GNU（在第1章中已經有所介紹）對自己發佈的軟件有嚴格的規範，比如必須附帶許可證聲明文件COPYING等，否則automake執行時會報錯。automake提供了三種軟件等級：foreign、gnu和gnits，讓用戶選擇採用，默認等級爲gnu。在本例使用foreign等級，它只檢測必須的文件。

bin_PROGRAMS定義要產生的執行文件名。如果要產生多個執行文件，每個文件名用空格隔開。

main_SOURCES定義“main”這個執行程序所需要的原始文件。如果”main”這個程序是由多個原始文件所產生的，則必須把它所用到的所有原始文件都列出來，並用空格隔開。例如：若目標體“main”需要“main.c”、“sunq.c”、“main.h”三個依賴文件，則定義 main_SOURCES=main.c sunq.c main.h。要注意的是，如果要定義多個執行文件，則對每個執行程序都要定義相應的file_SOURCES。

其次

使用automake對其生成“configure.in”文件，在這裏使用選項“—adding-missing”可以讓automake自動添加一些必需的腳本文件。

運行後的狀態是：

[root@localhost main]# automake --add-missing

configure.in:8: installing `./missing’

configure.in:8: installing `./install-sh’

Makefile.am: installing `./depcomp’

[root@localhost main]# ls

aclocal.m4 config.h.in configure.in~ main.c Makefile.in

autom4te.cache configure depcomp Makefile.am missing

autoscan.log configure.in install-sh Makefile.am~

[root@localhost main]#

第八步

運行configure，在這一步中，通過運行自動配置設置文件configure，把Makefile.in變成了最終的Makefile。

運行的結果如下：

[root@localhost main]# ./configure

checking for a BSD-compatible install… /usr/bin/install -c

checking whether build environment is sane… yes

checking for a thread-safe mkdir -p… /bin/mkdir -p

checking for gawk… gawk

checking whether make sets $(MAKE)… yes

checking for gcc… gcc

checking for C compiler default output file name… a.out

checking whether the C compiler works… yes

checking whether we are cross compiling… no

checking for suffix of executables…

checking for suffix of object files… o

checking whether we are using the GNU C compiler… yes

checking whether gcc accepts -g… yes

checking for gcc option to accept ISO C89… none needed

checking for style of include used by make… GNU

checking dependency style of gcc… gcc3

configure: creating ./config.status

config.status: creating Makefile

config.status: creating config.h

config.status: executing depfiles commands

[root@localhost main]# ls

aclocal.m4 config.h.in configure.in main.c Makefile.in

autom4te.cache config.log configure.in~ Makefile missing

autoscan.log config.status depcomp Makefile.am stamp-h1

config.h configure install-sh Makefile.am~

[root@localhost main]#

第九步

運行 make，對配置文件Makefile進行測試一下

此時的狀態如下:

[root@localhost main]# make

cd . && /bin/sh /root/project/main/missing --run aclocal-1.10

cd . && /bin/sh /root/project/main/missing --run automake-1.10 --foreign

cd . && /bin/sh /root/project/main/missing --run autoconf

/bin/sh ./config.status --recheck

running CONFIG_SHELL=/bin/sh /bin/sh ./configure --no-create --no-recursion

checking for a BSD-compatible install… /usr/bin/install -c

checking whether build environment is sane… yes

checking for a thread-safe mkdir -p… /bin/mkdir -p

checking for gawk… gawk

checking whether make sets $(MAKE)… yes

checking for gcc… gcc

checking for C compiler default output file name… a.out

checking whether the C compiler works… yes

checking whether we are cross compiling… no

checking for suffix of executables…

checking for suffix of object files… o

checking whether we are using the GNU C compiler… yes

checking whether gcc accepts -g… yes

checking for gcc option to accept ISO C89… none needed

checking for style of include used by make… GNU

checking dependency style of gcc… gcc3

configure: creating ./config.status

/bin/sh ./config.status

config.status: creating Makefile

config.status: creating config.h

config.status: config.h is unchanged

config.status: executing depfiles commands

cd . && /bin/sh /root/project/main/missing --run autoheader

rm -f stamp-h1

touch config.h.in

make all-am

make[1]: Entering directory `/root/project/main’

gcc -DHAVE_CONFIG_H -I. -g -O2 -MT main.o -MD -MP -MF .deps/main.Tpo -c -o main.o main.c

mv -f .deps/main.Tpo .deps/main.Po

gcc -g -O2 -o main main.o

cd . && /bin/sh ./config.status config.h

config.status: creating config.h

config.status: config.h is unchanged

make[1]: Leaving directory `/root/project/main’

[root@localhost main]# ls

aclocal.m4 autoscan.log config.h.in config.status configure.in depcomp main main.o Makefile.am Makefile.in stamp-h1

autom4te.cache config.h config.log configure configure.in~ install-sh main.c Makefile Makefile.am~ missing

[root@localhost main]#

第十步

運行生成的文件 main：

[root@localhost main]# ./main

Hello, Auto Makefile!

[root@localhost main]#

我用的是ubuntu

以上就是全文了.

個人心得：
要使用automake ,關鍵在於兩個文件 configure.ac , Makefile.am 。
其中 configure.ac 可以使用 autoscan 生成的 configure.scan 上加以修改得到。
Makefile.am 需要自己添加編輯。用於生成makefile.in 。

原文鏈接：
linux下automake用法 - Rixu Blog (日需博客) - C++博客
http://www.cppblog.com/gezidan/archive/2011/08/08/152772.html

同類文章：
例解 autoconf 和 automake 生成 Makefile 文件
https://www.ibm.com/developerworks/cn/linux/l-makefile/index.html

linux下automake用法

Power Automate Desktop 安裝完，登錄後老是提示one driver 錯誤

再談23種設計模式（3）：行爲型模式（學習筆記）

微前端學習筆記(4):從微前端到微模塊之EMP與hel-micro方案探索

微前端學習筆記（1）：微前端總體架構概述，從微服務發微

985 碩士程序員，空窗 4 個月沒有 Offer！

一文搞懂 Spring 循環依賴

賽博鬥地主——使用大語言模型扮演Agent智能體玩牌類遊戲。

VScode右鍵打開(添加到右鍵)

記一次 .NET某工控視覺自動化系統卡死分析

WindowsServer--SQL Server搭建主從同步實現讀寫分離 - 事務性分發

全志H3 usb-otg 配置爲 host 模式

openwrt 中的設備節點自動創建

cgicc 上傳大文件失敗問題

SQUASHFS error: xz decompression failed, data probably corrupt

phy 驅動與 switch 驅動

Mac下配置sublime實現LaTeX

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結