讲师中心 微信公众号
AI工具推荐 视频效率加速

uni-app如何关闭各端自动生成的引导页

夏敏小哥_8698

夏敏小哥_8698

发布时间:2026-09-08 07:13:29

|

856人浏览过

|

来源于php中文网

原创

uni-app无自动生成引导页,所谓“引导页”均为开发者手动编写的Vue页面(如pages/guide/guide.vue),原生splash仅为静态图/视频,不可交互;关闭分两类:跳过Vue引导页需用uni.getStorageSync('launchFlag')===true判断并立即跳转,同时设为true标记;禁用原生splash需配置manifest.json中autoclose:false并手动调用plus.navigator.closeSplashscreen()。

uni-app如何关闭各端自动生成的引导页

uni-app 没有“自动生成的引导页”,只有原生 splash 和你手动写的 Vue 引导页

很多人搜“uni-app 关闭引导页”,其实是被误导了——uni-app 本身不提供、也不自动生成任何可交互的引导页。所谓“引导页”全是开发者自己用 Vue 页面写的(比如 pages/guide/guide.vue),而系统级出现的,只有原生 splash 图(静态图/视频),它由 manifest.jsonpages.json 配置控制,不能执行 JS、不能跳转、不能判断逻辑。

所以“关闭引导页”实际分两类:

  • 关掉你写的 Vue 引导页(靠缓存标记 + 跳转)
  • 关掉原生 splash(靠配置 + 手动调用 plus.navigator.closeSplashscreen()

怎么让首次启动直接跳过 Vue 引导页

核心是用 uni.getStorageSync('launchFlag') === true 做判断,且必须在引导页的 onLoad 里立刻执行跳转,不能等异步回调。

uni-app
uni-app

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

下载
  • 别用 uni.getStorage(异步),否则页面白屏或闪退
  • 标记值必须是布尔 true,不是字符串 "true" 或数字 1,否则首次进引导页后,下次仍会进
  • 跳转后必须立刻 uni.setStorageSync('launchFlag', true),否则每次冷启都重进
  • 引导页要设为 pages.json 中第一个页面路径,否则 splash 关闭后可能先闪首页再跳引导页

怎么彻底禁用原生 splash(App 端)

如果你根本不想显示任何启动图,不是“跳过”,而是“压根不要”,就得从打包配置入手:

  • 删掉 static/splash.png(iOS/Android 默认 splash 图)
  • manifest.json → App 启动界面配置 → 取消勾选“启用启动界面”
  • 离线打包时,manifest.json 的配置可能不生效,需额外检查 nativePlugins 是否注入了 splash 插件(如 uni-splash-screen),有就删掉
  • 云打包下,“是否显示等待雪花”勾选项必须关掉,否则即使没图也会显示加载动画

为什么 plus.navigator.closeSplashscreen() 有时无效

这个 API 只在 App 端有效,且受两个硬性限制:

  • autoclose 必须设为 false,否则引擎自动关 splash,你调用也白搭;修改位置在 manifest.jsonapp-plus.splashscreen.autoclose
  • 调用时机不能晚于 6 秒,超时后引擎强制关闭,且此时页面可能还没 mount,plus 对象还不可用
  • H5、小程序端无 plus 对象,直接报 plus is not defined,必须加运行环境判断:if (uni.getSystemInfoSync().platform === 'app')
  • 某些 Android 厂商 ROM(如华为 EMUI)会拦截 splash 关闭,需配合 alwaysShowBeforeRender: false 使用

最易忽略的一点:splash 和 Vue 页面之间的空档期无法完全消除,哪怕你立刻调用 closeSplashscreen,首帧渲染慢的设备仍会闪白屏——这时首帧图和 splash 图必须像素级一致,否则“无缝”就是空谈。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

相关专题

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

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

2063

2023.08.11

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

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

4403

2023.10.09

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

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

5510

2024.03.19

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

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

4958

2024.03.22

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

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

703

2024.05.22

Conan创建软件包配方指南
Conan创建软件包配方指南

本专题介绍通过conanfile.py创建软件包的方法,讲解包名、版本、依赖和构建设置等基础信息,以及source、build、package、package_info等常用方法的作用及编写思路。

0

2026.09.22

Conan二进制包配置指南
Conan二进制包配置指南

本专题介绍Conan根据操作系统、编译器、架构和构建类型生成二进制包的方法,讲解Profile、Settings、Options及Package ID的作用,帮助管理不同平台和编译环境下的包版本。

0

2026.09.22

Conan私有仓库搭建教程
Conan私有仓库搭建教程

本专题系统的讲解Conan私有仓库的搭建流程,涵盖仓库服务部署、存储目录配置、用户认证、权限划分和远程地址添加,并介绍内部C++依赖包的上传、下载及版本维护方法。

0

2026.09.22

loomy官网入口地址合集
loomy官网入口地址合集

本专题汇总了 Loomy 桌面 AI 助理的官方入口地址合集及使用指南。提供 macOS 与 Windows 客户端下载 。Loomy 是讯飞推出的桌面级 AI 工作搭子,支持文件整理、数据分析、网页操作及通过飞书/钉钉远程操控电脑,助你高效完成本地办公任务 。

0

2026.09.22

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习

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

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn