uni-app如何设置自定义的App启动逻辑-uni-app-PHP中文网

uni-app启动页不生效的主因是manifest.json中splashscreen未置于app-plus节点下；必须严格配置在app-plus内、大小写敏感、路径为static/相对路径，且iOS须用Storyboard而非纯图片。

uni-app如何设置自定义的app启动逻辑

启动页不生效？先确认 manifest.json 的 splashscreen 是否在 app-plus 下

90% 的“自定义启动页不显示”问题，根源是 splashscreen 字段写错了位置。它必须严格放在 manifest.json 的 app-plus 节点内，不能在根节点、h5 或 mp-weixin 下。大小写也敏感：splashscreen 不是 splashScreen。

正确结构示例：

"app-plus": {
  "splashscreen": {
    "alwaysShowBeforeRender": true,
    "autoclose": false,
    "waiting": true,
    "android": {
      "image": "static/splash/android.png"
    },
    "ios": {
      "image": "static/splash/ios.png"
    }
  }
}

alwaysShowBeforeRender: true 表示首页渲染完成前，启动页不会关闭；设为 false 则首页一加载完就关（易白屏）
autoclose: false 是手动控制的前提，否则 plus.navigator.closeSplashscreen() 无效
路径必须是 static/ 开头的相对路径，如 "static/splash/android.png"，不能带 / 或 ./
iOS 真机和 App Store 审核要求使用 LaunchScreen.storyboard，纯 image 配置仅限调试，上线必换

想等接口返回再关启动页？别在 onLaunch 里调 closeSplashscreen

首页 onLoad 或 onShow 中调用 plus.navigator.closeSplashscreen() 才可靠。在 App.vue 的 onLaunch 里调，大概率失败——此时页面栈未就绪，plus 对象可能未初始化。

uni-app

uni-app 是基于 Vue 的跨端开发框架，适合开发 H5、App、小程序、鸿蒙和多端业务应用。

下载

必须确保 manifest.json 中 splashscreen.autoclose 和 alwaysShowBeforeRender 都为 false，否则引擎会抢在你之前关掉
关闭时机建议放在 API 成功回调里，比如 uni.request({ success: () => plus.navigator.closeSplashscreen() })
加超时兜底：6 秒后强制关闭，避免用户卡在启动页（setTimeout(() => plus.navigator.closeSplashscreen(), 6000)）
H5 平台不支持 plus.navigator，需条件编译：#ifdef APP-PLUS

iOS 启动页必须用 Storyboard，不是配个图就能过审

从 iOS 13 起，App Store 强制要求 Launch Screen 使用 LaunchScreen.storyboard，只填 splashscreen.ios.image 在真机上可能显示，但提交审核 100% 被拒。这不是 uni-app 的 bug，是苹果系统策略。

uni-app 官方提供 Windows 可用的 LaunchScreen.storyboard 模板（无需 Mac/Xcode），下载解压后放入 unpackage/res/ios/
背景图命名必须规范：dc_launchscreen_portrait_background@2x.png、@3x.png，尺寸按 iPhone X（1125×2436）设计
storyboard 文件里可配置背景色、中间 logo、底部文字，全部通过 XML 修改，HBuilderX 可直接编辑
鸿蒙平台复用 Android 配置字段，不用单独填 harmony 节点