背景:
在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后是具体的库的名字(后缀不用加)。 例如: |
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
类型的工程,步骤如下。
- 右击工程(例如
.exe
工程),选择“Add Library…”。 - 选择“Internal Library”,即选择在同一个solution(编译树)下的库。这会把库文件和头文件的路径添加到
.pro
文件中。 - 选择要引用的库对应的工程(在同一个solution下)
- Qt会自动往
.pro
文件中添加引用库的库文件&
头文件的路径和文件名。 - (指定LIBS库文件的路径和名称,指定#include文件的路径,指定依赖项的路径)。
深入了解:
Subdirs工程自身只有一个.pro文件,如下图所示。除了 “TEMPLATE=subdirs”,
“SUBDIRS”后面列出了该subdirs包含的所有工程,编译顺序按工程列出的书序进行。下图中先编译funDll,然后是mydll,最后是subWidgets。
参考资料
Qt之pro配置详解QT中PRO文件写法的详细介绍QT中的Solution-Subdirs Project