[系统运维]qmake 4.8使用

SOURCES = main.cpp mainwindow.cpp \
          paintwidget.cpp
CONFIG += qt

win32:INCLUDEPATH += "C:/mylibs/extra headers"
unix:INCLUDEPATH += "/home/user/extra headers"

# Comments usually start at the beginning of a line, but they
# can also follow other content on the same line.

win32 {
        SOURCES += paintwidget_win.cpp}

EXTRAS = handlers tests docsfor(dir, EXTRAS) {
        exists($$dir) {
        SUBDIRS += $$dir
        }}

CONFIG(opengl) {
        message(Building with OpenGL support.)} else {
        message(OpenGL support is not available.)}

CONFIG += qt
QT += network xml

CONFIG += link_pkgconfig
PKGCONFIG += ogg dbus-1

TEMPLATE = lib
CONFIG += lib_bundle

FRAMEWORK_HEADERS.version = Versions
FRAMEWORK_HEADERS.files = path/to/header_one.h path/to/header_two.h
FRAMEWORK_HEADERS.path = Headers
QMAKE_BUNDLE_DATA += FRAMEWORK_HEADERS

TARGET.EPOCHEAPSIZE = 10000 10000000
TARGET.EPOCSTACKSIZE = 0x8000

QMAKE_CXXFLAGS.CW += -O2
QMAKE_CXXFLAGS.ARMCC += -O0

TARGET.UID2 = 0x00000001
TARGET.UID3 = 0x00000002
TARGET.SID = 0x00000003
TARGET.VID = 0x00000004

EVERYTHING = $$SOURCES $$HEADERS
message("The project contains the following files:")
message($$EVERYTHING)

<condition> {
        <command or definition>
        ...
}

win32 {
        SOURCES += paintwidget_win.cpp}

!win32 {
        SOURCES -= paintwidget_win.cpp}

macx {
        debug {
            HEADERS += debugging.h
        }}

macx:debug {
        HEADERS += debugging.h}

win32|macx {
        HEADERS += debugging.h}

win32:xml {
        message(Building for Windows)
     SOURCES += xmlhandler_win.cpp} else:xml {
         SOURCES += xmlhandler.cpp} else {
        message("Unknown configuration")}

opengl {
        TARGET = application-gl} else {
        TARGET = application}

message($$QMAKESPEC)
linux-g++ {
        message(Linux)}

DESTDIR = $$(PWD)
message(The project will be installed in $$DESTDIR)

DESTDIR = $$(PWD)
message(The project will be installed in $$DESTDIR)

DESTDIR = $(PWD)
message(The project will be installed in the value of PWD)
message(when the Makefile is processed.)

在上述代码中，当工程文件被处理时，PWD的值会被立即读取，但$(PWD)会在生成的MakeFile文件中被赋值给DESTDIR变量。这使得构建过程更加灵活，只要在处理MakeFile文件时环境变量被正确设置。
特殊的$$[...]操作符被用于访问Qt构建时的多个配置选项。

message(Qt version: $$[QT_VERSION])
message(Qt is installed in $$[QT_INSTALL_PREFIX])
message(Qt resources can be found in the following locations:)
message(Documentation: $$[QT_INSTALL_DOCS])
message(Header files: $$[QT_INSTALL_HEADERS])
message(Libraries: $$[QT_INSTALL_LIBS])
message(Binary files (executables): $$[QT_INSTALL_BINS])
message(Plugins: $$[QT_INSTALL_PLUGINS])
message(Data files: $$[QT_INSTALL_DATA])
message(Translation files: $$[QT_INSTALL_TRANSLATIONS])
message(Settings: $$[QT_INSTALL_SETTINGS])
message(Examples: $$[QT_INSTALL_EXAMPLES])
message(Demonstrations: $$[QT_INSTALL_DEMOS])

使用这个操作符访问的变量通常用于使第三方插件与组件集成。例如，如果工程文件中有下列声明，Qt Designer插件可以与Qt Designer内置插件一起安装。

target.path = $$[QT_INSTALL_PLUGINS]/designer
INSTALLS += target

5、变量处理函数

qmake提供了一个内置函数的选择，以允许变量的内容被处理。内置函数处理被提供的参数，将值或值列表作为结果返回。为了将内置函数结果赋值给变量，必须对内置函数使用$$操作符，就像将一个变量的内置赋值给另一个变量一样。

HEADERS = model.h
HEADERS += $$OTHER_HEADERS
HEADERS = $$unique(HEADERS)

内置函数应该用于操作符的右侧。
可以自定义一个函数处理变量内容。自定义函数按如下定义：

defineReplace(functionName){
        #function code}

下列函数使用一个变量作为唯一参数，使用eval内置函数从变量中提取出了一个值列表，并且编辑了值列表。

defineReplace(headersAndSources) {
    variable = $$1
    names = $$eval($$variable)
    headers =
    sources =
for(name, names) {
    header = $${name}.h
    exists($$header) {
        headers += $$header
    }
    source = $${name}.cpp
    exists($$source) {
        sources += $$source
    }
}
return($$headers $$sources)}</code></pre> 

6、条件判断函数

qmake提供了用于编写作用域时作为条件的内置函数。这些内置函数不会返回一个值，而是指明成功或失败。

count(options, 2) {
        message(Both release and debug specified.)}

这些内置函数只能用于条件表达式。
可以自定义函数提供作用域的条件。下列代码用于测试一个列表中的每个文件是否存在，如果所有的文件都存在，返回true；否则返回false。

defineTest(allFiles) {
        files = $$ARGS
    for(file, files) {
        !exists($$file) {
            return(false)
        }
    }
    return(true)}</code></pre> 

7、增加新的配置特性

Qmake允许用户创建自己的特性，增加到工程文件中，通过增加名称到CONFIG变量的值列表中。

六、QMake预编译头文件

1、预编译头文件简介

预编译头文件是一些编译器支持的一种性能特性，用于编译稳定的代码体，并将代码的编译状态存储在二进制文件中。在后续编译过程中，编译器将加载存储状态，并继续编译指定的文件。每个后续编译速度更快，因为不需要重新编译稳定的代码。qmake支持在某些平台上使用预编译头文件（PCH）和构建环境。
Windows平台：

nmake
Dsp projects (VC 6.0)
Vcproj projects (VC 7.0 & 7.1)

Mac OS X平台：

Makefile
Xcode

Unix平台：
GCC 3.4及以上版本

2、增加预编译头文件到工程

A、预编译头文件的注释
预编译头必须包含在整个工程中稳定和静态的代码。典型的PCH如下：

// Add C includes here

#if defined __cplusplus
// Add C++ includes here
#include <stdlib>
#include <iostream>
#include <vector>
#include <QApplication> // Qt includes
#include <QPushButton>
#include <QLabel>
#include "thirdparty/include/libmain.h"
#include "my_stable_class.h"
…
#endif

注意：预编译头文件需要从C++包含中分离出C包含，因为C文件的预编译头文件可能不包含C++代码。
B、工程选项
要在工程中使用预编译头文件，只需要在工程文件中定义PRECOMPILED_HEADER变量即可。
PRECOMPILED_HEADER = stable.h
qmake会处理其余事情，确保创建和使用预编译头文件。开发者不需要在HEADERS中包含预编译头文件，因为如果配置支持PCH，qmake会这样做。
默认情况下，Windows（以及Windows CE）为目标的MSVC和G++规范会通过precompile_header开启预编译。
使用precompile_header选项，可以在工程文件中触发条件代码块，以便在使用预编译头时添加设置。

precompile_header:!isEmpty(PRECOMPILED_HEADER) {
DEFINES += USING_PCH}

3、注意事项

在某些平台上，预编译头文件的文件名后缀与其他对象文件的文件名后缀相同。例如，下面的声明可能会导致两个不同的对象文件生成相同的名称：

PRECOMPILED_HEADER = window.h
SOURCES            = window.cpp

为了避免像这样的潜在冲突，确保将预编译的头文件赋予不同的名称是一种很好的工程实践。

4、工程实例

下列代码可以在Qt发布版的examples/qmake/precompile目录下可以找到。
mydialog.ui文件：

<ui version="4.0" >
 <author></author>
 <comment></comment>
 <exportmacro></exportmacro>
 <class>MyDialog</class>
 <widget class="QDialog" name="MyDialog" >
  <property name="geometry" >
   <rect>
    <x>0</x>
    <y>0</y>
    <width>401</width>
    <height>70</height>
   </rect>
  </property>
  <property name="windowTitle" >
   <string>Mach 2!</string>
  </property>
  <layout class="QVBoxLayout" >
   <property name="margin" >
    <number>9</number>
   </property>
   <property name="spacing" >
    <number>6</number>
   </property>
   <item>
    <widget class="QLabel" name="aLabel" >
     <property name="text" >
      <string>Join the life in the fastlane; - PCH enable your project today! -</string>
     </property>
    </widget>
   </item>
   <item>
    <widget class="QPushButton" name="aButton" >
     <property name="text" >
      <string>&Quit</string>
     </property>
     <property name="shortcut" >
      <string>Alt+Q</string>
     </property>
    </widget>
   </item>
  </layout>
 </widget>
 <pixmapfunction>qPixmapFromMimeSource</pixmapfunction>
 <resources/>
 <connections/>
</ui>

stable.h文件：

/* Add C includes here */

#if defined __cplusplus
/* Add C++ includes here */

include <iostream>

include <QApplication>

include <QPushButton>

include <QLabel>

#endif

myobject.h文件：

#include <QObject>

class MyObject : public QObject
{
public:
MyObject();
~MyObject();
};

myobject.cpp文件：

#include <iostream>
#include <QDebug>
#include <QObject>
#include "myobject.h"

MyObject::MyObject()

QObject()
{
std::cout << "MyObject::MyObject()\n";
}

util.cpp文件：

void util_function_does_nothing()
{
    // Nothing here...
    int x = 0;
    ++x;
}

main.cpp文件：

#include <QApplication>
#include <QPushButton>
#include <QLabel>
#include "myobject.h"
#include "mydialog.h"

int main(int argc, char **argv)
{
QApplication app(argc, argv);

MyObject obj;
MyDialog dialog;

dialog.connect(dialog.aButton, SIGNAL(clicked()), SLOT(close()));
dialog.show();

return app.exec();

}

precompile.pro文件：

TEMPLATE  = app
LANGUAGE  = C++
CONFIG   += console precompile_header

Use Precompiled headers (PCH)

PRECOMPILED_HEADER = stable.h

HEADERS = stable.h
mydialog.h
myobject.h
SOURCES = main.cpp
mydialog.cpp
myobject.cpp
util.cpp
FORMS = mydialog.ui

七、QMake变量

1、QMake变量简介

QMake的基本行为受定义在工程构建过程中声明的变量的影响。某些变量用于声明资源，如每个平台中通用的头文件、源文件，其它变量用于定义指定平台中的编译器和链接器中的行为。
平台特定变量遵循变量扩展或修改的命名模式，但在其名称中包含相关平台的名称。例如，QMAKE_LIBS用于指定工程需要链接的库的列表，QMAKE_LIBS_X11用于扩展或覆写这个列表。

2、常用QMake变量

CONFIG
CONFIG变量用于指定工程配置和编译器选项。CONFIG变量的值会被qmake内部识别并有特殊的意义。
下列CONFIG值用于控制编译选项：
release：工程会以release模式构建，如果指定了debug，会被忽略。
debug：工程会被debug模式构建
debug_and_release：工程会以debug和release两种模式构建，会有一些意想不到的副作用。
build_all：如果指定了debug_and_release，工程默认会以debug和release两种模式构建
ordered：当使用subdirs模板时，本选项指定列出的子目录会以给出的顺序被处理
precompile_header：在工程中支持预编译头文件的使用
warn_on：编译器应该输出尽可能多的警告信息，如果指定warn_off，本选项会会忽略。
warn_off：编译器应该输出尽可能少的警告信息
由于 CONDIG变量中定义debug和release两个选项时，debug选项会覆盖release选项，如果想要使用debug和release两种模式构建工程，使用debug_and_release选项。此时，qmake会生成包含构建两种版本的规则的MakeFiles，使用make all可以调用。
当链接库时，qmake依赖于底层平台来了解库中链接的其它库。但是，如果是静态链接，除非使用下列的CONFIG选项，否则qmake不会得到这些信息。
create_prl：本选项使qmake能够追踪这些依赖关系。当本选项开启，qmake会创建一个以.prl结尾的文件，用于保存有关库的元信息。
link_prl：当本选项开启时，qmake会处理所有链接到应用程序的库，并找出他们的元信息。
注意：构建一个静态库时，需要使用create_prl；使用一个静态库时，需要使用link_prl。

DEFINES
qmake会将DEFINES变量的值作为C编译器预处理宏（-D）添加。
例如：DEFINES += USE_MY_STUFF QT_DLL

DEPENDPATH
此变量包含要查找依赖关系的所有目录的列表，会在查找包含文件时候使用。
DESTDIR
指定输出目标文件的目录

DESTDIR_TARGET
本变量是由qmake内部设置的，基本是DESTDIR变量加上TARGET变量作为结尾。本变量的值通常由qmake或qmake.conf处理，并且很少需要修改。

DLLDESTDIR
指定dll目标文件拷贝到的地方

FORMS
本变量指定在编译前，uic要处理的UI文件。为了构建这些UI文件自动增加到工程，需要所有的依赖、头文件、源文件。

HEADERS
定义工程的头文件。qmake会为指定头文件生成依赖信息。如果头文件中需要moc，qmake也会自动检测，为了生成和链接moc文件，会增加相应的依赖和文件到工程。

HEADERS = myclass.h \
          login.h \
          mainwindow.h

INCLUDEPATH
本变量指定编译时需要查找搜索的inlucde路径。
为了指定一个包含空格的路径，将路径使用引号括起来。

win32:INCLUDEPATH += "C:/mylibs/extra headers"
unix:INCLUDEPATH += "/home/user/extra headers"

INSTALLS
本变量包含当make install或是类似的安装过程被执行时，要被安装的资源列表。INSTALLS值列表中的每个项会通常会使用属性定义，属性提供安装在哪儿的相关信息。
例如，下列代码target.path定义描述了构建目标被安装的路径，增加构建目标到INSTALLS会将构建目标加入要安装的资源列表中。

target.path += $$[QT_INSTALL_PLUGINS]/imageformats
INSTALLS += target

注意：qmake会忽略可执行文件，如果需要安装可执行文件，可以取消文件的可执行属性标识。

LIBS
本变量包含链接到工程的库列表。可以使用Unix平台-l(library)和-L(library path)的标识，qmake会正确处理Windows和Symbian平台上的这些库。例如：

unix:LIBS += -L/usr/local/lib -lmath
win32:LIBS += c:/mylibs/math.lib

注意：在Windows平台，使用-l选项指定库会使用最高版本的库。例如，math2.lib可能会潜在使用，替换math.lib。为了便面这种模糊性，推荐显示的指定库，通过使用包含库文件后缀.lib的文件名。
为了指定包含空格的路径，将路径使用引号括起来。

win32:LIBS += "C:/mylibs/extra libs/extra.lib"
unix:LIBS += "-L/home/user/extra libs" -lextra

默认情况下，使用库前，存储在LIBS变量中的库列表会被简化为唯一名称的列表。为了改变这种行为，可以使用在CONFIG变量使用no_lflags_merge选项。

MOC_DIR
本变量指定临时moc文件的存放路径。例如，

unix:MOC_DIR = ../myproject/tmp
win32:MOC_DIR = c:/myproject/tmp

PRECOMPILED_HEADER
为了加快工程的编译速度，本变量会为创建一个预编译头文件指明一个头文件。预编译头文件目前只支持某些平台（Windows所有MSVC工程类型, Mac OS X - Xcode, Makefile, Unix - gcc 3.3+版本）。

PWD
本变量指定指向当前文件被解析的目录的全路径。为了支持影子构建，编写工程文件时在源码树引用文件时会有用。

OUT_PWD
本变量包含指向生成MakeFile文件的目录的全路径

QMAKE
本变量包含qmake程序自己的名字，会放在生成的MakeFile文件中。

QMAKESPEC
当生成MakeFile时，本变量包含qmake配置要使用的名称。
使用QMAKESPEC环境变量会覆盖qmake配置。注意，由于qmake读取工程文件的方式，在工程文件内设置QMAKESPEC变量会没有效果。

QT
QT变量中存储的值用于控制工程中使用的Qt模块。
core：默认包含，QtCore模块
gui：默认包含，QtGui模块
network：QtNetwork模块
opengl：QtOpenGl模块
phonon：Phonon多媒体框架
sql：QtSql模块
svg：QtSvg模块
xml：QtXml模块
webkit：QtWebkit模块
默认，QT包含core和gui模块，在没有进一步配置的情况下确保构建一个GUI应用程序。
如果想要构建一个没有QtGui模块的工程，需要使用“-=”将gui排除。如：
QT -= gui # Only the core module is used
注意：增加opengl选项到QT变量会自动将相应的选项增加到CONFIG变量。因此，对于应用程序来说，不必增加opengl选项到QT和CONFIG两个变量。

QTPLUGIN
本变量包含静态插件的名字列表

QT_VERSION
本变量包含当前Qt的版本

QT_MAJOR_VERSION
本变量包含当前Qt版本的主版本号

QT_MINOR_VERSION
本变量包含当前Qt版本的次版本号

RC_FILE
本变量包含应用程序的资源文件的名称

RESOURCES
本变量包含资源集合文件的名称（qrc）

SOURCES
本变量包含工程中所有源文件的名称，如：

SOURCES = myclass.cpp \
        login.cpp \
        mainwindow.cpp

SUBDIRS
此变量与subdirs模板一起使用时，指定包含需要构建的工程部分的所有子目录或工程文件的名称。使用此变量指定的每个子目录必须包含其自己的工程文件。
建议每个子目录中的工程文件与子目录本身具有相同的基名，因为这样可以省略文件名。例如，如果子目录是myapp，目录中的工程文件应用命名为myapp.pro。
或者，可以在任何目录中指定.pro文件的相对路径。强烈建议只在当前工程的父目录或其子目录中指定路径。例如：

SUBDIRS = kernel \
          tools \
          myapp

如果需要确保子目录按指定的顺序构建，需要在CONFIG 变量增加ordered选项。
CONFIG += ordered
通过修改附加的属性SUBDIRS的默认行为，支持的附加调节属性如下：
.subdir：使用指定的子目录取代SUBDIRS的值
.file：显示指定子工程的pro文件，不能与修饰符.subdir结合使用
.condition：指定bld.inf定义，如果子工程被构建，必须为true。
.depends：子工程依赖于指定的子工程，只对生成MakeFile的平台可用。
.makefile：子工程的MakeFile，只对生成MakeFile的平台可用。
.target：子工程相关的MakeFile目标的基字符串
例如，定义两个子目录，它们的值不同于SUBDIRS的值。

SUBDIRS += my_executable my_library
my_executable.subdir = app
my_executable.depends = my_library
my_library.subdir = lib

Visual Studio不支持ordered选项。

TARGET
本变量指定目标文件名称
TEMPLATE = app
TARGET = myapp
SOURCES = main.cpp
上述代码会在创建一个可执行文件myapp（Unix）和myapp.exe（Windows）。

TEMPLATE
本变量指定目标文件的名称。
app ：建立一个应用程序的Makefile，是默认值。
lib：建立一个库的Makefile。
vcapp：建立一个应用程序的Visual Studio项目文件。
vclib：建立一个库的Visual Studio项目文件。
subdirs：特殊的模板，
TRANSLATIONS
本变量包含翻译文件（.ts）列表，

VERSION
本变量用于包含应用程序或库的版本号。

八、QMake函数

1、QMake函数简介

QMake提供内置函数用于处理变量的内容以及在配置过程中进行测试。处理变量内容的函数通常会返回可赋值给其它变量的值，可以使用$$FuncionName获取函数的返回值；进行测试的函数通常作为作用域的条件部分使用。

2、替换函数

qmake提供了在配置过程中处理变量内容的函数。这些函数称为替换函数。通常，替换函数返回可以赋值给其它变量的值。可以通过在函数名称前使用$$操作符来获取这些值。

basename(variablename)
返回指定文件的基本文件名

FILE = /etc/passwd
FILENAME = $$basename(FILE) #passwd

dirname(file)
返回指定文件file中的目录部分

FILE = /etc/X11R6/XF86Config
DIRNAME = $$dirname(FILE) #/etc/X11R6

find(variablename, substr)
在variablename变量的所有值中查找匹配substr字符串的值，substr可能是正则表达式。

join(variablename, glue, before, after)
使用glue连接variablename变量中的值。如果变量的值非空，在值前面加一个前缀before，在值的后面加一个后缀after。Variablename是必须参数，其它参数默认是空字符串。如果需要在glue、before、after中对空格进行编码，必须对它们使用引号。

member(variablename, position)
返回variablename变量的值列表中position位置的值。如果在指定位置不能找到值项，返回一个空字符串。Variablename是必须参数，如果不指定position参数，position默认为0，返回variablename变量的值列表中的第一个值。

prompt(question)
显示指定的question，返回一个从stdin读取的值。

quote(string)
将整个string转换为单个实体，返回结果。这只是一种把字符串括上双引号的花样方法。

replace(string, old_string, new_string)
使用new_string替换在变量string中出现的old_string。如：

MESSAGE = This is a tent.
message($$replace(MESSAGE, tent, test))
sprintf(string, arguments...)

使用逗号分隔的函数参数arguments替换1%——9%，返回处理后的字符串。

unique(variablename)
返回变量中值的链表，如果有重复的删除。

ARGS = 1 2 3 2 5 1
ARGS = $$unique(ARGS) #1 2 3 5

3、测试函数

CONFIG(config)
本函数用来测试放置在CONFIG变量中的变量。这与常规旧式（tmake）作用域相同，但具有附加的优点，可以将第二个参数传递给活动配置进行测试。由于CONFIG变量中值的顺序是重要的，CONFIG的第二个参数用于指定要考虑的值的集合。例如：

CONFIG = debug
CONFIG += release
CONFIG(release, debug|release):message(Release build!) #will print
CONFIG(debug, debug|release):message(Debug build!) #no print

由于release作为活跃设置， CONFIG用于生成构建文件。在一般情况下，不需要第二个参数，但对于特定的互斥测试，这是非常宝贵的。

contains(variablename, value)
如果variablename变量包含value值，成功；否则，失败。可以使用作用域检查此函数的返回值。

contains( drivers, network ) {
        # drivers contains 'network'
        message( "Configuring for network build..." )
        HEADERS += network.h
        SOURCES += network.cpp}

上述代码只有在drivers变量包含network值的条件下，作用域才会被处理。

count(variablename, number)
如果variablename变量包含指定数量number的值列表，成功；否则，失败。
本函数用于确保作用域内的声明仅在变量包含正确数值的情况下才被处理。

options = $$find(CONFIG, "debug") $$find(CONFIG, "release")
count(options, 2) {
        message(Both release and debug specified.)}

error(string)
函数无返回值，用于显示给定的字符串string给用户，并退出。只用于不可恢复的错误。
error(An error has occurred in the configuration process.)

eval(string)
评估使用qamke语法规则的string字符串的内容，返回true。在string字符串中可以使用定义和赋值来修改现有变量的值或创建新的定义。

eval(TARGET = myapp) {
        message($$TARGET)}

注意：引号可以用来分隔字符串，如果不需要返回值，则可以放弃。

exists(filename)
测试给定文件名的文件是否存在。如果文件存在，函数成功；否则，失败。如果文件名是一个正则表达式，如果有任何文件匹配成功，则函数执行成功。

exists( $(QTDIR)/lib/libqt-mt* ) 
{
      message( "Configuring for multi-threaded Qt..." )
      CONFIG += thread
}

for(iterate, list)
这个特殊的测试函数将开启循环，遍历列表中的所有值，依次对每个值设置迭代。为方便起见，如果列表为1…10，则迭代将遍历值1到10。
在for循环的条件行后使用else作用域是不允许的。

LIST = 1 2 3
for(a, LIST):exists(file.$${a}):message(I see a file.$${a}!)

message(string)
此函数简单地将消息写入控制台。不像error()函数，本函数允许继续处理。
message( "This is a message" )
上述代码会将"This is a message"消息写入控制台。引号的使用是可选的。
注意：默认，对于给定项目，qmake生成的每个MakeFile文件都会写入消息。如果要确保每个项目只显示一次消息，在构建期间，可以测试build_pass变量，并在相邻build_pass变量的作用域中过滤出消息。
!build_pass:message( "This is a message" )

include(filename)
将filename指定的文件的内容包含在当前工程所在的点。如果文件已经被包含，函数成功；否则，失败。被包含的文件要被立即处理。
通过使用此函数作为作用域的条件，可以检查文件是否被包含。

include( shared.pri )
OPTIONS = standard custom!include( options.pri ) {
        message( "No custom build options specified" )
OPTIONS -= custom}

infile(filename, var, val)
当文件被qmake解析时，如果filename文件包含有val值的var变量，成功；否则，失败。如果不指定第三个参数val，函数只会测试文件中是否包含var变量。
isEmpty(variablename)
如果variablename变量为空，成功；否则，失败。等价于count(variablename, 0)。

isEmpty(CONFIG) {
CONFIG += qt warn_on debug}

system(command)
在shell中执行给定的命令command，如果command返回一个0的退出状态，成功；否则，失败。
可以使用system函数从command命令获取stdout和stderr，赋值给变量。如：

UNAME = $$system(uname -s)
contains( UNAME, [lL]inux ):message( This looks like Linux ($$UNAME) to me )

warning(string)
显示给定的字符串string，总会成功。与message()相同。

packagesExist(packages)
使用PKGCONFIG机制决定在工程解析时是否存在给定的packages。通常用于打开、关闭特性。如:

packagesExist(sqlite3 QtNetwork QtDeclarative) 
{
DEFINES += USE_FANCY_UI
}

九、配置QMake环境

1、属性

qmake拥有一个持久信息系统，允许在qmake中一次设置变量，以后每次调用qmake时，可以查询该值。
在qmake中按如下设置变量：
qmake -set VARIABLE VALUE
使用适当的变量和值应该代替VARIABLE和VALUE。
为了从qmake中取出信息，如下：

qmake -query VARIABLE
qmake -query #queries all current VARIABLE/VALUE pairs..

注意：qmake -query只会列出先前使用qmake -set VARIABLE VALUE设置的变量。
属性信息会被保存到QSetting对象中对象中（意味着它将存储在不同平台的不同位置）。由于VARIABLE也可以被版本化，可以在较旧版本的qamke中设置一个值，而较新版本将检索此值。但是，如果在较新版本的qmake设置VARIABLE，将不能再旧版本使用这个值。通过前缀化qmake的版本到VARIABLE，可以查询特定版本的变量，代码如下：
qmake -query "1.06a/VARIABLE"
qmake也有内置属性的概念，例如可以使用QT_INSTALL_PREFIX属性查询这个qmake版本的Qt安装。
qmake -query "QT_INSTALL_PREFIX"
由于没有被版本化，内置属性不能有前缀版本，并且qmake的每个版本都有自己的内置属性值集合。

QT_INSTALL_PREFIX：Where the version of Qt this qmake is built for resides
QT_INSTALL_DATA - Where data for this version of Qt resides

QMAKE_VERSION：当前qmake的版本
最终，这些值可以在一个工程文件中查询，使用如下语法：
QMAKE_VERS = $$[QMAKE_VERSION]

2、QMAKESPEC

qmake需要一个平台和编译器的描述文件，文件包含很多用于生成MakeFile的默认值。标准的Qt版本带有很多这类文件，位于Qt安装目录的 mkspecs子目录下。
QMAKESPEC环境变量包含下列的任何值：
指向包含qmake.conf文件的目录的完整路径。qmake会打开目录中的qmake.conf文件。如果文件不存在，qmake会以错误退出。
平台-编译器组合的名称。qmake会搜索，当Qt编译时
QMAKESPEC路径会自动增加到INCLUDEPATH系统变量。

3、INSTALLS

在Unix上，使用构建工具安装应用程序和库是相同的。例如，通过调用make install。qmake有安装集的概念，。
例如，documentation文件集合使用如下方式描述：

documentation.path = /usr/local/program/doc
documentation.files = docs/*

path成员告诉qmake，文件应该安装在/usr/local/program/doc路径，files成员指定要拷贝到安装目录下的文件。本例中，docs目录下的所有文件将被拷贝到/usr/local/program/doc目录。
一旦安装集已被完全描述，可以像如下代码将其添加到安装列表中：
INSTALLS += documentation
qmake会确保指定的文件被拷贝到安装目录。如果需要对安装过程进行更大的控制，还可以为对象的额外成员提供定义。例如，下列代码告诉qmake为安装集执行一系列的命令：
unix:documentation.extra = create_docs; mv master.doc toc.doc
unix作用域确保这些特殊的命令只会在unix平台下执行。其它平台适合的命令可以使用其它作用域规则定义。
在执行对象的其他成员中的指令前执行extra成员中指定的命令。
如果追加内置的安装集到INSTALLS变量，并且不指定files和extra成员，qmake会决定拷贝哪些内容。目前，只支持内置安装集的是target：

target.path = /usr/local/myprogram
INSTALLS += target

上诉代码中，qmake知道拷贝哪些内容，自动处理安装过程。

4、缓存文件

缓存文件是qmake读取的特殊文件，用于查找不在qmake.conf文件、工程文件或是命令行指定的设置。如果qmake运行时没有指定-nocache选项，qmake会试图在当前目录的上层目录下查找名称为.qmake.cache的文件。如果没有找到，qmake会忽略这个处理步骤。 如果qmake找到一个.qmake.cache文件，qmake会在处理工程文件前首先处理这个文件。

5、库依赖

经常在链接到一个库时，qmake依赖于底层平台来了解库中链接的其他库，并让平台将它们拉入。然而，在很多情况下，这是不够的。例如，当静态链接一个库时，没有链接到其他库，因此不会创建与这些库的依赖关系。但是，后续链接到该库的应用程序需要知道在哪里可以找到静态库所需的符号。为了帮助解决这种情况，qmake尝试在适当的情况下遵循库的依赖关系，但是必须通过以下两个步骤明确地启用该行为。
A、开启库自身的依赖追踪。要做到这点，必须告诉qmake保存库的有关信息。
CONFIG += create_prl
这只和lib模板有关，其它模板会被忽略。当启用此选项时，qmake会创建一个在.prl结尾的文件，该文件将保存库相关的一些元信息。这个元文件就像一个普通的工程文件，但只包含内部变量声明。可以自由查看该文件，如果删除该文件，则qmake会知道在需要时重新创建它，即在后续读取工程文件时，或者如果依赖库（以下描述）已经发生变化时。在安装此库时，通过将其指定为INSTALLS声明中的目标，qmake将自动将.prl文件拷贝到安装路径。
B、在使用静态库的应用程序中读取该元信息。
CONFIG += link_prl
当该选项开启，qmake会处理由应用程序链接的所有库，并找到它们的元信息。qmake会使用它来确定相关链接信息，特别是向应用程序工程文件的DEFINES以及LIBS添加值。一旦qmake处理了该文件，它将查看LIBS变量中新引入的库，并找到它们的依赖.prl文件，直到所有库都被解析。此时，MakeFile文件按常规创建，并且库与应用程序显式链接。
prl文件的内部结构是关闭的，因此后续可以很容易地进行更改。prl文件并不是用来被手工改变的，只能由{qmake Manual#qmake}{qmake}创建，并且不应该在操作系统之间传输，由于它们可能包含依赖于平台的信息。

6、文件扩展

在正常情况下，qmake会尝试为平台使用适当的文件扩展名。但是，有时需要重写每个平台的默认选项，并显式定义用于qmake的文件扩展名。这是通过重新定义某些内置变量来实现的；
例如，用于moc文件的扩展可以用工程文件中的以下赋值来重新定义。
QMAKE_EXT_MOC = .mymoc
下列变量可用于重新定义qmake所识别的公共文件扩展名。
QMAKE_EXT_MOC：修改包含的moc文件的扩展
QMAKE_EXT_UI：修改designer UI文件的扩展
QMAKE_EXT_PRL：修改库依赖文件的扩展
QMAKE_EXT_LEX：修改文件后缀（LEXSOURCES）
QMAKE_EXT_YACC：修改文件后缀（YACCSOURCES）
QMAKE_EXT_OBJ：修改生成的对象文件的后缀
上述所有变量都只接受第一个值，所以必须给它分配一个值，会在整个工程文件中使用。有两个变量可以接受一个值列表：
QMAKE_EXT_CPP：qmake会将这些后缀的文件解释为C++源文件 QMAKE_EXT_H：qmake会将这些后缀的文件解释为C和C++头文件

7、自定义MakeFile文件输出

qmake试图实现跨平台构建工具所期望的一切。当真的需要运行特定的平台相关命令时，常常是不太理想的。这可以通过对不同qmake后端的特定指令来实现。
对MakeFile文件输出的定制是通过对象风格的API实现的，就像在qmake中其它地方发现的那样。对象是通过指定成员来自动定义的，例如：

mytarget.target = .buildfile
mytarget.commands = touch $$mytarget.target
mytarget.depends = mytarget2
mytarget2.commands = @echo Building $$mytarget.target

上述代码定义了一个名为mytarget的qmake目标，mytarget目标包含一个名为.buildfile的MakeFile目标，.buildfile使用touch命令依次生成。最终，.depends成员指定mytarget目标依赖于mytarget2。mytarget2是一个伪目标，只定义了一些显示到控制台的文本。
最后一步是指示qmake，这个对象是要建立的目标。
QMAKE_EXTRA_TARGETS += mytarget mytarget2
这就是实际构建自定义目标所需做的一切。当然，可能希望将其中一个目标绑定到qmake构建目标。要做到这一点，只需要将MakeFile目标包含到PRE_TARGETDEPS列表中。
下表是QMAKE_EXTRA_TARGETS变量的可用选项的概述。
commands：生成自定义构建目标的命令
CONFIG：自定义构建目标的特定配置选项
depends：自定义目标锁依赖的现有构建目标
recurse：为了调用子目标的MakeFile文件，当创建MakeFile文件时，指定使用哪些子目标。当CONFIG变量设置了recursive才能使用。
recurse_target：通过MakeFile文件中的子目标MakeFile文件，指定要构建的目标。
target：自定义构建目标创建的文件
CONFIG变量：
recursive：指明MakeFile中要创建的规则，因而会在子目标的MakeFile文件中调用相关目标。默认会为每个子目标创建一个实体。
为了方便起见，还有一种新的编译器或预处理器的工程定制方法。

new_moc.output  = moc_${QMAKE_FILE_BASE}.cpp
new_moc.commands = moc ${QMAKE_FILE_NAME} -o ${QMAKE_FILE_OUT}
new_moc.depend_command = g++ -E -M ${QMAKE_FILE_NAME} | sed "s,^.*: ,,"
new_moc.input = NEW_HEADERS
QMAKE_EXTRA_COMPILERS += new_moc

通过上面的定义，如果有可用的moc，可以使用moc随时替换。
在给定的NEW_HEADERS变量的所有参数上执行命令。结果写到output成员指定文件。这个文件会被增加到工程中的其它源文件。此外，为了生成依赖信息，qmake会执行depend_command命令，也将这些信息放到工程中。
这些命令可以很容易地放入缓存文件中，从而允许后续工程文件向NEW_HEADERS添加参数。
下表概述了QMAKE_EXTRA_COMPILERS变量的可用选项。
commands：用于从输入产生输出的命令。
CONFIG：为自定义编译器指定配置选项
depend_command：指定用于生成输出依赖项列表的命令。
dependency_type：指定输出的文件类型，如果它是已知类型（TYPE_C, TYPE_UI, TYPE_QRC），则使用其中的一种类型处理它。
depends：指定输出文件的依赖
input：包含使用自定义编译器处理的文件的变量
name：对自定义编译器所做事情的描述。只用于某些后端
output：自定义编译器创建的文件名
output_function：指定用于创建文件名的qmake自定义函数
variable_out：应该将从输出创建的文件添加到变量。
指定到CONFIG选项的成员：
commands：用于从输入产生输出的命令。
CONFIG：为自定义编译器指定配置选项
depend_command：指定用于生成输出依赖项列表的命令。
dependency_type：指定输出的文件类型，如果它是已知类型（TYPE_C, TYPE_UI, TYPE_QRC），则使用其中的一种类型处理它。
depends：指定输出文件的依赖
input：包含使用自定义编译器处理的文件的变量
name：对自定义编译器所做事情的描述。只用于某些后端
output：自定义编译器创建的文件名
output_function：指定用于创建文件名的qmake自定义函数
variable_out：应该将从输出创建的文件添加到变量