Qt 中的多项目管理

背景：

在Visual Studio中使用 “Solution” 来组织多个 Projects。

在Qt中，使用 "Subdirs Project"来组成多个projects ，实现VS中的Solution功能。

项目类型

首先是先新建一个子目录项目，再根据需要在子目录项目中添加一个应用程序项目以及多个库的项目，子目录项目默认就只有一个.pro文件。

“subdirs”模板告诉qmake生成一个makefile，它可以进入到特定子目录并为这个目录中的项目文件生成makefile并且为它调用make。

在这个模板中只有一个系统变量SUBDIRS可以被识别。这个变量中包含了所要处理的含有项目文件的子目录的列表。这个项目文件的名称是和子目录同名的，这样qmake就可以发现它。例如，如果子目里是“MainApp”，那么在这个目录中的项目文件应该被叫做MainApp.pro。

.pro文件配置

选项	说明
TEMPLATE	模板变量告诉qmake为这个应用程序生成哪种makefile。
CONFIG	指定编译器选项和项目配置，值由qmake内部识别并具有特殊意义。
DEFINES	qmake添加这个变量的值作为编译器C预处理器宏(-D选项)。
INCLUDEPATH	指定编译项目时应该被搜索的#include目录。
DEPENDPATH	指定程序编译时依赖的相关路径。
DESTDIR	指定在何处放置目标文件。
TARGET	指定目标文件的名称。默认情况下包含的项目文件的基本名称。
OUT_PWD	指定构建目录。
MOC_DIR	指定来自moc的所有中间文件放置的目录（含Q_OBJECT宏的头文件转换成标准.h文件的存放目录）。
OBJECTS_DIR	指定所有中间文件.o（.obj）放置的目录。
RCC_DIR	指定Qt资源编译器输出文件的目录（.qrc文件转换成qrc_*.h文件的存放目录）。
LIBS	指定链接到项目中的库列表。-L后是库文件的目录，-l后是具体的库的名字(后缀不用加)。 例如：LIBS += -L$$PWD/../../../ThirdLib/winapi -lWSock32
RC_ICONS	仅适用于Windows，指定的图标应该包含在一个生成的.rc文件里。如果RC_FILE 和RES_FILE变量都没有设置这才可利用。
TRANSLATIONS	指定包含用户界面翻译文本的翻译(.ts)文件列表。

TEMPLATE 配置项

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

CONFIG 配置项

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

选项	说明
release	项目以release模式构建。如果也指定了debug，那么最后一个生效。
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	自动生成一个.cpp文件，包含在.pro中指定的预编译头文件。
ordered	使用subdirs模板时，此选项指定应该按照目录列表的顺序处理它们。
precompile_header	可以在项目中使用预编译头文件的支持。
warn_on	编译器应该输出尽可能多的警告。如果也指定了warn_off，最后一个生效。
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这个选项，没有影响。默认情况下，支持是禁用的。

平台相关性处理

为Windows平台加的依赖平台的文件的简单的作用域看起来就像这样：
win32 { SOURCES += hello_win.cpp }

子项目 .pro文件

每次添加一个子项目就会在SUBDIRS项目加上一个项目名，子目录项目的TEMPLATE = subdirs。
CONFIG += ordered是让项目按照顺序编译，由于主程序依赖于对应的库，一般都是把MainApp放在SUBDIRS的最后。

主程序pro文件

主程序的TEMPLATE = app。除了常规的 pro 设置外，要记得将自己编的库的头文件目录加上，并将生成的 dll 通过LIBS链接：

#library
INCLUDEPATH += \
    $$PWD/../../Libraries \

LIBS += \
    -L$$DESTDIR -lComponent -lcommonLibs \

库pro文件

库的TEMPLATE = lib。库在通过Creator新建的时候会生成一个xxx_global.h，定义了导出库的相关信息：

#include <QtCore/qglobal.h>

#if defined(TESTLIB_LIBRARY)
#  define TESTLIBSHARED_EXPORT Q_DECL_EXPORT
#else
#  define TESTLIBSHARED_EXPORT Q_DECL_IMPORT
#endif

在库中要作为接口的类记得加上对应的宏：
class TESTLIBSHARED_EXPORT TestLib : public QObject
静态库貌似不需要这个，待测试…

.pri文件

对于一些库和主程序都需要的目录设置 (构建目录、obj生成目录、moc文件生成目录等)，可以统一写在一个 pri 文件中：

CONFIG(release, debug|release) {
    BuildType=release
    CONFIG += warn_off
} else {
    BuildType=debug
    DEFINES += __DEBUG
}

INTERMEDIATE_DIR = $$PWD/../Intermediate/$$BuildType

DESTDIR         = $$PWD/../RunImage/$$BuildType
OUT_PWD         = $$INTERMEDIATE_DIR/$$TARGET
MOC_DIR         = $$INTERMEDIATE_DIR/$$TARGET
OBJECTS_DIR     = $$INTERMEDIATE_DIR/$$TARGET
RCC_DIR         = $$INTERMEDIATE_DIR/$$TARGET
UI_DIR          = $$INTERMEDIATE_DIR/$$TARGET

在需要引用的pro文件中：

include($$PWD/../../../Path.pri)

查看变量信息

message($$INCLUDEPATH), 会在概要信息中打印相关变量的值

---

实践操作（如何使用QMake的 subdirs模板？）

创建Subdirs类型的工程

添加子工程

添加的子工程可以是.exe类型的，也可以是.dll类型的。

子工程的相互引用

.exe工程通常需要引用其他.dll类型的工程，步骤如下。

1. 右击工程（例如.exe工程），选择“Add Library…”。
   

2. 选择“Internal Library”，即选择在同一个solution（编译树）下的库。这会把库文件和头文件的路径添加到.pro文件中。
   

3. 选择要引用的库对应的工程(在同一个solution下)
   

4. Qt会自动往.pro文件中添加引用库的库文件&头文件的路径和文件名。
   
   （指定LIBS库文件的路径和名称，指定#include文件的路径，指定依赖项的路径）。

深入了解：

Subdirs工程自身只有一个.pro文件，如下图所示。除了 “TEMPLATE=subdirs”，

“SUBDIRS”后面列出了该subdirs包含的所有工程，编译顺序按工程列出的书序进行。下图中先编译funDll，然后是mydll，最后是subWidgets。

参考资料
Qt之pro配置详解
QT中PRO文件写法的详细介绍
QT中的Solution-Subdirs Project