Duilib源码分析(一)整体框架

  Duilib界面库是一款由杭州月牙儿网络技术有限公司开发的界面开源库,以viksoe项目下的UiLib库的基础上开发(此后也将对UiLib库进行源码分析);通过XML布局界面,将用户界面和处理逻辑彻底分离,极大地提高用户界面的开发效率。一般常用于开发小型项目Windows桌面客户端软件;其子窗口不以窗口句柄的形式创建,只是逻辑上的窗口,绘制在父窗口之上。目前开源协议以BSD发布,可使用于商业应用,好了,其他更为详细的介绍,请查阅其官网或百度。

  源码获取:

    目前duilib不在被维护,基本上网络中各种duilib版本都是被个人维护,原始duilib源码可以在github:https://github.com/disable/duilib;中获取,此外比较活跃的版本:https://github.com/redrains/DuiLib_Redrain;以及https://github.com/duisharp/DuiLib_Ultimate;另外包含一个扩展版本:https://github.com/shaoyuan1943/Duilib_Ext;为了便于理解dullib项目,我们将采用原始版本的duilib源码分析。

  源码文件组织:

    源码文件中主要分为:DuiLib库、用以XML脚本配置的DuiDesigner设计器、doc文档入门手册、bin编译后的设计器和duilib.dll以及各demo需要的xml资源、各种用例demo、包含各种控件的属性列表.XML、其他不重要的文件;

  题外话--》源码分析步骤:

    基本上作为分析源码的步骤大致应该是:

    1. 阅读官方简介,了解其特性、功能、应用场景;

    2. 获取源码和开发文档等一系列说明文档;

    3. 思考自己开发该项目应该会如何架构、功能实现等;

    4. 编译源码、顺利执行程序,观察执行效果,从入口点跟踪程序;

    5. 先了解项目大致运行方式、模块组织结构,体会其中可以学习的设计模式;

    6. 再从细节上学习其使用到得惯用法、奇淫技巧;

    7. 与第3步作对比,感受项目实现和自己的想法的异同点;

    8. 在学习过程中作笔记、画草图,此后若有时间建议可以自己尝试实现该项目,拷贝部分源码分步骤学习也是不错的方式。

    事实上,每个人学习的方式不同,有的人会从开发文档或入门手册开始,有的人会从demo用例开始了解使用。

  以后将以DuLlib库文件分析说明,其他如设计器请自行查看入门手册和使用,因设计器会产生很多无用代码且存在BUG,后期配置XNL时可手动填写即可,填写后可以设计器简单查看效果即可:

  DuLlib库:

    文件结构:

      Core:核心组件(渲染器、容器、构建器、解析器、控件基类);

      Layout:界面布局组件(水平、垂直、子控件、Tab等);

      Utils:辅助工具相关(解压缩、图片、窗口基类、委托等);

      Control:各种控件(button、combox、label、checkbox、list等);

    执行流程:

      以下以TestApp1作为入手demo;找到入口点:WinMain,可以看到实际上是对Win32程序的另外一套不同于MFC框架的封装过程;

      1. CPaintManagerUI:界面显示、消息管理类;此处其设置当前应用程序实例句柄以及实例所需要的资源路径目录;

      2. 初始化COM组件(::CoInitialize() ),以使得duilib可调用COM相关函数;

      3. 创建当前窗口实例并创建、显示窗口,执行CPaintManagerUI的消息循环;

      4. 卸载COM组件(::CoUninitialize() )。

      注意:申请的资源pFrame并没有显式地析构,事实上在退出消息循环前已被析构,请留意消息WM_NCDESTROY,并调用了OnFinalMessage(hWnd)执行了析构;

      运行该程序,一个比较炫的界面展示在我们面前,我们通过断点跟踪每一个步骤:

     我们重点关注第3个流程,窗口如何被创建、界面是如何布局、消息如何流转等;进入Create函数,一眼看见我们熟悉的注册窗口中定义窗口类,

注册窗口、创建窗口;其中重点关注注册窗口类中的消息处理函数CWindowWnd::__WndProc;在创建窗口前(窗口已存在),执行了一系列的操作;

      __WndProc首先得到消息WM_GETMINMAXINFO,然后是WM_NCCREATE,该消息内部处理为保存当前句柄对象,并将本类对象放置在窗口的用户数据中,这样后期可以取出该对象,

    并直接使用该对象成员处理函数即可,实现类静态或全局处理函数转化为类普通成员消息处理函数的目的,即HandleMessage;此外还有其他的消息,如WM_NCSIZE, WM_SIZE等,

    其中消息WM_CREATE下的构建器将实际地根据提供的XML配置、遍历创建各控件元素、并将本类对象和创建的root根控件依附于绘制管理器中;

    消息流转大体方式为:CWindowWnd::__WndProc -> HandleMessage -> CPaintManager::MessageHandler;其中有些消息不被处理将还给::DefWindowProc或

    ::CallWindowProc默认处理;

    消息循环:调用CPaintManagerUI中的MessageLoop,内部采用GetMessage、TranslateMessage、DispatchMessage获取消息、翻译消息、分派消息;其中在调用全局的

    TranslateMessage前,先调用了CPaintManagerUI::TranslateMessage,给予用户自己翻译消息码的机会;  

  基本的流程框架如上,若要站在一个比较高的角度去看整体框架,需要对所有的组织结构有所了解,对于初次接触duilib的话可以先看文档是否有对整体结构的文档说明,然后再对症下药,从自己感兴趣的部分入手;不过没有关系,我们一步一步来,接下来我们将对各组织部分的主要内容进行详细的分析。

      

上一篇:Delphi的类和对象(十)- 异常处理(10种异常来源、处理、精确处理)


下一篇:Duilib源码分析(三)XML解析器—CMarkup