目录

H5适配HarmonyOS开发指导

问题现象

其他端已经有完整H5页面代码,如何适配到HarmonyOS应用中?

背景知识

ArkWeb:提供了Web组件,用于在应用程序中显示Web页面内容。常见使用场景包括:

解决方案

快速适配流程图如下:

  1. 创建Web组件加载:
    • 页面加载是Web组件的基本功能。根据页面加载数据来源可以分为三种常用场景,包括加载网络页面、加载本地页面、加载HTML格式的富文本数据。详情请参考:使用Web组件加载页面。
    • 加载在线网页时需要在module.json5中配置ohos.permission.INTERNET网络访问权限。具体配置方式请参考:声明权限。
    • 创建Web组件时,可通过提供的生命周期回调接口,用于感知状态变化和处理业务。如onPageBegin回调,网页开始加载时触发该回调等。详情请参考:Web组件的生命周期。
    • 创建Web组件时需要配置属性,某些属性是默认关闭的,开启后才能使用对应的功能。如fileAccess,开启后才能访问文件系统。详情请参考:Web的属性。
  2. 设置User-Agent :

    其他端使用User-Agent(简称UA)字符串识别请求的来源设备及其特性,从而根据这些信息提供定制化的内容和服务时,需要给HarmonyOS端通过setCustomUserAgent()方法设置HarmonyOS字段,并通过该字段进行HarmonyOS适配。根据业务选择性设置,详情请参考:User-Agent开发指导。

  1. 设置允许本地资源跨域:

    在使用Web组件加载本地离线资源的时候,Web组件会拦截file协议和resource协议的跨域访问。可以通过设置一个路径列表,再使用file协议访问该路径列表中的资源,允许跨域访问本地文件。根据业务选择性设置,详情请参考:解决Web组件本地资源跨域问题。

  2. HarmonyOS与前端页面交互: