qmake的入门与简单使用

qmake简介

qmake是Qt的构建工具,主要作用是解析pro格式的项目文件、生成编译规则(Makefiles或其它)。

qmake是一个比较古老的工具,很多功能使用perl脚本实现。

Qt官方之前开发的Qbs,后来又宣布不再更新,现在又大力支持CMake。

在这样的背景下,qmake依然是当下主要的构建工具,所以qmake的一些技巧还是有必要掌握的。

qmake本身作为一个可执行程序,也是有一些参数的,但这不是本文的重点,本文的重点都在pro文件里。

pro文件中,除了常规的组织项目结构外,还可以做很多事情, 比如 指定编译选项、链接选项、制定目标生成规则、扩展编译规则 等等。

pro文件中的qmake语法,包括 变量声明和使用、内建变量、替换函数、测试函数等,帮助文档都有详细的介绍。

添加第三方库

在C++开发,使用第三方库也是家常便饭了,这是一个必备的技能。

这里首选的方法,是使用QtCreator提供的添加库功能。在pro文件里(或者项目文件夹), 鼠标右键->添加库,然后根据自己的需要下一步、下一步点一下即可。

熟练的人也可以直接按pro语法(perl语法)写,给LIBS变量赋值。

  • 直接使用链接库的全路径
  LIBS += c:/mylibs/XXX.lib

我们都知道windows系统默认的路径分割符是\,但在qmake中要写成\才行。qmake也支持写成’/’,其它unix系统又都是’/’,所以干脆都写成’/’,方便处理。

  • 路径中包含空格等特殊字符,用引号括起来
  LIBS += "C:/mylibs/xxx libs/XXX.lib"
  • 分别指定路径和库
  LIBS += "-LC:/mylibs/xxx libs" -lxxx

这里的LIBS指定要链接的库,’-L’是指定链接库的路径,’-l’指定要链接的库名称。
名称可以省略lib前缀和 扩展名后缀,Qt会自动处理。拓展名包括 ‘.so’ ‘.dll’ ‘.dylib’ 等。

  • 分平台条件链接
  win32:LIBS += "C:/mylibs/xxx libs/xxx.lib"
  unix:LIBS += "-L/home/user/xxx libs" -lxxx

条件链接可以很方便地实现不同平台链接不同的库。
这里的 win32 unix 是在选择了不同的编译器环境时,qmake分别预置的变量。

原理

Qt内置了一些perl脚本,在执行qmake解析时会包含这些脚本。其中一些脚本会来处理这个LIBS变量,将其转换成编译器/链接器的参数。

内置的脚本路径在[QTDIR]/mkspecs/features文件夹下,扩展名为prf。

后续的很多变量,也是一样的原理, 只是处理方式各不相同。

很多pro文件的语法、功能实现,都可以参考这些prf来实现。

Qt程序员都知道的一件事:有时候修改了信号/槽相关的代码,不能正常运行,要重新qmake一下,才会生效。

本质上就是在重新触发[QTDIR]/mkspecs/features/moc.prf这个脚本。

影子构建

影子构建,就是编译生成的产物和源代码在不同的文件夹。这样可以防止源代码文件夹被污染。

QtCreator默认导入pro工程时,就会生成一个影子构建路径。比如这样:

F:\Dev\Qt\Desktop_Qt_5_12_3_MSVC2017_64bit-Debug

之后编译项目时生成的中间文件及目标文件,都在这个文件夹中。

这个路径很长,而且编译器或者编译选项不同时都有可能不一样。

有时候要做一些特定的操作:比如目标exe生成到特定目录、拷贝资源文件等等,直接用这个路径会不太方便/不太可靠,我们需要一些定制。

指定目标路径

  DESTDIR = $$PWD/bin

通过给DESTDIR变量赋值, 可以指定生成的lib/exe放在哪个目录下

‘PWD’是qmake内置变量,’$$‘是内置变量取值的写法。’/bin’是字符串拼接在变量后面。

指定中间件生成路径

可以通过这几个变量指定中间件生成的路径

config(debug, debug|release) {
    OBJECTS_DIR = build/debug/obj
    MOC_DIR = build/debug/moc
    RCC_DIR = build/debug/rcc
    UI_DIR = build/debug/uic
} else {
    OBJECTS_DIR = build/release/obj
    MOC_DIR = build/release/moc
    RCC_DIR = build/release/rcc
    UI_DIR = build/release/uic
}

config(debug, debug|release) 是一个条件表达式,可以理解为

if (debug === true) {

} else if (release == true) {

}

注意: 按照perl语法,那个左大括号’{‘不能换行,要和前面的表达式在同一行。

上面这种指定中间件路径的方式,在QtCreator中有默认路径所以没有太大意义,不过在命令行编译时这样写却很有用。

发表评论

您的电子邮箱地址不会被公开。 必填项已用*标注