跨端动态化模板引擎详解,看完你也能写一个 | GaiaX 开源解读

简介: GaiaX 跨端模板引擎,是在阿里优酷、淘票票、大麦内广泛使用的 Native 动态化方案,其核心优势是性能、稳定和易用。本系列文章《GaiaX 开源解读》,将带大家看看过去三年GaiaX的发展过程。GaiaX 开源地址:https://github.com/alibaba/GaiaX

在「GaiaX 开源解读」系列文章第一篇:《基于优酷业务特色的跨平台技术 | GaiaX 开源解读》中,为各位读者详细介绍了GaiaX起源背景、业务中碰到的瓶颈问题、解决问题的思路以及GaiaX技术形态的发展过程,在本篇中将进一步深入GaiaX的各个细节,深度解读GaiaX团队同学是如何进行方案落地的,看完本篇内容相信你一定会有所收获。

image.png

GaiaX是由优酷应用技术中心团队研发的一款跨端高性能渲染引擎,其本质是个视图还原框架,其核心理念是将模板还原成双端的视图组件,我们先通过一个视图还原渲染的流程图,看看GaiaX的上下游是如何工作的:

组件设计稿:组件设计稿是由设计同学给出,用于展示视图组件的效果图,开发同学需要用这个文件进行视图组件的开发。

GaiaStudio:开发同学通过使用GaiaStudio,以拖拽、编写的方式来创建节点的层级、设置节点的样式、为节点绑定数据,最终得到模板文件。

模板文件:模板文件也被称作GaiaX的DSL,其中包含三个子DSL,分别是index.json、index.css、index.databinding,用来描述节点的层级关系、节点样式、节点数据绑定逻辑。

GaiaX:在双端上通过使用SDK来解析模板的内容,经过节点树的构建和视图树的构建、视图树的数据绑定等步骤后,得到Native视图,最终交给双端渲染。

端渲染:经过双端SDK对模板的加工和处理后,在Android和iOS上可以分别得到一个View和一个UIVIew,这两个NativeView便是最终用于渲染的视图,只需要将其插入的原生视图中即可展示出渲染效果。

在了解了GaiaX的上下游与涉及到的环节后,下面就介绍一下GaiaX中的两个核心概念 - 模板、节点树与视图树:

image.png

模板:其描述了用于视图还原的各种信息,模板作为自定义的DSL,其由三个子DSL构成,分别是FlexBox、Css、Databinding,它们会被存储在index.json文件、index.css文件、index.databinding文件中:

  • index.json文件用于存储视图的关联关系。在该文件中,以json的格式,描述了每个视图的层级关系、并列关系、嵌套关系等。
  • index.css文件用于存储视图的样式。在该文件中,以通用的Css规范格式,描述了每个视图节点的布局信息和样式信息。
  • index.databinding文件用于存储视图的数据绑定逻辑。在该文件中,以json的格式,描述了每个视图的数据绑定关系和动态更新逻辑。这其中用到了自定义的表达式 ,它支持常规的取值、对比、条件等计算。

image.png

节点树与视图树:如果用比喻的手法来描述节点树与视图树,那么可以将其比作人体的骨架与血肉。节点树的主体结构由模板的index.json文件解析构建而来,节点树上的每个节点所附带的信息则是由模板的index.css和index.databinding文件解析而来,每个节点上都包含有id、type、parent、children、layer、data、style、layout等信息。视图树是节点树加工后的产物,在加工过程中,通过利用节点上所附带的信息可以创建出与节点类型一致的原生视图类型,并将其挂载到节点树上,当节点树遍历完成后,视图树也就创建完成了。

理解了这两个核心概念,也就理解了GaiaX作为视图还原框架的核心思想,不过这对于想要完整理解GaiaX全部技术细节的同学来说还不太够,要构建出一个好用的跨平台框架还需要良好的架构设计来辅助开发人员,下面带大家看看GaiaX的架构是如何设计的。

架构设计

在讲解GaiaX的架构设计之前,让我们先介绍一下什么是架构图。从定义上来说,架构是由系统组件以及组件间相互关系共同构成的集合体,而架构图,则是用来表达这种集合的载体,它的作用也很简单,划分目标系统的边界、将目标系统的结构可视化,进而减少沟通障碍,提升协作效率。

明确了什么是架构图之后,让我们看看GaiaX架构设计的几个原则:少依赖、可扩展、高内聚、低耦合,这些原则不仅能满足的业务的诉求,也满足了技术上的一般性原则,为此我们将架构设计为了上中下三层,分别是服务层、核心层、基础依赖层,每一层以下一层为支撑,每层之中又拆分为若干模块,每个模块彼此独立的同时又包含若干子模块以支撑自身模块的功能。

image.png

在基础依赖层之中,包含了一个Stretch模块。

Stretch是基于Rust语言编写的跨平台FlexBox布局计算库,通过传入节点树和视口尺寸,就能计算出各个节点的基于绝对布局的坐标信息(宽、高、X轴Y轴偏移量),而这便是GaiaX能够跨平台的关键。

在核心层之中,包含了四个模块,模板数据管理模块、模板解析与转换模块、渲染模块、上下文模块。

在模板数据管理模块中包含了两个子模块 - 缓存模块、数据源模块。由于模板是个文件集合,可以被灵活使用,既可以放在app内置作为普通文件读取,也能上传到服务端用于服务端下发以增加动态性,而不同来源的模板则需要不同的数据源实现,一般来说会有内置数据源、远程数据源等等,这些都被数据源模块统一管理。由于模板文件的读取和解析是个耗时操作,其中包含IO文件读取和JSON格式的转换,如果不缓存就会产生大量耗时,这些都被缓存模块统一管理。

在模板解析与转换模块中包含了四个子模块 - 模板解析模块、转换模块、表达式模块、动画模块。模板解析模块,顾名思义就是将模板原始字符串解析成模板实体类的模块,将index.json、index.css、index.databinding三个文件转换为键值对结构存储以便后续直接索引使用,在解析过程中还涉及到了转换模块(用于处理px、%、pt等数值逻辑和#00ff00、red等颜色逻辑)、表达式模块(用于数据绑定和样式更新)、动画模块的逻辑,其最终产物是个模板实体类。

在渲染模块中包含了两个子模块 - 节点与布局模块和视图与渲染模块。节点与布局模块中包含很多逻辑,节点的定义、节点树的创建、节点树的更新、节点树到布局信息产物的计算逻辑(会使用到Stretch)以及对文字自适应的处理。视图与渲染模块中则包含了视图树的创建、视图树的层级合并、视图树的样式设置、视图树的数据绑定、视图类型的定义(GXView、GXScroll、GXText等等)等逻辑。

在服务层之中,包含了两个模块,引擎模块和扩展模块。

引擎模块中主要包含了统一对外的API,方便业务接入,例如createView和bindData的两个核心方法。扩展模块中包含了诸多扩展方法,也是可扩展性的体现,其中包含了表达式扩展、Lottie扩展、事件扩展等等,足以满足各种业务的使用。

表达式这部分内容将在后续系列文章《表达式作为逻辑动态化的基础,我们是如何设计的》中进行详细的进行介绍,也请各位读者持续的关注。

当了解完架构设计原则和架构图之后,相信各位读者已经对GaiaX比较熟悉了,下面就进入GaiaX逻辑链路之中,看看各个模块是如何相互配合的。

渲染总线

image.png

在GaiaX的模板到端渲染的逻辑链路过程中,主要涉及到六个模块,分别是上下文模块、模板数据管理模块、模板解析与转换模块、节点与布局模块、视图与渲染模块等等。

业务方:业务方需要确定使用的业务ID和模板ID,构建出GXTemplateItem,将其传入到GaiaX的createView方法中,该方法最终会返回一个原生视图用于页面渲染。

模板数据管理模块:根据传入的GXTemplateItem,获取模板实体类信息。如果缓存池中有则直接使用,否则按照优先级顺序打开数据源,获取模板信息。在这个过程中如果模板是首次加载,会使用模板解析与转换模块,将模板内容转换为实体类对象返回,并缓存到缓存池中。

模板解析与转换模块:在模板解析与转换模块中,会对index.json、index.css、index.databinding文件分别读取解析。index.json文件会将其转化成节点树结构,每一个节点对应一个类型,一个类型又对应一个原生View;index.css会将其存储为键值对(KV)结构,Key为节点ID,Value为节点样式,样式中存储了节点的位置信息和样式信息;index.databinding为将其存储为键值对(KV)结构,Key为节点ID,Value为节点的数据绑定逻辑,其中包含Value的取值逻辑和Extend的扩展逻辑。

上下文模块:使用模板数据管理模块获取到模板信息后,则会使用上下文模块进行GXTemplateContext的构建,每个模板创建出的组件实例都会有一个GXTemplateContext对象用于维护必要的信息,例如context、size、templateItem、rootView等等,GXTemplateContext会存活于组件的整个生命周期。

渲染模块 - 节点与布局模块:准备好GXTemplateContext(上下文)和GXTemplateInfo(模板信息)后,会执行一个关键步骤 - 节点树的构建。上文中,我们提到过两个子DSL,分别是FlexBox和Css,其中FlexBox和index.json组合可以确定一个视图的位置信息,我们知道原生组件,是无法识别FlexBox和index.json的,这里会用到一个转换过程,可以将基于FlexBox的节点,转化成基于绝对布局的节点层级,而绝对布局在双端是可以被还原的。这里用于FlexBox转换为绝对布局的库就是Stretch。Stretch是使用Rust语言编写的跨平台双端底层库,为其传入一个节点树,通过布局计算方法,就可以拿到基于绝对布局的节点布局信息。

渲染模块 - 视图与渲染模块:当有了节点布局信息、节点样式信息、节点数据绑定关系后,还会执行一个关键的步骤 - 视图树的构建。这里以Android为例,描述一下视图树的构建过程,根据上个步骤得到的节点树信息,不断遍历,根据每个节点的类型信息,为其创建原生的视图,例如:当节点类型是view时,会反射创建一个AbsoluteLayout。当创建了原生View后,根据节点ID取出布局信息,也就是宽度、高度和X、Y轴的偏移量,将其赋值给AbsoluteLayout。当遍历结束,一个带有宽高和偏移量的视图树就被构建成功了。

渲染模块 - 视图与渲染模块:当视图树构建成功后,此时视图树中的每个子视图还只是空壳子,还需要为视图树设置样式和绑定数据,此时业务方会调用bindData方法,进行数据的绑定和样式的更新。在这个过程中,需要为每个子视图绑定样式、事件、动画等,在这个过程中也会和一些扩展逻辑进行交互,例如:响应式、基础组件库、DesignToken、暗黑模式等;也需要为每个子视图绑定数据,每个子视图的数据绑定逻辑都由两个部分构成 - Value取值逻辑和Extend扩展逻辑,在值和扩展中,都可以使用表达式来构建。等这些全部处理结束后,一个携带布局、样式、数据的视图树就构建完成了。

端渲染:最后,就可以将视图树的根节点交给页面渲染了。

以上就是模板到端渲染逻辑链路的全过程,相信各位读者看完后一定对GaiaX的核心链路和全貌有了更为深入的了解。

细节下探

除了核心链路,GaiaX中还有一些细节点值得挖掘,下面我们看看节点树计算逻辑、视图层级合并逻辑、文本自适应逻辑是如何处理的。

             节点树计算逻辑

image.png

节点树的计算逻辑是连接自定义DSL和双端Native的关键纽带。在上文中,我们提到过两个子DSL,分别是FlexBox和Css,其中FlexBox和index.json组合可以确定一个视图的位置信息,而原生组件,是无法识别FlexBox和index.json的,通过Stretch可以将基于FlexBox的节点,转化成基于绝对布局的节点层级,而绝对布局在双端是可以被还原的。

Stretch这部分的详细内容将在后续系列文章《给Stretch(Rust语言编写的跨平台FlexBox布局计算库)新增特性,我掉了好多头发》中进行详细的进行介绍,也请各位读者持续的关注。

视图层级合并逻辑

image.png

层级合并是多数跨平台技术方案都会做的事情,其主要目的是减少无用耗时。一方面,在遍历节点树创建视图和遍历视图树为视图绑定样式和数据时,存在大量的CPU计算,如果能够减少遍历的次数,减少节点的数量,就可以提高性能。另一方面,在通过GaiaStudio搭建模板时,为了达成某个布局目标,开发人员往往会放置多个无意义的节点,仅有FlexBox信息,没有样式信息、没有扩展属性、没有事件、没有埋点和动画,那么这种节点就不应该被渲染,通过层级合并技术,将这种视图创建逻辑在运行时移除掉,不仅仅可以省去反射构建视图的过程,还能省去绑定操作。

层级合并的逻辑规则如下:

  1. 根节点不进行合并
  2. 被合并节点需要满足一定规则
  • 节点是view类型
  • 节点是空样式
  • 节点没有虚拟父节点
  • 节点没有动画、事件、埋点、数据绑定逻辑
  1. 记录被合并节点的布局信息,直到遇见不需要被合并的节点时,统一弹出使用
  • 遍历记录的节点,记录x轴与y轴的变化(合并节点仅需要注意x、y的偏移量)
  • 与将要渲染视图的节点结合处理x、y偏移量
  1. 重复1~3步骤

此处提供了层级合并的核心代码,有兴趣的可以了解一下:核心代码[1]

文本自适应逻辑

Stretch提供的FlexBox布局计算逻辑虽然能满足大部分使用场景,但主要针对的是静态布局,对文本自适应的场景却无法自动处理,而做过客户端的同学都知道,无论是Android的TextView和iOS的UIText都提供了很强大的文本自适应能力,以满足各种灵活的使用场景。因此,也需要在Stretch基础上为GaiaX增加了文本自适应的逻辑。

image.png

为了简化文本自适应的逻辑,双端制定了一些基础规则:

  • 定宽求高或者定高求宽
  • 单行状态下,定高求宽。文字自适应后的宽度以实际计算为准,不应超过原有宽度设置值
  • 多行状态下,定宽求高。文字自适应后的高度以实际计算为准,不受到原有高度的影响。
  • 前置处理与后置处理:
  • 应先使用Stretch计算过一次布局,这样可以拿到节点的布局信息,增加计算准确性。
  • 如果模板中存在动态更新节点的样式等逻辑(例如:width、height、margin、padding),需要再使用Stretch计算一次布局,以保证计算准确性。
  • 如果设置了flexGrow,文字适应后,需要将flexGrow设置成0。

此处提供了文本自适应的核心代码,有兴趣的可以了解一下:核心代码[2]

系列文章

《GaiaX开源解读》系列文章预告如下,欢迎持续关注:

  1. 基于优酷业务特色的跨平台技术 | GaiaX 开源解读
  2. 《跨端动态化模板引擎详解,看完你也能写一个》
  3. 《给Stretch(Rust语言编写的跨平台FlexBox布局计算库)新增特性,我掉了好多头发》
  4. 《表达式作为逻辑动态化的基础,我们是如何设计的》
  5. 《向经典致敬 ReactNaitve与GaiaX渲染核心技术分析》
  6. 《为了保障双端一致性,我们做了哪些努力》
  7. 《一条龙的模板研发体系,你不来看看么》



相关实践学习
如何快速连接云数据库RDS MySQL
本场景介绍如何通过阿里云数据管理服务DMS快速连接云数据库RDS MySQL,然后进行数据表的CRUD操作。
相关文章
|
数据采集 移动开发 文字识别
服务阿里 9 个APP|揭秘新奥创升级的质量演变
新奥创技术体系,是手机淘宝端搭载着星环中台的整个商业化研发体系,孵化出的面对无线电商领域的技术体系。过去一年在手淘完成了下单、详情、购物车三大业务域的改造,接下来还会在订单、手淘导购等领域进行技术升级。目前新奥创已经接入阿里内的9个 App,逐步成为阿里集团无线领域电商系的技术解决方案。 本文主要围绕新奥创技术体系的升级,剖析架构升级对测试保障带来的新的转变,也是新的机遇。
6239 0
服务阿里 9 个APP|揭秘新奥创升级的质量演变
|
3月前
|
人工智能 自然语言处理 安全
Claude Code 全攻略:命令大全 + 实战工作流(建议收藏)
本文介绍了Claude Code终端AI助手的使用指南,主要内容包括:1)常用命令如版本查看、项目启动和更新;2)三种工作模式切换及界面说明;3)核心功能指令速查表,包含初始化、压缩对话、清除历史等操作;4)详细解析了/init、/help、/clear、/compact、/memory等关键命令的使用场景和语法。文章通过丰富的界面截图和场景示例,帮助开发者快速掌握如何通过命令行和交互界面高效使用Claude Code进行项目开发,特别强调了CLAUDE.md文件作为项目知识库的核心作用。
48095 72
Claude Code 全攻略:命令大全 + 实战工作流(建议收藏)
|
6月前
|
人工智能 运维 前端开发
Claude Code 30k+ star官方插件,小白也能写专业级代码
Superpowers是Claude Code官方插件,由核心开发者Jesse打造,上线3个月获3万star。它集成brainstorming、TDD、系统化调试等专业开发流程,让AI写代码更规范高效。开源免费,安装简单,实测显著提升开发质量与效率,值得开发者尝试。
13241 5
|
3月前
|
人工智能 监控 JavaScript
Claude Code 必装插件:claude-hud 让你的 AI 编程效率翻倍
![封面图](https://oscimg.oschina.net/oscnet/up45b3d45a4d73cfc21ab909d1632066be5b9.png) JeecgBoot AI专题研究 Claude Code 状态监控插件 claudehud 深度体验与实战指南 你真的了解 Cla
4453 1
Claude Code 必装插件:claude-hud 让你的 AI 编程效率翻倍
|
人工智能 IDE 开发工具
2.4k star 开源项目,Wingman AI + 知识图谱,如何帮你搭建‘私人大脑’?学术/项目必备,让笔记真正活起来!
MindForger 是一款灵感源于人脑思维机制的桌面 Markdown IDE,帮助用户构建私人知识体系。它通过强大的语义联想与结构重构功能,解决笔记混乱、缺乏智能联接等痛点。核心功能包括 TAYR/TAYW 联想、知识图谱浏览器、Markdown 编辑器和 AI 助手 Wingman。支持本地隐私保护,跨平台使用,开源 GPLv2 许可。项目地址:https://github.com/dvorka/mindforger。
515 4
|
机器学习/深度学习 存储 人工智能
MNN-LLM App:在手机上离线运行大模型,阿里巴巴开源基于 MNN-LLM 框架开发的手机 AI 助手应用
MNN-LLM App 是阿里巴巴基于 MNN-LLM 框架开发的 Android 应用,支持多模态交互、多种主流模型选择、离线运行及性能优化。
17045 81
MNN-LLM App:在手机上离线运行大模型,阿里巴巴开源基于 MNN-LLM 框架开发的手机 AI 助手应用
|
人工智能 JSON 定位技术
地图类MCP 从0-1构建行程规划Agent 之 DeepNLP MCP应用市场
本文重点介绍借助DeepNLP的MCP应用市场中 MCP Server的JSON文件配置,在 Cursor客户端 从0-1构建一个行程规划AI AGENT,为行程规划类的AI AGENT。五一假期期间帮助用户把自己电脑变成一个超级AI AGENT智能体。目前主要使用了Google Map/Baidu Map和高德AMAP的MCP,实现如北京到上海的三天火车旅行规划。内容涵盖基础设置准备、Agent Mode测试及不同地图服务的横向对比与具体配置方法(如NPX、Docker、Python等)。
|
Web App开发 移动开发 安全
h5页面的优缺点(浅谈)
H5页面优点包括:跨平台性,易于传播,丰富的多媒体支持,开发成本低,更新便捷,良好的交互性。缺点则有:性能受限,功能受限,高度依赖网络,存在安全风险,用户体验一致性差。确保H5页面在不同设备上的兼容性,需遵循HTML5标准,使用响应式设计,并进行多设备测试。优化H5页面性能的方法包括减少HTTP请求,压缩文件大小,利用缓存机制,优化代码执行效率等。