Qt项目管理(33个规则)

时间:2023-03-09 14:56:35
Qt项目管理(33个规则)
2016-06-20 花莫弦 小小杂货铺LY

一、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

http://mp.weixin.qq.com/s?__biz=MzI4NzIwMDQ3OA==&mid=2247483680&idx=1&sn=33844b0bfdb9cae3be8c2137f9e70d11&scene=23&srcid=0620axBP8kO6hzc03MHxqfNV#rd