ACE_Engine 框架是 OpenHarmony 的 UI 开发框架,提供开发者在进行应用 UI 开发时所必需的各种组件,以及定义这些组件的属性,样式,事件及方法。通过这些组件可以很方便的进行 OpenHarmony 上 UI 应用的开发。
ACE_Engine 框架概述
ACE_Engine 提供的组件分为两种类型,即:类 Web 开发范式类型和声明式开发范式类型。其中类 Web 开发范式中定义一个页面需要三个文件,html,css 和 js 文件。
html 文件负责页面布局,css 文件负责定义组件的样式,js 文件负责业务逻辑实现。
而声明式范式仅需要 1 个 ets 文件,页面布局和组件的样式以及业务逻辑实现都在此文件中。
如下图:
ACE_Engine 框架模块划分
对于类 Web 开发范式组件,根据组件从前端到后端的过程,可以将整个框架划分为 JsFrameWork,DomNode,ComPonent,RenderNode 四个模块。
其作用分别如下:
①JsFrameWork
负责解析前端 html 和 css 文件,创建出 DomNode 树。该树的结构和前端页面是一一对应的。
②DomNode
负责将 Dom 树转换为 Component 树。注意一个 Dom 节点转换过后的 Component 节点实际上并不是一个单独的节点,而是一颗以 rootComponent 为跟节点的组件树。
该树中逐层包裹了对应的功能组件,最内部才是真正的主节点(这样的作用是功能解耦合,将某一特定的功能放到对应的组件中去)。
如 BoxComponet 负责组件的边框绘制,DisplayComponent 负责组件透明度绘制,TouchComponent 负责组件触摸时间的处理等。
一个详细过程见 DOMNode::GenerateComponentNode 函数。
③ComPonent
负责将 Component 树中所有继承自 RenderComponent 的节点(可绘制节点)创建对应的 RendNode 节点,生成对应的 RendNode 树。
见 RenderComponent ::CreateRenderNode 虚函数。
④RenderNode
RenderNode 即可绘制的节点,负责组件的最终布局和绘制。其中布局函数为 PerformLayout 虚函数,由每个组件对应的实现类 Render 类来实现。
绘制函数为 Paint 虚函数,由每个组件对应的子类 FlutterRender 类来实现。
对于声明式开发范式组件,根据组件从前端到后端的过程,可以将整个框架划分为 EtsLoader,JsView,ComPonent,RenderNode 四个模块。
其作用分别如下:
①EtsLoader
负责解析 ets 页面,根据组件的 tag 标签创建对应的 JsView 对象,生成 jsView 树。
②JsView
负责处理组件的属性,方法和事件。并通过 Create 函数创建对应的 Component 树。
③ComPonent
同 Web 开发范式组件中的 Component。
④RenderNode
同 Web 开发范式组件中的 RenderNode。 各模块创建示意图如下图所示:
各模块见的调用关系及主要函数如下:
组件的属性/样式的传递过程
①组件的属性和样式是保存在前端页面的,通过 JsframeWork 解析页面,并调用 JsEngine 的 CreateDomNode 接口创建 Dom 节点的同时传递新节点属性和样式。
如果页面中属性样式发生变化,则单独调用SetAttr或SetStyle来更新属性和样式。
②DomNode 收到属性和样式之后,会将通用属性保存在 Declation 类中,将组件特有的属性通过 SetSpecialAttr 和 SetSpectialStyle 函数保存在自身。
③DomNode 调用对应 Component 类的 Set*** 函数,将所有属性和样式设置到 Component 中。
④RenderNode 创建后,会调用其 Update 函数。
该函数内调用对应 Component 的 Get*** 函数,来接收组件的所有属性和样式。
⑤在 PipeLine 中会遍历每个 RenderNode 进行布局和绘制,此时,就依据 RenderNode 中接收的属性和样式,进行布局并绘制。
总结
ACE_Engine 框架整体代码较复杂,涉及的类也比较多。本文简单介绍了一个 ACE 组件从前端的页面描述,到中间层三棵树的创建和属性传递,以及最终进行UI布局和绘制的整个过程。
该过程简单总结一下就是:JS 页面→Dom 树→Component 树→Render 树,最后绘制 Render 树。
大家只要理解这个基本过程,在结合代码关注重点流程。相信一定能够对 ACE_Engine 框架的代码有整体的理解。在此基础上可以进行 ACE 组件的增强功能开发,包括新增一个 ACE 组件等。
审核编辑:汤梓红
免责声明:文章内容来自互联网,本站不对其真实性负责,也不承担任何法律责任,如有侵权等情况,请与本站联系删除。
转载请注明出处:鸿蒙ACE开发框架总结-鸿蒙开发app上线 https://www.yhzz.com.cn/a/5200.html