说明
从零开始编写automake工程非常复杂也没有必要,我们只要能看懂开源项目的automake即可,然后根据自己实际情况进行修改即可,下面给出两个比较好的参考项目,其中spice-gtk涵盖了使用libtool生成动态库的方法,后面所有的教程都是根据这两个模板进行改编
spice-gtk
virt-viewer
宏 |
作用 |
示例 |
AC_PREREQ |
autoconf最低版本 |
AC_PREREQ([2.69]) |
AC_INIT |
初始化包信息,将会自动生成PACKAGE_NAME、PACKAGE_VERSION、PACKAGE_BUGREPORT宏 |
AC_INIT([Porject], [1.0], [fwdssg.love@163.com]) |
AC_CONFIG_SRCDIR |
通过检测目录中必定存在的文件来判断目录是否存在 |
AC_CONFIG_SRCDIR([src/main.cpp]) |
AC_CONFIG_HEADERS |
生成config.h文件保存configure.ac定义的宏,此文件可被源文件包含 |
AC_CONFIG_HEADERS([config.h]) |
AC_CONFIG_MACRO_DIRS |
指定本地宏文件的存放目录,.m4后缀的文件都将被保存进此目录,acloacl命令会自动创建此目录 |
AC_CONFIG_MACRO_DIRS([m4]) |
AC_CONFIG_AUX_DIR |
指定辅助脚本文件的存放目录 |
AC_CONFIG_AUX_DIR([build-aux]) |
AC_MSG_CHECKING |
打印"checking XXX ..." |
AC_MSG_CHECKING([for native Win32]) |
AC_MSG_RESULT |
打印checking结果并另起新行 |
AC_MSG_RESULT([$os_win32]) |
AC_PROG_INSTALL |
生成安装脚本 install-sh |
AC_PROG_INSTALL |
AC_PROG_LIBTOOL |
使得configure能够支持--enable-shared、--disable-shared、--enable-static、--disable-static、--with-pic和--without-pic参数 |
AC_PROG_LIBTOOL |
AC_PROG_CXX |
自动检测要使用的C++编译器 |
AC_PROG_CXX |
AC_PROG_CC |
自动检测要使用的C编译器 |
AC_PROG_CC |
AC_CHECK_HEADERS |
检测系统头文件是否存在 |
AC_CHECK_HEADERS([sys/socket.h netinet/in.h arpa/inet.h]) |
AC_SUBST |
输出能够被Makefile.am使用的变量 |
AC_SUBST(GLIB2_CFLAGS) |
AC_CONFIG_SUBDIRS |
configure子目录 |
AC_CONFIG_SUBDIRS([spice-common]) |
PKG_CHECK_MODULES |
检测对应模块是否存在 |
PKG_CHECK_MODULES([SPICE_PROTOCOL], [spice-protocol >= 0.12.11]) |
AC_CHECK_FUNCS |
检测对应函数是否可用 |
AC_CHECK_FUNCS([setlocale]) |
AC_ARG_ENABLE |
为configure添加--XX选项 |
AC_ARG_ENABLE([gstaudio],AS_HELP_STRING([--enable-gstaudio=@<:@yes/auto/no@:>@], [Enable the GStreamer 1.0 audio backend @<:@default=auto@:>@]),[],[enable_gstaudio="auto"]) |
AC_OUTPUT |
运行configure后生成的config脚本需要处理的文件,将Makefile.in变成Makefile |
AC_OUTPUT([Makefile]) |
AM_INIT_AUTOMAKE |
初始化automake |
AM_INIT_AUTOMAKE([subdir-objects -Wno-portability]) |
AM_GNU_GETTEXT |
初始化gettext |
AM_GNU_GETTEXT([external]) |
AM_GNU_GETTEXT_VERSION |
指定gettext最低版本 |
AM_GNU_GETTEXT_VERSION([0.19.7]) |
IT_PROG_INTLTOOL |
初始化并指定libtool最低版本 |
IT_PROG_INTLTOOL([0.35.0]) |
AM_CONDITIONAL |
根据条件来定义宏 |
AM_CONDITIONAL([OS_WIN32],[test "$os_win32" = "yes"]) #如果$os_win32的值为yes则#define OS_WIN32宏 |
Makefile.am宏定义说明
宏 |
作用 |
示例 |
ACLOCAL_AMFLAGS |
指定宏文件的存放目录,与AC_CONFIG_MACRO_DIRS成配合使用 |
ACLOCAL_AMFLAGS = -I m4 |
SUBDIRS |
指定需要递归automake的子文件夹,即存在Makefile.am的子文件夹 |
SUBDIRS = spice-common src man po doc data |
EXTRA_DIST |
指定要被打包的额外文件,即执行make dist 时需要被放入压缩包的文件,一般是不需要参与编译但是又需要被使用的文件,比如图片目录里的图片 |
EXTRA_DIST = $(PACKAGE).spec |
DISTCLEAN_FILES |
执行make distclean 时候需要删除的文件,一般是EXTRA_DIST中的.in文件生成的不需要打包的中间文件 |
DISTCLEAN_FILES = $(PACKAGE).spec |
MAINTAINERCLEANFILES |
执行make maintainer-clean时候需要删除的文件,即执行autoreconf -vfi 、intltoolize --force 以及configure 或执行autogen.sh 后能够重新生成的文件都要放入其中 |
MAINTAINERCLEANFILES = $(srcdir)/AUTHORS |
dist-hook |
执行make dist 时需要执行的脚本 |
dist-hook: gen-ChangeLog gen-AUTHORS |
bin_PROGRAMS |
要生成的可执行文件 |
bin_PROGRAMS = spicy |
XX_SOURCES |
编译可执行文件所需的源文件 |
spicy_SOURCES = spicy.c |
XX_LIBADD |
链接参数,即pkg-config --libs 的结果 |
spicy_stats_LDADD = libspice-client-glib-2.0.la |
XX_CFLAGS |
编译参数,即pkg-config --cflags 的结果和-D 之类的宏定义 |
libvirt_viewer_la_CFLAGS = -DLOCALE_DIR=""./../share/locale"" $(GLIB2_CFLAGS) |
nodist_XX_SOURCES |
执行make dist 时不需要被打包的源文件,一般是根据其他源文件通过脚本临时生成的中间源文件,比如使用glib-genmarshal 生成的文件 |
nodist_libspice_client_glib_2_0_la_SOURCES = spice-marshal.c spice-marshal.h |
LDADD |
无法被configure找到但是又需要链接的库或资源文件,例如临时生成的windows下使用的rc文件 |
LDADD += virt-viewer_rc.$(OBJEXT) |
dist_XX_DATA |
程序运行需要的数据文件,比如图标、配置文件等 |
dist_cfg_DATA = xx.cfg |
dist_bin_SCRIPTS |
程序的脚本文件,将被安装到bin目录 |
dist_bin_SCRIPTS = xx.sh |
实际问题处理
# 在对应源文件的Makefile.am中添加
CPPFLAGS = -DSYSCONFDIR='"$(sysconfdir)"'
# 编辑POTFILES.in文件
[type: gettext/glade] src/filename.glade
- 语言国际化textdomain加载成功但是程序却没翻译
# Ubuntu
语言必须带后缀.utf8,即LANG=zh_CN.utf8而不能直接使用LANG=zh_CN
# Fedora
使用系统头文件#include <glib/gi18n.h>,而不要自定义