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 文档页平台标注为准，本表为快照。

框架

组件

接口