# HarmonyOS 适配指南

基础库从 3.7.0 起正式支持 HarmonyOS 平台，后续与其他平台一致，通过后台灰度更新基础库，开发者工具可在详情 - 本地设置 - 调试基础库切到 3.7.0 及以上版本（推荐最新稳定版）进行开发调试。

# 架构概览

小程序在 HarmonyOS 平台的运行环境与安卓类似，即逻辑层的 JavaScript 代码运行在 v8 中，视图层是基于 HarmonyOS 原生的 ArkWeb 引擎来渲染，而 Skyline 渲染引擎在支持中，暂未提供。

此外，小程序的运行机制、更新机制、组件框架等均保持一致，但在一些特性支持度上会有区别。

# 适配方式

目前小程序在 HarmonyOS 平台与其他平台的区别主要是 HarmonyOS WebView 引擎及涉及原生能力的特性上。

前者在 HarmonyOS 上使用的是 ArkWeb 引擎，可能存在一些依赖 WebView 的特性上的差异，如 CSS 样式相关，这类问题需按实际情况兼容；

后者大多是与组件/接口相关，可通过 wx.canIUse 接口或者通过 platform 判断，对业务逻辑做必要的兼容。

const p = wx.getDeviceInfo().platform
const isHarmonyOS = p === 'ohos' || p === 'ohos_pc'

注意：如在微信开发者工具中模拟鸿蒙，则需判断 wx.getDeviceInfo().system=='HarmonyOS' (工具中 platform 为 devtools)

# 调试方式

• 通过开发者工具调试

1. 下载最新的开发者工具，通过最新开发者工具调试
2. 调试基础库版本选择 3.7.0 及以上（推荐最新稳定版）
3. 选择「小程序模式」，并选择华为鸿蒙机型
4. 支持使用 wx.canIUse 判断接口是否可使用

• 通过真机调试

在 HarmonyOS 的应用商店下载微信，安装后即可正常打开小程序进行调试。

# 支持情况

以下罗列出暂未支持的特性，对使用到未支持的特性需做好兼容。其中组件/接口具体的支持情况可跳转至对应文档查看，以各 API 文档页平台标注为准，本表为快照。

# 框架

# 组件

# 接口