QT中的.pro文件，以及.pri .prj .prl文件说明

转载自: http://blog.csdn.net/zjc0230/article/details/37815365

在QT中，有一个工具qmake可以生成一个makefile文件，它是由.pro文件生成而来的，.pro文件的写法如下：

1. 注释
从“#”开始，到这一行结束。

2.模板变量告诉qmake为这个应用程序生成哪种makefile。下面是可供使用的选择：
TEMPLATE = app
A> app -建立一个应用程序的makefile。这是默认值，所以如果模板没有被指定，这个将被使用。
B> lib - 建立一个库的makefile。
C> vcapp - 建立一个应用程序的VisualStudio项目文件。
D> vclib - 建立一个库的VisualStudio项目文件。
E> subdirs -这是一个特殊的模板，它可以创建一个能够进入特定目录并且为一个项目文件生成makefile并且为它调用make的makefile。

#指定生成的应用程序放置的目录
DESTDIR += ../bin

#指定生成的应用程序名
TARGET = pksystem

#配置信息
CONFIG用来告诉qmake关于应用程序的配置信息。

CONFIG+= qt warn_on release

在这里使用“+=”，是因为我们添加我们的配置选项到任何一个已经存在中。这样做比使用“=”那样替换已经指定的所有选项是更安全的。
A> qt部分告诉qmake这个应用程序是使用Qt来连编的。这也就是说qmake在连接和为编译添加所需的包含路径的时候会考虑到Qt库的。
B> warn_on部分告诉qmake要把编译器设置为输出警告信息的。
C> release部分告诉qmake应用程序必须被连编为一个发布的应用程序。在开发过程中，程序员也可以使用debug来替换release

#指定uic命令将.ui文件转化成ui_*.h文件的存放的目录
UI_DIR += forms

#指定rcc命令将.qrc文件转换成qrc_*.h文件的存放目录
RCC_DIR += ../tmp

#指定moc命令将含Q_OBJECT的头文件转换成标准.h文件的存放目录
MOC_DIR += ../tmp

#指定目标文件(obj)的存放目录
OBJECTS_DIR += ../tmp

#程序编译时依赖的相关路径
DEPENDPATH += . forms include qrc sources

#头文件包含路径
INCLUDEPATH += .

#qmake时产生的信息,【{a}读取变量a的字符串】,【(PATH)读取环境变量PATH】
#message($$(PATH))

#源文件编码方式
CODECFORSRC = GBK

#工程中包含的头文件
HEADERS += include/painter.h
#工程中包含的.ui设计文件
FORMS += forms/painter.ui
#工程中包含的源文件
SOURCES += sources/main.cpp sources/painter.cpp
#工程中包含的资源文件
RESOURCES += qrc/painter.qrc

LIBS += -L folderPath //引入的lib文件的路径 -L：引入路径

Release:LIBS += -L folderPath // release 版引入的lib文件路径

Debug:LIBS += -L folderPath // Debug 版引入的lib 文件路径

DEFINES += XX_XX_XXX //定义编译选项，在.h文件中就可以使用 ：#ifdefine xx_xx_xxx

RC_FILE = xxx.icns

7. 平台相关性处理
我们在这里需要做的是根据qmake所运行的平台来使用相应的作用域来进行处理。为Windows平台添加的依赖平台的文件的简单的作用域看起来就像这样：

win32 {
SOURCES += hello_win.cpp
}
====================================================================================================================
当你已经创建好你的项目文件，生成Makefile就很容易了，你所要做的就是先到你所生成的项目文件那里然后输入：

Makefile可以像这样由“.pro”文件生成：

qmake -oMakefile hello.pro

对于VisualStudio的用户，qmake也可以生成“.dsp”文件，例如：

qmake -tvcapp -o hello.dsp hello.pro

++++++++++++++++++++++++一个PRO文件实例++++++++++++++++++++++++++++++++++++++++

TEMPLATE = app #模块配置
LANGUAGE = C++ #C++语言

CONFIG += qt warn_on debug release

#引入的lib文件,用于引入动态链接库
LIBS += qaxcontainer.lib

#头文件包含路径
INCLUDEPATH += ../../qtcompnent/qtchklisten/inc ../../qtcompnent/qtclearfile/inc ../../validator/inc/validerrcode ../../qtcompnent/qtdir/inc ../inc ../../utillib/inc/xmlapi ../../utillib/inc/util ../../xercesc ../../qtcompnent/qteditor/inc ../../qtcompnent/qtfunreview/inc ../../qtcompnent/qttable/inc ../../qtcompnent/qtversion/inc ../../qtcompnent/qtini/inc ../../icdtool/icdservices/inc ../../icdtool/dataset/inc ../../icdtool/doi/inc ../../icdtool/reportcontrol/inc ../../icdtool/GSEconctrol/inc ../../icdtool/inputs/inc ../../icdtool/SMVconctrol/inc ../../icdtool/logcontrol/inc ../../scdpreview/inc/scdpreviewtoollib ../../scdpreview/form ../../icdtool/sclcontrol/inc ../../icdtool/log/inc ../../icdtool/settingcontrol/inc ../../qtcompnent/qteditor/inc ../../qtcompnent/qttreeview/inc ../../qtcompnent/qttabwidget/inc ../../communication/inc ../../qtcompnent/qtabout/inc ../iedmanage/inc ../ldmanage/inc ../foriecrun/inc ../../qtcompnent/validset/inc

#工程中包含的头文件
HEADERS += ../inc/exportstable.h /
../inc/maintabwidget.h /
../inc/outputtab.h /
../inc/strutil.h /
../inc/treeeditview.h /
../inc/MainForm.h /
../inc/recenfileini.h /
../inc/ExportCIDFunction.h

#工程中包含的源文件
SOURCES += ../src/main.cpp /
../src/exportstable.cpp /
../src/maintabwidget.cpp /
../src/outputtab.cpp /
../src/treeeditview.cpp /
../src/MainForm.cpp /
../src/recenfileini.cpp /
../src/ExportCIDFunction.cpp

#工程中包含的.ui设计文件
FORMS = ../form/scdmainform.ui /
../form/exportiedform.ui /
../form/Exportsedform.ui /
../form/Importsedform.ui /
../form/formiminputs.ui

#图像文件

IMAGES = images/substation.png /
images/communication.png /
images/autocom.png /
images/reportcfg.png /
images/comcfg.png /
images/filetrans.png /
images/review.png /
images/setting.png

#工程中包含的资源文件
RESOURCES = Scintilla.qrc

#CONFIG -= release
CONFIG -= debug

RC_FILE = scdtool.rc

BINLIB = ../../bin ../../xercesc/lib

UI_HEADERS_DIR = ../inc # .ui文件转会为**.h 存放的目录
UI_SOURCES_DIR = ../src # .ui文件转会为**.cpp 存放的目录
QMAKE_LIBDIR = $${BINLIB}

release {
TARGET = scdtool #指定生成的应用程序名
OBJECTS_DIR = ../../obj/scdtool/release #指定目标文件(obj)的存放目录
}
debug {
TARGET = scdtool_d #指定生成的应用程序名
OBJECTS_DIR = ../../obj/scdtool/debug #指定目标文件(obj)的存放目录
}

MOC_DIR = $${OBJECTS_DIR}
DESTDIR = ../../bin #指定生成的应用程序放置的目录

尽管每次和cmake对比起来，我们总是说 qmake 简单、功能少。但是qmake仍然是一个非常复杂的东西，我想大多人应该和我一样吧：

• 不是太清楚CONFIG等变量到底如何起作用的
• 用过的qmake内置变量和函数不超过20个

• 看Qt Creator源码或者QtSolution等库中自己使用的 *.pro 文件就想看天书一样

本文只能抓住一条线，简单介绍一下 *.pro、*.pri、*.prf、*.prl等四种文件：干嘛用的，如何用的

*.pro

qmake 的工程(project)文件，这个大家肯定都非常熟悉了。那我就不费话了，上例子：

这是一个典型的Qt示例程序的.pro文件(propriprfprl.pro)：

TEMPLATE = app
CONFIG += QT
QT += core gui

TARGET = propriprfprl

SOURCES += main.cpp/
        widget.cpp
HEADERS  += widget.h
FORMS    += widget.ui

• 前面3行是qmake的默认值，我们都可以省略
• TARGET 这行指定工程名，我们也可以省略

*.pri

i 是什么东西？包含(include)的首字母。类似于C、C++中的头文件吧，反正就是我们可以吧 *.pro 文件内的一部分单独放到一个 *.pri 文件内，然后包含进来。

接前面的例子，我们将源文件的设置独立出来，放到propriprfprl.pri文件内：

SOURCES += main.cpp/
        widget.cpp
HEADERS  += widget.h
FORMS    += widget.ui

这时，我们的 propriprfprl.pro 文件就可以简化为：

TEMPLATE = app
CONFIG += QT
QT += core gui

TARGET = propriprfprl
include(propriprfprl.pri)

• 这有什么用呢？对我们这个例子来说，确实没什么用，反而多了一个文件，更麻烦了。
• 可是，如果一个大点的项目，含有多个*.pro文件呢，这些pro需要有些共同的设置或需要的文件，这时就很有必要了。

*.prf

f又是神马东东？特性(feature)的首字符

• 和pri文件类似，该文件也是要被包含进pro文件的
• 只是：它更隐蔽
• 你经常和它打交道，可能却一直视而不见

我们这个例子中其实已经用到了，这就是

CONFIG+=QT

当我们在CONFIG中指定一个东西时，qmake就会尝试去加载相应的feature文件：

• Qt安装目录下的 mkspecs/features/qt.prf
• features 文件的文件名必须小写
• qmake 去哪些目录下搜索features文件呢？
  • manual中有介绍，此处略
  • 暂时只知道前面提到的 $$QTDIR/mkspecs/features 就可以了

写一个自己的features文件：propriprfprl.prf

win32:CONFIG += console

• 为win32的程序添加控制台，有点多次一举哈。
• 将该文件放置到我们前面提到的目录中

然后在pro文件内添加

CONFIG += propriprfprl

看到和 CONFIG += console 同样的效果了吧？

注：我们也可以使用 load命令来加载prf文件，比如前面的命令可以认为等价于

load(propriprfprl)

*.prl

l 这个东西容易理解，链接(link)的首字符。主要和生成与使用静态库密切相关(动态库也可以有该文件，去Qt安装目录下的lib目录下看看即可)。

• 生成静态库时，我们需要使用下列配置(进而生成和库文件同名的 *.prl 文件)

CONFIG += create_prl

• 当工程的TEMPLATE为app时，会自动添加如下指令(找库文件的时候，会尝试找相应的 *.prl 文件)

CONFIG += link_pri

那么该文件有什么用处呢？举一个大家可能熟悉的例子QextSerialPort1.2这个库(windows下的情况)：

• 编译时，需要 setupapi.lib advapi32.lib user32.lib 这几个库文件
• 编译成静态库以后，它本身是不包含这3个库文件信息的

• 于是，当我们使用这个 QextSerialPort 静态库，还是需要指定 这几个库文件

如果有prl文件呢，该文件就会包含依赖信息了，我们看一下：

QMAKE_PRL_BUILD_DIR = E:/dbzhang800-qextserialport/buildlib
QMAKE_PRO_INPUT = buildlib.pro
QMAKE_PRL_TARGET = qextserialport-1.2
QMAKE_PRL_CONFIG = include_source_dir incredibuild_xge lex yacc warn_on uic resources incremental_off windows release ReleaseBuild Release build_pass qt warn_on release incremental flat link_prl precompile_header autogen_precompile_source copy_dir_files debug_and_release debug_and_release_target embed_manifest_dll embed_manifest_exe stl exceptions rtti mmx 3dnow sse sse2 release ReleaseBuild Release build_pass qt qextserialport-buildlib create_prl qextserialport-uselib qextserialport-static static debug_and_release build_all release ReleaseBuild Release build_pass no_autoqmake staticlib static moc thread
QMAKE_PRL_LIBS = setupapi.lib advapi32.lib user32.lib d://Qt//4.7.0//lib//QtGui4.lib d://Qt//4.7.0//lib//QtCore4.lib 

参考

• qmake manual:qmake-advanced-usage.html
• qmake manual:qmake-variable-reference.html

• http://www.qtcentre.org/wiki/index.php?title=Undocumented_qmake