当前位置:首页 > 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 基础介绍 uniapp 是一个基于 Vue.js 的跨平台开发框架,支持一次开发,多端发布(如微信小程序、H5、App、快应用等)。其核心优势在于代码复用率高,学习成本低,适合快速构建多…

uniapp隐藏滚动条

uniapp隐藏滚动条

在UniApp中隐藏滚动条可以通过以下几种方法实现,具体根据使用场景选择: 全局样式设置(APP/H5) 通过修改全局CSS样式隐藏滚动条,适用于所有页面: ::-webkit-scrollbar…

uniapp多环境配置

uniapp多环境配置

多环境配置的必要性 在UniApp开发中,多环境配置能有效区分开发、测试、生产等不同环境的API地址、密钥等参数,避免手动修改代码导致的错误。 创建环境配置文件 在项目根目录下创建env.js或c…

uniapp组件

uniapp组件

uniapp组件基础概念 uniapp的组件系统基于Vue.js,支持跨平台开发(H5、小程序、App等)。组件分为内置基础组件(如<view>、<button>)和自定义组件…

uniapp前端项目

uniapp前端项目

Uniapp 前端项目开发指南 Uniapp 是一个基于 Vue.js 的跨平台开发框架,支持一次开发,多端发布(如微信小程序、H5、App 等)。以下是关于 Uniapp 前端项目的关键信息: 环…

uniapp设置title

uniapp设置title

设置页面标题的方法 在UniApp中设置页面标题可以通过以下几种方式实现,适用于不同场景和需求。 通过pages.json配置 在pages.json文件中,可以为每个页面单独配置导航栏标题。找到对…