A.2 使用 qmake

qmake 工具是与 Qt 一起提供的。它用来编译 Qt 本身，并且生成 Qt 自带的工具和例 子。贯穿整书，我们一直使用 qmake 工程文件（.pro 文件）编译示例应用程序。本附录将 系统（但非全面）的学习.pro 文件的语法，并且会介绍几个 qmake 的基本概念。要想全面 了解它们，请参阅 qmake 指南的在线帮助文档。

A.2.1 .pro 文件语法

.pro 文件的目的是列举工程中包含的源文件。由于 qmake 用于编译 Qt 及其相关工具， 所以它很熟悉 Qt，并且能够生成一些触发 moc、uic、和 rcc 的规则。因此，qmake 的语法 很简明，而且很容易学习。

工具文件主要分为三种：app（单独的应用程序）、lib（静态和动态库）和 subfirs（递归编译）。工程文件的类型可以使用 TEMPLATE 变量指定如下：

TEMPLATE = lib

subdirs 模板可以用来编译子目录里的目标文件。在这种情况下，除 TEMPLATE = subdirs 外，还需要指定 SUBDIRS 变量。在每个子目录中，qmake 会搜寻以目录名命名 的.pro 文件，并且会编译该工程。如果没有 TEMPLATE 这一项，那么默认工程是 app。对于

app 或者 lib 工程，最常用使用的变量是下面这些：

  • HEADERS 指定工程的 C++头文件（.h）。
  • SOURCES 指定工程的Ｃ++实现文件（.cpp）。
  • FORMS 指定需要 uic 处理的由 Qt 设计师生成的.ui 文件。
  • RESOURCES 指定需要 rcc 处理的.qrc 文件。
  • DEFINES 指定预定义的 C++预处理符号。
  • INCLUDEPATH 指定 C++编译器搜索全局头文件的路径。
  • LIBS 指定工程要链接的库。库既可以通过绝对路径指定，也可以使用源自 Unix 的- L 和-l 标识符来指定（例如，-L/usr/local/lib 和-ldb_cxx）。
  • CONFIG 指定各种用于工程配置和编译的参数。
  • QT 指定所要使用的 Qt 模块（默认是 core gui，对应于 QtCore 和 QtGui 模块）。
  • VERSION 指定目标库的版本号。
  • TARGET 指定可执行文件或库的基本文件名，其中不包含任何的扩展、前缀或版本 号（默认的是当前的目录名）。
  • DESTDIR 指定可执行文件放置的目录（默认值是平台相关的。例如，在 Linux 上，指当前目录；在 Windows 上，则是指 debug 或 release 子目 录）。
  • DLLDESTDIR 指定目标库文件放置的目录（默认路径与 DESTDIR 相同）。
  • CONFIG 变量用来控制编译过程中的各个方面。它支持下面这些参数：
    • debug 是指具有调试信息的可执行文件或者库，链接 Qt 库的调试版。
    • release 是指编译不具有调试信息的可执行文件或者库，链接发行版的 Qt 库。如果 同时指定 debug 和 release，则 debug 有效。
    • warn_off 会关闭大量的警告。默认情况下，警告的状态是打开的。
    • qt 是指应用程序或者库使用 Qt。这一选项是默认包括的。
    • dll 是指动态编译库。
    • staticlib 是指静态编译库。
    • plugin 是指编译一个插件。插件总是动态库，因此这一参数暗含 dll 参数。
    • console 是指应用程序需要写控制台（使用 cout、cerr、qWarning()，等等）。
    • app_bundle 只适用于 Mac OS X 编译，是指可执行文件被放到束中，这是 Mac OS X 的默认情况。
    • lib_bundle 只适用于 Mac OS X 编译，指库被放到框架中。

要生成工程文件 hello.pro 的 makefile，可以输入：

qmake hello.pro

在这之后，可以调用 make 或 nmake 编译工程。通过键入以下命令，也可以使用 qmake 生成一个 Microsoft Visual Studio 工程（.dsp 或.vproj）文件：

qmake -tp vd hello.pro

在 Mac OS X 系统上，可以创建一个 Xcode 工程文件：

qmake -spec macx-xcode hello.pro

要创建 makefile，可以输入：

qmake -spec macx-g++ hello.pro

这里的-spec 命令行参数可以用来指定平台/编译器的组合。通常，qmake 可以正确的检测到所在的平台，但在某些情况下则由必要显式的指定平台的情况。例如，在 Linux 上 以 64 位模式调用 Intel C++编译器（ICC）生成 makefile，应当输入：

qmake -spec linux-icc-64 hello.pro

那些可用的规则在 Qt 的 mkspecs 目录中。

尽管 qmake 的主要用途是生成.pro 文件的 makefile，但也可以使用-project 参数在当 前目录下使用 qmake 生成.pro 文件，例如：

qmake -project

在这种模式下，qmake 将搜索当前目录下已知扩展名（.h、.cpp、.ui 等等）的文件，生成一个列举这些文件的.pro 文件。

本附录的余下部分将更详细的介绍.pro 文件的语法。一个.pro 文件中的条目的语法通 常具有如下形式：

variable = values

values 是字符串的列表。注释以井号（#）开头，在行尾处结束。例如：

CONFIG = qt release warn_off # I know what I'm doing

将列表["qt"，"release"，"warn_off"]赋给 CONFIG 变量，它会覆盖以前的各个值。

额外的操作符作为=操作符的补充。+=操作符可以用来扩展变量的值。因此：

CONFIG = qt
CONFIG += release
CONFIG += warn_off

这几行会和前面的例子一样，可以有效的把列表 ["qt"，"release"，"warn_off"] 赋值给 CONFIG 变量。-=操作符从当前的变量中移除所有出现的指定的值。因此：

CONFIG = qt realease warn_off
CONFIG -= qt

会使 CONFIG 的值变成["release"，"warn_off"]。*=操作在一个变量上添加一个值，但要求被添加的值不在变量的列表上；否则，就什么都不做。例如：

SOURCE *= main.cpp

这一行将把 main.cpp 实现文件添加到工程中，只有当还没有被添加的情况下才添加它。最后，=操作符使用指定的值替换符合正则表达式的值，这是一种类似于 sed（UNIX 流 编辑器）的语法。

例如：

SOURCE ~= s/\.cpp\b/.cxx/

使用.cxx 替换 SOURCES 变量中所有.cpp 文件的扩展名。

在值的列表中，qmake 提供了访问其他 qmake 变量、环境变量和配置参数的方法。表附 录 A-1 列举了这些语法。

表附录 A-1 qmake 变量语法

存取函数 说明
$$var/Name 或者$${varName} .pro 文件中 qmake 变量在那一时刻的值
$$(varName) 当 qmake 运行时环境变量的值
$(varName) 当处理 makefile 时环境变量的值
$$[varName] Qt 的配置参数值

A.2.2 qmake 的存取函数

前面的例子中使用的总是一些标准变量，例如 SOURCES 和 CONFIG，然而，我们也可以 设置任意变量的值，并且可以使用 $$varName 或者$${varName}语法引用它。例如：

MY_VRESION = 1.2
SOURCE_BASIC = alphadialog.cpp \
main.cpp \
windowpanel.cpp
SOURCE_EXTRA = bezierextension.cpp \
xplot.cpp
SOURCES = $$SOURCES_BASIC \
$$SOURCES_EXTRA
TARGET = imgpro_$${MY_VERSION}

接下来的例子组合了前面介绍的几种语法，使用内置函数 $$lower()把字符串转换为小写：

# List of classes in the project
MY_CLASS = Annotation \
CityBlock \
CityScape \
CityView
# Append .cpp extension to lowercased class names,and add main.cpp
SOURCES = $$lower($$MY_CLASSES)
SOURCES ~= s/([a-z0-9_]+)/\1.cpp/
SOURCES += main.cpp
# Append .h extension to lowercased class names
HEADERS = $$lower($$MY_CLASSES)
HEADERS ~= s/([a-z0-9_]+)/\1.h/

有时可能需要在.pro 文件中指定包含空格的文件名。在这种情况下，只需简单的把文件名用引号括起来即可。

当在不同的平台上编译工程时，可能有必要基于平台指定不同的文件或者不同的参 数。qmake 的条件语法是：

condition
{
    then-case
}
else
{
    else-case
}

condition 部分可以是平台名字（例如，win32、unix、或者 macx），或者更复杂的断言。then-case 和 else-case 部分使用标准语法为变量赋值。例如：

win32
{
    SOURCES += serial_win.cpp
}
else
{
    SOURCES += serial_unix.cpp
}

else 分支是可选的。为了方便，当 then-case 部分仅有一条变量赋值，而且在没有 else-case 分支时，qmake 也支持单行形式的语法：

condition:then-case

例如：

macx:SOURCE += serial_mac.cpp

如果有几个工程文件需要共享相同的项，则可以把相同的项提取到单独的文件中，在各自的.pro 文件中使用 include()语句包含它们：

include(../common.pri)
HEADERS += window.h
SOURCES += main.cpp \
window.cpp

通常，打算被别的工程文件所包含的工程文件会带有 .pri（工程包含）的扩展名。

在前面的例子中，我们了解了$$lower()内置函数，它可以返回参数的小写版本。另外 一个有用的函数是$$system()，它允许我们从外部应用程序中产生字符串。例如，如果想要 确认当前使用的 UNIX 版本，可以这样写：

OS_VERSION = $$ system(uname -r)

然后，可以在条件中使用结果变量，并与 contains()合用：

contains(OS_VERSION,SunOS):SOURCES += mythread_sun.c

本附录只讲了一些表面的东西。qmake 工具提供了许多参数和特性，远多于这里所讲到的这些，包括对预编译头文件的支持、对 Mac OS X 通用二进制库的支持以及对用户定义的 编译器或者其他工具的支持等。对于这方面更多信息的了解，可以参阅 qmake 指南在线帮助文档。