isware

Linux下automake軟件編譯與發布之多級目錄結構的處理

    多級目錄結構的軟件，一般是單個程序、庫文件或模塊放在各自的目錄中。automake要求每個目錄都有自己的Makefile.am文件來編譯各自目錄下的代碼。在頂級的目錄中，有一個Makefile.am文件，該文件通過SUBDIRS指明了這個目錄下有多少個直接下級目錄的代碼需要編譯。下級目錄的Makefile.am也指明自己需要編譯的下級目錄。通過這樣的層層遞歸i，從而完成多級目錄結構的編譯。

    下面看一個具體的示例：

    本例假設目錄結構如下：
    helloworld
    |src
    ||--test.cpp
    ||dohello
    |||--dohello.h
    |||--dohello.cpp
    |doc
    ||--userguide
    頂級目錄helloworld，該目錄下有src和doc兩個目錄。src目錄下有一個test.cpp文件，一個dohello目錄，dohello目錄下又有dohello.h和dohello.cpp兩個文件。doc下有一個readme文件。
    整個程序中test.cpp是主文件，里面有main函數。test.cpp調用了dohello.h和dohello.cpp中的類。

    下面是編譯步驟：

    1.運行autoscan產生configure.scan

    在頂級目錄helloworld下運行autoscan命令。產生configure.scan文件內容如下：
#                -*- Autoconf -*-
# Process this file with autoconf to produce a configure script.

AC_PREREQ(2.61)
AC_INIT(FULL-PACKAGE-NAME, VERSION, BUG-REPORT-ADDRESS)
AC_CONFIG_SRCDIR([src/test.cpp])
AC_CONFIG_HEADER([config.h])

# Checks for programs.
AC_PROG_CXX
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
                 src/Makefile
                 src/dohello/Makefile])
AC_OUTPUT


    2.編輯configure.in

    將configure.scan改名成configure.in，然后修改如下：
# Process this file with autoconf to produce a configure script.

AC_PREREQ(2.61)
AC_INIT(hello,1.0) #軟件包名稱和版本號,另一種寫法是寫在AM_INIT_AUTOMAKE中.
AC_CONFIG_SRCDIR([src/test.cpp])
#AC_CONFIG_HEADER([config.h])
AM_INIT_AUTOMAKE

# Checks for programs.
AC_PROG_CXX
AC_PROG_CC
AC_PROG_RANLIB #使用了靜態庫編譯,需要此宏定義

# Checks for libraries.

# Checks for header files.

# Checks for typedefs, structures, and compiler characteristics.

# Checks for library functions.

#AC_CONFIG_FILES([src/Makefile src/dohello/Makefile])
AC_OUTPUT(Makefile src/Makefile src/dohello/Makefile) #需要生成的Makefile，本例需要生成三個。

    3.運行aclocal和autoconf

    configure.in修改完后則先后執行aclocal和autoconf命令。

    4.建立各個目錄的Makefile.am文件

    在頂級目錄、src目錄和dohello目錄下分別建立三個Makefile.am文件。內容分別如下：

    頂級目錄Makefile.am：
#----------------開始------------------------------------------
AUTOMAKE_OPTIONS=foreign
SUBDIRS=src   #本目錄的直接下級目錄src需要編譯
EXTRA_DIST=doc/userguide #doc/userguide不需要編譯，但要發布該文件。如果有多個文件，則用空格分開。
#----------------結束------------------------------------------

    src目錄下的Makefile.am：
#----------------開始------------------------------------------
AUTOMAKE_OPTIONS=foreign
SUBDIRS=dohello #本目錄的直接下級目錄dohello需要編譯
bin_PROGRAMS=hello #本目錄的文件編譯成可執行文件hello。如有多個，用空格分開。然后在下面分別寫它們的SOURCE和LDADD。
hello_SOURCES=test.cpp #編譯hello需要的源文件列表，如有多個，用空格分開。
hello_LDADD=dohello/libhello.a #編譯hello需要的庫文件列表。如有多個，用空格分開。
#----------------結束------------------------------------------

    dohello目錄下的Makefile.am
#----------------開始------------------------------------------
AUTOMAKE_OPTIONS=foreign
noinst_LIBRARIES=libhello.a   #本目錄下的代碼編譯成libhello.a庫。不需要發布。如果需要發布，則寫成bin_LIBRARIES。注意，庫的名稱格式必需為 libxxx.a。因為編譯靜態庫，configure.in需要定義AC_PROG_RANLIB宏。
libhello_a_SOURCES=dohello.h dohello.cpp #編譯libhello.a需要的源文件。注意將庫名稱中的'.'號改成'_'號。
#----------------結束------------------------------------------

    5.運行automake

    以上幾個Makefile.am都書寫完畢后，運行automake --add-missing。

    6.運行./configure和make

    上面步驟完成后，先后運行./configure和make完成編譯。如果編譯成功，運行make dist可以將所有文件打包成hello-1.0.tar.gz。