qt qmake详解

【实例简介】将qmake详解撸一遍，QT将更美好一点

【实例截图】

qmake基础
[TOC]

一.qmake是什么
qmake是Qt提供的一个编译打包的工具，简单的理解就是makefile的生成器，根据Qt项目工程文件(.pro)来生成对应的makefile。（这个阶段里配合moc、UIC和RCC工具生成C 的头文件和源文件。）
二.qmake语法
TEMPLATE

功能：模板变量，告诉qmake为这个程序生成哪种makefile，下面是可供使用的选择：

app - 建立一个应用程序的makefile。这是默认值，如果模板没有被指定，这个将被使用。

lib - 建立一个库的makefile。

vcapp - 建立一个应用程序的visual studio项目文件。

vclib - 建立一个库的visual studio的项目文件。

subdirs - 这是一个特殊的模板。它可以创建一个能够进入特定目录并且为一个项目文件生成makefile并且为它调用make的makefile。

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

可参考官网：https://doc.qt.io/qt-5/qmake-variable-reference.html

TEMPLATE = app

HEADERS

功能：所有头文件的列表。

HEADERS = hello.h

SOURCES

功能：所有源文件的列表。

SOURCES = hello.cpp

FORMS

功能：所有的.ui文件的列表。

FORMS = hello.ui

LEXSOURCES

功能：所有lex源文件的列表。(与语法文件有关)

LEXSOURCES = grammer.l

YACCSOURCES

功能：所有yacc源文件的列表。(与语法文件有关)

YACCSOURCES = grammer.y

TARGET

功能：可执行应用程序的名称。默认值为项目名称。（如果需要扩展名，会被自动加上）

TARGET = hello

DESTDIR

功能：放置可执行程序目标的目录。

DESTDIR = /mnt/qt/helloapp

DEFINES

功能：应用程序所需的额外的预处理程序定义的列表。类似gcc -D条件编译功能，在源码里可以使用此宏定义

DEFINES = HSDEFINED

INCLUDEPATH

功能：头文件的路径列表

INCLUDEPATH = /mnt/qt/include

DEPENDPATH

功能：应用程序所依赖的搜索路径。当包含文件时使用。

DEPENDPATH = . forms include qrc sources

VPATH

功能：寻找补充文件的搜索路径。

LIBS

功能：引入lib文件或者路径。-L：引入路径；-l：引入文件

LIBS = -L libPath //引入lib文件路径

LIBS = -lLibName //引入lib文件

LIBS = -L“$(OutDir)” \

-lopengl32

QT

功能：加入QT库模块

参考：官方QT库模块（英文）、Qt类库模块详细划分、Qt各大模块简介

QT = qml quick

CONFIG

配置变量指定了编译器所要使用的选项和所需要被连接的库。配置变量中可以添加任何东西，但只有下面这些选项可以被qmake识别。

下面这些选项控制着使用哪些编译器标志：

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 - 使用子模板时，此选项指定应该按照目录列表的顺序处理它们。
precompile_header - 可以在项目中使用预编译头文件的支持。
warn_on - 编译器会输出尽可能多的警告信息。如果“warn_off”被指定，它将被忽略。
warn_off - 编译器会输出尽可能少的警告信息。
exceptions - 启用异常支持。默认设置。
exceptions_off - 禁用异常支持。
rtti - 启用RTTI支持。默认情况下，使用编译器默认。
rtti_off - 禁用RTTI支持。默认情况下，使用编译器默认。
stl - 启用STL支持。默认情况下，使用编译器默认。
stl_off - 禁用STL支持。默认情况下，使用编译器默认。
c 11 - 启用c 11支持。如果编译器不支持c 11这个选项，没有影响。默认情况下，支持是禁用的。
c 14 - 启用c 14支持。如果编译器不支持c 14这个选项，没有影响。默认情况下，支持是禁用的。
下面这些选项定义了所要连编的库/应用程序的类型：

qt - 应用程序是一个Qt应用程序，并且Qt库将会被连接。
thread - 应用程序是一个多线程应用程序。
x11 - 应用程序是一个X11应用程序或库。
windows - 只用于“app”模板：应用程序是一个Windows下的窗口应用程序。
console - 只用于“app”模板：应用程序是一个Windows下的控制台应用程序。
dll - 只用于“lib”模板：库是一个共享库（dll）。
staticlib - 只用于“lib”模板：库是一个静态库。
plugin - 只用于“lib”模板：库是一个插件，这将会使dll选项生效。
例如，如果你的应用程序使用Qt库，并且你想把它连编为一个可调试的多线程的应用程序，你的项目文件应该会有下面这行：

CONFIG = qt thread debug
注意，你必须使用“ =”，不要使用“=”，否则qmake就不能正确使用连编Qt的设置了，比如没法获得所编译的Qt库的类型了。

VERSION

功能：当使用“lib”模板的时候(TEMPLATE=lib)，生成目标库的版本号。

VERSION=2.3.1

DEF_FILE（windows需要）

RC_FILE（windows需要）

RES_FILE（windows需要）

功能：寻找补充文件的搜索路径

举一个实际的例子：

TEMPLATE = app
DESTDIR = c:\helloapp
HEADERS = hello.h
SOURCES = hello.cpp 
SOURCES = main.cpp
DEFINES = QT_DLL
CONFIG = qt warn_on release
值得强调一点的是，如果条目是单值的，比如template或者目的目录，我们是用“=”，但如果是多值条目，我们使用“ =”来为这个类型添加现有的条目。使用“=”会用新值替换原有的值，例如，如果我们写了DEFINES=QT_DLL，其它所有的定义都将被删除。

三、qmake高级概念
操作符

"="操作符 ： 分配一个值给一个变量

“ =”操作符 ： 向一个变量的值的列表中添加一个值

“-=”操作符 ： 从一个变量的值的列表中移去一个值

“*=”操作符 ： 仅仅在一个值不存在于一个变量的值的列表中的时候，把它添加进去

“~=”操作符 ： 替换任何与指定的值的正则表达式匹配的任何值

DEFINES ~= s/QT_[DT]. /QT
（这将会用QT来替代任何以QT_D或QT_T开头的变量中的QT_D或QT_T）
作用域

CONFIG行中的任何条目都是一个作用域，举几个例子

win32 {
   thread {
    DEFINES = QT_THREAD_SUPPORT
   }
}
为避免许多嵌套作用域（避免上个例子的写法），我们可以这样使用冒号来嵌套作用域
win32:thread {
        DEFINES = QT_THREAD_SUPPORT   

} else:debug {       

    DEFINES = QT_NOTHREAD_DEBUG   

} else {      

    warning("Unknown configuration")   

}  
win32{
    DEFINES  = QT_DLL
}
可以写作：
win32：DEFINES = QT_DLL

unix{     
DEFINES  = QT_LIB
}
!win32 {
        DEFINES = QT_LIB
}
变量

上面的一些都是系统变量，如DEFINES、SOURCES和HEADERS。

我们也可以自己创建一些变量，如：

MY_VARIABLE = value
或者将任何一个变量分配给一个变量，前面加上$$,例如：

MY_DEFINES = $$DEFINES
测试函数

contains( variablename, value )
如果value存在于一个被叫做variablename的变量的值的列表中，那么这个作用域中的设置将会被处理。例如：

contains( CONFIG, thread ) {
    DEFINES = QT_THREAD_SUPPORT
}
如果thread存在于CONFIG变量的值的列表中时，那么QT_THREAD_SUPPORT将会被加入到DEFINES变量的值的列表中。

count( variablename, number )
如果number与一个被叫做variablename的变量的值的数量一致，那么这个作用域中的设置将会被处理。例如：

count( DEFINES, 5 ) {
   CONFIG = debug
}
error( string )
这个函数输出所给定的字符串，然后会使qmake退出。例如：

error( "An error has occured" )
文本“An error has occured”将会被显示在控制台上并且qmake将会退出。

exists( filename )
如果指定文件存在，那么这个作用域中的设置将会被处理。例如：

exists( /local/qt/qmake/main.cpp ) {
    SOURCES = main.cpp
}
如果*/local/qt/qmake/main.cpp*存在，那么main.cpp将会被添加到源文件列表中。

注意可以不用考虑平台使用“/”作为目录的分隔符。

include( filename )
项目文件在这一点时包含这个文件名的内容，所以指定文件中的任何设置都将会被处理。例如：

include( myotherapp.pro )
myotherapp.pro项目文件中的任何设置现在都会被处理。

isEmpty( variablename )
这和使用count( variablename, 0 )是一样的。如果叫做variablename的变量没有任何元素，那么这个作用域中的设置将会被处理。例如：

isEmpty( CONFIG ) {
    CONFIG = qt warn_on debug
}
message( string )
这个函数只是简单地在控制台上输出消息。

message( "This is a message" )
文本“This is a message”被输出到控制台上并且对于项目文件的处理将会继续进行。

system( command )
特定指令被执行并且如果它返回一个1的退出值，那么这个作用域中的设置将会被处理。例如：

system( ls /bin ) {
    SOURCES = bin/main.cpp
    HEADERS = bin/main.h
}
所以如果命令ls /bin返回1，那么bin/main.cpp将被添加到源文件列表中并且bin/main.h将被添加到头文件列表中。

infile( filename, var, val )
如果filename文件（当它被qmake自己解析时）包含一个值为val的变量var，那么这个函数将会返回成功。你也可以不传递第三个参数（val），这时函数将只测试文件中是否分配有这样一个变量var。