uni-app启动页面配置 alwaysShowBeforeRender 不支持鸿蒙吗

uni-app启动页面配置 alwaysShowBeforeRender 不支持鸿蒙吗

鸿蒙应用启动页和加载的首页中间有一个过渡白屏，alwaysShowBeforeRender 这个属性是不是不支持鸿蒙应用

2 回复

该问题请在专业群（ uni-app鸿蒙化技术交流群 ） 咨询，群中有相关专业的管理员和群友。

是的，alwaysShowBeforeRender 属性在鸿蒙平台上确实不支持。该属性属于 app-plus 配置项（用于传统 Android/iOS App 开发），而根据知识库明确说明：鸿蒙平台不支持 plus API（见 dev-v1 > uni-app 开发鸿蒙应用 > 兼容性说明 和 dev-old 相同条目）。
鸿蒙的启动页机制与 App 平台完全独立：

alwaysShowBeforeRender 是 manifest.json 中 app-plus.splashscreen 的配置项，仅适用于传统 App
鸿蒙使用自己的方舟引擎启动流程，无法识别 app-plus 相关配置
过渡白屏问题正是因鸿蒙忽略此配置导致的默认行为

解决方案：

鸿蒙启动页需在 harmony-configs/ 目录下通过鸿蒙原生配置调整（如 main_pages.json）
参考官方文档 鸿蒙启动页配置
若需高级控制，可尝试用 uts 插件实现自定义逻辑（插件市场搜索 “鸿蒙启动页”）

建议优先查阅鸿蒙平台专属文档，避免混用 App 平台配置。 内容为 AI 生成，仅供参考

更多关于uni-app启动页面配置 alwaysShowBeforeRender 不支持鸿蒙吗的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


alwaysShowBeforeRender 属性在鸿蒙平台确实存在兼容性问题。该属性主要用于控制启动页显示逻辑，但在鸿蒙系统中可能无法完全生效，导致启动页与首页渲染之间出现白屏过渡。

目前针对鸿蒙平台启动页白屏问题，可尝试以下方案：

  1. 检查启动页配置：确保 pages.json 中启动页图片适配鸿蒙的分辨率要求，建议提供多尺寸图片资源。
  2. 使用原生增强：通过 renderjs 或条件编译处理鸿蒙平台的启动逻辑，例如：
// #ifdef HARMONYOS
// 鸿蒙专用启动处理
// #endif
回到顶部