Qt高级——QMake快速入门

Qt高级——QMake快速入门

一、QMake简介

qmake是Trolltech公司创建的用来为不同的平台和编译器书写Makefile的工具。
qmake是一个用来简化在不同平台间开发工程的构建过程的工具。qmake会自动生成MakeFile文件，可以用于任何软件项目中，无论是否由Qt编写。
qmake会注意所有的编译器和平台的依赖性，开发者只需关注自己的代码。qmake作为Qt库和Qt所提供的工具的主要连编工具，可以自动的包含moc和uic的连编规则。

二、QMake入门教程

1、创建一个工程

创建一个应用，包含 hello.cpp、hello.h、main.cpp三个文件。
使用文本编辑器创建一个hello.pro文件，增加源文件、头文件到工程文件hello.pro。

HEADERS += hello.h
SOURCES += hello.cpp
SOURCES += main.cpp

同时，也可以使用换行符一次增加多个文件。

SOURCES = hello.cpp \
          main.cpp

目标名称会自动设置，一般与工程文件相同，当会用后缀区别不同的平台。如，工程文件是hello.pro，Windows平台的目标名称是hello.exe，Unix平台的目标名称是hello。如果要使用不同的目标名称，需要在工程文件hello.pro中设置。如：
TARGET = helloworld
最后就是配置CONFIG变量，对于Qt应用程序来说，给CONFIG赋值qt，QMake会链接相关的库，并确保moc和uic相关的连编规则生成到MakeFile文件中。最终的hello.pro工程文件如下：

CONFIG += qt
HEADERS += hello.h
SOURCES += hello.cpp
SOURCES += main.cpp

在工程所在目录打开命令行终端，使用qmake生成为应用生成MakeFile。
qmake -o Makefile hello.pro
对于Visual Studio开发者，qmake会生成.dsp或.vcproj文件。
qmake -tp vc hello.pro

2、增加工程的调试版

应用程序的 release版本不包含调试符号或其它调试信息。在开发过程中，生成带调试信息的应用程序调试版本是很有用的。通过增加debug到CONFIG变量可以生成应用程序的调试版本。

CONFIG += qt debug
HEADERS += hello.h
SOURCES += hello.cpp
SOURCES += main.cpp

3、增加特定平台的源文件

应用程序中特定平台部分的源码需要保持平台独立代码的分离。现在有hellowin.cpp和hellounix.cpp两个新文件。不能直接增加这两个文件到SOURCES变量，因为这会导致这两个文件直接生成到MakeFile文件，需要在qmake所运行的平台的代码块中独立处理。
对于Windows平台，在一个简单的代码块中增加平台独立的文件。

win32 {
SOURCES += hellowin.cpp}

如果qmake运行在Windows平台上，会增加hellowin.cpp文件到源文件列表。如果qmake运行在其它平台上，会忽略。现在创建一个代码块增加和Unix平台相关的文件。

unix {
    SOURCES += hellounix.cpp}

工程文件hello.pro文件如下：

CONFIG += qt debug
HEADERS += hello.h
SOURCES += hello.cpp
SOURCES += main.cpp
win32 {
    SOURCES += hellowin.cpp}
unix {
    SOURCES += hellounix.cpp}

4、如果文件不存在中止qmake过程

如果某个文件不存在，不生成MakeFile文件。可以使用exists()函数检查一个文件是否存在。通过使用error()函数可以中止qmake执行过程。对main.cpp文件检查如下：

!exists( main.cpp ) {
    error( "No main.cpp file found" )}

如果main.cpp文件存在，exists(main.cpp)为true。
如果main.cpp文件不存在，!exists(main.cpp)为true。

CONFIG += qt debug
HEADERS += hello.h
SOURCES += hello.cpp
SOURCES += main.cpp
win32 {
    SOURCES += hellowin.cpp}
unix {
SOURCES += hellounix.cpp}
!exists( main.cpp ) {
    error( "No main.cpp file found" )}

5、检查多个条件

假设在Windows平台上，使用命令行运行应用程序，想通过qDebug()函数查看输出状态。除非在应用程序构建过程中使用console设置，否则看不到输出状态信息。通过将console增加到CONFIG变量可以在生成的MakeFile文件中生成相应的设置。
如果只在Windows平台上debug版本时查看输出信息。代码如下：

win32 {
    debug {
        CONFIG += console
    }}

内嵌的作用域也可以使用冒号（:）连接在一起。

CONFIG += qt debug
HEADERS += hello.h
SOURCES += hello.cpp
SOURCES += main.cpp
win32 {
    SOURCES += hellowin.cpp}
unix {
SOURCES += hellounix.cpp}
!exists(main.cpp) {
    error("No main.cpp file found")}
win32:debug {
    CONFIG += console}

三、QMake创建工程

本文将讲述如何设置基于Qt的三种通用工程类型的qmake工程文件。

1、QMake创建应用程序

app模板会告诉qmake生成一个构建应用程序的MakeFile。使用app模板，应用的类型可以增加一个选项到CONFIG变量定义中。
windows：应用是一个Windows GUI应用程序
console：应用是一个Windows控制台应用。
使用app模板时，下列qmake系统变量会被识别，可以在应用程序的.pro文件中使用。
HEADERS：应用程序的头文件列表
SOURCES：应用程序的源文件列表
FORMS：应用程序的UI（Qt Designer创建）文件列表
LEXSOURCES：应用程序的LEX原文件列表
YACCSOURCES：应用程序的YACC源文件列表
TARGET：应用程序的可执行文件名称
DESTDIR：生成的目标文件的存放目录
DEFINES：应用程序指定的预定义预处理器符号
INCLUDEPATH：编译器的搜索头文件路径
DEPENDPATH：应用程序的依赖查找路径
VPATH：寻找补充文件的搜索路径
DEF_FILE： 应用程序链接的.def文件，仅支持Windows。
RC_FILE：应用程序的资源文件，仅支持Windows。
RES_FILE：应用程序链接的资源文件，仅支持Windows。
开发者可以直接使用有值的qmake系统变量，不必指定任何值。qmake会自动增加需要的默认值。
实例工程文件如下：

TEMPLATE = app
DESTDIR  = c:/helloapp
HEADERS += hello.h
SOURCES += hello.cpp
SOURCES += main.cpp
DEFINES += QT_DLL
CONFIG  += qt warn_on release

对于单个值的数据项，如模板或目的目录，使用“=”，但多个值的数据项需要使用“+=”增加到已经存在相应类型的数据项中。如果使用“=”会使用新的值替换原来的值，例如，DEFINES=QT_DLL，所有其它的定义都会被删除。

2、QMake创建库

lib模板告诉qmake生成构建一个库的MakeFile。使用lib模板时，除了app模板支持的系统变量，也支持VERSION变量。可以使用这些变量在.pro文件中指定库的相关信息。当使用lib模板时，以下选项需要增加到CONFIG变量决定要构建的库的类型。
dll：库是一个共享库
staticlib：库是一个静态库
plugin：库是一个插件，也支持dll选项
VERSION变量指定库的版本信息
库的目标文件名是平台独立的。例如，X11和Mac OS X，库名称使用lib 前缀，Windows平台上，库文件名不增加任何前缀。

3、QMake创建插件

插件使用lib模板构建，告诉qmake生成一个工程的MakeFile。
VERSION变量用于指定插件的版本信息。
就像普通库一样，VERSION变量用于指定插件的版本信息。Qt Designer插件会使用一套依赖于Qt配置的特定配置集进行构建。为了方便起见，这些设置可以通过增加designer到工程CONFIG变量开启。例如：
CONFIG += designer plugin

4、QMake创建Debug 和Release

某些时候，构建同时支持debug和release的工程是必要的。虽然CONFIG变量有debug和release选项，但是debug选项会覆盖release选项。
为了开启工程同时支持debug和release，必须在CONFIG变量增加debug_and_release选项。

CONFIG += debug_and_release

CONFIG(debug, debug|release) {
    TARGET = debug_binary} else {
    TARGET = release_binary}

以上代码块会修改每一种模式的构建目标，确保目标有不同的文件名称。为目标提供不同的名称可以确保目标相互间不会被覆盖。
当qmake处理工程文件时，会生成一个允许支持debug和release模式的MakeFile规则。可以通过以下方式调用：
make all
build_all选项增加到工程文件的CONFIG变量，可以确保工程默认会被两种模式编译。
CONFIG += build_all
这会允许Makefile使用默认规则处理。
make
build_all选项也可以确保目标的两个版本在安装规则被调用时被安装。
make install
可以自定义依赖于目标平台的构建目标的名称。例如，一个库或插件可以在Windows平台使用不同于Unix平台的命名规范。

CONFIG(debug, debug|release) {
    mac: TARGET = $$join(TARGET,,,_debug)
    win32: TARGET = $$join(TARGET,,d)}

在debug模式构建时，以上代码块的默认行为会修改构建目标使用的名称。