Qt学习笔记之项目管理（pro）文件

痛定思痛。 2023-07-09 15:28 15阅读 0赞

# 一、概述 #

项目管理（pro）文件是对整个工程的配置，例如工程里包含哪些文件，路径是什么；以来哪些库，路径是什么；使用了Qt的哪些组件等等，实现自动化编译。

# 二、pro常用关键字的含义 #

## 2.1 QT ##

指定工程中使用的Qt的模块。默认情况下会使用Qt 的core和gui模块。

QT += core gui

## 2.2 TARGET ##

指定所生成.可执行文件名称。

TARGET = myOpencvTest1
    TEMPLATE = app

## 2.3 DEFINES ##

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

例如：

DEFINES += USE_MY_STUFF

然后就可以在代码中使用：

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

VS中也有类似的全局宏定义，在.dll工程中经常用到，来指定是 *dllexport* 还是 *dllimport* .

DEFINES += FUNDLL_LIBRARY

在头文件中使用上述宏定义：

#if defined(FUNDLL_LIBRARY)
    #  define FUNDLLSHARED_EXPORT __declspec(dllexport)
    #else
    #  define FUNDLLSHARED_EXPORT __declspec(dllimport)
    #endif

## 2.4 SOURCES ##

工程中使用的所有源文件的名字（不包含路径）。

SOURCES += \
            main.cpp \
            dialog.cpp

## 2.5 HEADERS ##

工程中使用的所有头文件的名字（不包含路径）。

HEADERS += \
            dialog.h

## 2.6 FORMS ##

列出工程中使用的UI文件（xml格式），这些文件会在编译之前被 uic（User Interface Compile，UI编译器） 处理。构建UI文件是所需的依赖项、头文件、源文件等都会自动被添加到工程中。

UIC会把 .ui（xml格式）文件转换成C++的 .h 文件（通常叫Ui\_dialog.h）。其实是在.h文件里定义一个类，里面包含了UI文件中的所以元素/对象。

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

## 2.7 INCLUDEPATH ##

列出工程中 \#include 项需要搜索的**路径**，即头文件的路径。多个路径用空格隔开。

INCLUDEPATH        = c:/msdev/include d:/stl/include
    win32:INCLUDEPATH += "C:/mylibs/extra headers"

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

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

## 2.8 DEPENDPATH ##

列出依赖项所在的**路径**。当处理included文件时会使用该项。

INCLUDEPATH += $$PWD/../mydll
    DEPENDPATH += $$PWD/../mydll

## 2.9 PWD ##

表示当前.pro文件所在的路径。

INCLUDEPATH += $$PWD/../mydll

## 2.10 OUT\_PWD ##

表示输出的“Makefile”所在的路径（通常在编译后生成的.exe文件的上层目录里）。

LIBS += -L$$OUT_PWD/../funDll/ -lfunDll

## 2.11 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

## 2.12 MOC\_DIR ##

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

例如：

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

## 2.13 OBJECTS\_DIR ##

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

例如：

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

## 2.14 RCC\_DIR ##

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

例如：

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

##    2.14 RESOURCES ##

指定资源文件 (qrc) 的名称，参考：Qt之资源系统

例如：

RESOURCES += Resource/resource.qrc

## 2.15 RC\_FILE ##

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

例如：

RC_FILE += myapp.rc

## 2.16 RC\_ICONS ##

仅适用于Windows，指定的图标应该包含在一个生成的.rc文件里。如果RC\_FILE 和RES\_FILE变量都没有设置这才可利用。

例如：

RC_ICONS = myapp.ico

## 2.17 TEMPLATE ##

模板变量告诉qmake为这个应用程序生成哪种makefile。

可供使用的选项：

<table style="width:500px;"> 
 <tbody> 
  <tr> 
   <td>选项</td> 
   <td>&nbsp;说明</td> 
  </tr> 
  <tr> 
   <td>app</td> 
   <td>创建一个用于构建应用程序的Makefile（默认）</td> 
  </tr> 
  <tr> 
   <td>lib</td> 
   <td>创建一个用于构建库的Makefile</td> 
  </tr> 
  <tr> 
   <td>subdirs</td> 
   <td>创建一个用于构建目标子目录的Makefile，子目录使用SUBDIRS变量指定</td> 
  </tr> 
  <tr> 
   <td>aux</td> 
   <td>创建一个不建任何东西的Makefile。如果没有编译器需要被调用来创建目标，比如你的项目使用解释型语言写的，使用此功能。注：此模板类型只能用于Makefile-based生成器。特别是，它不会工作在vcxproj和Xcode生成器。</td> 
  </tr> 
  <tr> 
   <td>vcapp</td> 
   <td>仅适用于Windows。创建一个Visual Studio应用程序项目</td> 
  </tr> 
  <tr> 
   <td>vclib</td> 
   <td>仅适用于Windows。创建一个Visual Studio库项目</td> 
  </tr> 
 </tbody> 
</table>

例如：

TEMPLATE = lib
    SOURCES = main.cpp
    TARGET = mylib

## 2.18 TRANSLATIONS ##

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

例如：

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

##    2.19 UI\_DIR ##

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

例如：

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

## 2.20 CONFIG ##

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

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

<table style="width:500px;"> 
 <tbody> 
  <tr> 
   <th>选项</th> 
   <th>说明</th> 
  </tr> 
  <tr> 
   <td>release</td> 
   <td>项目以release模式构建。如果也指定了debug，那么最后一个生效。</td> 
  </tr> 
  <tr> 
   <td>debug</td> 
   <td>项目以debug模式构建。</td> 
  </tr> 
  <tr> 
   <td>debug_and_release</td> 
   <td>项目准备以debug和release两种模式构建。</td> 
  </tr> 
  <tr> 
   <td>debug_and_release_target</td> 
   <td>此选项默认设置。如果也指定了debug_and_release，最终的debug和release构建在不同的目录</td> 
  </tr> 
  <tr> 
   <td>build_all</td> 
   <td>如果指定了debug_and_release，默认情况下，该项目会构建为debug和release模式。</td> 
  </tr> 
  <tr> 
   <td>autogen_precompile_source</td> 
   <td>自动生成一个.cpp文件，包含在.pro中指定的预编译头文件</td> 
  </tr> 
  <tr> 
   <td>ordered</td> 
   <td>使用subdirs模板时，此选项指定应该按照目录列表的顺序处理它们。</td> 
  </tr> 
  <tr> 
   <td>precompile_header</td> 
   <td>可以在项目中使用预编译头文件的支持。</td> 
  </tr> 
  <tr> 
   <td>warn_on</td> 
   <td>编译器应该输出尽可能多的警告。如果也指定了warn_off，最后一个生效</td> 
  </tr> 
  <tr> 
   <td>warn_off</td> 
   <td>编译器应该输出尽可能少的警告。</td> 
  </tr> 
  <tr> 
   <td>exceptions</td> 
   <td>启用异常支持。默认设置。</td> 
  </tr> 
  <tr> 
   <td>exceptions_off</td> 
   <td>禁用异常支持。</td> 
  </tr> 
  <tr> 
   <td>rtti</td> 
   <td>启用RTTI支持。默认情况下，使用编译器默认</td> 
  </tr> 
  <tr> 
   <td>rtti_off</td> 
   <td>禁用RTTI支持。默认情况下，使用编译器默认。</td> 
  </tr> 
  <tr> 
   <td>stl</td> 
   <td>启用STL支持。默认情况下，使用编译器默认。</td> 
  </tr> 
  <tr> 
   <td>stl_off</td> 
   <td>禁用STL支持。默认情况下，使用编译器默认</td> 
  </tr> 
  <tr> 
   <td>thread</td> 
   <td>启用线程支持。当CONFIG包括qt时启用，这是缺省设置。</td> 
  </tr> 
  <tr> 
   <td>c++11</td> 
   <td>启用c++11支持。如果编译器不支持c++11这个选项，没有影响。默认情况下，支持是禁用的</td> 
  </tr> 
  <tr> 
   <td>c++14</td> 
   <td>启用c++14支持。如果编译器不支持c++14这个选项，没有影响。默认情况下，支持是禁用的</td> 
  </tr> 
  <tr> 
   <td>qt</td> 
   <td>指应用程序使用Qt</td> 
  </tr> 
  <tr> 
   <td>dll</td> 
   <td>动态编译库</td> 
  </tr> 
  <tr> 
   <td>staticlib</td> 
   <td>静态编译库</td> 
  </tr> 
  <tr> 
   <td>plugin</td> 
   <td>编译一个插件</td> 
  </tr> 
  <tr> 
   <td>console</td> 
   <td>应用程序需要写控制台</td> 
  </tr> 
 </tbody> 
</table>

## 2.21 注释 ##

从“\#”开始，到这一行结束。快捷键：Ctrl+ /

#LIBS += -LC:\OpenCv4.0\x64\vc14\lib \
    #        -lopencv_world400d

# 三、Qt跨平台 #

在不同的编译平台上编译时，需要设定条件。如：

win32{
     SOURCES += 1.cpp
    }else{
     SOURCES += 2.cpp
    }

代码里

#ifdef Q_OS_WIN
        const char * const eol = "\r\n";
    #else
        const char *eol = "\n";
    #endif

qt定义的各个系统的宏定义  
Q\_OS\_AIX  
Defined on AIX.  
Q\_OS\_ANDROID  
Defined on Android.  
Q\_OS\_BSD4  
Defined on Any BSD 4.4 system.  
Q\_OS\_BSDI  
Defined on BSD/OS.  
Q\_OS\_CYGWIN  
Defined on Cygwin.  
Q\_OS\_DARWIN  
Defined on Darwin-based operating systems such as macOS, iOS, watchOS, and tvOS.  
Q\_OS\_DGUX  
Defined on DG/UX.  
Q\_OS\_DYNIX  
Defined on DYNIX/ptx.  
Q\_OS\_FREEBSD  
Defined on FreeBSD.  
Q\_OS\_HPUX  
Defined on HP-UX.  
Q\_OS\_HURD  
Defined on GNU Hurd.  
Q\_OS\_IOS  
Defined on iOS.  
Q\_OS\_IRIX  
Defined on SGI Irix.  
Q\_OS\_LINUX  
Defined on Linux.  
Q\_OS\_LYNX  
Defined on LynxOS.  
Q\_OS\_MAC  
Deprecated synonym for Q\_OS\_DARWIN. Do not use.  
Q\_OS\_MACOS  
Defined on macOS.  
Q\_OS\_NETBSD  
Defined on NetBSD.  
Q\_OS\_OPENBSD  
Defined on OpenBSD.  
Q\_OS\_OSF  
Defined on HP Tru64 UNIX.  
Q\_OS\_OSX  
Deprecated synonym for Q\_OS\_MACOS. Do not use.  
Q\_OS\_QNX  
Defined on QNX Neutrino.  
Q\_OS\_RELIANT  
Defined on Reliant UNIX.  
Q\_OS\_SCO  
Defined on SCO OpenServer 5.  
Q\_OS\_SOLARIS  
Defined on Sun Solaris.  
Q\_OS\_TVOS  
Defined on tvOS.  
Q\_OS\_ULTRIX  
Defined on DEC Ultrix.  
Q\_OS\_UNIX  
Defined on Any UNIX BSD/SYSV system.  
Q\_OS\_UNIXWARE  
Defined on UnixWare 7, Open UNIX 8.  
Q\_OS\_WATCHOS  
Defined on watchOS.  
Q\_OS\_WIN32  
Defined on 32-bit and 64-bit versions of Windows.  
Q\_OS\_WIN64  
Defined on 64-bit versions of Windows.  
Q\_OS\_WIN  
Defined on all supported versions of Windows. That is, if Q\_OS\_WIN32, Q\_OS\_WIN64, or Q\_OS\_WINRT is defined.  
Q\_OS\_WINPHONE  
Defined on Windows Phone 8.  
Q\_OS\_WINRT  
Defined for Windows Runtime (Windows Store apps) on Windows 8, Windows RT, and Windows Phone 8.

# 四 . pro中变量 #

<table> 
 <tbody> 
  <tr> 
   <td> <p>$$varName$${varName}</p> </td> 
   <td> <p>qmake工程文件内定义变量的值</p> </td> 
  </tr> 
  <tr> 
   <td> <p>$$(varName)</p> </td> 
   <td> <p>qmake运行时，环境变量的值</p> </td> 
  </tr> 
  <tr> 
   <td> <p>$(varName)</p> </td> 
   <td> <p>makefile被处理时，环境变量的值</p> </td> 
  </tr> 
  <tr> 
   <td> <p>$$[varName]</p> </td> 
   <td> <p>Qt配置选项的值</p> </td> 
  </tr> 
  <tr> 
   <td> <p>${varName}</p> </td> 
   <td> <p>你可能见过这个用法，但本文不讨论这个东西，以后用到时会提及</p> </td> 
  </tr> 
 </tbody> 
</table>

## 4.1 $$varName ##

例子：

*  test.pro

projectname = dbzhang
    FULL1 = $$projectname/800
    FULL2 = $${projectname}800
    !build_pass:message($$FULL2)

运行qmake时，输出结果是

Project MESSAGE: dbzhang/800 dbzhang800

*  何时加大括号？当变量和后面的字符连接到一块的时候。
 *  build\_pass 干嘛用的？自己试试看吧，如果没有它，同样的消息在windows下会被输出3次(因为会生成3个makefile文件，每个一次)。

## 4.2 $$(varName) ##

环境变量，就是大家通常说得环境变量。例子：

*  test.pro

message($$(PATH))

运行qmake时，结果：

Project MESSAGE: /usr/bin:/home/debao/qt-labs/qt5/qtbase/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games

## 4.3 $(varName) ##

makefile被处理时，环境变量的值?如何理解？？

看例子：

*  test.pro

INCLUDEPATH += $(MYINCLUDEPATH)

执行qmake

$ export MYINCLUDEPATH="/home/dbzhang800/include"
    $ qmake test.pro

生成的makefile：

...
    INCPATH = -I/usr/share/qt4/mkspecs/linux-g++ -I. -I/usr/include/qt4/QtCore -I/usr/include/qt4/QtGui -I/usr/include/qt4 -I$(MYINCLUDEPATH) -I.
    ...

为了对比，可以将单$符号，改成$$再试试看看，运行命令，结果：

...
    INCPATH = -I/usr/share/qt4/mkspecs/linux-g++ -I. -I/usr/include/qt4/QtCore -I/usr/include/qt4/QtGui -I/usr/include/qt4 -I/home/dbzhang800/include -I.
    ...

## 4.4 $$\[varName\] ##

Qt配置选项的值？何解？？

*  配置选项值有哪些？

debao@ubuntu:~/ttt/qmake-t1$ qmake -query
    QT_INSTALL_PREFIX:/usr
    QT_INSTALL_DATA:/usr/share/qt4
    QT_INSTALL_DOCS:/usr/share/qt4/doc
    QT_INSTALL_HEADERS:/usr/include/qt4
    QT_INSTALL_LIBS:/usr/lib
    QT_INSTALL_BINS:/usr/bin
    ...

*  有什么用呢？比如，我们编译一个动态库，想将dll放置到Qt的bin目录下(供其它程序使用)：

win32:{
        DLLDESTDIR = $$[QT_INSTALL_BINS]
        QMAKE_DISTCLEAN += $$[QT_INSTALL_BINS]\\dbzhang800.dll
    }

*  除了这些还有其他值么？恩，你可以自己设置一些值，比如

$ qmake -set dbzhang 800

然后就可以在pro文件内用 $$\[dbzhang\] 了

# 参考资料 #

1. [Qt中.pro文件介绍][Qt_.pro]

2. [Qt之资源系统][Qt]

3. [Qt之生成Window资源文件（.rc 文件）][Qt_Window_.rc]

4.[Qt 之 pro 配置详解][Qt _ pro]

5. [Linux下的QT的库路径设置和连接][Linux_QT]

6. [浅谈 qmake 之 pro、pri、prf、prl文件][qmake _ pro_pri_prf_prl]

7. [浅谈 qmake 之 shadow build][qmake _ shadow build]

8. [qmake 之 CONFIG(debug, debug|release)][qmake _ CONFIG_debug_ debug_release]

9. [qmake 之 CONFIG 与 QT 乱谈][qmake _ CONFIG _ QT]

[Qt_.pro]: https://www.jianshu.com/p/682b9ab004c9
[Qt]: http://blog.csdn.net/liang19890820/article/details/51994441
[Qt_Window_.rc]: http://blog.csdn.net/u011012932/article/details/52702523
[Qt _ pro]: https://blog.csdn.net/liang19890820/article/details/51774724
[Linux_QT]: https://blog.csdn.net/chenglinliang/article/details/77684009
[qmake _ pro_pri_prf_prl]: http://blog.csdn.net/dbzhang800/article/details/6348432
[qmake _ shadow build]: http://blog.csdn.net/dbzhang800/article/details/6343838
[qmake _ CONFIG_debug_ debug_release]: http://hi.baidu.com/cyclone/blog/item/d77a8618608448b94bedbc0b.html
[qmake _ CONFIG _ QT]: http://hi.baidu.com/cyclone/blog/item/d299af511bed309f8c5430c3.html