uni-app怎么取消默认的启动页图片(Splash屏)

阿雪酱_1246

阿雪酱_1246

2026-08-12

412人浏览

原创

删掉 static/splash.png 可取消云打包默认启动页,但离线打包需修改原生工程资源或配置;云打包下删除后需清缓存并上传,且 manifest.json 中 imagepath 需清空;离线打包需分别处理 android 和 ios 原生资源与配置。

uni-app怎么取消默认的启动页图片(splash屏)

直接删掉 static/splash.png 就能取消默认启动页图片,但仅对云打包生效;离线打包必须改原生工程资源或配置。

云打包下删图就完事

UniApp 云打包时,启动页逻辑会主动查找 static/splash.png。如果文件不存在,就不会显示任何启动图(也不会 fallback 到黑屏或白屏,前提是其他配置合理)。

  • 确认项目根目录下没有 static/splash.png —— 直接删除即可
  • 删完后务必清缓存、重新上传云端打包,否则 HBuilderX 可能读取旧缓存
  • 删图后若仍看到启动图,说明 manifest.json 里显式指定了 imagePath,需一并清空该字段或设为 ""

离线打包必须动原生工程

云打包的配置在离线打包中基本失效。Android 和 iOS 各有一套原生机制,manifest.jsonsplashscreen 配置不起作用。

uni-app
uni-app

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

下载
  • Android:进入 native/android/app/src/main/res/,删掉所有 drawable-*/ic_splash.* 或类似命名的启动图资源(常见于 drawable-v21drawable-v31
  • iOS:打开 native/ios/Podfile 所在工程,在 Xcode 中找到 LaunchScreen.storyboard,删掉其中的 UIImageView,或将其 Image 属性清空,并确保背景色设为纯色(如 #FFFFFF
  • 改完必须用 Xcode / Android Studio 重新编译原生工程,不能只靠 HBuilderX “运行到手机”

manifest.json 配置别乱设 delay

splashscreen.delay 在 HBuilderX ≥4.20 版本已废弃,写了也无效。真正影响启动图行为的是这三个布尔值:

  • autoclose: false —— 必须关掉,否则系统会在首页 JS 渲染完成瞬间强制关闭,你根本来不及控制
  • alwaysShowBeforeRender: false —— 关掉可避免首页白屏闪一下才出内容
  • waiting: false —— 关掉雪花图标,但仅对云打包和部分离线场景有效,iOS 原生层的转圈无法靠它消除

App.vue 里手动关 splash 的时机很关键

即使你删了图、关了 waiting,某些设备(尤其 iOS)仍可能短暂闪一下黑屏或白屏——这是因为原生启动图退场和 Vue 首屏渲染存在竞态。

  • 必须在 onLaunch 里用 setTimeout 调用 plus.navigator.closeSplashscreen()
  • 时间建议 1500–3000ms:太短用户感觉“没过渡”,太长 iOS 会在 6000ms 强制关且不触发你的回调
  • 别写在 onShow 或页面生命周期里——那时 splash 早被系统回收了,调用无效

最麻烦的其实是 Android 12+ 的 SplashScreen API,它完全绕过 uni-app 控制,哪怕你删光所有图、关掉所有配置,系统仍可能显示带图标缩放的默认动画。这时候只能进 android/app/src/main/res/values/themes.xmlandroid:windowSplashScreenBackgroundandroid:windowSplashScreenAnimatedIcon —— 这已经不是 uni-app 层面能解决的事了。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

uni-app配置 uni-app

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2043

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

4343

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

5470

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

4918

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

683

5

NumPy性能优化版本更新与常见报错排查
NumPy性能优化版本更新与常见报错排查

本专题整理 NumPy 性能优化、版本更新与常见报错排查相关教程,覆盖向量化计算、广播性能、内存布局、NumPy 2.0 升级、版本兼容冲突、安装导入报错、dtype 溢出、矩阵运算异常和 broadcasting 报错修复,帮助读者系统掌握 NumPy 性能调优与问题定位方法。

2026.09.22

0

25

Vibeknow在线使用入口合集
Vibeknow在线使用入口合集

本专题汇总了Vibeknow在线创作视频的官方入口及网页版使用教程,涵盖PPT、PDF、Word等文档一键转讲解视频的核心操作,并整理了免费版水印规则与手机端浏览器访问指南,助你快速将知识内容视频化。

2026.09.21

20

20

NumPy随机数文件读写与dtype数据类型
NumPy随机数文件读写与dtype数据类型

本专题整理 NumPy 随机数、文件读写与 dtype 数据类型相关教程,覆盖 Generator/random、随机数种子、正态分布采样、npy/npz/CSV/TXT 保存读取、loadtxt/savetxt、memmap、大文件处理、astype 类型转换、结构化 dtype、整数溢出和精度丢失等场景。

2026.09.21

20

24

NumPy矩阵运算与线性代数计算
NumPy矩阵运算与线性代数计算

本专题整理 NumPy 矩阵运算与线性代数计算相关教程,覆盖矩阵乘法、dot 与 @ 运算符、逆矩阵、行列式、特征值与特征向量、SVD、线性方程组、欧氏距离、矩阵分解和大规模矩阵性能优化等内容,帮助读者掌握 np.linalg 与矩阵计算实战。

2026.09.21

0

20

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app从入门到实战教程
uni-app从入门到实战教程

共0课时 | 0人学习

uni-app x harmony开发指南
uni-app x harmony开发指南

共0课时 | 0人学习

uni-app鸿蒙运行和发行
uni-app鸿蒙运行和发行

共0课时 | 0人学习