您当前位置：首页 > php开源 > 综合技术 > Qt之pro配置详解

Qt之pro配置详解

来源：程序员人生发布时间：2016-07-23 10:37:29 阅读次数：3017次

简述

使用Qt的时候，我们常常会对pro进行1系列繁琐的配置，为方便大家理解、查找，现将经常使用的配置进行整理。

简述
配置
- 注释
- CONFIG
- DEFINES
- DEPENDPATH
- DESTDIR
- FORMS
- HEADERS
- INCLUDEPATH
- LIBS
- MOC_DIR
- OBJECTS_DIR
- QT
- RCC_DIR
- RESOURCES
- RC_FILE
- RC_ICONS
- SOURCES
- TARGET
- TEMPLATE
- TRANSLATIONS
- UI_DIR
更多参考

配置

注释

以“#”开始，到这1行结束。
快捷键：Ctrl + /

CONFIG

指定编译器选项和项目配置，值由qmake内部辨认并具有特殊意义。

以下配置值控制编译标志：

选项	说明
release	项目以release模式构建。如果也指定了debug，那末最后1个生效。
debug	项目以debug模式构建。
debug_and_release	项目准备以debug和release两种模式构建。
debug_and_release_target	此选项默许设置。如果也指定了debug_and_release，终究的debug和release构建在不同的目录。
build_all	如果指定了debug_and_release，默许情况下，该项目会构建为debug和release模式。
autogen_precompile_source	自动生成1个.cpp文件，包括在.pro中指定的预编译头文件。
ordered	使用subdirs模板时，此选项指定应当依照目录列表的顺序处理它们。
precompile_header	可以在项目中使用预编译头文件的支持。
warn_on	编译器应当输出尽量多的正告。如果也指定了warn_off，最后1个生效。
warn_off	编译器应当输出尽量少的正告。
exceptions	启用异常支持。默许设置。
exceptions_off	禁用异常支持。
rtti	启用RTTI支持。默许情况下，使用编译器默许。
rtti_off	禁用RTTI支持。默许情况下，使用编译器默许。
stl	启用STL支持。默许情况下，使用编译器默许。
stl_off	禁用STL支持。默许情况下，使用编译器默许。
thread	启用线程支持。当CONFIG包括qt时启用，这是缺省设置。
c++11	启用c++11支持。如果编译器不支持c++11这个选项，没有影响。默许情况下，支持是禁用的。
c++14	启用c++14支持。如果编译器不支持c++14这个选项，没有影响。默许情况下，支持是禁用的。

当使用debug和release选项时(Windows下默许的)，该项目将被处理3次：1次生成1个”meta”Makefile，另外两次生成Makefile.Debug和Makefile.Release。

在后面的次数，build_pass和相应的debug或release添加到CONFIG选项。这使得它可以履行构建特定任务。

例如：

build_pass:CONFIG(debug, debug|release) {
    unix: TARGET = $$join(TARGET,,,_debug)
    else: TARGET = $$join(TARGET,,,d)
}

DEFINES

qmake添加这个变量的值作为编译器C预处理器宏(-D选项)。

例如：

DEFINES += USE_MY_STUFF

然后就能够在代码中使用：

#ifdef USE_MY_STUFF
    // TODO
#else
    // TODO
#endif

DEPENDPATH

指定查看解决依赖关系的目录列表，当包括文件时使用。

例如：

DEPENDPATH += . forms include qrc sources

DESTDIR

指定在何处放置目标文件。

例如：

DESTDIR = ../../lib

常常可以指定项目的特殊版本（比如：正式版、试用版）、对1些特殊功能（比如：加密狗）进行限制等。

FORMS

指定UI文件（参考： Qt Designer Manual）在编译前被uic处理。所有的构建这些UI文件所需的依赖、头文件和源文件都会自动被添加到项目中。

例如：

FORMS = mydialog.ui \
        mywidget.ui \
        myconfig.ui

HEADERS

指定项目中所有的头文件。

qmake会自动检测是头文件的类中是不是需要moc，并增加适当的依赖关系和文件到项目中，来生成和链接moc文件。

例如：

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

INCLUDEPATH

指定编译项目时应当被搜索的#include目录。

例如：

INCLUDEPATH = c:/msdev/include d:/stl/include

如果路径包括空格，需要使用引号包括。

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

LIBS

指定链接到项目中的库列表。如果使用Unix -l (library) 和 -L (library path) 标志，在Windows上qmake正确处理库（也就是说，将库的完全路径传递给链接器），库必须存在，qmake会寻觅-l指定的库所在的目录。

例如：

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

如果路径包括空格，需要使用引号包括路径。

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

MOC_DIR

指定来自moc的所有中间文件放置的目录（含Q_OBJECT宏的头文件转换成标准.h文件的寄存目录）。

例如：

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

OBJECTS_DIR

指定所有中间文件.o（.obj）放置的目录。

例如：

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

QT

指定项目中使用Qt的模块。默许情况下，QT包括core和gui，以确保标准的GUI利用程序无需进1步的配置就能够构建。

如果想建立1个不包括Qt GUI模块的项目，可使用“ -=”操作符。

下面1即将构建1个很小的Qt项目：

QT -= gui # 仅仅使用core模块

如果要创建1个界面，里面用到XML及网络相干的类，那末需要包括以下模块：

QT += core gui widgets xml network

如果你的项目是1个Qt Designer插件，使用值uiplugin指定项目构建成库，但特定的Qt Designer插件支持，请参考：Building and Installing the Plugin。

RCC_DIR

指定Qt资源编译器输出文件的目录（.qrc文件转换成qrc_*.h文件的寄存目录）。

例如：

unix:RCC_DIR = ../myproject/resources
win32:RCC_DIR = c:/myproject/resources

RESOURCES

指定资源文件 (qrc) 的名称。更多参考：The Qt Resource System。

例如：

RESOURCES += Resource/resource.qrc

RC_FILE

指定利用程序资源文件的名称。这个变量的值通常是由qmake或qmake.conf处理，很少需要进行修改。

例如：

RC_FILE += myapp.rc

RC_ICONS

仅适用于Windows，指定的图标应当包括在1个生成的.rc文件里。如果RC_FILE 和RES_FILE变量都没有设置这才可利用。

例如：

RC_ICONS = myapp.ico

SOURCES

指定项目中所有源文件。

例如：

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

TARGET

指定目标文件的名称。默许情况下包括的项目文件的基本名称。

例如：

TEMPLATE = app
TARGET = myapp
SOURCES = main.cpp

上面项目会生成1个可履行文件，Windows下为myapp.exe，Unix下为myapp。

TEMPLATE

模板变量告知qmake为这个利用程序生成哪一种makefile。

可供使用的选项：

选项	说明
app	创建1个用于构建利用程序的Makefile（默许）。
lib	创建1个用于构建库的Makefile。
subdirs	创建1个用于构建目标子目录的Makefile，子目录使用SUBDIRS变量指定。
aux	创建1个不建任何东西的Makefile。如果没有编译器需要被调用来创建目标，比如你的项目使用解释型语言写的，使用此功能。注：此模板类型只能用于Makefile-based生成器。特别是，它不会工作在vcxproj和Xcode生成器。
vcapp	仅适用于Windows。创建1个Visual Studio利用程序项目。
vclib	仅适用于Windows。创建1个Visual Studio库项目。

例如：

TEMPLATE = lib
SOURCES = main.cpp
TARGET = mylib

TRANSLATIONS

指定包括用户界面翻译文本的翻译(.ts)文件列表。

例如：

TRANSLATIONS += Resource/myapp_zh.ts \
                Resource/myapp_en.ts

UI_DIR

指定来自uic的所有中间文件放置的目录（.ui文件转化成ui_*.h文件的寄存目录）。

例如：

unix:UI_DIR = ../myproject/ui
win32:UI_DIR = c:/myproject/ui