Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-uni-app-x-zh
提交
5e90f551
U
unidocs-uni-app-x-zh
项目概览
DCloud
/
unidocs-uni-app-x-zh
通知
144
Star
2
Fork
33
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
9
列表
看板
标记
里程碑
合并请求
11
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
U
unidocs-uni-app-x-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
9
Issue
9
列表
看板
标记
里程碑
合并请求
11
合并请求
11
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
提交
5e90f551
编写于
5月 20, 2024
作者:
DCloud-yyl
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
Update manifest-splashscreen.md
上级
543b624f
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
157 addition
and
111 deletion
+157
-111
docs/collocation/manifest-splashscreen.md
docs/collocation/manifest-splashscreen.md
+157
-111
未找到文件。
docs/collocation/manifest-splashscreen.md
浏览文件 @
5e90f551
## splash启动封面
# splash启动界面@splash
> HBuilderX 3.99+
App启动时,系统加载应用渲染首页需要一定的时间,为了避免用户等待,手机操作系统提供了特殊的启动界面设计,让用户先看到一个简单的界面,等应用加载完成后正式进入应用首页。
App启动时,系统加载应用渲染首页需要一定的时间,为了避免用户等待,手机操作系统提供了特殊的启动界面设计,让用户先看到一个简单的界面,等应用加载完成后正式进入应用首页。
...
@@ -10,27 +8,31 @@ App启动时,系统加载应用渲染首页需要一定的时间,为了避
...
@@ -10,27 +8,31 @@ App启动时,系统加载应用渲染首页需要一定的时间,为了避
uni-app x中,如不配置splash,则与计算器等应用一致,启动时有轻微闪白,但可以让用户更快的使用首页。
uni-app x中,如不配置splash,则与计算器等应用一致,启动时有轻微闪白,但可以让用户更快的使用首页。
如需配置splash,注意避免splash图与首页风格差异太大。因为uni-app x启动速度非常快,splash只是一闪而过,如果颜色差异太大,会让用户视觉不舒服。
如需配置splash,注意避免splash图与首页风格差异太大。因为uni-app x启动速度非常快,splash只是一闪而过,如果颜色差异太大,会让用户视觉不舒服。
uni-app x的Android版,启动封面有3种策略:
-
不配置
## Android平台splash@android
-
启动图片
> HBuilderX 3.99+ 版本支持配置启动界面
uni-app x 的 app-android 平台,启动界面有以下策略:
-
不配置
-
启动图片
-
Google SplashScreen
-
Google SplashScreen
iOS平台目前还不支持splash。
### 启动图配置
### 启动图配置
项目的manifest.json文件中,在“App启动界面配置”中的“Android启动界面设置”项下配置各设备分辨率启动图:
项目的manifest.json文件中,在“App启动界面配置”中的“Android启动界面设置”项下配置各设备分辨率启动图:
![](
../static/splash_screen_android_1.png
)
![](
../static/splash_screen_android_1.png
)
推荐使用.9.png来适配不同分辨率。
推荐使用.9.png来适配不同分辨率。
#### .9.png图@9png
#### .9.png图@9png
manifest虽然可以定义3种标准分辨率的启动图配置,而实际上存在很多不同分辨率的手机,导致启动图在一些不常见的设备会进行拉伸或压缩引起变形。
manifest虽然可以定义3种标准分辨率的启动图配置,而实际上存在很多不同分辨率的手机,导致启动图在一些不常见的设备会进行拉伸或压缩引起变形。
为了解决此问题,Google推出了可以适配各种尺寸的一种图片格式“.9.png”。它可以指定特定的区域进行拉伸而不失真。
为了解决此问题,Google推出了可以适配各种尺寸的一种图片格式“.9.png”。它可以指定特定的区域进行拉伸而不失真。
**使用.9.png的优点**
**使用.9.png的优点**
...
@@ -46,7 +48,7 @@ manifest虽然可以定义3种标准分辨率的启动图配置,而实际上
...
@@ -46,7 +48,7 @@ manifest虽然可以定义3种标准分辨率的启动图配置,而实际上
2.
使用android studio,因为android studio已经集成.9.png制作工具,只需选中需要生成的png文件,然后右键,点击create 9-patch file 选项
2.
使用android studio,因为android studio已经集成.9.png制作工具,只需选中需要生成的png文件,然后右键,点击create 9-patch file 选项
详细制作步骤可参考链接:
[
Android中.9图片的含义及制作教程
](
https://www.jianshu.com/p/3fd048644e3f?tdsourcetag=s_pctim_aiomsg
)
详细制作步骤可参考链接:
[
Android中.9图片的含义及制作教程
](
https://www.jianshu.com/p/3fd048644e3f?tdsourcetag=s_pctim_aiomsg
)
可以使用在线.9.png生成工具:
[
http://inloop.github.io/shadow4android/
](
http://inloop.github.io/shadow4android/
)
可以使用在线.9.png生成工具:
[
http://inloop.github.io/shadow4android/
](
http://inloop.github.io/shadow4android/
)
**.9.png配置使用**
**.9.png配置使用**
...
@@ -54,79 +56,79 @@ manifest虽然可以定义3种标准分辨率的启动图配置,而实际上
...
@@ -54,79 +56,79 @@ manifest虽然可以定义3种标准分辨率的启动图配置,而实际上
> 不同尺寸的启动图是为了适配不同分辨率的手机,所以提交打包时请务必上传不同尺寸的启动图,切忌上传多张同尺寸启动图
> 不同尺寸的启动图是为了适配不同分辨率的手机,所以提交打包时请务必上传不同尺寸的启动图,切忌上传多张同尺寸启动图
可以参考开发者在
[
插件市场
](
https://ext.dcloud.net.cn/search?q=.9
)
做好的.9样例工程
可以参考开发者在
[
插件市场
](
https://ext.dcloud.net.cn/search?q=.9
)
做好的.9样例工程
### Google SplashScreen配置
### Google SplashScreen配置
Android 12(API 31)开始强制开启
[
SplashScreen
](
https://developer.android.google.cn/guide/topics/ui/splash-screen?hl=zh-cn
)
。
Android 12(API 31)开始强制开启
[
SplashScreen
](
https://developer.android.google.cn/guide/topics/ui/splash-screen?hl=zh-cn
)
。
这个启动界面不是静态图片,而是自定义启动封面的背景颜色、居中logo图标、底部品牌图标。
这个启动界面不是静态图片,而是自定义启动封面的背景颜色、居中logo图标、底部品牌图标。
如果不配置SplashScreen,在Android 12及以上系统的官方Rom和部分三方Rom上,默认会显示白色背景+居中的应用图标,不会显示配置的splash启动图。
如果不配置SplashScreen,在Android 12及以上系统的官方Rom和部分三方Rom上,默认会显示白色背景+居中的应用图标,不会显示配置的splash启动图。
但大部分国产Rom默认关闭了这个效果。所以这是一个非常碎片化的问题,在不同的Android版本、不同的Rom上有差异。
但大部分国产Rom默认关闭了这个效果。所以这是一个非常碎片化的问题,在不同的Android版本、不同的Rom上有差异。
海外手机大多支持SplashScreen,而国内手机大多不支持。
海外手机大多支持SplashScreen,而国内手机大多不支持。
在支持的Rom上表现形式如下图,启动后会看到下面的界面,然后直接进入应用主页。
在支持的Rom上表现形式如下图,启动后会看到下面的界面,然后直接进入应用主页。
![](
../static/splash_screen_android_example.png
)
![](
../static/splash_screen_android_example.png
)
项目的manifest.json文件中,在“App启动界面配置”中的“Google SplashScreen配置”项下,可以配置背景颜色及各设备分辨率的居中logo图标、底部品牌图标。
项目的manifest.json文件中,在“App启动界面配置”中的“Google SplashScreen配置”项下,可以配置背景颜色及各设备分辨率的居中logo图标、底部品牌图标。
#### 配置启动界面背景颜色:
#### 配置启动界面背景颜色:
可选配置,默认白色
可选配置,默认白色
![](
../static/splash_screen_android_picture2.png
)
![](
../static/splash_screen_android_picture2.png
)
#### 配置启动界面中部logo图标:
#### 配置启动界面中部logo图标:
可选配置,默认应用启动图标
可选配置,默认应用启动图标
![](
../static/splash_screen_android_picture3.png
)
![](
../static/splash_screen_android_picture3.png
)
#### 配置启动界面底部品牌图标:
#### 配置启动界面底部品牌图标:
可选配置,默认底部不显示品牌图标
可选配置,默认底部不显示品牌图标
![](
../static/splash_screen_android_picture4.png
)
![](
../static/splash_screen_android_picture4.png
)
**Tips**
**Tips**
+
Android启动图设置需提交云端打包后才能生效
+
Android启动图设置需提交云端打包后才能生效
+
配置Android 12应用启动界面后仅影响Android 12及以上版本应用启动界面,Android 12以下版本依然使用启动图展示splash
+
配置Android 12应用启动界面后仅影响Android 12及以上版本应用启动界面,Android 12以下版本依然使用启动图展示splash
+
Android 12启动界面中部logo图标在部分系统设备会被裁剪成圆形,部分设备不会裁剪,需要注意圆形logo适配
+
Android 12启动界面中部logo图标在部分系统设备会被裁剪成圆形,部分设备不会裁剪,需要注意圆形logo适配
### 不同Splash方式的选择参考@select
### 不同Splash方式的选择参考@select
Splash是因为主界面渲染慢,给用户一个等待过渡。但注意复杂的Splash,也一样会影响启动速度。
Splash是因为主界面渲染慢,给用户一个等待过渡。但注意复杂的Splash,也一样会影响启动速度。
1.
如不需要splash
1.
如不需要splash
不配置启动图,在SplashScreen中配置一个小的白色Logo图。
不配置启动图,在SplashScreen中配置一个小的白色Logo图。
这样在所有Rom中启动都不会有splash效果。
这样在所有Rom中启动都不会有splash效果。
如果不在SplashScreen配置白色小图,那么在支持SplashScreen的Rom上,启动会在中间渲染App的icon图标。当然这样一个小图也不会占用太多渲染资源。
如果不在SplashScreen配置白色小图,那么在支持SplashScreen的Rom上,启动会在中间渲染App的icon图标。当然这样一个小图也不会占用太多渲染资源。
2.
如需要splash
2.
如需要splash
那么首先需要配置启动图,确保不支持SplashScreen的手机上显示这个启动图。
那么首先需要配置启动图,确保不支持SplashScreen的手机上显示这个启动图。
然后Google SplashScreen配置中配置背景色、居中图标和底图,在支持SplashScreen的手机上,启动封面会变成这个效果。
然后Google SplashScreen配置中配置背景色、居中图标和底图,在支持SplashScreen的手机上,启动封面会变成这个效果。
3.
如只配启动图会怎么样?
3.
如只配启动图会怎么样?
在不支持SplashScreen的手机上,会显示启动图;在支持SplashScreen的手机上,不会显示启动图,而是会显示白底背景+居中应用图标。
在不支持SplashScreen的手机上,会显示启动图;在支持SplashScreen的手机上,不会显示启动图,而是会显示白底背景+居中应用图标。
4.
如只配置SplashScreen会怎么样?
4.
如只配置SplashScreen会怎么样?
在支持SplashScreen的手机上会显示您的配置。在不支持SplashScreen的手机上会闪白,相当于没有Splash效果。
在支持SplashScreen的手机上会显示您的配置。在不支持SplashScreen的手机上会闪白,相当于没有Splash效果。
5.
为什么不能像uni-app js引擎版那样提供一个转圈logo的默认Splash来简化这个事情?
5.
为什么不能像uni-app js引擎版那样提供一个转圈logo的默认Splash来简化这个事情?
uni-app js引擎版的Android App启动时那个默认的logo转圈效果,其实不是splash,是应用启动后原生view绘制的一个动画。所以点击桌面应用图标后界面不会立即有反应。这个设计影响启动速度,在uni-app x上被废弃了。
uni-app js引擎版的Android App启动时那个默认的logo转圈效果,其实不是splash,是应用启动后原生view绘制的一个动画。所以点击桌面应用图标后界面不会立即有反应。这个设计影响启动速度,在uni-app x上被废弃了。
### Android平台splash关闭时机@close
### Android平台splash关闭时机@close
...
@@ -138,8 +140,8 @@ splash默认是在首页onShow时关闭。但可配置,打开项目的manifest
...
@@ -138,8 +140,8 @@ splash默认是在首页onShow时关闭。但可配置,打开项目的manifest
|-- |-- |
|-- |-- |
|onShow |首页页面生命周期触发onShow时关闭splash |
|onShow |首页页面生命周期触发onShow时关闭splash |
|onReady|首页页面生命周期触发onReady时关闭splash|
|onReady|首页页面生命周期触发onReady时关闭splash|
onReady触发时机要比onShow晚一些。
onReady触发时机要比onShow晚一些。
暂不支持其他方式关闭splash。
暂不支持其他方式关闭splash。
...
@@ -156,23 +158,67 @@ onReady触发时机要比onShow晚一些。
...
@@ -156,23 +158,67 @@ onReady触发时机要比onShow晚一些。
**注意**
**注意**
-
splash关闭时机中描述的
`首页`
,指的是第一个真正显示的页面,如项目中pages.json第一个页面A在onLoad生命周期被关闭重新跳转了一个新页面B并显示,则B页面就是
`首页`
,原因是显示的是页面B,A页面并未显示,
-
splash关闭时机中描述的
`首页`
,指的是第一个真正显示的页面,如项目中pages.json第一个页面A在onLoad生命周期被关闭重新跳转了一个新页面B并显示,则B页面就是
`首页`
,原因是显示的是页面B,A页面并未显示,
如果是在页面A的onShow或更晚的生命周期关闭在跳转或直接跳转,则页面A是
`首页`
,因为页面A已经显示符合第一个真正显示的页面。
如果是在页面A的onShow或更晚的生命周期关闭在跳转或直接跳转,则页面A是
`首页`
,因为页面A已经显示符合第一个真正显示的页面。
-
splash关闭后才显示开屏广告
-
splash关闭后才显示开屏广告
### 不同启动方式对splash的影响@starttype
### 不同启动方式对splash的影响@starttype
应用的启动有冷启动、温启动、切换到前台,这三种方式splash展示时间是有区别的。
应用的启动有冷启动、温启动、切换到前台,这三种方式splash展示时间是有区别的。
1.
应用冷启动
1.
应用冷启动
指首次启动或被kill掉进程后的启动,冷启动时初始化环境,数据加载等会占用一些启动时间,所以splash展示时间长一些。
指首次启动或被kill掉进程后的启动,冷启动时初始化环境,数据加载等会占用一些启动时间,所以splash展示时间长一些。
2.
切换至前台
2.
切换至前台
应用未被关闭,再次启动只是激活到前台,此时不显示splash。
应用未被关闭,再次启动只是激活到前台,此时不显示splash。
3.
温启动
3.
温启动
指应用的activity退出但进程仍未被手机系统回收。此时启动,由于不会再初始化环境,加载数据等操作,所以相对启动时间较少,splash展示时间也会缩短。
指应用的activity退出但进程仍未被手机系统回收。此时启动,由于不会再初始化环境,加载数据等操作,所以相对启动时间较少,splash展示时间也会缩短。
由于uni-app x默认在app.uvue里使用了uni.exit,这种退出方式只关闭了activity,没有关闭应用进程。如果rom没有回收掉App进程时再启动该App,就会触发温启动。此时splash会一闪而过。
由于uni-app x默认在app.uvue里使用了uni.exit,这种退出方式只关闭了activity,没有关闭应用进程。如果rom没有回收掉App进程时再启动该App,就会触发温启动。此时splash会一闪而过。
当然App如何退出是开发者自己定义的。很多Android App直接单击back隐藏在后台,不弹toast询问用户是否退出。此时也可以避免温启动的splash快闪。这种方式的开发详见
[
切换应用到后台
](
../api/exit.md#back
)
。
当然App如何退出是开发者自己定义的。很多Android App直接单击back隐藏在后台,不弹toast询问用户是否退出。此时也可以避免温启动的splash快闪。这种方式的开发详见
[
切换应用到后台
](
../api/exit.md#back
)
。
## iOS平台splash@ios
> HBuilderX4.18+ 版本支持配置启动界面
uni-app x 的 app-ios 平台,启动界面有以下策略:
-
不配置
-
自定义storyboard启动界面
Storyboard是Apple提供的一种简化的布局界面,通过xml描述界面,不能编程。
虽然无法制作非常灵活的界面,但满足启动界面是没问题的,比如设定背景色背景图、设定前景文字、图片的位置。
storyboard的优势是启动速度快。在App的真实首页被渲染完成前,可以快速给用户提供一个基于Storyboard的启动屏。
### 制作storyboard文件
storyboard有两种制作方式:
**1.**
**直接使用[模板文件(点击下载)](https://native-res.dcloud.net.cn/uni-app/file/CustomStoryboard.zip)中提供的相对常用的 storyboard 模板,可在这个文件的基础上进行自定义(不需要 Mac 及 XCode,详情请查看附件中的 readme 教程)**
此 storyboard 文件适用于各种 iPhone 及 iPad 设备的横竖屏,支持自定义界面元素包括
-
页面背景图片或背景颜色
-
中间显示图片
-
底部显示文字及颜色
注:每一项都是可选的(比如只显示背景图片,只提供背景图片即可)
**2.**
使用xcode自行制作。xcode提供了可视化的制作storyboard的方式,但依赖于mac电脑。在xcode中制作storyboard的教程请自行网络搜索,请注意下面的注意事项。
HBuilderX需要的自定义storyboard文件格式为zip压缩包,里面要求包含XCode使用的.storyboard文件,以及.stroybard文件中使用的png图,如下图所示:
![](
https://img.cdn.aliyun.dcloud.net.cn/client/ask/pkg/splash/storyboard.png
)
**注意事项**
-
zip压缩包中不要包含目录,直接包含.storyboard和.png文件
-
有且只有一个.storyboard文件
-
.storyboard文件可以通过xcode生成,也可以使用任何文本编辑器修改其源码,比如对.storyboard文件点右键,使用HBuilderX打开。它本质是一个xml文件。
-
png文件名称中的@2x和@3x是适配不同分辨率的图片,系统会自动根据设备dpi选择,可参考
[
这里
](
https://www.jianshu.com/p/5b5f47ff87d4
)
-
为了避免png文件名称与应用中内置的文件名冲突,建议以dc_launchscreen开头
-
制作 storyboard 时,
**请将图片资源直接拖到放工程中,不要放到 imageset 里面,并且图片命名要保证一定的唯一性可参考附件中的示例**
-
XCode中创建 storyboard 文件时,
**页面元素添加约束时一定要相对于**
`Superview`
,不然启动图到 loading页面过渡时页面会跳动或者变形
![](
https://img.cdn.aliyun.dcloud.net.cn/client/ask/pkg/splash/xcode.png
)
### 使用storyboard文件
打开项目的manifest.json文件,在“App启动界面配置”中的“iOS启动图设置”项下选择自己制作的storyboard文件:
![](
../static/splash_screen_ios_storyboard.png
)
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录