当前位置:首页 > uni-app

uniapp 启动画面

2026-02-06 13:04:22uni-app

设置 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 目录下的启动图片。需根据平台要求准备不同分辨率的图片:

  1. Android: 替换 static/android/splash 中的图片(需多套分辨率)。
  2. iOS: 替换 static/ios/splash 中的图片(需适配不同设备尺寸)。

推荐图片规范

uniapp 启动画面

  • 格式:.png.jpg
  • 尺寸:参考各平台官方文档(如 iOS 需提供 @2x@3x 版本)。

动态关闭启动画面

通过 API 控制关闭
App.vueonLaunch 生命周期中调用 plus.navigator.closeSplashscreen() 手动关闭:

onLaunch: function() {
  setTimeout(() => {
    if (plus && plus.navigator) {
      plus.navigator.closeSplashscreen();
    }
  }, 2000); // 延迟 2 秒关闭
}

适用于需要等待某些初始化操作完成后再关闭的场景。

uniapp 启动画面

注意事项

  1. 平台差异

    • iOS 可能对图片尺寸有严格限制,需确保符合苹果的 Human Interface Guidelines。
    • Android 需注意不同分辨率设备的适配问题。
  2. 调试技巧

    • 使用真机调试启动画面,模拟器可能无法完全还原效果。
    • 通过 console.log 检查 plus 对象是否可用,避免 API 调用失败。
  3. 版本兼容

    • Uniapp 2.7.0+ 版本对启动画面配置有优化,建议保持最新稳定版。

标签: 画面uniapp
分享给朋友:

相关文章

uniapp模板库

uniapp模板库

uniapp模板库推荐 官方模板库 uni-app官方提供多个模板,涵盖电商、社交、新闻等多个领域。这些模板可直接在HBuilderX中通过新建项目选择,包含基础结构和常用功能模块,适合快速启动项目。…

uniapp关闭侧滑

uniapp关闭侧滑

禁用全局侧滑返回功能 在pages.json中配置全局禁止侧滑返回: { "globalStyle": { "popGesture": "none" } } 禁用单个页面侧滑返回 在…

uniapp特性

uniapp特性

uniapp的核心特性 跨平台开发 uniapp支持一套代码编译到多个平台,包括iOS、Android、H5、微信小程序、支付宝小程序、百度小程序、字节跳动小程序等。开发者无需为不同平台单独编写代码。…

uniapp悬浮

uniapp悬浮

实现悬浮效果的方法 在UniApp中实现悬浮效果可以通过CSS的position: fixed或position: sticky属性结合动态样式控制来实现。以下是具体实现方式: 使用CSS固定定位…

uniapp接入

uniapp接入

接入UniApp的基本流程 UniApp是一个基于Vue.js的跨平台开发框架,支持一次开发,多端发布。以下是接入UniApp的基本流程: 环境准备 确保已安装Node.js(建议版本12+)和HB…

uniapp $on

uniapp $on

uniapp $on 方法详解 $on 是 UniApp 中用于监听全局事件的 API,常用于跨页面或跨组件通信。它基于 Vue 的事件机制,允许在全局范围内触发和监听自定义事件。 基本语法…