项目文件包含qmake生成应用程序,库和插件所需的所有信息。通常,您使用一系列声明来指定项目中的资源,但是对简单编程结构的支持使您能够描述针对不同平台和环境的不同构建过程
项目文件元素
qmake使用的项目文件格式可用于支持简单和相当复杂的构建系统。简单的项目文件使用简单的声明式样式,定义标准变量以指示项目中使用的源文件和头文件。复杂的项目可能会使用控制流结构来微调构建过程。
以下各节描述了项目文件中使用的不同类型的元素。
变量
- 变量用于保存字符串类别
- 在最简单的项目中,这些变量通知qmake要使用的配置选项,或提供在构建过程中使用的文件名和路径。
- qmake在每个项目文件中查找某些变量,并使用这些变量的内容来确定应将哪些内容写入Makefile。例如,HEADERS和SOURCES变量中的值列表用于告知qmake与项目文件位于同一目录中的头文件和源文件。
- 变量也可以用于在内部存储临时值列表,并且现有值列表可以用新值覆盖或者扩展
HEADERS = mainwindow.h paintwidget.h
SOURCES = main.cpp mainwindow.cpp \= main.cpp mainwindow.cpp \
paintwidget.cpp.cpp
CONFIG += console+= console
- 第一个赋值仅包含与HEADERS变量在同一行上指定的值。第二个赋值SOURCES使用反斜杠(\)将变量中的值分成几行。
表列出了一些常用变量并描述了它们的内容。
变量 | 内容 |
---|---|
CONFIG | 常规项目配置选项 |
DESTDIR | 可执行文件或二进制文件所在的目录 |
FORMS | 用户界面编译器(uic)要处理的UI文件列表。 |
HEADERS | 生成项目时使用的头(.h)文件的文件名列表。 |
QT | 项目中使用的Qt模块列表。 |
RESOURCES | |
SOURCES | 生成项目时要使用的源代码文件列表。 |
TEMPLATE | 用于项目的模板。这确定了构建过程的输出是应用程序,库还是插件。 |
变量的内容可以通过在变量名前添加来读取$$。这可用于将一个变量的内容分配给另一个:
TEMP_SOURCES = $$ SOURCES
空格
通常,空格分隔变量分配中的值。要指定包含空格的值,必须将值用双引号引起来:
DEST = "Program Files"
win32:INCLUDEPATH += "C:/mylibs/extra headers"
unix:INCLUDEPATH += "/home/user/extra headers"
带引号的文本在变量所保存的值列表中被视为单个项目。使用类似的方法来处理包含空格的路径,尤其是在为Windows平台定义INCLUDEPATH和LIBS变量时:
INCLUDEPATH
指定编译项目时应搜索的#include目录。
win32:INCLUDEPATH += "C:/mylibs/extra headers"
unix:INCLUDEPATH += "/home/user/extra headers"
win32:LIBS += "C:/mylibs/extra libs/extra.lib"
unix:LIBS += "-L/home/user/extra libs" -lextra
注释
- 注释以#字符开头,并一直到同一行的末尾
#注释通常从一行的开头开始,但是它们
#也可以跟随同一行上的其他内容。
内置功能和控制流程
qmake提供了许多内置函数来启用变量内容的处理。
- 简单项目文件中最常用的函数是include()函数
- 该函数以文件名作为参数。
- 给定文件的内容包含在include使用该功能的项目文件中。
- 该include函数最常用于包含其他项目文件:
include(other.pro)
通过作用域类似于if编程语言中的语句,可以提供对条件结构的支持:
- 仅当条件为true时,才进行大括号内的赋值。
- 在这种情况下,必须设置win32 CONFIG选项。这在Windows上自动发生
win32 {
SOURCES += paintwidget_win.cpp
}
项目模板
该模板变量用于定义将要建成的项目类型。如果未在项目文件中声明此内容,则qmake假定应构建应用程序,并将为此目的生成适当的Makefile(或等效文件)。
选项 | |
---|---|
app | Makefile构建一个应用程序 |
LIB | Makefile建立一个库。 |
subdirs | 创建用于在子目录中构建目标的Makefile。子目录是使用SUBDIRS变量指定的。 |
aux | Makefile不构建任何东西。如果不需要调用编译器来创建目标,请使用此选项,例如,因为您的项目是用解释语言编写的。 |
vcapp | Visual Studio Project文件来构建应用程序。 |
vclib | Visual Studio Project文件来构建库。 |
vcsubdirs | Visual Studio解决方案文件可在子目录中生成项目。 |
- 使用subdirs模板时,qmake会生成一个Makefile来检查每个指定的子目录,处理在该目录中找到的任何项目文件,然后make在新创建的Makefile上运行平台的工具。该SUBDIRS变量用于包含所有要处理的子目录的列表。
- 有关为使用和模板的项目编写项目文件的建议,请参见构建通用项目类型
常规配置
CONFIG
变量指定的选项和功能,该项目应进行配置。- 可以以发布模式或调试模式,或两者都构建项目。如果同时指定了
debug和release
,则最后一个生效。如果您指定debug_and_release
用于生成项目的调试版本和发行版的选项,则qmake生成的Makefile包含同时生成两个版本的规则。可以通过以下方式调用它:
make all
- 可以使用
CONFIG()
函数测试某些配置选项的存在
# 测试是否仅使用该opengl选项
CONFIG(opengl) {
message(Building with OpenGL support.)
} else {
message(OpenGL support is not available.)
}
CONFIG
定义了要构建的项目的类型。
CONFIG += qt debug