QMake配置问题

创建项目文件

项目文件包含qmake构建你的应用程序,库文件,或插件需要的所有信息。通常,你会在项目文件里使用一系列的声明指定资源,但是对简单程序构造的支持,允许你为不同的平台或环境描述不同的构建过程。

项目文件元素

qmake使用的项目文件格式可以支持简单和复杂的构建系统使用。简的项目文件使用简单的声明样式,定义标准的变量,用于指出项目中使用的头文件和源文件。复杂的项目可以使用控制流程结构来调整构建过程。

下面的章节描述了在项目文件里使用不同类型的元素。

变量

在项目文件里,变量是用于保存字符串的列表。在简单的项目里,这些变量通知qmake使用相关的配置信息,或者提供文件名和路径在构建过程使用。

qmake在每个项目文件中查找某些变量,并使用这些内容用于确定什么要写到 makefile里。举例,在HEADERSSOURCES里的变量列表用于告诉qmake在相同目录里的头文件和源文件做为项目文件。

变量也可以在内部保存临时变量列表,现有变量列表可以被新值覆盖或扩展。

下面的代码片段说明了值列表是如何赋值给变量的:

HEADERS = mainwindow.h paintwidget.h

在变量里的值列表是通过下边的方式进行扩展的:

SOURCES = main.cpp mainwindow.cpp           paintwidget.cpp
CONFIG += console

注意:第一个赋值语句只包含指定在同一行里的值是HEADERS变量。第二个赋值语句把SOURCES里不同行的值用反斜杠(\)分开。

CONFIG变量是另一个当生成Makefile时qmake用来使用的特殊变量 。这里讨论了它General Configuration .在上面的代码片段,console被添加到CONFIG已经存在的值列表里。

下边的表格列了了常用的变量并描述了他们的内容。完整的变量列表及它们的描述,请查看Variables

变量 描述
CONFIG 通用的项目配置选项。
DESTDIR 将要存放可执行文件和二进制文件的目录。
FORMS user interface compiler(uic)处理过的UI文件列表。
HEADERS 当构建项目时被使用的头文件(.h)名称列表。
QT 在项目中使用的Qt模块列表
RESOURCES 在最终项目中包含的资源文件(.qrc)列表。更多资源文件的详细信息查看   The Qt Resource System 。
SOURCES 在构建项目时使用的源文件(.cpp)列表。
TEMPLATE 项目使用的模板。这个决定构建过程输出的是否是一个应用程序、库、或者生成一个插件

可以通过在变量名前附加$$读取变量的内容。这样可以把一个变量的内容赋值给另一个变量。

TEMP_SOURCES = $$SOURCES

$$操作符被广泛的应用于内置函数,用于操作字符串和值的列表。更多详细信息,请查看,qmake Language

空格

通常,在变量赋值中用空格分隔值。指定变量中包含空格,你必需用双引号包围变量

DEST = "Program Files"

引号文本被视为一个单独的值保存在变量里。类似的方法用来处理包含空格的路径,特别是在windows平台定义INCLUDEPATHLIBS变量时:

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

注释

可以在项目文件里添加注释。注释以#字符开始持续到这一行的结尾。例如:

# 注释通常开始于一行的头部,但它
# 也可以在这同行内容的后边

要在赋值变量时包含#字符,必需使用内置的LITERAL_HASH变量的内容

内置函数和控件流

qmake 提供了大量的内置函数允处理变量内容。在简单的项目文件里最常用的是include()函数,这个函数用一个文件名做为参数。 给定的文件的内容包含在在项目文件的地方使用include函数。include()函数经常用于包含其它项目文件

include(other.pro)

可以通过作用域(scopes)支持条件结构语句。这种行为和编程语言里的if一样

win32 {
    SOURCES += paintwidget_win.cpp
}

只有条件为true的时候花括号里的任务才会被执行。在这个例子里,必须设置CONFIG的Win32选项。只有在windows系统上才会自动处理,左边的大括号必须和条件在同一行

变量上更复杂的操作通常封面要循环提供的内置函数比如find()unique()和 count()。提供的这些功能,和其它操作字符串和路径,提供用户输入,以及调用扩展工具。使用这些函数更详细的内容,请查看 qmake Language 。所有函数和它们的描述列表,请查看 Replace Functions 和 Test Functions.

项目模板

TEMPLATE变量,是用来定义项目将要构建的类型。如果它没有在项目文件里声明,qmake会假定构建应用程序,并且将为此生成一个适当的Makefile(或者等价的文件)。

下表简要说明了项目类型变量和成描述qmake生成的每一个文件:

模板 qmake输出
app (default) makefile生成一个应用程序
lib makefile生成一个库
aux makefile什么也不生成。如果没有编辑器需要调用创建目标。例如你的项目是用解释型语言编写的。
注意:这个模板类型只适用于基于Makefile的生成器。特别是,它不会与vcxproj和Xcode生成器一起工作。
subdirs Makefile规则包含使用SUBDIRS变量指定的子文件。每一个子目录必须包含它自己的项目文件。
vcapp Visual Studio项目文件 生成一个应用程序
vclib
Visual Studio项目文件生成一个库

vcsubdirs
Visual Studio解决方案文件要在子目录生成项目

查看 Building Common Project Types 在编写使用项目模板和库模板项目的项目文件时的建议。

当使用subdirs模板时,qmake生成一个makefile用来检查每一个子目录,处理在子目录里找到的工程文件,并执行平台的make 工具生成新的Makefile。SUBDIRS变量被用于包含所有要被处理的子目录的列表。

常规配置

CONFIG变量指定项目应该配置的选项和功能。

可以在release模式或debug模式或两种模式一起构建项目。如果debug和release一同指定,最后一个指定的生效。如果你指定 debug_and_release 选项用来构建项目的debug和release两个版本,qmake会生成包含构建两个版本规则的Makefile。可以通过以下方式调用:

make all

添加 build_all选项到 CONFIG变量,在规则构建项目时使用这个默认值。

注意:每一个在CONFIG里指定的变量都可以用做条件作用域。你可以使用内置的CONFIG()方法测试某个配置选项是否存在。例如,下边的代码展示使用这个方法做为域的条件测试是否只有opengl选项被使用

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

这允许为release和debug 定义不同的配置 构建。更详细的信息,请查看Using Scopes

下边的选项定义要构建的项目类型。

注意:一些选项只有在相关平台上使用时才会生效。

选项 描述
qt 这个项目是Qt应用程序需要连接Qt库。你可以为用QT变量控制应用程序所需的所有额外的Qt模块。这个值是默认添加的,但是你可为非qt项目用qmake删除它。
x11 项目是一个X11应用程序或库。如果目标使用Qt那么这个值是不需要的。

应用程序和库项目模板为你提供了更专业的配置选项用来调整生成过程。选项更详细的解释在Building Common Project Types

例如,如果你的应用程序使用Qt库并且你想在debug模式下构建项目。你的项目文件将包含下边的代码:

CONFIG += qt debug

注意:你必需使用"+=",不能使用"=",不然qmake将不能为使用Qt的配置确定哪些设置是你的应用程序需要的。

声明Qt库

如果CONFIG变量包含qt值,开启qmake对Qt应用程序的支持。这样就可以微调你的应用程序使用的Qt模块。通过QT的变量可以用于声明需要的额外的模块。例如我们可以也下面的方式启用 XML和network模块:

QT += network xml

注意:QT默认包含core和gui模块,所以上边的声明把network和XML模块添加到了默认列表。下边的赋值删除了默认模块,这将导致应用程序的源码在编译的时候出现错误:

QT = network xml # This will omit the core and gui modules.

如果你想构建没有gui模块的项目,你需要用 "-=" 操作删除它。默认情况下,QT包含core和gui。下面的代码将导致最小的Qt项目构建:

QT -= gui # Only the core module is used.

你可以添加到QT变量的Qt模块列表,请查看QT

配置功能

qmake可以提供在功能文件(.prf)里指定的额外的配置功能。这些额外的功能经常为在构建过程使用的自定义工具提供支持。为了能将功能添加到构建过程,把功能的名字(功能文件名的词干)追加到CONFIG变量后边

例如,用下边的代码qmake可以配置构建过程利用pkg-config提供的外部库。如D-Bus和ogg库。

CONFIG += link_pkgconfig

PKGCONFIG += ogg dbus-1

关于添加新特性更详细的信息,请查看 Adding New Configuration Features.

声明其它库

除了Qt支持的库,你可以把其它的库添加到工程里,你必需在工程文件里指定它们。

qmake可以查找库所在的路径,及特定库链接可以被添加到LIBS变量的值列表。你可以指定库的路径或者,或者使用UNIX样式符号指定库和路径。

例如,下边的代码显示如何指定库:

LIBS += -L/user/local/lib -lmath

包含头文件的路径也可以使用相同的方式添加到 INCLUDEPATH 变量

例如,添加几个用于查找头文件的路径

INCLUDEPATH = c:/msdev/include d:/stl/include
时间: 2024-10-08 10:07:13

QMake配置问题的相关文章

make makefile cmake qmake都是什么,有什么区别

原文:https://www.zhihu.com/question/27455963 作者:玟清链接:https://www.zhihu.com/question/27455963/answer/36722992来源:知乎著作权归作者所有,转载请联系作者获得授权. 1. make 是用来执行Makefile的2. Makefile是类unix环境下(比如Linux)的类似于批处理的"脚本"文件.其基本语法是: 目标+依赖+命令,只有在目标文件不存在,或目标比依赖的文件更旧,命令才会被执

浅谈 qmake 之 shadow build(就是将源码路径和构建路径分开)

shadow build shadow build 是什么东西?就是将源码路径和构建路径分开(也就是生成的makefile文件和其他产物都不放到源码路径),以此来保证源码路径的清洁. 这不是qmake独创的东西,cmake中早就使用这个东西了   cmake qmake 备注 in-source cmake . qmake project.pro 在源码路径下执行 out-of-source(shadow-build) mkdir build cd buildcmake ../project m

qmake和moc的功能(★firecat推荐★)

原创作品,允许转载,转载时请务必以超链接形式标明文章 原始出处 .作者信息和本声明.否则将追究法律责任.http://devbean.blog.51cto.com/448512/355100 前面我们说过,Qt 不是使用的“标准的” C++ 语言,而是对其进行了一定程度的“扩展”.这里我们从Qt新增加的关键字就可以看出来:signals.slots 或者 emit.所以有人会觉得 Qt 的程序编译速度慢,这主要是因为在 Qt 将源代码交给标准 C++ 编译器,如 gcc 之前,需要事先将这些扩展

使用qmake生成Makefile

手动写Makefile是一件痛苦的事情,稍不小心就会出错,不过qmake可以让你脱离苦海 qmake可以根据你提供的.pro文件,生成Makefile 又是要些.pro文件呀!,不过他可比Makefile简单多啦,一分钟你就能学会 简单的.pro文件 SOURCES += hello.cpp HEADERS += hello.h CONFIG += cnosole warn_on debug 只配置这三项就可以生成Makefile SOURCES 写出源文件的位置,支持相对路径,支持通配符 SO

翻译qmake文档之 qmqke指南和概述(一)

利用空闲时间把qmke的文档翻译出来,语言水平有限,有些地放翻译的不好,请谅解,如果您能指出来,我会很感激并在第一时候做出修改. 原文连接: http://qt-project.org/doc/qt-5/qmake-manual.html http://qt-project.org/doc/qt-5/qmake-overview.html 由于qmake manual和overview  两章的内容都不多就把它们放在一起翻译了出来 qmake 指南 qmake 是帮助简化跨平台项目开发的构建过程

Struts2中使用Velocity模板时模板资源路径配置问题

在Struts2中使用Velocity模板时,如何以相对与Web工程的路径来配置模板资源文件路径这个问题网上千篇一律的来自Velocity官方文档.官方文档中指出如果是Web工程的话,模板的相对路径是工程根路径,今天在使用的时候有如下配置: Velocity.properties(默认在WEB-INF下): resource.loader =file, classclass.resource.loader.description = Velocity Classpath Resource Loa

从零开始学习音视频编程技术(三) 开发环境搭建(Qt4.86手动设置环境,主要就是设置g++和qmake,比较透彻,附下载链接)

1.先下载安装Qt 我们使用的版本是4.8. 可以自行百度下载也可以从下面的网盘地址下载: Qt库和编译器下载: 链接:http://pan.baidu.com/s/1hrUxLIG 密码:0181 Qt Creator下载: 链接:http://pan.baidu.com/s/1miPgpfi 密码:1hb6 下载后得到这三个文件: 其中 MinGW-gcc440_1.zip 是mingw编译器 qt-win-opensource-4.8.2-mingw.exe 是Qt的库 qt-creato

Qt程序发行Linux版,软件打包知识(patchelf 工具修改依赖库,确认 qmake -v 是自己使用的Qt版本,否则用export PATH进行修改)good

patchelf 工具可以修改已编译运行程序的依赖库位置和指定库链接器 patchelf --set-rpath patchelf --set-interpreter 通过这个工具 https://github.com/probonopd/linuxdeployqt 如果自己编译不了,也可以下载现成的 https://github.com/probonopd/linuxdeployqt/releases 运行 ./linuxdeployqt-2-x86_64.AppImage ShanbayDi

学会了使用qmake -query

D:\Qt\Qt5.6.2_static_kk\bin>qmake -queryQT_SYSROOT:QT_INSTALL_PREFIX:C:/Qt/Qt5.6.2_static_kkQT_INSTALL_ARCHDATA:C:/Qt/Qt5.6.2_static_kkQT_INSTALL_DATA:C:/Qt/Qt5.6.2_static_kkQT_INSTALL_DOCS:C:/Qt/Qt5.6.2_static_kk/docQT_INSTALL_HEADERS:C:/Qt/Qt5.6.2_