ArkWeb简介

使用场景

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

  • 应用集成Web页面:应用可以在界面中使用Web组件,嵌入Web页面内容,以降低开发成本,提升开发、运维效率。

  • 浏览器网页浏览场景:浏览器类应用可以使用Web组件,打开三方Web网页,使用无痕浏览模式浏览Web页面,设置广告拦截等。

  • 小程序:小程序类宿主应用可以使用Web组件,渲染小程序的页面,实现同层渲染,视频托管等小程序的功能。

能力范围

Web组件为开发者提供了丰富的控制Web页面能力。包括:

  • Web页面加载:声明式加载Web页面和离屏加载Web页面等。

  • 生命周期管理:组件生命周期状态变化,通知Web页面的加载状态变化等。

  • 常用属性与事件:User-Agent开发指导管理Cookie及数据存储、字体与Web深色模式适配、权限管理等。

  • 与应用界面交互:自定义文本选择菜单、上下文菜单、文件上传界面等与应用界面交互能力。

  • 应用通过JavaScriptProxy,与Web页面进行JavaScript交互。

  • 安全与隐私:无痕浏览模式、广告拦截、坚盾守护模式等。

  • 维测能力:DevTools工具调试能力,使用crashpad收集Web组件崩溃信息、定位与解决Web白屏问题。

  • 其他高阶能力:与系统组件同层渲染、Web组件的网络托管、Web组件的媒体播放托管、Web组件输入框拉起自定义输入法等。

需要权限

使用Web组件访问在线Web网页时需添加网络权限:ohos.permission.INTERNET,具体申请方式请参考声明权限

"requestPermissions":[
    {
      "name" : "ohos.permission.INTERNET"
    }
  ]

约束与限制

相关实例

针对Web组件开发,有以下相关实例可供参考: