uniapp 启动画面
设置 Uniapp 启动画面
修改 manifest.json 文件
在项目的 manifest.json 文件中配置启动画面参数。找到 app-plus 节点下的 splashscreen 配置项,添加以下内容:
"app-plus": {
"splashscreen": {
"autoclose": true,
"waiting": true,
"delay": 0
}
}
autoclose: 是否自动关闭启动画面(true为自动关闭)。waiting: 是否显示等待界面(通常设为true)。delay: 启动画面延迟关闭时间(毫秒,0表示不延迟)。
自定义启动图片
替换默认图片
Uniapp 默认使用 static 目录下的启动图片。需根据平台要求准备不同分辨率的图片:
- Android: 替换
static/android/splash中的图片(需多套分辨率)。 - iOS: 替换
static/ios/splash中的图片(需适配不同设备尺寸)。
推荐图片规范

- 格式:
.png或.jpg。 - 尺寸:参考各平台官方文档(如 iOS 需提供
@2x和@3x版本)。
动态关闭启动画面
通过 API 控制关闭
在 App.vue 的 onLaunch 生命周期中调用 plus.navigator.closeSplashscreen() 手动关闭:
onLaunch: function() {
setTimeout(() => {
if (plus && plus.navigator) {
plus.navigator.closeSplashscreen();
}
}, 2000); // 延迟 2 秒关闭
}
适用于需要等待某些初始化操作完成后再关闭的场景。

注意事项
-
平台差异
- iOS 可能对图片尺寸有严格限制,需确保符合苹果的 Human Interface Guidelines。
- Android 需注意不同分辨率设备的适配问题。
-
调试技巧
- 使用真机调试启动画面,模拟器可能无法完全还原效果。
- 通过
console.log检查plus对象是否可用,避免 API 调用失败。
-
版本兼容
- Uniapp 2.7.0+ 版本对启动画面配置有优化,建议保持最新稳定版。






