Qt构建工具QBS之零 —— QBS 概览

本系列文章起因

自己非常喜欢 QT 这个框架, 使用 QT 这几年, IDE 一直是使用的 QT 自带的 Qt Creator, 这个 IDE 本身比较轻巧, 同事相关的语法提示之类的也算够用, 但是 qmake 有的时候就显得不那么只能了, 有时非得手动qmake一下才行, 有时需要清除再构建, 有时这两者合一起也不一定解决问题. 需要删除构建目录才行. 很多新手学习的时候, 经常会再论坛或群里问, 为什么我的代码和书上的一模一样, 怎么构建时就出错呢? 这种情况, 大多是 qmake “抽风”了. 其实 QBS 刚出来的时候就想试试, 但是被那个自带文档吓住了. 这个春节, 无意中打开 QBS 的文档, 仔细看了下. 同时实践了下, 原来这个东西还是很简单的. 鉴于目前网上对 QBS 的中文资料好像一篇都没有, 特意整理了下自己学习过程中的心得分享出来. 一来可以让自己对 QBS 的认识更加系统, 二来也给有需要的人一个参考.

QBS 总体认识

QBS 即 Qt Build Suite. 同 qmake, cmake 之类一样, 都是构建工具. QBS 号称是下一代的构建工具(我的理解是上一代是基于 makefile 的构建工具?). 不过个人认为, 至少和 qmake 比, 还是要好用很多. 首先文档就比qmake好些, 其次 QBS 的可扩展性真的很强大且易于使用.

QBS 项目文件使用一种类 QML 语言编写的, 其实就是 QML 的简化版, 对于已经学会 QML 的人理解 QBS 应该会更简单(可惜我就不会QML). 对了这是一种声明式语言, 对于习惯了命令式编程语言的, 需要转变下思维, 其实会发现声明式其实更简单.

按 QBS 的自带文档, QBS 的知识可以分 3 大块, 即语言项(Language Item), 模块(Module), 以及其它如 QBS 内建提供的服务之类的. 其中最后一块的知识比较简单, 一般查下文档就会用了. 而模块又是由一系列的语言项组成的. 所以最重要的就是语言项了. 语言项和模块的关系就像 C++ 和 库(例如STL, Qt 等的关系). 对于这些预定义的模块, 基本上在用的时候查下模块相应属性的用法即可.

本系列文章, 没有说明 QBS 命令行的用法, 因为我本人是直接使用 Qt Creator 中自带集成的 QBS. 本系列文章, 是面向写 Qt 程序的, 对于平台 Windows 和 Linux 下基本是一致的, 但对于 Mac/iOS, Andorid 的相关语言项是忽略掉的(因为我不会). 还有关于编译 Java 语言的语言项也会忽略.

语言项概述

上面讲到 QBS 的基础是语言项, QBS 文档列出的语言项共有 30 个, 看起来挺多, 但是以后你会知道, 实际使用到的仅有十多个. 下面是我加单的分了下类, 列出了所有的语言项.

注: 本篇文章, 只是对 QBS 有个大概的介绍, 无需记住或拼命的理解什么.

  1. Project 和 SubProject

    Project 项在结构上是所有语言项的最顶层的(最外围的)那个语言项, 一个 Project 项包含了一个或多个 Product 项. 同时 Project 项中还能嵌套包含 Project 项.

    SubProject 项用来将一个 Project 项加入到当前的 Project项中, 将其作为当前项目的一个子项目.

    Project/SubProject 项作用类似与 qmake 项目文件中(pro文件) 定义 TEMPLATE = subdirs.

  2. Product
    • Application

      • CppApplication

        • QtApplication

          • QtGuiApplication
      • XPCService 
        • ApplicationExtension
    • DynamicLibrary
    • StaticLibrary
    • JavaClassCollection
    • JavaJarCollection
    • AndroidApk
    • LoadableModule

    一个 Product 项就是在构件过程最终生产的结果, 比如可以是一个: 可执行的应用程序, 动态库, 或是静态库等等. 如上列出所示, 从 Product 项又派生出了 Application, DynamicLibrary, StaticLibrary 等项. 但其本质还是 Product 项, 只是为了使用上更方便, 在 Product 项上预设了一些属性和依赖. 例如: Application 项, 也可以如下 Product 项来表示

    Product {
        type: "application"
        // ...
    }
    • 1
    • 2
    • 3
    • 4
    • 1
    • 2
    • 3
    • 4

    Product 项及其派生的各种项作用类似与定义了 TEMPLATE = appTEMPLATE = lib 等的 qmake 项目文件.

  3. FileTaggerGroup 和 Properties

    FileTagger 项用来标记(源)文件的类别, 即标记出哪些文件是 C++ 源码, 哪些文件是资源文件等等, 有点类似于 Windows 系统上的文件扩展名的作用, 但是比扩展名强大的多.

    Group 项用来分组(源)文件, 比如在 Windows 平台和 Linux 平台上需要包含不同的文件时就可以用 Group 项来分组. 如下:

    Application {
        Group {
            name: "Windows files"
            condition: targetOS.contains("windows")
            files: "myclass_win_impl.cpp"
        }
        Group {
            name: "Linux files"
            condition: targetOS.contains("linux")
            files: "myclass_linux_impl.cpp"
        }
    }
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12

    Properties 项则是用来分组属性的. 用法类似于 Group, 只是一个作用于文件, 一个作用于属性.

  4. DependsModule 和 Export

    Depends 项用来引入功能模块(Module).

    Module 项用来定义一个模块, 模块可能包含一系列属性, 规则, 变换等等.

    Export 项可以将 Product 中的一系列属性导出, 使得这个 Product 能够像 Module 一样由 Depends 引入使用.

  5. ArtifactRule 和 Transformer

    Artifact 项, 即工件, 构建过程以及构建最终产生的文件都称之为工件. 工件由规则(Rule) 和 变换 (Transformer)产生.

    Rule/Transformer 项, 将输入文件生成一个或多个工件.

  6. 其它项: AutotestRunner, InstallPackage, Probe, PropertyOptions, Scanner

小结

为了对 QBS 对上述语言项更好的理解. 可以用一个 C++ 项目来类比:

Project 和 SubProject 就项就像项目的工程文件一样, 对于简单的项目, 比如 Hello World 程序, 就一个源文件, 不要工程文件也是可以的. 但是对于有很多源文件的, 还包含各种资源文件时, 还是有必要通过工程文件来管理的.

Product 项及其派生项, 有点项 main, WinMain, DllMain, 之类的入口函数, 决定了最后生成的是什么东西(控制台程序, windows程序, 动态库).

FileTagger, Group 和 Properties 项有点项 C/C++ 中哪些用来条件编译的预处理指令.

Depends, Module 和 Export 有点像引入/定义库文件.

Artifact, Rule 和 Transformer 则项最后开始编译程序的编译命令行, 以及生成的中间文件和最终的程.

为了怕吓住大家, 再次告诉大家 QBS 虽然很强大, 但是也是很简单的. 比如上面看到列出那么多语言项, 其实很多功能上是重复/相似的, 可以不用的, 还有很多是用不到的. 比如上面第 2 类中的 Product 系总共有13个, 我只用到了CppApplicationDynamicLibrary 和 StaticLibrary 三个. 即使你真的都能用到, 那么它们的用法也是一样的, 换个名字而已.

下一篇文章开始正式开始使用 QBS 来构建项目, 并讲解其中出现的语言项.

转载请加上原文链接, 并保证文章的完整性. 鉴于自己的能力可能有表达失当或者错误的地方, 希望大家包含. 如您能提出意见或建议, 本人不甚感激.li_wey AT 163.com

http://blog.csdn.net/ysu533/article/details/50728815

时间: 08-14

Qt构建工具QBS之零 —— QBS 概览的相关文章

webpack前端构建工具学习总结(四)之自动化生成项目中的html页面

接续上文:webpack前端构建工具学习总结(三)之webpack.config.js配置文件 1.安装html-webpack-plugin插件,输入命令:npm install html-webpack-plugin --save-dev 2.在webpack.config.js文件中,引入html-webpack-plugin插件 3.输入命令:npm run webpack,编译打包 可以看到在dist/js目录下新生成了一个index.html文件,并且引入了新编译生成的两个js,但此

动态补丁构建工具nuwa中的“坑”

1. 继承android中的Application的类A1Application:并且A2Application继承自A1Application,并且配置在清单文件中name=".A2Application";那么在使用nuwa就会出现hack异常: (在网上随处可以查到) 2.nuwa当然需要使用sdk中的构建工具,会寻找名为ANDROID_HOME的sdk路径,更要注意的是sdk所在路径要有管理员的权限,如果没有权限也会报错:ANDROID_HOME not defind! (所以

前端构建工具gulpjs的使用介绍及技巧

gulpjs是一个前端构建工具,与gruntjs相比,gulpjs无需写一大堆繁杂的配置参数,API也非常简单,学习起来很容易,而且gulpjs使用的是nodejs中stream来读取和操作数据,其速度更快.如果你还没有使用过前端构建工具,或者觉得gruntjs太难用的话,那就尝试一下gulp吧. 本文导航: gulp的安装 开始使用gulp gulp的API介绍 一些常用的gulp插件 1.gulp的安装 首先确保你已经正确安装了nodejs环境.然后以全局方式安装gulp: npm inst

web 环境搭建00前端自动化构建工具(gulp)

web 环境搭建----前端自动化构建工具(gulp): 1----先下载安装node.js 2----然后在node.js命令行安装:npm install gulp -g (全局下载安装gulp插件) 3----然后进入到项目文件夹(命令cd 文件夹名),在项目文件夹中安装依赖文件:npm install gulp --save-dev (根据依赖文件下载gulp插件) 4----在项目文件夹目录下初始化:npm init (初始化文件) {初始化文件后项目中会出现packgae.json文

深入了解Ant构建工具 命令

深入了解Ant构建工具 标签: ant工具任务jarjavaclass 2010-05-29 21:16 1346人阅读 评论(2) 收藏 举报 版权声明:本文为博主原创文章,未经博主允许不得转载. 深入了解Ant构建工具 当一个项目很大的时候,每次都要重新编译,打包,测试变得非常复杂而且重复,Ant本身就是这样一个流程脚本引擎,用于自动化调用程序完成项目的编译,打包,测试.除了基于Java平台无关外,脚本格式是基于XML. Ant构建文件 当开始一个新的项目时,首先应该编写Ant构建文件.构建

构建工具的发展及Android Gradle快速上手

前话: 最近谷歌宣布官方不再维护Eclipse ADT了,之后将更加专注于Android Studio的功能和性能上的改进,早在2013年的Google IO大会上首次推出了Android Studio,当时刚出来的时候我就好奇的去下载体验了一下,想看一下新开发工具的优势在哪里,据官方介绍,最吸引我的一点就是使用Studio使用了Gradle编译系统,可以支持很灵活的定制需求,而我当时正在研究当成库使用的APK(就是现在的aar文件,不过当时还没有出身),刚好遇到了ADT编译系统的限制,所以当时

python的构建工具——setup.py文件

一.构建工具setup.py的应用场景 在安装python的相关模块和库时,我们一般使用"pip install  模块名"或者"python setup.py install",前者是在线安装,会安装该包的相关依赖包:后者是下载源码包然后在本地安装,不会安装该包的相关依赖包.所以在安装普通的python包时,利用pip工具相当简单.但是在如下场景下,使用python setup.py install会更适合需求: 在编写相关系统时,python 如何实现连同依赖包

Gulp:自动化构建工具

一.介绍: gulp是一个基于流的构建工具,可以自动执行指定的任务,简洁且高效 二.优点: 开发环境下,想要能够按模块组织代码,监听实时变化 css/js预编译,postcss等方案,浏览器前缀自动补全等 条件输出不同的网页,比如app页面和mobile页面 线上环境下,我想要合并.压缩 html/css/javascritp/图片,减少网络请求,同时降低网络负担 三.安装: 1.全局安装:cnpm install -g gulp 2.本地安装:cnpm install --save-dev g

linux自动化构建工具-scons指南

1.scons是linux下的自动构建工具 scons是用Python编写的,使用scons之前需确认是否已经安装了Python.(在系统的命令行中运行python -V或python --version). 2.安装过程如下 wget http://prdownloads.sourceforge.net/scons/scons-2.2.0.tar.gz . tar zxvf scons-2.2.0.tar.gz cd scons-2.2.0 python setup.py install 3.