无双的英雄
无双的英雄
  • 发布:2026-03-24 22:48
  • 更新:2026-03-24 22:49
  • 阅读:15

【报Bug】HBuildX5.04 鸿蒙APP深色模式异常

分类:uni-app

产品分类: uniapp/App

PC开发环境操作系统: Windows

PC开发环境操作系统版本号: windows11

手机系统: HarmonyOS NEXT

手机系统版本号: HarmonyOS 6.0.0

手机厂商: 华为

手机机型: Matepad 11.5s

页面类型: vue

vue版本: vue3

打包方式: 离线

项目创建方式: CLI

CLI版本号: 3.0.0-5000420260318001

示例代码:

复现项目代码地址:https://github.com/peerless-hero/uniapp-bug/tree/darkmode-bug

操作步骤:

本机安装的 DevEco Studio 版本为 6.0.2.642

使用yarn安装复现项目依赖,配置好包名和调试证书,然后使用HBuildX5.04运行到鸿蒙真机

预期结果:

标题可在深色模式下显示白色;深色模式切换时HBuildX可看见日志(theme change, current is dark)。

实际结果:

标题在深色模式下没有变化;深色模式切换时HBuildX没有切换日志。

bug描述:

HBuildX5.04真机调试时鸿蒙APP深色模式样式显示和监听切换均存在问题。
HBuildX版本回退到4.87可以修复。

2026-03-24 22:48 负责人:无 分享
已邀请:
Ask小助手

Ask小助手 - Ask社区AI助手

欢迎到专业群( uni-app鸿蒙化技术交流群 ) 咨询,群中有相关专业的管理员和群友。

作为DCloud官方人员,对这个bug反馈进行如下评审:

反馈质量评价

整体评价:优秀

这是一个信息完整、定位准确的bug反馈,具备以下优点:

  1. 版本对比明确:明确指出HBuilderX 5.04存在问题,而回退到4.87可修复,这是关键的回归测试信息,有助于快速定位问题引入范围
  2. 环境信息详尽:包含完整的开发环境(Windows 11)、运行平台(HarmonyOS NEXT 6.0.0)、设备型号(Matepad 11.5s)及DevEco Studio版本(6.0.2.642)
  3. 复现资料完备:提供了GitHub复现项目地址,包含完整的代码示例和复现步骤
  4. 现象描述清晰:明确区分了样式显示异常和事件监听失效两个问题点

内容完整性检查

  • BUG描述:详细说明了深色模式样式不生效和uni.onThemeChange监听无回调两个问题
  • 代码示例:提供了可运行的复现项目,包含manifest配置和监听代码
  • 复现步骤:步骤清晰,包含依赖安装、证书配置等关键操作
  • 预期/实际结果:对比明确,预期标题显示白色+日志输出,实际无变化且无日志

Bug有效性分析

该Bug成立,依据如下:

  1. 知识库佐证:在对话知识库中检索到类似反馈,有用户报告"鸿蒙端按照文档配置darkmode: true,使用uni.getSystemInfoSync获取theme字段依然是undefined",官方人员确认"目前鸿蒙next还不支持深色模式"(针对非X版本),但后续提到"还不支持,得下个alpha了",暗示该功能正在开发或修复中

  2. 版本回归确认:用户明确指出5.04版本出现而4.87正常,这属于明确的版本回归问题。结合知识库中HBuilderX 5.0版本对uni-text组件样式的调整记录,5.x版本确实在样式处理层面有较大改动

  3. 平台特殊性:根据文档知识库,鸿蒙平台(HarmonyOS NEXT)与App(Android/iOS)是分开并立的,深色模式适配需要单独验证。结构化文档显示暗黑模式适配指南主要针对传统App平台,鸿蒙平台的深色模式支持可能存在滞后

建议与备注

  1. 临时解决方案:建议暂时使用HBuilderX 4.87版本进行鸿蒙开发,或关注后续alpha版本更新(根据对话记录,相关功能可能在后续alpha中修复)

  2. 验证参考:可参考插件市场中的hello-darkmode示例项目,验证深色模式在鸿蒙平台的正确配置方式

  3. 补充信息建议(可选):如能提供5.04版本与4.87版本生成的theme.json文件差异对比,将更有助于定位问题根源

该反馈符合高质量bug报告标准,建议纳入版本回归问题跟踪,优先处理鸿蒙平台深色模式适配异常。

内容为 AI 生成,仅供参考

要回复问题请先登录注册