Qt pro文件中的常用宏说明

目录

• 一、注释：
• 二、include：
• 三、平台宏：
• 四、作用域：
• 五、操作符
• 六、TEMPLATE变量
  • 6.1 app模板
  • 6.2 lib 模板
  • 6.3 subdirs模板
• 七、CONFIG变量
• 八、变量用法
  • 8.1 自定义变量
  • 8.2 变量值的传递

 

---

回到顶部

一、注释：

用 # 注释，表示到行尾均为注释。

回到顶部

二、include：

包含别的文件，例如：include xx.pri。类似于 c++ 的 #include。。。

回到顶部

三、平台宏：

win32/macx/unix/linux-g++等，分别对应于windows、mac、unix、linux等系统。

回到顶部

四、作用域：

作用域和 if 语句很像，如果某个条件为真，作用域中的设置就会被处理，例如：

debug{
	TARGET = XXd
}
release{
	TARGET = XX
}

上面代码的意思是：如果是 debug 版本，可执行程序的名字是 xxd，否则就是 xx。可以这样写：

debug:TARGET = xxd
release:TARGET = XX

作用域也可以嵌套使用，例如：

win32{
	debug{
		TARGET = xxwd
	}
}

还可以加上 else 语句：

win32{　　
　　debug{
　　　　TARGET = xxd
　　}else{
　　　　TARGET = xx
　　}
}

回到顶部

五、操作符

Qt+=: 添加额外的模块支持，例如Qt -= QtCore; Qt += network,phonon,xml,thread

“=” 操作符：
分配一个值给一个变量。例如：TARGET = myapp，这将会删掉原来对 TARGET 的任何设置，并将变量 TARGET 的值设置为 myapp。

“+=” 操作符：
向一个变量的值的列表中添加一个值。例如：DEFINES += QT_DLL，把 QT_DLL 添加到 makefile 的预处理定义的列表中。

“-=” 操作符：
从变量的列表中移除一个值。例如：DEFINES -= QT_DLL，把 QT_DLL 从 Makefile 的预处理定义列表中移除。

“*=” 操作符：
仅仅在一个值不存在于一个变量的值的列表中的时候，把它添加进去。例如：DEFINES *= QT_DLL，只用在 QT_DLL 没有被定义在预处理定义的列表中时，它才会被添加进去。

“~=” 操作符：
将会替换任何与指定的值的正则表达式匹配的任何值。例如：DEFINES ~= s/QT_[DT].+/QT，将会用 QT 来替代任何以 QT_D 或 QT_T 开头的变量中的 QT_D 或 QT_T。

回到顶部

六、TEMPLATE变量

生成 Makefile 采用的模板。以下是可供选择的模板：

• app：建立一个应用程序 Makefile，这个也是默认值，没有指定模板是默认是这个。
• lib：建立一个库的 Makefile。
• vcapp：建立一个应用程序的 visual studio 项目文件。
• vclib：建立一个库的 visual studio 项目文件。
• subdirs：创建一个能够进入子目录并且为之生成为它调用 make 的 Makefile。需要在后面用 SUBDIRS=XX 来指定那些子目录。

6.1 app模板

app 模板告诉 qmake 为建立一个应用程序生成一个 Makefile。当使用这个模板时，下面这些 qmake 系统变量是被承认的。你应该在你的 .pro 文件中使用它们来为你的应用程序指定特定信息。

• HEADERS：需要包含的头文件的列表。
• SOURCES：需要的源文件的列表。
• FORMS：需要的 .ui 文件的列表。
• LEXSOURCES：所有 lex 源文件的列表。
• YACCSOURCES：所有 yacc 源文件的列表。
• TARGET：可执行应用程序的名称。默认值为项目文件的名字。
• DESTDIR：放置可执行程序目标的目录。
• OBJECTS_DIR：放置 obj 中间文件的目录。
• MOC_DIR：moc 转换文件路径。
• RCC_DIR：资源文件路径。
• UI_DIR：ui 文件转换的路径。
• RESOURCES：需要包含的资源文件。
• LIBS：依赖库的路径和名称 -L{xxdirxx} -l{xxnamexx}。
• LIBEXT：产生lib的后缀。
• DEFINES：应用程序所需的额外的宏定义列表。
• INCLUDEPATH：应用程序所需的额外的包含路径列表。
• DEPENDPATH：应用程序所依赖的搜索路径。
• VPATH：寻找补充文件的搜索路径。
• DEF_FILE：只有 Windows 需要：应用程序所要连接的.def文件。
• RC_FILE：只有 Windows 需要：应用程序的资源文件。
• RES_FILE：只有 Windows 需要：应用程序所要连接的资源文件。
• TRANSLATIONS: 多国语言支持文件。
• INSTALLS：要安装的文件。
• target.path：安装的路径。

详细请参考 Qt 帮助条目：qmake Variable Reference。

6.2 lib 模板

lib 模板告诉 qmake 为建立一个库而生成 makefile。当使用这个模板时，除了 “app” 模板中提到系统变量，还有一个 VERSION 是被支持的。你需要在为库指定特定信息的 .pro 文件中使用它们。

• VERSION：目标库的版本号，例如：1.2.3。

6.3 subdirs模板

subdirs 模板告诉 qmake 生成一个 makefile，它可以进入到特定子目录并为这个目录中的项目文件生成 makefile 并且为它调用 make。这个模板只有一个系统变量 SUBDIRS 可以被识别。

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

回到顶部

七、CONFIG变量

配置变量，指定了编译器所要使用的选项和所需要链接的库。

（1）控制编译器标志的选项：

• release：应用程序将以 release 模式连编，如果 “debug” 被指定，它将被忽略。
• debug：应用程序将以 debug 模式连编。
• warn_on：编译器会输出尽可能多的警告信息，如果 “warn_off” 被指定，它将被忽略。
• warn_off：编译器会输出尽可能少的警告信息。

（2）控制需要连接的库的选项：

• qt：应用程序是一个 Qt 应用程序，并且 Qt 库将会被链接。
• thread：应用程序是一个多线程程序。
• x11：应用程序是一个 x11 应用程序或者库。
• windows：只用于 app 模板，应用程序是一个 windows 下的窗口应用程序。
• console：只用于 app 模板，应用程序是一个 windows 下的控制台应用程序。
• dll：只用于 lib 模板，库是一个共享库。
• staticlib：只用于 lib 模板，库是一个静态库。
• plugin：只用于 lib 模板，库是一个插件，这将会使 dll 选项生效。

例如：CONFIG += qt debug，使用 qt 库的应用程序，debug 版本。

注意事项：必须使用 “+=”，不要使用 “=”，否则原来的设置会被清除。

回到顶部

八、变量用法

8.1 自定义变量

# 定义了一个变量MY_VARIABLE，并将值设置为value
MY_VARIABLE = value

8.2 变量值的传递

可以通过在其它任何一个变量的变量名前加$$来把这个变量的值分配给当前的变量。例如：

MY_DEFINES = $$DEFINES

现在 MY_DEFINES 变量包含了项目文件在这点时 DEFINES 变量的值。这也和下面的语句一样：

MY_DEFINES = $${DEFINES}

这里列出的不全，最好还是看 Qt 的帮助主题：qmake Function Reference

（1）include(filename)

包含文件。

（2）dirname(file)

返回指定文件的目录名称。例如：

FILE = /etc/X11R6/XF86Config
DIRNAME = $$dirname(FILE) #/etc/X11R6

（3）error( string )

这个函数输出所给定的字符串，然后会使 qmake 退出。例如：

error(An error has occurred in the configuration process.)

（4）exists( filename )

如果指定文件存在，那么函数成功，否则失败。例如：

exists( /local/qt/qmake/main.cpp ) {
	SOURCES += main.cpp
}

如果/local/qt/qmake/main.cpp存在，那么 main.cpp 将会被添加到源文件列表中。

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

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

（6）isEmpty( variablename )
这和使用count( variablename, 0 )是一样的。如果叫做 variablename 的变量没有任何元素，函数返回成功否则失败。例如：

isEmpty( CONFIG ) {
CONFIG += qt warn_on debug
}

（7）message( string )：
这个函数只是简单地在控制台上输出消息。

message( "This is a message" )

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

（8）replace(string, old_string, new_string)：
将 string 中的 old_string 用 new_string 代替，例如：

MESSAGE = This is a tent.
message($$replace(MESSAGE, tent, test))

prints the message:
This is a test.

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

（9）warning(string)：
这个函数一直返回成功，并且会输出指定字符串给用户，跟 message 是同义词。

（10）system(command)：
特定指令被执行并且如果它返回一个 1 的退出值，那么函数成功否则失败。例如：

system( ls /bin ) {
    SOURCES += bin/main.cpp
    HEADERS += bin/main.h
}

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

参考：

Qt Pro中常用宏说明