Taro 鸿蒙技术黑幕系列(一):怎样将 React 代码跑在 ArkUI 上
<blockquote id="w-e-element-15">基于 Taro 打造的京东鸿蒙 APP 已跟随鸿蒙 Next 系统公测,本系列文章将深入解析 Taro 怎样实现使用 React 开辟高性能鸿蒙应用的技术黑幕背景随着鸿蒙操作系统的快速发展,开辟者们期待将现有跨平台应用迁徙到鸿蒙平台。Taro作为一个盛行的跨平台开辟框架,其支持鸿蒙系统的大概性引起了广泛关注。
然而,鸿蒙系统采取全新的ArkUI框架作为原生UI开辟方案,与Taro本来支持的平台存在显着差别。将Taro的React开辟模式与ArkUI的声明式UI开辟范式举行有用对接成为了一个技术难题。
本文将探讨Taro框架怎样通过创新方案实现React代码在ArkUI上的运行。我们将解析Taro的运行时原理,剖析其怎样将React组件转换为ArkUI可辨认的结构,以及相关技术寻衅和解决方案。
Taro运行时原理先容
为了理解Taro适配ArkUI的核心机制,我们起首需要深入相识Taro的运行时原理。Taro通过巧妙的设计,将React代码转换为各平台可执行的形式,其中包括对鸿蒙平台的适配。下面将详细先容 Taro 是怎样将 React 代码转换为ArkUI可执行的形式,以及节点转换的流程细节。
https://img-blog.csdnimg.cn/img_convert/97c3a996c5dd1ceac248c53c920f5fa1.png
1. 从 React 到 Taro
React 跨平台的秘诀
在 Taro 的运行时中,起首执行的是开辟者编写的 React 业务代码。这些代码定义了业务应用的结构、逻辑和状态管理。那么既然要对接React,那肯定先得相识它的核心架构,React是怎么运作的:
https://img-blog.csdnimg.cn/img_convert/07e91f30c2490c6f721ae9edfcab4c99.png
相识了React的基本架构后,我们可以清晰地看到,Renderer 作为渲染器,负责将React的虚拟节点操作终极映射到相应的平台上。例如,react-dom将这些操尴尬刁难接到浏览器上,而react-native则将其对接到iOS或Android平台。这种设计使得React可以或许适配不同的运行环境。
https://img-blog.csdnimg.cn/img_convert/3a2b22fd2e29689f0cc8d8568863d20e.png
正是基于这种思绪,Taro 团队设计了 Taro Renderer。这个渲染器充当了 React 与 Taro 虚拟节点树之间的桥梁,使得 React 的操作可以被转换为 Taro 的中心表示。
通过实现 Taro Renderer 天生 Taro 虚拟节点树
https://img-blog.csdnimg.cn/img_convert/61f5e5d5438a0362c0b7809b72b33e04.png
HostConfig接口实现
要实现 Taro 的 Renderer,我们需要实现 React Reconciler 所需的 hostConfig 接口。这个接口定义了一系列方法,用于创建、更新和管理渲染目标平台的元素。以下是一些关键的 hostConfig 方法:
•createElement:创建ArkUI对应的元素。
•createTextInstance:创建文本节点。
•appendChild:将子元素添加到父元素。
•removeChild:从父元素中移除子元素。
•insertBefore:在指定位置插入元素。
•commitUpdate:更新元素属性。
通过实现这些方法,Taro Renderer 可以或许将 React 的操作转换为 Taro 虚拟节点树的相应操作。这个虚拟节点树是 Taro 实现跨平台的核心,它为不同平台的渲染提供了统一的中心表示。
// 部分HostConfig接口实现的代码
const hostConfig: HostConfig {
// 创建Taro虚拟节点
createInstance (type, props: Props, _rootContainerInstance, _hostContext, internalInstanceHandle: Fiber) {
const element: TaroElement = TaroNativeModule.createTaroNode(type)
precacheFiberNode(internalInstanceHandle, element)
updateFiberProps(element, props)
return element
},
// 更新属性
commitUpdate (dom, updatePayload, _, oldProps, newProps) {
updatePropsByPayload(dom, oldProps, updatePayload)
updateFiberProps(dom, newProps)
},
// 插入节点
insertBefore (parent: TaroElement, child: TaroElement, refChild: TaroElement) {
parent.insertBefore(child, refChild)
},
// 移除节点
removeChild (parent: TaroElement, child TaroElement) {
parent.removeChild(child)
},
// ...
}
2. 从 Taro 到 ArkUI
在将 Taro 虚拟节点树转换为 ArkUI 的过程中,我们需要举行几个关键步骤:
https://img-blog.csdnimg.cn/img_convert/8cfbe6af6558488626156cf89f39fe15.png
Taro Element转换 ArkUI过程
起首,我们需要在 ArkUI 层面实现一套与 Taro 组件对应的组件库。这个步骤至关重要,因为它建立了 Taro 组件和 ArkUI 组件之间的映射关系。例如,我们需要为 Taro 的 View、Text、Image 等基础组件创建对应的 ArkUI 组件。这样,当我们遍历 Taro 虚拟节点树时,就能找到每个节点在 ArkUI 中的对应实现。
在节点映射的过程中,我们注意到 Taro 虚拟节点树与实际 ArkUI 视图结构存在差别。这些差别主要体现在以下几个方面:
•复合组件结构:某些 Taro 组件在 ArkUI 中大概需要多个组件配合实现。例如,ScrollView 组件在 ArkUI 中大概需要一个 Scroll 节点搭配一个 Stack 来实现完备功能。
•层级位置调整:一些特殊定位的节点(如 Fixed 定位的元素)在终极渲染时的位置大概与其在虚拟节点树中的层级不同等。这需要在天生渲染树时举行特殊处理。
•平台特定组件:某些 Taro 组件大概需要使用 ArkUI 特有的组件或结构方式来实现,这要求我们在转换过程中举行适当的调整和映射。
https://img-blog.csdnimg.cn/img_convert/eec0e98cc1b0628538c19dd5946a67d6.png
因此,在天生渲染树时,我们需要一个更复杂的转换过程,不但要思量简朴的一对一映射,还要处理这些结构性的差别,确保终极天生的 ArkUI 组件树可以或许正确反映预期的视图结构和结构。因此,在Taro > ArkUI的节点对接中,我们需要维护一棵 Render Tree,用于做中心的桥梁。
1. 根据组件范例 创建 Taro Element
在创建 Taro Element 的过程中,我们根据组件的范例来实例化相应的 Taro 元素。这一步骤是将 React 组件转换为 Taro 内部表示的关键。
// 根据组件类型创建对应的Taro节点
std::shared_ptr<TaroElement> TaroDocument::CreateElement(napi_value &node) {
// 获取组件类型
TAG_NAME tag_name_ = TaroDOM::TaroElement::GetTagName(node);
// 根据组件类型,创建对应的实例
std::shared_ptr<TaroDOM::TaroElement> item;
switch (tag_name_) {
case TAG_NAME::SCROLL_VIEW: {
item = std::make_shared<TaroDOM::TaroScrollView>(node);
break;
}
case TAG_NAME::IMAGE:
item = std::make_shared<TaroDOM::TaroImage>(node);
break;
}
case TAG_NAME::SPAN:
case TAG_NAME::TEXT: {
item = std::make_shared<TaroDOM::TaroText>(node);
break;
}
case TAG_NAME::SWIPER: {
item = std::make_shared<TaroDOM::TaroSwiper>(node);
break;
}
// ...
}
return item;
}
2. Taro Element 创建 Taro RenderNode
在创建完 Taro Element 之后,下一步是将其转换为 Taro RenderNode。这个过程是将 Taro 的内部表示进一步转化为更靠近 ArkUI 结构的渲染节点。
// 创建 Taro RenderNode
void TaroSwiper::Build() {
if (!is_init_) {
// create render node
TaroElementRef element = std::static_pointer_cast<TaroElement>(shared_from_this());
auto render_swiper = std::make_shared<TaroSwiperNode>(element);
render_swiper->Build();
}
}
3. Taro RenderNode 创建 ArkUI Node
末了一步是将 Taro RenderNode 转换为实际的 ArkUI 节点。这个过程涉及到直接与 ArkUI 的底层 API 交互,创建和配置 ArkUI 的原生节点。实现了从 Taro 的渲染节点到 ArkUI 实际可渲染节点的终极转换。
// 创建 ArkUI Node
void TaroSwiperNode::Build() {
NativeNodeApi *nativeNodeApi = NativeNodeApi::getInstance();
// 创建一个Swiper的ArkUI节点
SetArkUINodeHandle(nativeNodeApi->createNode(ARKUI_NODE_SWIPER));
}
通过这三个步骤,我们在 C++ 层面成功实现了 React 组件结构到 ArkUI 原生组件结构的映射。这一过程使 Taro 应用可以或许在鸿蒙系统上准确地渲染和运行,为跨平台开辟提供了有力支持。
总结
末了总结下,本文探讨了Taro框架怎样将React代码成功运行在鸿蒙系统的ArkUI上。这个过程主要分为两个关键部门:
https://img-blog.csdnimg.cn/img_convert/c911d795ffd1eb832c7dc4e0718299e6.png
React > ArkUI 架构图
1. Taro对接React
Taro通过实现自定义的Renderer来对接React。这个Renderer包含了一系列方法,如createInstance、commitUpdate等,用于将React的操作转换为Taro虚拟节点树的操作。这个虚拟节点树是Taro实现跨平台的核心,为不同平台的渲染提供了统一的中心表示。
2. Taro对接ArkUI
Taro通过自定义Renderer将React操作转换为虚拟节点树,然后通过三步转换过程将其映射到ArkUI结构。这个过程涉及Taro Element、Taro RenderNode和ArkUI Node这三棵树的维护,主要通过这三个流程步骤实现:
1.创建Taro Element:这一步将React组件转换为Taro内部表示。
2.创建Taro RenderNode:将Taro的内部表示进一步转化为更靠近ArkUI层级结构的渲染节点。
3.创建ArkUI Node:末了一步是将Taro RenderNode转换为实际的ArkUI节点,直接与ArkUI的底层API交互。
通过这种方式,Taro成功地将React组件结构映射到ArkUI原生组件结构,使得Taro应用可以或许在鸿蒙系统上准确地渲染和运行,同时也为跨平台开辟提供了有力支持。
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。
页:
[1]