uniapp 启动画面
设置 Uniapp 启动画面
在 Uniapp 中配置启动画面主要通过修改 manifest.json 文件实现。以下为具体方法:
修改 manifest.json
打开项目根目录下的 manifest.json 文件,找到 app-plus 或 mp-weixin 等平台相关配置节点。添加或修改以下配置:
"app-plus": {
"splashscreen": {
"autoclose": true,
"waiting": true,
"delay": 0
}
}
autoclose: 是否自动关闭启动页(默认true)waiting: 是否显示等待雪花动画delay: 延迟关闭时间(毫秒)
自定义启动图路径
在 manifest.json 中指定不同平台的启动图路径:
"app-plus": {
"splashscreen": {
"android": "@drawable/splash",
"ios": "@drawable/splash"
}
}
需将图片放入对应平台的资源目录(如 nativeResources 文件夹)。

平台差异处理
微信小程序
在 mp-weixin 节点下配置:
"mp-weixin": {
"appid": "",
"lazyCodeLoading": "requiredComponents",
"usingComponents": true,
"window": {
"backgroundTextStyle": "light",
"navigationBarBackgroundColor": "#fff",
"navigationBarTitleText": "WeChat",
"navigationBarTextStyle": "black"
}
}
微信小程序的启动图需通过微信开发者工具单独上传。
H5 平台 H5 无原生启动画面,可通过以下方式模拟:

- 在
index.html中添加自定义加载动画 - 使用 CSS 或 JavaScript 控制显示/隐藏
高级配置技巧
延迟关闭启动页
通过 plus.navigator.closeSplashscreen() 手动控制关闭时机:
setTimeout(() => {
plus.navigator.closeSplashscreen();
}, 3000);
动态修改启动图 通过 Native.js 调用原生接口实现运行时更换启动图(仅 App 端可用):
const bitmap = new plus.nativeObj.Bitmap();
bitmap.load('/static/new_splash.png', () => {
plus.navigator.setSplashscreen(bitmap);
});
注意事项
- iOS 启动图必须包含状态栏区域(推荐 1242x2688)
- Android 9+ 需要适配刘海屏
- 图片格式建议使用 PNG 以保证透明度支持






