OpenHarmony实战开发-ArkWeb同层渲染、如何将系统原生组件直接渲染到前端H5页面上。

最新推荐文章于 2024-08-18 09:30:00 发布
最新推荐文章于 2024-08-18 09:30:00 发布
阅读量942 收藏 14
点赞数 21
分类专栏： 鸿蒙工程师 鸿蒙 HarmonyOS 文章标签： harmonyos HarmonyOS 鸿蒙应用开发 鸿蒙 鸿蒙开发 鸿蒙系统 OpenHarmony
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/2401_82546228/article/details/137920649
版权
鸿蒙工程师 同时被 3 个专栏收录
567 篇文章 8 订阅
订阅专栏
鸿蒙
567 篇文章 2 订阅
订阅专栏
HarmonyOS
555 篇文章 0 订阅
订阅专栏

介绍

该方案展示了ArkWeb同层渲染：将系统原生组件直接渲染到前端H5页面上，原生组件不仅可以提供H5组件无法实现的一些功能，还能提升用户体验的流畅度。

效果图预览

在这里插入图片描述

使用说明

1.进入页面即可看到同层渲染效果，Text，Image都是原生组件。

实现思路

1.添加权限。

"ohos.permission.INTERNET"

2.创建控制器管理绑定的NodeController。

class SearchNodeController extends NodeController {
  private rootNode: BuilderNode<[Params]> | undefined | null = null;
  private embedId: string = "";
  private surfaceId: string = "";
  private renderType: NodeRenderType = NodeRenderType.RENDER_componentTypeDISPLAY;
  private componentWidth: number = 0;
  private componentHeight: number = 0;
  private componentType: string = "";

  setRenderOption(params : NodeControllerParams): void {
    this.surfaceId = params.surfaceId;
    this.renderType = params.renderType;
    this.embedId = params.embedId;
    this.componentWidth = params.width;
    this.componentHeight = params.height;
    this.componentType = params.type;
  }
  /**
   * 在对应NodeContainer创建的时候调用、或者通过rebuild方法调用刷新
   */
  makeNode(uiContext: UIContext): FrameNode | null {
    this.rootNode = new BuilderNode(uiContext, { surfaceId: this.surfaceId, type: this.renderType});
    if (this.componentType === 'native/component') {
      this.rootNode.build(wrapBuilder(searchBuilder), { width: this.componentWidth, height: this.componentHeight});
    } else {
    }
    // 返回FrameNode节点
    return this.rootNode.getFrameNode();
  }
  /**
   * 设置BuilderNode节点
   */
  setBuilderNode(rootNode: BuilderNode<Params[]> | null): void {
    this.rootNode = rootNode;
  }
  /**
   * 获取BuilderNode节点
   */
  getBuilderNode(): BuilderNode<[Params]> | undefined | null {
    return this.rootNode;
  }
  /**
   * 更新BuilderNode节点
   */
  updateNode(arg: Object): void {
    this.rootNode?.update(arg);
  }
  /**
   * 获取EmbedId
   */
  getEmbedId(): string {
    return this.embedId;
  }
  /**
   * 将触摸事件派发到rootNode创建出的FrameNode上
   */
  postEvent(event: TouchEvent | undefined): boolean {
    return this.rootNode?.postTouchEvent(event) as boolean;
  }
}

3.添加同层渲染的组件。

@Component
struct SearchComponent {
@Prop params: Params;

build() {
  Column({ space: MARGIN_VERTICAL }) {
    // 原生Text组件
    Text($r('app.string.mall')).fontSize($r('app.string.ohos_id_text_size_body1'))
    Row() {
      Image($r('app.media.search_icon'))
        .width($r('app.integer.search_icon_width'))
        .margin({ left: $r('app.integer.left_margin') })
      Text($r('app.string.search_text_placeholder'))
        .fontSize($r('app.string.ohos_id_text_size_body2'))
        .opacity(OPACITY)
        .fontColor($r('app.color.ohos_id_color_foreground'))
        .margin({ left: $r('app.integer.left_margin') })
    }
    // 原生Grid组件，Grid中包含Image和Text
    Grid() {
      // 性能知识点：此处数据量确定且数量较少，使用了ForEach，在数据量多的情况下，推荐使用LazyForeEach
      ForEach(PRODUCT_DATA, (item: ProductDataModel, index: number) => {
        GridItem() {
          Column({ space: MARGIN_VERTICAL }) {
            Image(item.uri).width($r('app.integer.image_size'))
            Row({ space: MARGIN_VERTICAL }) {
              Text(item.title).fontSize($r('app.string.ohos_id_text_size_body3'))
              Text(item.price).fontSize($r('app.string.ohos_id_text_size_body3'))
            }
          }
        }
      })
    }
    .columnsTemplate('1fr 1fr')
    .rowsTemplate('1fr 1fr 1fr')
    .rowsGap($r('app.string.ohos_id_elements_margin_vertical_m'))
    .columnsGap($r('app.string.ohos_id_elements_margin_vertical_m'))
   }
 }
}

4.embed标签可以在H5页面中嵌入任何类型的内容，在H5界面上通过embed标签标识同层元素，应用侧会将原生组件渲染到H5页面embed标签所在位置。

<div>
    <div id="bodyId">
        <!-- 在H5界面上通过embed标签标识同层元素，在应用侧将原生组件渲染到H5页面embed标签所在位置-->
        <embed id="nativeSearch" type = "native/component" width="100%" height="100%" src="view"/>
    </div>
</div>

5.通过WebView的enableNativeEmbedMode()控制同层渲染开关，通过onNativeEmbedLifecycleChange获取embed标签的生命周期变化数据。

build(){
  Stack() {
    // 性能知识点：此处componentId项确定且数量较少，使用了ForEach，在数据量多的情况下，推荐使用LazyForeEach
    ForEach(this.componentIdArr, (componentId: string) => {
      NodeContainer(this.nodeControllerMap.get(componentId));
    }, (embedId: string) => embedId)
    // web组件加载本地test.html页面
    Web({ src: $rawfile("view.html"), controller: this.browserTabController })
      .backgroundColor($r('app.color.ohos_id_color_sub_background'))
      .zoomAccess(false) // 不允许执行缩放
      .enableNativeEmbedMode(true) // TODO: 知识点：通过enableNativeEmbedMode（）配置同层渲染开关
      .onNativeEmbedLifecycleChange((embed) => { // TODO: 知识点：通过onNativeEmbedLifecycleChange获取embed标签的生命周期变化数据
        // 获取web侧embed元素的id
        const componentId = embed.info?.id?.toString() as string
        if (embed.status === NativeEmbedStatus.CREATE) {
          // 创建节点控制器，设置参数并rebuild
          let nodeController = new SearchNodeController();
          // 外接纹理与WebView同层渲染
          nodeController.setRenderOption({
            surfaceId: embed.surfaceId as string,
            type: embed.info?.type as string,
            renderType: NodeRenderType.RENDER_TYPE_TEXTURE,
            embedId: embed.embedId as string,
            width: px2vp(embed.info?.width),
            height: px2vp(embed.info?.height)
          });
          nodeController.rebuild();
          // 根据web传入的embed的id属性作为key，将nodeController存入map
          this.nodeControllerMap.set(componentId, nodeController);
          // 将web传入的embed的id属性存入@State状态数组变量中，用于动态创建nodeContainer节点容器，需要将push动作放在set之后
          this.componentIdArr.push(componentId);
        } else if (embed.status === NativeEmbedStatus.UPDATE) {
          let nodeController = this.nodeControllerMap.get(componentId);
          nodeController?.updateNode({
            text: 'update',
            width: px2vp(embed.info?.width),
            height: px2vp(embed.info?.height)
          } as ESObject);
          nodeController?.rebuild();
        } else {
          let nodeController = this.nodeControllerMap.get(componentId);
          nodeController?.setBuilderNode(null);
          nodeController?.rebuild();
        }
      })
      .onNativeEmbedGestureEvent((touch) => { // 获取同层渲染组件触摸事件信息
        this.componentIdArr.forEach((componentId: string) => {
          let nodeController = this.nodeControllerMap.get(componentId);
          if (nodeController?.getEmbedId() === touch.embedId) {
            nodeController?.postEvent(touch.touchEvent);
          }
        })
      })
  }
}

6.h5侧通过id名获取embed标签信息,并通过embed标签添加同层渲染界面的touch监听事件；应用侧添加onNativeEmbedGestureEvent回调使得手指触摸到embed标签时能获取到触摸事件信息。

let nativeEmbed = {
  // 通过id名获取embed标签
  nativeSearch : document.getElementById('nativeSearch'),
  // 事件
  events:{},
  // 初始化
  init:function(){
    let self = this;
    // 添加touch的监听事件
    self.nativeSearch.addEventListener('touchstart', self.events, false);
  }
};
nativeEmbed.init();

Web({ src: $rawfile("view.html"), controller: this.browserTabController })
  // 获取同层渲染组件触摸事件信息
  .onNativeEmbedGestureEvent((touch) => {
    this.componentIdArr.forEach((componentId: string) => {
      let nodeController = this.nodeControllerMap.get(componentId);
      if (nodeController?.getEmbedId() === touch.embedId) {
        nodeController?.postEvent(touch.touchEvent);
      }
    })
  })

高性能知识点

ArkWeb同层渲染原生组件，原生组件不仅可以提供H5组件无法实现的一些功能，还能提升用户体验的流畅度；同层渲染节点上下树，实现节点复用，节省节点重复开销。

工程结构&模块类型

nativeembed                            // har类型
|---mock
|   |---GoodsMock.ets                  // 数据源
|---model
|   |---GoodsModel.ets                 // 数据类
|---view
|   |---NativeEmbedView.ets            // 视图层

模块依赖

本实例依赖common模块来实现资源的调用。 依赖动态路由模块来实现页面的动态加载。

如果大家还没有掌握鸿蒙，现在想要在最短的时间里吃透它，我这边特意整理了《鸿蒙语法ArkTS、TypeScript、ArkUI等…视频教程》以及《鸿蒙开发学习手册》（共计890页），希望对大家有所帮助：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

鸿蒙语法ArkTS、TypeScript、ArkUI等…视频教程：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

在这里插入图片描述

OpenHarmony APP应用开发教程步骤：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

在这里插入图片描述

《鸿蒙开发学习手册》：

如何快速入门：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

1.基本概念
2.构建第一个ArkTS应用
3.……

在这里插入图片描述

开发基础知识：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

1.应用基础知识
2.配置文件
3.应用数据管理
4.应用安全管理
5.应用隐私保护
6.三方应用调用管控机制
7.资源分类与访问
8.学习ArkTS语言
9.……

在这里插入图片描述

基于ArkTS 开发：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

1.Ability开发
2.UI开发
3.公共事件与通知
4.窗口管理
5.媒体
6.安全
7.网络与链接
8.电话服务
9.数据管理
10.后台任务(Background Task)管理
11.设备管理
12.设备使用信息统计
13.DFX
14.国际化开发
15.折叠屏系列
16.……
在这里插入图片描述

鸿蒙生态应用开发白皮书V2.0PDF：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

在这里插入图片描述

码牛程序猿
关注
专栏目录
前端H5获取Android原生相册文件和拍照功能直接重新WebView的方法即可
03-06
在开发移动端应用时，前端H5与Android原生交互是一个常见的需求。特别是在涉及到用户选择本地文件，如从相册选取图片或直接通过相机拍照时，由于不同平台的兼容性问题，开发者需要采取特定的策略。本文将深入探讨...
HarmonyOS 开发者联盟高级认证最新题库
热门推荐
网罗天下方法，方便你我开发！！！
07-15 1万+
本篇文章包含 Next 版本更新后高级认证题库中95%的题目。 答案正确率 50-60%，答案仅做参考。 请在考试前重点看一遍题目，勿要盲目抄答案。 欢迎在评论留言正确答案和未整理的题目。
【鸿蒙开发】 使用ArkWeb组件加载H5页面
m0_56255097的博客
04-10 2564
相当于iOS/Android中的WebView控件，给个url就可以展示H5页面。我也是带着这些问题去学习使用ArkWeb的。
鸿蒙OS应用试题例题（绿色的是答案）
最新发布
SSRppIG的博客
08-18 1281
为了确保高质量的发布，小李意识到需要实施一套全面的测试策略，覆盖代码的自动化测试和手动测试，还需要衡量代码的测试覆盖率，以确定测试的充分性。C.可以在HAR模块工程的build-profile.json5中的obfuscation.consumerFiles字段中配置导出的混淆配置，该配置仅在编译依赖该HAR的模块时生效。D.files：配置待检查的文件名单，如未指定目录，规则适用于所有文件，例如：[“**/*.ets”,”**/*.js”,”**/*.ts”]
HarmonyOS NEXT应用开发之ArkWeb同层渲染
maniuT的博客
03-20 1680
该方案展示了ArkWeb同层渲染：将系统原生组件直接渲染到前端H5页面上，原生组件不仅可以提供H5组件无法实现的一些功能，还能提升用户体验的流畅度。
HarmonyOS Next 使用ArkWeb同层渲染案例_arkweb现在在鸿蒙中还在使用吗(1)
2401_84170623的博客
04-17 445
（**ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony****多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）**技术知识点。// 性能知识点：此处componentId项确定且数量较少，使用了ForEach，在数据量多的情况下，推荐使用LazyForeEach。// 原生Grid组件，Grid中包含Image和Text。
HarmonyOS Next 使用ArkWeb同层渲染案例
shudaoshanQAQ的博客
03-19 964
使用ArkWeb同层渲染案例
Arkts web组件的使用
程序三两行
11-27 1347
访问在线网页时您需要在module.json5文件中申明网络访问权限：ohos.permission.INTERNET。加载网页效果无法在预览器中查看，需要在模拟器或者真机中展示项目。Web组件的使用非常简单，只需要ArkTS文件中创建一个。组件，传入两个参数就可以了。指定引用的网页路径，为组件的控制器，通过。
uniapp实战直播app全栈开发-前端
03-25
在本项目中，我们将深入探讨使用uni-app进行实战直播应用的前端全栈开发。uni-app是一个基于Vue.js的多端开发框架，它允许开发者编写一次代码，就能在iOS、Android、Web（H5）、微信小程序、支付宝小程序、百度小...
wechat-weapp-demo_微信小程序模板js代码前台前端H5页面源码.rar
08-09
"wechat-weapp-demo" 是一个关于微信小程序的示例项目，它包含了一套完整的js代码，用于展示微信小程序的前台前端开发，以及H5页面的源码。这个压缩包的文件列表中只有一个主文件夹 "wechat-weapp-demo"，我们可以从...
原生JS贪吃蛇游戏实战开发
06-10
在本项目中，我们将深入探讨如何使用原生JavaScript来实现一个经典的H5游戏——贪吃蛇。这个项目适合对JavaScript有一定基础，想要提升Web全栈技能的开发者。通过实际操作，我们可以了解到游戏开发的基本原理，以及...
PigRaising-master_微信小程序模板js代码前台前端H5页面源码.rar
08-09
《微信小程序模板js代码前台前端H5页面源码解析》 微信小程序，作为腾讯公司推出的一种轻量级应用开发平台，以其便捷的开发环境、丰富的API接口和良好的用户体验，深受开发者喜爱。本压缩包“PigRaising-master”...
HarmonyOS应用开发者高级认证，Next版本发布后最新题库 - 多选题序号2
Gusha_的博客
07-21 4651
HarmonyOS应用开发者高级认证最新题库，编写于2024年7月19日，Next版本发布之后
小程序组件实现原理（Web Components）
home of 倒不了的dota
06-29 1399
web components很适合小程序组件的开发，Custom elements可以自定义组件，Shadow DOM 作用域内部的元素始终不会影响到它外部的元素，这为封装提供了便利
HarmonyOS NEXT应用开发之ArkWeb同层渲染(1)，HarmonyOS鸿蒙开发网络视频框架
2401_84164672的博客
04-13 1010
columnsGap($r(‘app.string.ohos_id_elements_margin_vertical_m’)) // 列间距。// 性能知识点：此处componentId项确定且数量较少，使用了ForEach，在数据量多的情况下，推荐使用LazyForeEach。r(‘app.string.ohos_id_elements_margin_vertical_m’)) // 行间距。// 根据web传入的embed的id属性作为key，将nodeController存入map。
微信小程序同层渲染原理剖析
moluchujian的博客
06-20 2171
「同层渲染」顾名思义则是指通过一定的技术手段把原生组件直接渲染到 WebView 层级上，此时「原生组件层」已经不存在，原生组件此时已被直接挂载到 WebView 节点上。你几乎可以像使用非原生组件一样去使用「同层渲染」的原生组件，比如使用 view、image 覆盖原生组件、使用 z-index 指定原生组件的层级、把原生组件放置在 scroll-view、swiper、movable-view 等容器内，通过 WXSS 设置原生组件的样式等等。...
【鸿蒙应用ArkTS开发系列】- Web组件使用讲解
枫的专栏
04-11 8502
Web是提供网页显示能力的组件，具体用法请参考Web API。
OpenHarmony/HarmonyOS的ArkUI的类Web范式开发详解
一键难忘的博客
10-02 1706
JS UI框架采用类HTML和CSS Web编程语言作为页面布局和页面样式的开发语言，页面业务逻辑则支持ECMAScript规范的JavaScript语言。5.写一些公共样式，我们到MainAbilty里新建一个common文件夹，然后在下面新建一个css文件夹，作用于存放我们的公共样式。主要运用了web三件套：Html，Css，JavaScript。因为我们需要美化的属于组件，我们直接可以到myinput.css对其进行样式美化。然后在我们的主要的css文件内引用我们的公共样式。
uni-app新特性：小程序组件运行H5，实现代码复用
"uni-app黑魔法：通过支持小程序自定义组件运行到H5平台，实现代码复用，解决跨平台开发难题。" 本文探讨的是在微信小程序快速发展背景下，如何有效地进行代码复用，以减少针对不同平台（如H5、小程序）的重复开发...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值