automake 的使用（一）

我的实验环境如下：

        1：autoconf (GNU Autoconf) 2.69

        2：automake (GNU automake) 1.16.1

首先创建一个工程目录，并写一个测试程序，如下所示：

qczl@DESKTOP-HP-ZHAN:automake$ ls
main.c
qczl@DESKTOP-HP-ZHAN:automake$ cat main.c

#include <stdio.h>
#include <string.h>
#include <stdlib.h>

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

第一步：执行 autoscan，会生成 autoscan.log  configure.scan 2个文件

qczl@DESKTOP-HP-ZHAN:automake$ ls
autoscan.log  configure.scan  main.c

configure.scan 文件内容如下：

#                                               -*- 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([main.c])
AC_CONFIG_HEADERS([config.h])

# Checks for programs.
AC_PROG_CC

# Checks for libraries.

# Checks for header files.
AC_CHECK_HEADERS([stdlib.h string.h])

# Checks for typedefs, structures, and compiler characteristics.

# Checks for library functions.

AC_OUTPUT

configure.scan 中参数说明

AC_PREREQ	autoconf 最低版本，如果你使用的版本比预设的要低，就在标准错误输出打印一条错误消息并不会创建configure
AC_INIT	初始化,定义软件的基本信息,包括设置包的全称,版本号以及报告BUG时需要用的邮箱地址
AC_CONFIG_SRCDIR	用来侦测所指定的源码文件是否存在，来确定源码目录的有效性
AC_CONFIG_HEADER	用于生成config.h文件，以便autoheader使用
AC_OUTPUT	创建输出文件。在`configure.in'的末尾调用本宏一次。
AM_INIT_AUTOMAKE	它是 automake 所必备的宏，默认没有，需要我们自行添加

第二步：我们需要更改 configure.scan 中 AC_INIT、AC_OUTPUT 并添加 AM_INIT_AUTOMAKE，更改后 configure.scan 文件内容如下：

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

AC_PREREQ([2.69])
AC_INIT(test, 1.0, xxxxx@gmail.com)
AC_CONFIG_SRCDIR([main.c])
AC_CONFIG_HEADERS([config.h])
AM_INIT_AUTOMAKE(test, 1.0)

# Checks for programs.
AC_PROG_CC

# Checks for libraries.

# Checks for header files.
AC_CHECK_HEADERS([stdlib.h string.h])

# Checks for typedefs, structures, and compiler characteristics.

# Checks for library functions.

AC_OUTPUT([Makefile])

第三步：将 configure.scan 文件重命名未 configure.ac 并运行 aclocal, 生成一个“aclocal.m4”文件和一个缓冲文件夹autom4te.cache，该文件主要处理本地的宏定义。此时文件目录如下：

qczl@DESKTOP-HP-ZHAN:automake$ ls
aclocal.m4  autom4te.cache  autoscan.log  configure.ac  configure.scan  main.c

第四步：运行 autoconf, 目的是生成 configure。此时的文件目录如下：

qczl@DESKTOP-HP-ZHAN:automake$ ls
aclocal.m4  autom4te.cache  autoscan.log  configure  configure.ac  configure.scan  main.c

第五步：运行 autoheader，它负责生成config.h.in文件。该工具通常会从“acconfig.h”文件中复制用户附加的符号定义，因此此处没有附加符号定义，所以不需要创建“acconfig.h”文件。此时文件目录如下：

qczl@DESKTOP-HP-ZHAN:automake$ ls
aclocal.m4  autom4te.cache  autoscan.log  config.h.in  configure  configure.ac  configure.scan  main.c

第六步：创建一个 Makefile.am. 这一步是创建Makefile很重要的一步，automake要用的脚本配置文件是Makefile.am，用户需要自己创建相应的文件。之后，automake工具转换成Makefile.in。文件内容如下：

qczl@DESKTOP-HP-ZHAN:automake$ cat Makefile.am
AUTOMAKE_OPTIONS=foreign

bin_PROGRAMS=main

main_SOURCES=main.c

Makefile.am 中的参数说明

AUTOMAKE_OPTIONS	设置automake的选项。由于GNU对自己发布的软件有严格的规范，比如必须附 带许可证声明文件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 --add-missing 此时文件目录如下：

qczl@DESKTOP-HP-ZHAN:automake$ ls
Makefile.am  Makefile.in  aclocal.m4  autom4te.cache  autoscan.log  compile  config.h.in  configure  configure.ac  configure.scan  depcomp  install-sh  main.c  missing

第八步：执行 ./configure 生成 Makefile。此时文件目录如下：

qczl@DESKTOP-HP-ZHAN:automake$ ls
Makefile     Makefile.in  autom4te.cache  compile   config.h.in  config.status  configure.ac    depcomp     main.c   stamp-h1
Makefile.am  aclocal.m4   autoscan.log    config.h  config.log   configure      configure.scan  install-sh  missing

第九步：执行 make 生成最终的可执行程序。可以看到最终生成了可执行程序 main

之后执行以下 main 看下运行效果：

第十步：（可选）如果你的软件包需要给被人使用，则可以执行 make dist 或者 make distcheck 命令将你的代码打包成压缩包。

        make dist ： 只打包，打包过程中不检查错误

        make distcheck ： 打包，并且检查错误

打包后文件目录如下图所示：压缩包的名字由 configure.ac 文件中的 AM_INIT_AUTOMAKE 宏控制。

 压缩包中的内容如下：