Autoconf 與 Automake 實戰教學：從原始碼自動生成可移植 Makefile 完整流程

手寫 Makefile 痛苦且難移植。GNU Build System (Autoconf + Automake + Libtool) 讓專案支援標準 ./configure && make && make install 三步安裝。本文以 HelloWorld.cpp 為例，完整演示從 autoscan 到生成 Makefile 的標準化流程，並深度解析 Makefile.am 編寫規則與打包發布。

核心工具鏈

標準化生成流程 (8 步驟)

1. autoscan → configure.scan
2. 重命名 mv configure.scan configure.ac，編輯巨集
3. aclocal → aclocal.m4
4. autoheader → config.h.in
5. autoconf → configure (可執行)
6. 編寫 Makefile.am
7. automake --add-missing → Makefile.in + 缺失檔案 (NEWS/README/ChangeLog/AUTHORS)
8. ./configure → Makefile

configure.ac 關鍵巨集

AC_PREREQ([2.69])
AC_INIT([HelloWorld], [1.0], [postmaster@126.com])
AC_CONFIG_SRCDIR([HelloWorld.cpp])
AC_CONFIG_HEADERS([config.h])
AM_INIT_AUTOMAKE([HelloWorld], [1.0])
AC_PROG_CXX
AC_CONFIG_FILES([Makefile])
AC_OUTPUT

Makefile.am 編寫規則

目標類型前綴

可執行檔範例

bin_PROGRAMS = client
client_SOURCES = key.c connect.c client.c main.c session.c hash.c
client_CPPFLAGS = -DCONFIG_DIR=\"$(sysconfdir)\" -DLIBRARY_DIR=\"$(pkglibdir)\"
client_LDFLAGS = -export-dynamic -lmemcached
noinst_HEADERS = client.h
client_LDADD = $(top_builddir)/sx/libsession.a $(top_builddir)/util/libutil.a

動態庫 (.so) 範例

projectlibdir = $(libdir)
projectlib_PROGRAMS = project.so
project_so_SOURCES = xxx.c
project_so_LDFLAGS = -shared -fPIC

靜態庫 (Libtool) 範例

noinst_LTLIBRARIES = libutil.la
libutil_la_SOURCES = access.c config.c datetime.c hex.c inaddr.c log.c device.c pool.c rate.c sha1.c stanza.c str.c xhash.c
noinst_HEADERS = inaddr.h util.h compat.h pool.h xhash.h url.h device.h

• 推薦 LTLIBRARIES (Libtool) 而非 LIBRARIES，跨平台零修改
• 頭檔需在 _HEADERS 宣告，否則 make dist 不會打包

安裝路徑變數

prefix = /usr/local
bindir = $(prefix)/bin
libdir = $(prefix)/lib
includedir = $(prefix)/include
sysconfdir = $(prefix)/etc
datadir = $(prefix)/share

# 自訂路徑
sysdatedir = $(prefix)/sysdate
sysdate_DATA = data1 data2

打包發布

make dist
# 生成 HelloWorld-1.0.tar.gz
# 內含：所有原始碼、Makefile.am、configure 相關檔、EXTRA_DIST 指定檔

• nodist_client_SOURCES = client.c 排除特定檔案
• EXTRA_DIST = README.md LICENSE 額外納入

完整實戰記錄

# 1. 建立專案
mkdir helloworld && cd helloworld
cat > HelloWorld.cpp <<'EOF'
#include 
using namespace std;
int main() { cout << "Hello World" << endl; return 0; }
EOF

# 2. autoscan
autoscan
mv configure.scan configure.ac
# 編輯 configure.ac (見上)

# 3. aclocal
aclocal

# 4. autoheader
autoheader

# 5. autoconf
autoconf

# 6. Makefile.am
cat > Makefile.am <<'EOF'
AUTOMAKE_OPTIONS = foreign
bin_PROGRAMS = HelloWorld
HelloWorld_SOURCES = HelloWorld.cpp
EOF

# 7. automake
automake --add-missing
# 提示缺檔案
touch NEWS README ChangeLog AUTHORS
automake --add-missing

# 8. configure
./configure
# 生成 Makefile

# 9. 建置安裝
make
make install  # 安裝至 /usr/local/bin/HelloWorld

Autotools 學習曲線陡峭，但一次掌握，終身受用。標準化建置系統是開源專案專業度的門檻，也是跨平台移植的基石。