Qt项目管理（33个规则）

一、qmake的介绍

    qmake是Trolltech公司创建的用来为不同的平台和编译器书写Makefile的工具。

    手写Makefile是比较困难并且容易出错的，尤其是需要给不同的平台和编译器组合写几个Makefile。使用qmake，开发者创建一个简单的“项目”文件并且运行qmake生成适当的Makefile。qmake会注意所有的编译器和平台的依赖性，可以把开发者解放出来只关心他们的代码。Trolltech公司使用qmake作为Qt库和Qt所提供的工具的主要连编工具。

    qmake也注意了Qt的特殊需求，可以自动的包含moc和uic的连编规则。

Qmake 编译信息可以通过qmake.conf进行配置。

二、pro、pri、prf、prl

    Qt的工程管理文件常用的主要分为pro、pri、prf、prl四种类型的文件，其中pro文件是主文件，另外三种都可以包含在pro文件中，他们的书写规则都遵循qmake的规则。

    1、prl链接文件，这个文件主要和生成与使用静态库密切相关。

    生成静态库时，我们需要使用 config += create_prl 配置，编译生成和库文件同名的 *.prl 文件；

    当工程的TEMPLATE为app时，会自动添加如下指令CONFIG += link_prl，在查找库文件的时候，会尝试找相应的 *.prl 文件进行链接。

    2、prf特征文件，这个文件主要标识编译特性，可以使用两种方式加载

    1）CONFIG += *prf；

    2）load(*prf)。

    3、pri配置文件，通常放置一些通用的配置信息，进行工程管理。

    4、pro工程管理文件，通常放置与具体工程相关的信息，以及进行层叠式模块的管理。

三、qmake的规则简介

    1、使用 # 进行注释；

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

    例如 TEMPLATE = app 应用程序
    app -建立一个应用程序的makefile。

    lib - 建立一个库的makefile。
    vcapp - 建立一个应用程序的VisualStudio项目文件。
    vclib - 建立一个库的VisualStudio项目文件。
    subdirs -这是一个特殊的模板，创建层叠式子目录，进行工程管理。

（eg:TEMPLATE = subdirs

     SUBDIRS += one

     SUBDIRS += two)

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

    4、指定生成的应用程序名 TARGET = pksystem （和pro文件名相同）；

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

    例如CONFIG+= qt warn_on release，其中+=为追加，=为赋值，warn_on为qmake要把编译器设置为输出警告信息的，release部分告诉qmake应用程序必须被连编为一个发布的应用程序，此处可以使用debug替换。
    6、指定uic命令，将.ui文件转化成ui_*.h文件的存放的目录 UI_DIR += forms ；

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

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

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

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

    11、头文件包含路径 INCLUDEPATH += . ；

    12、源文件编码方式 CODECFORSRC = GBK ；

    13、工程中包含的头文件 HEADERS += *.h ；

    14、工程中包含的源文件SOURCES += *.cpp ；
    15、工程中包含的.ui设计文件 FORMS += *.ui ；
    16、工程中包含的资源文件 RESOURCES += *.qrc ；

    17、LIBS += -L库路径 -l库名 ；

    18、定义编译选项，DEFINES += XX，在.h文件中就可以使用：#ifdefine xx；

    19、条件编译 （主要区分不同平台和release、debug版本）

    win32 {

    SOURCES += *.cpp

    }

    unix {

    SOURCES += *.cpp

    }

    !exists( main.cpp ) {

    error( “No main.cpp file found” )

    }

    win32:debug {

    CONFIG += console

    }

    CONFIG(debug, debug|release) {

}

（注：｛必须放置在条件的同一行））

    20、message（信息）；

    21、Include（*.pro/*.pri）；

    22、Translations Qt语言国际化文件

    23、命令行（配置好Qt环境变量）qmake -project 生成pro文件（需要配置qmake.conf手动修改pro文件进行处理），qmake  *.pro生成makefile文件，nmake（区分编译器）编译即可；

    24、qmake -tp vc *.pro（-r）生成vs解决方案；

    25、qmake -spec macx-xcode *.pro 生成xcode工程文件；

    26、warn_off - 编译器会输出尽可能少的警告信息；

    27、QT += xml  加入Qt模块；

    28、INSTALLS + = target sources   指定安装路径；

    29、QMAKE_CXXFLAGS_WARN_ON C++编译器警告；

    30、QMAKE_CFLAGS_WARN_ON C编译器警告；

    31、W34100  unreferenced formal parameter ;

    32、W34189  local variable is initialized but not referenced；

    33、contains（config，thread）根据thread是否在config中进行编译。

四、qmake编译选项

    1、qmake [options] files

    1）-help 列出qmake帮助信息；

    2）-o file 直接输出到文件file，如果这个选项没有指定, qmake将会尝试使用合适的文件名作为输出,这依赖于当前的运行模式。
    3）-d 列出qmake的调试信息；

    4）-Wall   qmake将会报告所有知道的警告信息。

五、参考链接

    1、http://www.kuqin.com/qtdocument/qmake-manual-7.html

    2、https://msdn.microsoft.com/en-us/library/ysb0wexw.aspx