当前位置:首页 > 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 常用样式库推荐 uView UI uView 是专为 uniapp 设计的多端兼容 UI 框架,提供丰富的组件和工具类。支持 Vue3 组合式 API,内置主题定制功能,常用于快速构建企…

uniapp组件

uniapp组件

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

uniapp yuv

uniapp yuv

YUV 格式在 UniApp 中的应用 在 UniApp 中处理 YUV 格式数据通常涉及视频编解码、图像处理或摄像头数据采集。YUV 是一种颜色编码系统,常用于视频传输和图像处理,与 RGB 格式相…

uniapp $on

uniapp $on

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

uniapp 头条

uniapp 头条

uniapp 适配今日头条(字节跳动小程序)的方法 环境配置 确保HBuilderX版本在2.7.0以上,manifest.json中勾选"字节跳动小程序"平台。在开发者工具中配置正确的AppID和项…

uniapp关闭广告

uniapp关闭广告

关闭广告的方法 在UniApp中关闭广告通常涉及以下几个方法,具体操作取决于广告的类型和集成方式。 移除广告模块 检查项目中是否集成了广告SDK或相关组件,如ad、ad-draw等。在pages.j…