收藏
评论

小程序 HarmonyOS 适配提醒官方

小程序基础库从 3.7.0 起正式支持 HarmonyOS 平台,开发者可在小程序发布前针对以下几项进行开发调试让小程序在 HarmonyOS 也获得最佳体验:

 

1、区分 platform 进行定制体验

鸿蒙系统作为新的 OS,小程序实际运行体验可能跟 Android、iOS 和 Windows 有不一致。

为获得最佳用户体验,建议通过以下方式来判断是否为鸿蒙系统进行定制的逻辑处理。


 wx.getDeviceInfo().platform === 'ohos'  // 判断纯血鸿蒙


getDeviceInfo 接口返回示例如下:

{
    "platform": "ohos"
    "brand": "HUAWEI",
    "system": "OpenHarmonyOS 5.0.1"
    ...
 }


接口详情请参考:Object wx.getDeviceInfo() 


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


2、区分 UserAgent 进行定制体验

因鸿蒙系统内浏览器 UserAgent 特征和 iOS、Android 不同,可能会导致微信内网页应用出现功能异常。为获得最佳用户体验,可通过获取navigator.userAgent 中是否包含 'OpenHarmony' 来判断是否为鸿蒙系统。


if(navigator.userAgent.includes('OpenHarmony')){
    console.log('需要适配纯血鸿蒙')
}


注:OpenHarmony 的判断应放在 iOS 和 Android 之前

 

3、避免 UI 元素重叠问题

部分小程序未对鸿蒙系统的状态栏,导航条等避让区做适配处理,导致界面存在重叠、无法点击等情况。为获得最佳用户体验,建议小程序做 UI 元素避让处理。

 

更多 HarmonyOS 适配方面的信息,可查看 HarmonyOS 适配指南


78376浏览
最后一次编辑于  2025-11-11
知识库内容非实时更新,可能已过期、失效或不适用于当前情形,请谨慎参考
收藏
反馈

16 个评论

  • 🔅晨雨ღ
    🔅晨雨ღ
    2025-12-23

    怎么关掉这个警告提醒?烦死了

    2025-12-23
    赞同 28
    回复 7
    • 曾辉文18750079781
      曾辉文18750079781
      01-07
      不懂如何消除
      01-07
      6
      回复
    • 布叮
      布叮
      01-14
      我也想问,,怎么关掉这个东西,好烦这个
      01-14
      回复
    • Ace
      Ace
      01-15
      开发时把基础库版本调整到大于3.7.0就没有了
      01-15
      1
      回复
    • 小马快飞航空
      小马快飞航空
      01-26回复Ace
      没用
      01-26
      回复
    • 段成林
      段成林
      01-31
      如何测试 HarmonyOS 适配:

      在微信开发者工具中,点击顶部菜单 -详情-→-本地设置-
      在调试基础库中选择 3.7.0 或以上版本
      在模拟器中不支持HarmonyOS 模式调试,所以就会提示
      结论: 这个警告可以忽略,因为我们已经完成了必要的适配工作。当用户在 HarmonyOS 设备上使用小程序时,代码会自动识别并进行相应的兼容处理。
      01-31
      3
      回复
    查看更多(2)
  • 🐒正吧
    🐒正吧
    2025-12-26

    小程序先做好区分qq和微信平台吧。活爹。

    2025-12-26
    赞同 11
    回复 1
    • huper
      huper
      01-12
      还有各个版本的企业微信客户端
      01-12
      1
      回复
  • sunflower
    sunflower
    01-04

    什么时候支持鸿蒙设备的真机调试

    01-04
    赞同 6
    回复
  • 难度的牢笼
    难度的牢笼
    2025-12-16

    感觉很敷衍啊


    2025-12-16
    赞同 3
    回复
  • 横亘柚
    横亘柚
    01-12

    出现的问题修改了还是没啥变化呀,是不是小程序版本选错了?

    01-12
    赞同 1
    回复
  • 欢乐马
    欢乐马
    2025-12-17

    重点:不支持 ad/ad-custom。

    2025-12-17
    赞同 1
    回复
  • kkk
    kkk
    星期五 09:16

    if (wx.getDeviceInfo().system === 'HarmonyOS') {

    wx.showModal({

    title: '提示',

    content: '暂不支持鸿蒙系统',

    showCancel: false, // 隐藏取消按钮,使其更像 alert

    confirmText: '我知道了',

    success(res) {

    if (res.confirm) {

    // 用户点击确定后的操作

    }

    }

    });

    }

    星期五 09:16
    赞同
    回复
  • 炎圭子
    炎圭子
    03-31

    sdfg dd dffgfffffffffffffffffff 1212222222222222222222https:/包邮到家这个柔肤仪

    03-31
    赞同
    回复
  • Puinn
    Puinn
    03-28

    什么时候解决鸿蒙不能录音的问题

    03-28
    赞同
    回复
  • ANYSYS
    ANYSYS
    02-26

    大神们,小程序中腾讯地图(鸿蒙)不支持GIF动画怎么搞?

    02-26
    赞同
    回复 1
    • 曾华勇
      曾华勇
      03-10
      这个应该问HW吧。
      03-10
      回复

正在加载...

登录 后发表内容