快速入门

本教程将教授您 qmake 基础知识。本手册中的其它话题包含有关使用 qmake 的更多详细信息。

从简单开始

假定您已完成应用程序的基本实现，且有创建以下文件：

hello.cpp
hello.h
main.cpp

将找到这些文件在 examples/qmake/tutorial Qt 分发目录。您对应用程序设置唯一知道的事情是，它是以 Qt 编写的。首先，使用喜爱的纯文本编辑器，创建文件称为 hello.pro in examples/qmake/tutorial 。需要做的第一件事是添加一些行，告诉 qmake 属于开发工程的有关源文件和头文件。

首先将源文件添加到工程文件。为此，需要使用 SOURCES 变量。仅仅开始新行采用 SOURCES += 并将 hello.cpp 放于其后。应该有的内容像这样：

SOURCES += hello.cpp

对各工程源文件重复这，直到得到以下结束:

SOURCES += hello.cpp
SOURCES += main.cpp

若首选使用像 make 句法，可以像这样使用换行转义将所有文件一起列出：

SOURCES = hello.cpp \
          main.cpp

现在源文件已列表于工程文件中，必须添加头文件。这些文件的添加方式与源文件准确相同，除了使用的变量名是 HEADERS .

一旦完成这，工程文件看起来应该像这样：

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

目标名称是自动设置的。与工程文件名相同，但带有适于平台的后缀。例如，若工程文件称为 hello.pro ，目标将是 hello.exe 在 Windows 和 hello 在 Unix。若想要使用不同名称，可以在工程文件中设置：

TARGET = helloworld

完成后的工程文件应该看起来像这样：

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

现在，可以使用 qmake 为应用程序生成 Makefile。在工程目录下的命令行，键入以下：

qmake -o Makefile hello.pro

然后键入 make or nmake 取决于所用的编译器。

对于 Visual Studio 用户，qmake 还可以生成 Visual Studio 工程文件。例如：

qmake -tp vc hello.pro

使应用程序可调试

应用程序发行版未包含任何调试符号或其它调试信息。在开发期间，产生拥有相关信息的应用程序调试版本很有用。这可以轻松达成通过添加 debug 到 CONFIG 变量在工程文件。

例如：

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

如之前一样使用 qmake 生成 Makefile。现在将获得有关应用程序的有用信息当在调试环境下运行时。

添加特定平台源文件

经几小时编码，您可能已开始应用程序的特定平台部分，并决定单独从属平台代码。因此，现在有 2 个新文件要包括到工程文件中： hellowin.cpp and hellounix.cpp 。无法仅仅将这些添加到 SOURCES 变量，由于那样会将 2 个文件都放在 Makefile 中。因此，在这里需要做的是使用作用域，将根据要为哪个平台构建进行处理。

添加 Windows 平台从属文件的简单作用域看起来像这样：

win32 {
    SOURCES += hellowin.cpp
}

当为 Windows 构建时，qmake 添加 hellowin.cpp 到源文件列表。当为任何其它平台构建时，qmake 仅仅忽略它。现在剩下要做的就是为 Unix 特定文件创建作用域。

当这样做时，工程文件内容应该看起来像这样：

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

如之前一样使用 qmake 生成 Makefile。

停止 qmake 若文件不存在

可能不想创建 Makefile，若某个文件不存在。可以校验文件是否存在，通过使用 exists() 函数。可以停止 qmake 的处理通过使用 error() 函数。这与作用域工作方式相同。只需采用函数替换作用域条件。校验称为 main.cpp 的文件看起来像这样：

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

The ! 符号用于否定测试。也就是说， exists( main.cpp ) 为 true 若文件存在，而 !exists( main.cpp ) 为 true 若文件不存在。

CONFIG += 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" )
}

如之前一样使用 qmake 生成 Makefile。若重命名 main.cpp 临时，将看到消息，且 qmake 将停止处理。

校验多个条件

假设使用 Windows，且想要能够看到语句输出采用 qDebug() 当在命令行运行应用程序时。要看到输出，必须采用适当控制台设置构建应用程序。可以很轻松地放置 console 在 CONFIG 行以在 Windows Makefile 中包括此设置。不管怎样，假设我们只想添加 CONFIG 行当在 Windows 运行 and 当 debug 已在 CONFIG 行。这要求使用 2 嵌套作用域。首先创建一个作用域，然后在其中创建另一个。将要处理的设置放入第 2 作用域，像这样：

win32 {
    debug {
        CONFIG += console
    }
}

可以使用冒号将嵌套作用域拼接在一起，因此，最终工程文件看起来像这样：

CONFIG += 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
}