Qt实用技能2-用好qmake



  • 简介

    本文是《Qt实用技能》系列文章的第二篇,涛哥将教大家,一些qmake的实用技巧。部分地方也会说一下原理,让大家知其然,知其所以然。

    工欲善其事,必先利其器。

    这个系列,全是干货!

    注:文章主要发布在涛哥的博客知乎专栏-涛哥的Qt进阶之路

    qmake简介

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

    qmake是一个比较古老的工具,很多功能使用perl脚本实现,涛哥在其它地方就没怎么见过使用perl脚本的代码/项目。

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

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

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

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

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

    搜索关键词为qmake, 或者和普通的类查看帮助文档方式一样,光标放在pro文件要查看的变量上,按F1就能看到相应的说明。

    预览

    涛哥就不赘述了,后面用到的会单独说明。

    添加第三方库

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

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

    预览

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

    下面给几个示例,至于动态库/静态库的差异,大家自己实践吧。

    示例1 - 直接链接库的全路径

      LIBS += c:/mylibs/math.lib
    

    我们都知道windows系统默认的路径分割符是'',但在qmake中要写成'\'才行。qmake也支持写成'/',其它unix系统又都是'/',

    所以干脆都写成'/',方便处理。

    示例2 - 路径中包含空格等特殊字符,用引号括起来。

      LIBS += "C:/mylibs/extra libs/extra.lib"
    

    示例3 - 分别指定路径和库

    LIBS += "C:/mylibs/extra libs" -lextra
    

    这里的LIBS指定要链接的库,'-L'是指定链接库的路径,'-l'指定要链接的库名称

    名称可以省略lib前缀和 扩展名后缀,Qt会自动处理。 后缀包括 '.so' '.dll' '.dylib' 等。

    示例4 - 分平台条件链接

      win32:LIBS += "C:/mylibs/extra libs/extra.lib"
      unix:LIBS += "-L/home/user/extra libs" -lextra
    

    条件链接可以很方便地实现不同平台链接不同的库。

    这里的 win32 unix 是在选择了不同的编译器环境时,qmake分别预置的变量。

    (比如win32平台相关的变量,可以参考msvc的配置文件: [QTDIR]/mkspecs/win32-msvc/qmake.conf 和 [QTDIR]/mkspecs/common/msvc-desktop.conf)

    原理

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

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

    预览

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

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

    (注意:不熟悉的同学,不要乱改prf,容易改坏)

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

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

    (多少年了,都没有修好Moc生成问题,可见qmake的古老...)

    影子构建

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

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

    预览

    F:\Dev\Qt\build-HelloTaoQuick-Desktop_Qt_5_12_3_MSVC2017_64bit-Debug
    

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

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

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

    指定目标路径

    DESTDIR = $$PWD/bin
    

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

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

    更多内置变量可以参考qmake帮助文档,以及这篇文档隐藏的qmake文档

    当然也可以参考那一堆prf和conf文件。

    指定中间件生成路径

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

    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中有默认路径所以没有太大意义,不过在命令行编译时这样写却很有用。

    拷贝资源

    pro可以实现,在编译代码时,拷贝一些文件到指定的路径下

    拷贝资源示例

    这里以TaoQuick为例,来说明:

    我在TaoQuick库目录下,有个叫qmldir的文件,需要在编译代码时自动拷贝到bin目录下。(先别管这个文件干嘛的,下一篇文章会说)

    预览

    关键目录结构如下:

    TaoQuick
        TaoQuick.pro
        - bin
            -TaoQuick
        - TaoQuickCore
            TaoQuickCore.pro
            - Qml
                qmldir
    

    那么我在TaoQuickCore.pro文件中的写法如下:

    !equals(_PRO_FILE_PWD_, $$DESTDIR) {
        copy_qmldir.target = $$DESTDIR/qmldir
        copy_qmldir.depends = $$_PRO_FILE_PWD_/qmldir
        win32 {
            copy_qmldir.target ~= s,/,\\\\,g
            copy_qmldir.depends ~= s,/,\\\\,g
        }
        copy_qmldir.commands = $${QMAKE_COPY_FILE} $${copy_qmldir.depends} $${copy_qmldir.target}
        QMAKE_EXTRA_TARGETS += copy_qmldir
    }
    
    

    ‘!equals(PRO_FILE_PWD, $$DESTDIR)’ 这一句是执行条件,即: 目标路径不等于pro文件所在路径时 执行下面的操作。

    剩下的事情就是在创建一个"编译目标"(Target),将这个编译目标添加到QMAKE_EXTRA_TARGETS变量中就行了。

    熟悉MakeFiles的同学应该都清楚什么是"目标"。不懂MakeFiles也没关系,这里的目标就理解为自己声明的一个变量即可。

    这个变量有三个很重要的"子变量":

    copy_qmldir.target 指定目标文件所在的路径 (这里理解成要拷贝到哪去)
    copy_qmldir.depends 指定依赖文件所在的路径 (这里理解成从哪里拷贝)
    copy_qmldir.commands 指定拷贝操作的执行命令 (就是怎么拷贝)

    QMAKE_COPY_FILE 这个变量来自前面说过的隐藏的qmake文档

    qmake会在解析pro文件时,自动替换成平台相应的拷贝命令。 windows 平台就是 copy /y

    注意windows的copy指令,路径分隔符得写成 '\'才行。所以有了下面的特殊处理:

        win32 {
            copy_qmldir.target ~= s,/,\\\\,g
            copy_qmldir.depends ~= s,/,\\\\,g
        }
    

    ‘s,/,\\,g’ 是一个正则表达式,作用是把‘/’替换成‘\’ 。s表示开头,g表示结尾。

    VAR~= REGEXP 是对变量VAR执行REGEXP这个正则表达式

    编译前拷贝

    如果想在编译之前,先把资源拷贝完成,只需要前面的基础上,添加一句

        PRE_TARGETDEPS += $$copy_qmldir.target
    

    也就是把"目标"加到 PRE_TARGETDEPS变量

    !equals(_PRO_FILE_PWD_, $$DESTDIR) {
        copy_qmldir.target = $$DESTDIR/qmldir
        copy_qmldir.depends = $$_PRO_FILE_PWD_/qmldir
        win32 {
            copy_qmldir.target ~= s,/,\\\\,g
            copy_qmldir.depends ~= s,/,\\\\,g
        }
        copy_qmldir.commands = $${QMAKE_COPY_FILE} $${copy_qmldir.depends} $${copy_qmldir.target}
        QMAKE_EXTRA_TARGETS += copy_qmldir
        PRE_TARGETDEPS += $$copy_qmldir.target
    }
    
    

    安装

    pro中还有一种INSTALL功能,可以执行文件拷贝。

    和编译期拷贝 类似,INSTALL用起来更简单无脑一些,而且INSTALL只在执行make install指令时,才会拷贝资源。

    还是以TaoQuick为例, 我有一堆文件,需要在make install时,安装到Qt的Qml路径中

    预览

    如上图所示所有的文件, 除了TaoQuickDesigner.pri, 都要按照这个结构拷贝。

    (这个pri文件是pro文件的一小部分,可以直接在pro中通过include引入。

    pri和pro语法一样,但是qmake不直接识别pri,只识别pro

    pri一般用来写一些公用的部分,让多个pro公用)

    拷贝整个文件夹是一种做法, 当然为了精确地控制要拷贝的内容,可以写成下面这样:

    taoquick_designer.files = $$PWD/designer/TaoQuick.metainfo
    taoquick_designer.path = $$[QT_INSTALL_QML]/$${uri}/designer
    
    toaquick_qmldir.files = $$PWD/qmldir
    toaquick_qmldir.path = $$[QT_INSTALL_QML]/$${uri}
    
    taoquick_qml_buttons.files = $$PWD/BasicComponent/Button/*.qml
    taoquick_qml_buttons.path = $$[QT_INSTALL_QML]/$${uri}/BasicComponent/Button
    
    taoquick_qml_mouse.files = $$PWD/BasicComponent/Mouse/*.qml
    taoquick_qml_mouse.path = $$[QT_INSTALL_QML]/$${uri}/BasicComponent/Mouse
    
    taoquick_qml_others.files = $$PWD/BasicComponent/Others/*.qml
    taoquick_qml_others.path = $$[QT_INSTALL_QML]/$${uri}/BasicComponent/Others
    
    taoquick_qml_progress.files = $$PWD/BasicComponent/Progress/*.qml
    taoquick_qml_progress.path = $$[QT_INSTALL_QML]/$${uri}/BasicComponent/Progress
    
    taoquick_degisner_images.files = $$PWD/designer/images/*.png
    taoquick_degisner_images.path = $$[QT_INSTALL_QML]/$${uri}/designer/images
    
    INSTALLS  += taoquick_designer toaquick_qmldir taoquick_qml_buttons taoquick_qml_mouse taoquick_qml_others taoquick_qml_progress taoquick_degisner_images
    
    

    自定义一个变量,然后其子变量files指定要拷贝的文件,子变量path指定目标路径。

    把自定义变量加入INSTALLS变量就行了。

    QT_INSTALL_QML也是一个内置变量,默认值为[QTDIR]/qml。

    之后只要执行以下命令,就能完成资源拷贝。

    qmake
    make 
    make install
    

    当然QtCreator中也能执行make install

    如下图所示:

    预览

    任意编译器kit都可以,项目->构建步骤->添加build步骤->Make,添加之后在make参数中输入install。最后重新构建工程,即可完成安装。

    结束语

    以上案例,大部分都在TaoQuick项目中实践过,可以去Github参考。

    TaoQuick

    转载声明

    文章出自涛哥的博客

    文章采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议进行许可, 转载请注明出处, 谢谢合作 © 涛哥

    联系方式


    作者 武威的涛哥
    开发理念 弘扬鲁班文化,传承工匠精神
    博客 https://jaredtao.github.io
    github https://github.com/jaredtao
    知乎 https://www.zhihu.com/people/wentao-jia
    邮箱 jared2020@163.com
    微信 xsd2410421
    QQ 759378563

    请放心联系我,乐于提供咨询服务,也可洽谈商务合作相关事宜。

    打赏

    weixin
    zhifubao


    如果觉得涛哥写的还不错,还请为涛哥打个赏,您的赞赏是涛哥持续创作的源泉。



Log in to reply
 

走马观花

最近的回复

  • Z

    我按照楼主说的,除了windeployqt以外,还需要Qt\labs\folderlistmodel,QtQuick\Layouts,QtQuick\VirtualKeyboard,QtQuick.2,platforminputcontexts这么几个目录,另外Qt5Qml.dll, Qt5Quick.dll也要加进来,还是不行,楼主可以发个完整的文件夹给我吗,release模式的,debug模式没问题

    read more
  • 1.jpg

    简介

    USD全称是“Universal Scene Description”,它主要着力的是电影、游戏复杂制作的流程的规范化。这回我们主要来研究USD在Maya中有关渲染部分究竟是如何实现的。

    USD通过附属的子项目Hydra来实现在其工具“UsdView”以及Maya中渲染方面的实现。Hydra是一款经过多年锤炼的渲染引擎(据说自从2012年就开始研发),Hydra与Maya中有关渲染的结合得益于Maya支持第三方渲染框架通过它提出的“Viewport (1.0、2.0)”方式支持。

    初探

    我们打开USD项目,会发现它有很多子项目。其中包含了imaging和usd子项目。这里我们主要关注的是imaging项目。由单词意思可知,其主要关注的是产出图片的,也就是有关渲染的。
    ca7ce8ff-7e7d-4ec3-9246-fbee48109c7b-image.png

    有关Hydra是三个子项目。包含了hdSt、hdStream以及hdx。我们主要关注的是hdSt。因为这个项目是和OpenGL渲染密切相关的。由于OpenGL是做渲染的大家通用知识,因而它是我们关注的主要子项目。

    调试

    调试.jpg
    我们调试这部分代码,截了此图。我们在图中至少发现几个问题:

    Maya底层是用OpenSceneGraph(OSG)管理场景的。我们可以看到Maya 2018的文件夹里有很多OSG开头的动态链接库,这么说具体视口渲染的部分都是建立在OSG上的。Maya的Viewport 2.0也是建立在OSG上的。在可见的将来它们不会替换掉OSG。

    USD的Hydra和Maya结合的类叫做UsdMayaGLBatchRenderer。由名字可知,它仅工作在OpenGL下,换句话说,如果Maya使用的是DirectX11进行渲染的,那么它将会失效。
    d7063ec4-242e-40bd-bf05-5103c38fedf1-image.png

    libhd项目只是一个前端库,后端通过libhdx以及libhdSt来实现。尤其是libhdSt,它主要是和OpenGL打交道的。它十分复杂。主要基于的是OpenGL 3.3+,也就是包含了各种着色器以及高级栅格化技术,并且整合了网格细分库:OpenSubdiv。

    后续

    由于我们的研究方向是思考一个方式来让让Hydra支持过程化纹理,因此我们还需要继续对此进行研究。

    read more
  • 最近我开始在Maya工作啦。Maya是一款优秀的三维软件,可以处理布景、建模、纹理、装备、渲染等操作。而且它可以支持C++和Python的开发。文档也是非常多的(参考这里)。

    我们最近的工作呢,是想要利用Maya的资源,尤其是图片资源,来制作新的界面。由于Maya是基于Qt开发的,因此要获取图片资源,除了Maya文件夹里D:\Develop\Autodesk\Maya2018\icons文件之外,还需要从资源文件中获取到。而资源文件一般是编译成C++代码放在程序的某个位置了,所以我们一般是看不到的。我们就开始想,既然Maya能够成功地读取并且显示,我们通过Maya的插件开发,不也能够获取并且显示到需要的图标吗?由于Qt的经验,我开始研究通过写Maya插件来获取到Maya资源文件的方法。

    新打开Maya软件,点击右下角的脚本图标,我们开始输入脚本:
    ad141613-63a5-4a93-9b79-3d6ca44da782-image.png

    2、我们通过Qt for Python来从Maya中获取到图标信息。由于Maya是构建在Qt 5.6.1上的,当时还不叫Qt for Python,而是PySide2。当然用法也是差不多的。更重要的是Qt 5.6.1已经支持QML了,可以支持QML的基本绘图方法。所以我们打算结合Qt for Python和QML来实现相关的功能。其实这样一组合就和Maya没有什么关系了。剩下的都是Qt的技术。
    我们的脚本是这样的:

    from PySide2.QtQuick import QQuickView from PySide2.QtCore import QDir, QFileInfo, QUrl def getMayaResourceFileList( nameFilter ): dir = QDir( ":/" ) return dir.entryList( nameFilter ) view = QQuickView( ) view.setResizeMode( QQuickView.SizeViewToRootObject ) mainUrl = QUrl.fromLocalFile( "C:/Users/huawei/Documents/ImageGridView.qml" ) view.setSource( mainUrl ) view.show( ) rootItem = view.rootObject( ) if rootItem != None: rootItem.setProperty( "prefix", "qrc:/" ) rootItem.setProperty( "model", getMayaResourceFileList( '*.png' ) )

    其中C:/Users/huawei/Documents/ImageGridView.qml是我本地的路径,可以改为任意的路径甚至是http路径呢。

    我们还得完成ImageGridView.qml文件内容,其实也非常简单,大概是这样的: import QtQuick 2.6 GridView { id: root width: 320 height: 480 cellWidth: 80 cellHeight: 80 delegate: Image { width: 80 height: 80 source: root.prefix + modelData Text { anchors { left: parent.left right: parent.right bottom: parent.bottom } text: modelData wrapMode: Text.Wrap } } model: 40 property string prefix }

    22ae8472-0bb3-4342-ae72-e1cb54bd87a7-image.png

    4、这些文件准备就位了!我们打开一下Maya软件,看看结果~
    f430332d-c824-47d3-8d1c-b17b3c53bc97-image.png
    它是一个可滑动的界面,每行显示4列,然后下面是文字的内容,展示了图标的名称。我们可以借此工具拿到我们感兴趣的图标的路径,然后应用到我们制作的界面上。其实,如果你觉得图片好,也可以通过QImage以及QPixmap给转存出去自己用。

    如果你觉得文章很棒,记得点赞哦。

    read more

关注我们

微博
QQ群











召唤伊斯特瓦尔