## 使用场景

ArkWeb（方舟Web）提供了Web组件，用于在应用中显示Web页面内容。常见使用场景包括：

* 应用集成Web页面：应用可以在界面中使用Web组件，嵌入Web页面内容，以降低开发成本，提升开发、运维效率。
* 浏览器网页浏览场景：浏览器类应用可以使用Web组件，打开三方Web网页，使用无痕浏览模式浏览Web页面，设置广告拦截等。
* 小程序：小程序类宿主应用可以使用Web组件，渲染小程序的页面，实现同层渲染，视频托管等小程序的功能。

## 能力范围

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

* Web页面加载：声明式加载Web页面和离屏加载Web页面等。
* 生命周期管理：组件生命周期状态变化，通知Web页面的加载状态变化等。
* 常用属性与事件：[User-Agent开发指导](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/web-default-useragent)、[管理Cookie及数据存储](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/web-cookie-and-data-storage-mgmt)、字体与[Web深色模式适配](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/web-set-dark-mode)、权限管理等。
* 与应用界面交互：自定义文本选择菜单、上下文菜单、文件上传界面等与应用界面交互能力。
* 应用通过JavaScriptProxy，与Web页面进行JavaScript交互。
* 安全与隐私：无痕浏览模式、广告拦截、坚盾守护模式等。
* 维测能力：[DevTools工具](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/web-debugging-with-devtools)调试能力，使用crashpad收集Web组件崩溃信息、定位与解决Web白屏问题、使用Hypium实现ArkWeb自动化测试。
* 其他高阶能力：与系统组件同层渲染、Web组件的网络托管、Web组件的媒体播放托管、Web组件输入框拉起自定义输入法、[网页接入密码保险箱](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkweb-access-password-safe)等。

## 需要权限

使用Web组件访问在线Web网页时需添加网络权限：ohos.permission.INTERNET，具体申请方式请参考[声明权限](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/declare-permissions)。

收起

自动换行

深色代码主题

复制

```
1. "requestPermissions":[
2. {
3. "name" : "ohos.permission.INTERNET"
4. }
5. ]
```

## 约束与限制

* 可依据ArkWeb内核版本在相关网站查询W3C标准的支持情况。例如：<https://developer.mozilla.org/en-US/> 和 <https://webassembly.org/features/> 。
* ArkWeb内核版本：ArkWeb基于谷歌Chromium内核开发，系统版本与Chromium版本的对应关系如表格所示。

  展开

  | 系统版本 | Chromium版本 |
  | --- | --- |
  | HarmonyOS 4.0及之前 | M99 |
  | HarmonyOS 4.1-5.1 | M114 |
  | HarmonyOS 6.0 | M132（默认，推荐使用）  M114（可选，若应用需切换为此内核，请参考[M114内核在HarmonyOS6.0系统上的适配指导](https://gitcode.com/openharmony-tpc/chromium_src/blob/132_trunk/web/ReleaseNote/CompatibleWithLegacyWebEngine.md)） |
* 本Kit支持模拟器，但与真机存在差异，详情请参见“[模拟器与真机的差异](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-emulator-specification)”。
* 为了保护用户的隐私安全，HarmonyOS内置了ArkWeb组件，能够为所有全场景设备的用户提供安全、可靠、一致的网页浏览体验。您的应用如需渲染网页，需使用ArkWeb组件；您的元服务如需渲染内嵌页面，需使用ArkWeb组件，元服务内嵌的网页内容，需遵守元服务内嵌页面管理规范。