# 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白屏问题、使用Hypium实现ArkWeb自动化测试。
    
*   其他高阶能力：与系统组件同层渲染、Web组件的网络托管、Web组件的媒体播放托管、Web组件输入框拉起自定义输入法、网页接入密码保险箱等。
    

#### 需要权限

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

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

#### 约束与限制

*   可依据ArkWeb内核版本在相关网站查询W3C标准的支持情况。例如： 和  。
    
*   ArkWeb内核版本：ArkWeb基于谷歌Chromium内核开发，系统版本与Chromium版本的对应关系如表格所示。
    
    | 系统版本 | Chromium版本 |
    | --- | --- |
    | HarmonyOS 4.0及之前 | M99 |
    | HarmonyOS 4.1-5.1 | M114 |
    | HarmonyOS 6.0 | M132（默认，推荐使用，请参考M114->M132差异适配指南） M114（可选，若应用需切换为此内核，请参考M114内核在HarmonyOS 6.0系统上的适配指导） |
    | HarmonyOS 6.1 | M132 |
    | HarmonyOS 7.0 | M144（默认，推荐使用，请参考M132->M144差异适配指南） M132（可选，若应用需切换为此内核，请参考M132内核在HarmonyOS 7.0系统上的适配指导） |
    
*   为保障用户隐私安全，HarmonyOS内置了ArkWeb组件，旨在为全场景设备提供安全、可靠且一致的网页浏览体验。应用渲染网页需调用ArkWeb组件；元服务内嵌网页渲染则需使用官方提供的Webview组件。开发者可根据其元服务开发框架，选择使用ASCF Webview或AtomicServiceEnhancedWeb组件。元服务内嵌页面内容需遵循元服务内嵌页面管理规范。
    

#### 模拟器支持情况

*   本Kit支持模拟器。模拟器与真机存在通用差异，详情请参见“模拟器与真机的差异”。