简 述:  DTKdeepin tool kit)全称是 深度工具套件;是基于 Qt5 开发一整套界面美观且实用的 UI 图形库。

本篇主要尽可能多的讲解一下 dtk 的起源于历史,以及项目壮大后的拆分、现在 dtk 项目的组成和基本含义;以及 dtk 的文档从无到有,再到现在的极大丰富历史;最后就是 dtk 的如何快速上手部分。

另一篇中讲解 deepin、dde的历史起源与发展(附deepin所有版本的dde截图),可以一览其近 10 年的变化。

网上关于它的教程比较少,关于历史的更是基本就没有,在此补一笔。

[TOC]


本文初发于 “偕臧的小站“,同步转载于此。


一点碎碎念~:

工欲善其事,必先利其器。再知道一点它的演变历史~?

本文仅仅无意代表官方文章,仅讲述 dtk 和 deepin 的演变历史

本来只是想单写一篇 dtk 的其实起源的,但随着本文知识的丰富、确保时间线的基本准确,请教很多的前辈和大佬们,感谢他们

)请教了 dtk、deepin、develop team 的历史和原源过程中,体会到事物往往不是单一的,且与彼此之间有着千丝万缕联系而又互相独立,各有特色。本篇的侧重点是 dtk 项目的历史起源、发展过程与现状、现在的理解和如何快速上手;最后附上部分 dtk 相关的资料文档。 而关于 deepin && dde && team 的介绍,则单独成立一篇新的文章


背景交代:

说来惭愧,初接触 deepin 是由 v15.11 才开始的,一开始埋头着开发 dtk 有许久的一些时间,但对其历史出身来历一直比较模糊,于是乎收集和整理一下现存的所有 dtk 的项目、手册资料,与库的维护者和最初的库的开发者,以及公司有着较深资历前辈们交流,外加上个人和小伙伴们,也都有参与过该库的维护一段时间后,才得以落笔,梳理成此篇文章(欢迎交流与指正)。


dtk 名称的理解(易混淆):

  • 其中有几个容易混淆的名词,dtkdtkwidgetdtk 项目。

下面仅为个人理解,按照当前 2020 上半年的阶段的项目实际情况理解:

dtk 含义理解: 是一个泛指,需要灵活的在上下文的语义中理解其含义:

  1. dtk 项目(库) 的集合。 (是一堆仓库的集合 = dtkwidget + dtkgui + dtkcore + qt5integration…)
  2. 偶也指 dtkwidget 这个仓库项目(这个仓库的名称就叫 dtkwidget
  3. deepin tool kit 是一个深度工具构建集合。
  4. 是能在 deepin(uos) 系统开发应用软件,使用非 Qt 原生的样式控件的集合的开发环境
  5. dtk 也作为构建 deepin 全家桶的基石

DTK 目前分为三个模块,dtkcore、dtkgui,dtkwidget,主要功能如下:

项目 功能描述
dtkcore 提供应用程序开发中的工具类,如程序日志、文件系统监控、格式转换等工具类
dtkgui 包含了开发图形用户界面应用程序所需的功能。主要是控制窗口主题这种外观性,调色板等信息。
dtkwidget 提供各种dtk基础控件,方便开发统一风格的应用。

DTK 的历史起源:

dtk 项目的历史演变(含名称):


  • 在 2015 年,开发 deepin v15 版本的时候,因为开发控制中心(基于 Qt Widgets),开发的过程中抽象出了 dui 控件库(从控制中心开发起三个月),只有一些通用性的控件,仓库名称为 dui
  • 16 年初,随后开发其他项目,dui 中加的东西越来越多,也不仅限于 ui 方面的控件,之后就改名为了 deepin-tool-kit 项目。
  • 17 年底,随后成为了 DDE 桌面环境的底层开发库,封装了桌面组件和上层应用的通用型窗口、控件、工具类,随着项目越来越大,编译也越来越慢,于是拆分为了 dtkcoredtkwidgetdtkwm(仅三个仓库),旧的 deepin-tool-kit 仓库地址处于废弃状态。
  • 19 年新增加了 dtkgui 模块,废弃了 dtkwm(不可跨平台,强依赖 X11,因此废弃),此后分为 dtkcore、dtkgui、dtkwidget,角色分别对应 Qt core、gui、widgets 模块。
  • 20 年之后,按照如今的理解为,dtk = dtkwidget + dtkgui + qt5integration + dtkcore + … 等多个项目的总称呼

由于 qt5integratioin 项目一直是独立的,本不算 dtk 项目里的一员,不过实际上是和 dtk 配套的,故本文算到 dtk 框架中。


样式变化:

其中随着时间的变化,界面的 UI 样式也发生了比较大的变化,当时 v15 版本的控制中心,还在屏幕右侧,不透明偏向黑色,到后来的成为白色偏透明色,在到现在的一个单独的控制中心(下图依次为 deepin v15 早期版本,和 uos v20 的控制中心)。

而 dtk 是属于绘画自定义皮肤控件的基础核心,然后在它的基础上面做了一次封装, 封装了一系列 Dxxxx 开头的控件(如 DPushButton 等), 然后再由应用开发的同学们,开发出一款款应用,全部使用 dtk 的控件。那样开发出来的界面,就和系统的风格保持了一致性;而对于 win 系列的软件,也可以使用 wine(deepin-win) 来在 此 linux 上面运行;而对于第三方的应用软件,使用 chameleon style 启动,来保证和系统的风格一致。

下面放图、使用 dtk 库 开发出来的控件或者应用,enen… dtk 的样式就这么好看,这么的棒,这里要多感谢设计师们。ps: 设计师们简直就是程序开发之友,尤其是使用绘画控件的时候,可以少修改 50%+ 的代码或者 bug,且他们也非常好沟通~

  • deepin v15 早期不透明黑色效果:
  • uos/deepin v20 早期透明磨砂效果:

0 -> 1 的诞生 dui:

约 2015 年,起初是创建 dui 项目的,后来才改名为,deepin-tool-kit ;再后来拆分为为多个库 dtkwidget + qt5integration + 其他;


早先,且所有的 dtk + deepin 的项目,都是在 github 作为唯一的大本营;由于 0->1 时代,主要是开发构建 dtk 的体系架构,基本没有什么文档的书写✍️(一个伏笔)


后来有听到前辈们说,那个时候是的氛围轻松而又欢乐,更多的是一种平等沟通的合作,大家都是开源爱好的志愿者,一起做着自己喜欢的事情。羡煞我也。 向往与憧憬那个年代,以及更早的几年


deepin-tool-kit 是石器时代:

deepin-tool-kit 最开始,是既没有文档,且 api 接口不稳定,容易变化,且设计图的 UI 样式也变化较快,导致入门、开发、维护该 dtk 库都很是困难~。基本是内部开发者靠小伙伴讲解,外部开发靠自行阅读源码 ;听说以至于一些社区的小伙伴都看不下去,主动做了一个《Deepin开发指南》(地址已失效)


壮大后拆分 dtk 库:

前辈们的开发者一起编写最初的 dtk 库,随着近好几年的变化和发展,后期一定规模了,深思熟虑后,为更好发展,就决定将对 deepin-tool-kit 仓库进行拆分(2017 年左右): 详见 issues #8

  • dtkcore: 由 dtkbase/dtkutil/dtksettings 合并进入
  • dtkwidget: 由 dtkwidget/dtksettings 构成
  • dtkwm: 处理窗口识别库/xcb功能, 供截图、录屏、系统监视器使用
  • qtwebkit: 封装chroium,提高CEF/WebEngine兼容接口

昂~ ,为了代码的健壮性发展,与方便后期的可维护性


dtk 的口口相传时代:

随着上一个时代已经过去了,dtk 的主体框架和 api 都趋向于稳定;且有了部分中文文档,(是中文文档!!! 鸡冻٩(๑>◡<๑)۶!!!);此时也基本对内部和外部的研发都已经友好了很多。


此阶段应该是 deepin 15.11 (恩,至今都是一个经典的版本,后来发现该发版本打磨和维护了近 5 年,很棒的一个版本)已经发布了出来了,开始研发 v20 阶段了。

不过此阶段,新的库的维护者学习 dtk 的方法,依旧是口口相传,手把手的教你一行一行的写代码(像一个大哥哥一样);毕竟使用的最新的接口,还没来得及更新到文档之中,且容易有变化,旧的接口就稳定得多。此阶段 dtk 的研发就是内部靠口口相传,外部研发靠部分文档+@戳你一下,加双方都看源码,来完成彼此的合作 (有事觉得有和其他开发者一起互动的感觉也很棒


这里说一个小的插曲:

当我初次开始接触 dtk 库的维护时候,学习方式也是口口相传。

记得刚来,就来负责 dtk 的开发与维护,初接触的一周,都不知到该如何敲下手,一行都憋不出来;担心自己凉了,然后网上搜了搜 dtk 关键字,我的妈耶,连一个文档都没得,心里下意识的觉着凉透了,想自学都没得门路,此刻只想点一碗伤心凉粉安慰一下自己;


后那一周,是我的负责人,搬着一个小板凳,坐在我旁边,一行一行的敲着我看的,我才得以快速上手的。后面就想着,一定要尽快的摸清楚 dtk 的绘画自定义皮肤的控件的架构和原理。后面写几篇 dtk 分析,帮助后面小白入门,尽我所能帮助,为它的发展添一块瓦(所幸,在延期了几个月后,将其写出来且发表了🤣🤣)


至今回忆起来,都感觉有点不好意思,但是那会却又是无可奈何。至今都十分奇怪,为何他的耐心如此只好,大概君子无愠色,就是这种赞誉吧~ (尤其是每天都有很多人找他的情况下,巨忙);那个时候,也不只是我,还有很多新人也是被手把手的教会 着如何开发 dtk。那会看到,大佬很忙碌,但是又不得不请教他的时候,就觉得很残忍~(尤其是偶尔还打扰周末休息)


dtk 的文档时代:

约 2019 年末,2020 年初~,deepin 和 team 成长的很多,收获了也很多,和外部一起合力成立一个更大的公司(统信软件),来更好的整合资源与预计前景规划 ~ ;


随着 uos v20 sp1 和 deepin v20 beta 的先后在今年发布,以及 deepin 也收获了金钱和其他资源的支持,反手就是一个投入更多的财力人力和其他资源来研发新的 v20 版本。以获得更好的回报~,然后良性循环。

咳咳,好像有点跑题了哦~ 不过落实到和 dtk 相关的就是,有一段时间,一群研发们,疯狂熬夜加班,给补充 dtk 文档(验证了伏笔 :dog:),使用 Doxygen 来生成文档(大部分都是中文的哦~)。

有关 dtk 的 api 使用说明,可以参考:https://linuxdeepin.github.io/dtk

但不知道为什么会显示上次更新的时间还是 20219-07-10,实际后面有补充很多的~。此阶段外部开发,可以很大一个程度来依靠此文档。且 dtk 的每一个 api 的解释都是写在函数的上面的注释地方。直接使用 IDE 的代码提示 + 源码 api 的注释,可以更加高效的开发。

现阶段就是内部靠: 视频培训 + 手把手带 + Doxygen 文档 + 企业wx群 + 翻看源码 + 组员帮助

外部靠: 回看视频培训 + Doxygen 文档 + 企业wx群@dtk研发来讲解 + 翻看源码 + 组员帮助


不过说讲真,dtk 学习,最快最有效的,还是自行翻阅 Qt & dtk 的源码;和自己尝试独立写出一个自绘 dtk 控件皮肤样式来的快。且学习 qt/ c++ 的人,一般自学能力都真的很强,其中 dtk 的项目都已经在 github 上面同步开源了:linuxdeepin, 其中社区版的分支是和内部的 gitlab 是保持同步的。


dtk 库的快速入门:


如今 dtk 项目的构成(2020-05):

目前,dtk 项目的各个仓库之间的关系如下: 现在基本是这个格局了(图片基本准确),说一下个人的 dtk 和它们之间的理解:

实际开发过程中,你是不需要掌握这么多的库的,也不会需要你一个人同时维护这么多的库,且同时有一些库,是很少被改动的。并不是经常需要提交。

这里再次说一下 dtk 的含义:

dtk = dtk项目 = 多个仓库集合 = dtkwidget + dtkgui + qt5integration + dtkcore + …

关于 dtk 的库,在外网 github 和内网 gitlab 上面是保持一致的,对应的分支是时刻同步的; 故从内网或者外网下载学习,都是这么开心和轻松。对于 dtk 的学习使用,主要掌握以下两个仓库 qt5integration 、 dtkwidget 的学习和使用,其中主要是在工作和兴趣开发中的书写代码的主要阵地。


简述 dtk 的各仓库作用:

下面以一种清晰、简陋的理解,全局的概括的讲解 qt5integrationdtkwidgetdtkgui这三个比较常用的仓库(若是第一次接触的话,看完了后,你还记得每一个部分对应的什么麽?😶😶)


qt5integration:
  • qt5integration 项目结构组成:

    • 其主要是由如下几个子部分组成

      • iconengines: DIcon 插件相关,方便直接提取项目中 .svg 图片资源,常用如:

        case SP_DialogResetButton:
                    icon = QIcon::fromTheme(QLatin1String("edit-clear"));
      • imageformats: 相当于实现 DIcon::fromTheme() 的功能函数

      • qt5deepintheme-plugin: 一些基础的图片 svg 资源存储地方,重点为 Resources 文件

      • styleplugins: deepin 的自定义 chameleon style 样式插件,基本所有 Dxxxxx 控件,都是在 chameleon.h chameleon.cpp 这两个里面实现的(也是我们最主要修改 code 的地方)

      • styles: 测试例子,也是 main.cpp 的函数入口

    • 绘画 dtk 控件的皮肤样式,主要是 chameleon 样式,其中主要的主要效果如下


dtkwidget:

  • dtkwidget 项目结构组成:
    • dtkwidget 其主要是由如下几个子部分组成
      • examples: 里面的 main.cpp 是整个程序的入口,通常在这里测试
      • src: dtk 的自定义 Dxxxx 控件,都存放于其下的 widgets 下, 如 darrowbutton.hdarrowlinedrawer.cppddialog.cppdslider.cpp 这些等(我们也通常在这里直接修改 Dxxx.h 和 Dxxx.cpp 文件),是 dtk 开发的主战场。
      • tools: 工具相关、可不管
    • 绘画 dtk 自定义的控件的皮肤样式,其中主要的主要效果如下


dtkgui:

  • dtkgui 项目结构组成:

    • 这个就是前面说的,现在很少需要修改,但是偶尔要会使用的仓库。比如设计师修改了他们的基础颜色的 Color 的 rgb 数值,调整了一下透明度等,他们给的参数,一般都是在这里来实现,将具体的颜色数值与 Qt 子定义的枚举对应起来。

    • 其中主要是修改 src-dguiapplicationhelper.cpp 该文件,一旦修改,所有其值,所有人的效果都会发生改变,谨慎。


下载地址:

QtExamples

欢迎 star 和 fork 这个系列的 qt/dtk 学习,附学习由浅入深的目录。


资料手册 && 故地址遗迹:

资料手册:

镜像下载:


参考 && 感谢:

在探究 dtk 的历史中,搜寻着一些并不多的网络博客文章,和前辈们、大佬们的沟通,口口相传,文中有使用他们的素材或者博客片段,或者 dtk 的相关介绍、使用技巧链接,表示好感和谢谢 Thanks♪(・ω・)ノ zccrsshulehualetBLumiaxmulijustforlxz …等