From 5e90f5518d76ea4429eee922c9b880b631ef36f8 Mon Sep 17 00:00:00 2001 From: DCloud-yyl Date: Mon, 20 May 2024 22:03:30 +0800 Subject: [PATCH] Update manifest-splashscreen.md --- docs/collocation/manifest-splashscreen.md | 268 +++++++++++++--------- 1 file changed, 157 insertions(+), 111 deletions(-) diff --git a/docs/collocation/manifest-splashscreen.md b/docs/collocation/manifest-splashscreen.md index b43abf45..1154b45c 100644 --- a/docs/collocation/manifest-splashscreen.md +++ b/docs/collocation/manifest-splashscreen.md @@ -1,6 +1,4 @@ -## splash启动封面 - -> HBuilderX 3.99+ +# splash启动界面@splash App启动时，系统加载应用渲染首页需要一定的时间，为了避免用户等待，手机操作系统提供了特殊的启动界面设计，让用户先看到一个简单的界面，等应用加载完成后正式进入应用首页。 @@ -10,27 +8,31 @@ App启动时，系统加载应用渲染首页需要一定的时间，为了避 uni-app x中，如不配置splash，则与计算器等应用一致，启动时有轻微闪白，但可以让用户更快的使用首页。 -如需配置splash，注意避免splash图与首页风格差异太大。因为uni-app x启动速度非常快，splash只是一闪而过，如果颜色差异太大，会让用户视觉不舒服。 - -uni-app x的Android版，启动封面有3种策略： -- 不配置 -- 启动图片 +如需配置splash，注意避免splash图与首页风格差异太大。因为uni-app x启动速度非常快，splash只是一闪而过，如果颜色差异太大，会让用户视觉不舒服。 + + +## Android平台splash@android + +> HBuilderX 3.99+ 版本支持配置启动界面 + +uni-app x 的 app-android 平台，启动界面有以下策略： +- 不配置 +- 启动图片 - Google SplashScreen - -iOS平台目前还不支持splash。 + ### 启动图配置 项目的manifest.json文件中，在“App启动界面配置”中的“Android启动界面设置”项下配置各设备分辨率启动图： -![](../static/splash_screen_android_1.png) - -推荐使用.9.png来适配不同分辨率。 - +![](../static/splash_screen_android_1.png) + +推荐使用.9.png来适配不同分辨率。 + #### .9.png图@9png - -manifest虽然可以定义3种标准分辨率的启动图配置，而实际上存在很多不同分辨率的手机，导致启动图在一些不常见的设备会进行拉伸或压缩引起变形。 - + +manifest虽然可以定义3种标准分辨率的启动图配置，而实际上存在很多不同分辨率的手机，导致启动图在一些不常见的设备会进行拉伸或压缩引起变形。 + 为了解决此问题，Google推出了可以适配各种尺寸的一种图片格式“.9.png”。它可以指定特定的区域进行拉伸而不失真。 **使用.9.png的优点** @@ -46,7 +48,7 @@ manifest虽然可以定义3种标准分辨率的启动图配置，而实际上 2. 使用android studio，因为android studio已经集成.9.png制作工具，只需选中需要生成的png文件，然后右键，点击create 9-patch file 选项 详细制作步骤可参考链接：[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配置使用** @@ -54,79 +56,79 @@ manifest虽然可以定义3种标准分辨率的启动图配置，而实际上 > 不同尺寸的启动图是为了适配不同分辨率的手机，所以提交打包时请务必上传不同尺寸的启动图，切忌上传多张同尺寸启动图 可以参考开发者在[插件市场](https://ext.dcloud.net.cn/search?q=.9)做好的.9样例工程 - - -### Google SplashScreen配置 - -Android 12（API 31）开始强制开启 [SplashScreen](https://developer.android.google.cn/guide/topics/ui/splash-screen?hl=zh-cn) 。 - -这个启动界面不是静态图片，而是自定义启动封面的背景颜色、居中logo图标、底部品牌图标。 - -如果不配置SplashScreen，在Android 12及以上系统的官方Rom和部分三方Rom上，默认会显示白色背景+居中的应用图标，不会显示配置的splash启动图。 - -但大部分国产Rom默认关闭了这个效果。所以这是一个非常碎片化的问题，在不同的Android版本、不同的Rom上有差异。 - -海外手机大多支持SplashScreen，而国内手机大多不支持。 - -在支持的Rom上表现形式如下图，启动后会看到下面的界面，然后直接进入应用主页。 - -![](../static/splash_screen_android_example.png) - -项目的manifest.json文件中，在“App启动界面配置”中的“Google SplashScreen配置”项下，可以配置背景颜色及各设备分辨率的居中logo图标、底部品牌图标。 - -#### 配置启动界面背景颜色： - -可选配置，默认白色 - -![](../static/splash_screen_android_picture2.png) - -#### 配置启动界面中部logo图标： - -可选配置，默认应用启动图标 - -![](../static/splash_screen_android_picture3.png) - -#### 配置启动界面底部品牌图标： - -可选配置，默认底部不显示品牌图标 - -![](../static/splash_screen_android_picture4.png) - -**Tips** - -+ Android启动图设置需提交云端打包后才能生效 -+ 配置Android 12应用启动界面后仅影响Android 12及以上版本应用启动界面，Android 12以下版本依然使用启动图展示splash -+ Android 12启动界面中部logo图标在部分系统设备会被裁剪成圆形，部分设备不会裁剪，需要注意圆形logo适配 - -### 不同Splash方式的选择参考@select - -Splash是因为主界面渲染慢，给用户一个等待过渡。但注意复杂的Splash，也一样会影响启动速度。 - -1. 如不需要splash - -不配置启动图，在SplashScreen中配置一个小的白色Logo图。 - -这样在所有Rom中启动都不会有splash效果。 - -如果不在SplashScreen配置白色小图，那么在支持SplashScreen的Rom上，启动会在中间渲染App的icon图标。当然这样一个小图也不会占用太多渲染资源。 - -2. 如需要splash - -那么首先需要配置启动图，确保不支持SplashScreen的手机上显示这个启动图。 - -然后Google SplashScreen配置中配置背景色、居中图标和底图，在支持SplashScreen的手机上，启动封面会变成这个效果。 - -3. 如只配启动图会怎么样？ - -在不支持SplashScreen的手机上，会显示启动图；在支持SplashScreen的手机上，不会显示启动图，而是会显示白底背景+居中应用图标。 - -4. 如只配置SplashScreen会怎么样？ - -在支持SplashScreen的手机上会显示您的配置。在不支持SplashScreen的手机上会闪白，相当于没有Splash效果。 - -5. 为什么不能像uni-app js引擎版那样提供一个转圈logo的默认Splash来简化这个事情？ - -uni-app js引擎版的Android App启动时那个默认的logo转圈效果，其实不是splash，是应用启动后原生view绘制的一个动画。所以点击桌面应用图标后界面不会立即有反应。这个设计影响启动速度，在uni-app x上被废弃了。 + + +### Google SplashScreen配置 + +Android 12（API 31）开始强制开启 [SplashScreen](https://developer.android.google.cn/guide/topics/ui/splash-screen?hl=zh-cn) 。 + +这个启动界面不是静态图片，而是自定义启动封面的背景颜色、居中logo图标、底部品牌图标。 + +如果不配置SplashScreen，在Android 12及以上系统的官方Rom和部分三方Rom上，默认会显示白色背景+居中的应用图标，不会显示配置的splash启动图。 + +但大部分国产Rom默认关闭了这个效果。所以这是一个非常碎片化的问题，在不同的Android版本、不同的Rom上有差异。 + +海外手机大多支持SplashScreen，而国内手机大多不支持。 + +在支持的Rom上表现形式如下图，启动后会看到下面的界面，然后直接进入应用主页。 + +![](../static/splash_screen_android_example.png) + +项目的manifest.json文件中，在“App启动界面配置”中的“Google SplashScreen配置”项下，可以配置背景颜色及各设备分辨率的居中logo图标、底部品牌图标。 + +#### 配置启动界面背景颜色： + +可选配置，默认白色 + +![](../static/splash_screen_android_picture2.png) + +#### 配置启动界面中部logo图标： + +可选配置，默认应用启动图标 + +![](../static/splash_screen_android_picture3.png) + +#### 配置启动界面底部品牌图标： + +可选配置，默认底部不显示品牌图标 + +![](../static/splash_screen_android_picture4.png) + +**Tips** + ++ Android启动图设置需提交云端打包后才能生效 ++ 配置Android 12应用启动界面后仅影响Android 12及以上版本应用启动界面，Android 12以下版本依然使用启动图展示splash ++ Android 12启动界面中部logo图标在部分系统设备会被裁剪成圆形，部分设备不会裁剪，需要注意圆形logo适配 + +### 不同Splash方式的选择参考@select + +Splash是因为主界面渲染慢，给用户一个等待过渡。但注意复杂的Splash，也一样会影响启动速度。 + +1. 如不需要splash + +不配置启动图，在SplashScreen中配置一个小的白色Logo图。 + +这样在所有Rom中启动都不会有splash效果。 + +如果不在SplashScreen配置白色小图，那么在支持SplashScreen的Rom上，启动会在中间渲染App的icon图标。当然这样一个小图也不会占用太多渲染资源。 + +2. 如需要splash + +那么首先需要配置启动图，确保不支持SplashScreen的手机上显示这个启动图。 + +然后Google SplashScreen配置中配置背景色、居中图标和底图，在支持SplashScreen的手机上，启动封面会变成这个效果。 + +3. 如只配启动图会怎么样？ + +在不支持SplashScreen的手机上，会显示启动图；在支持SplashScreen的手机上，不会显示启动图，而是会显示白底背景+居中应用图标。 + +4. 如只配置SplashScreen会怎么样？ + +在支持SplashScreen的手机上会显示您的配置。在不支持SplashScreen的手机上会闪白，相当于没有Splash效果。 + +5. 为什么不能像uni-app js引擎版那样提供一个转圈logo的默认Splash来简化这个事情？ + +uni-app js引擎版的Android App启动时那个默认的logo转圈效果，其实不是splash，是应用启动后原生view绘制的一个动画。所以点击桌面应用图标后界面不会立即有反应。这个设计影响启动速度，在uni-app x上被废弃了。 ### Android平台splash关闭时机@close @@ -138,8 +140,8 @@ splash默认是在首页onShow时关闭。但可配置，打开项目的manifest |-- |-- | |onShow |首页页面生命周期触发onShow时关闭splash | |onReady|首页页面生命周期触发onReady时关闭splash| - -onReady触发时机要比onShow晚一些。 + +onReady触发时机要比onShow晚一些。 暂不支持其他方式关闭splash。 @@ -156,23 +158,67 @@ onReady触发时机要比onShow晚一些。 **注意** - splash关闭时机中描述的`首页`，指的是第一个真正显示的页面，如项目中pages.json第一个页面A在onLoad生命周期被关闭重新跳转了一个新页面B并显示，则B页面就是`首页`，原因是显示的是页面B，A页面并未显示， -如果是在页面A的onShow或更晚的生命周期关闭在跳转或直接跳转，则页面A是`首页`，因为页面A已经显示符合第一个真正显示的页面。 +如果是在页面A的onShow或更晚的生命周期关闭在跳转或直接跳转，则页面A是`首页`，因为页面A已经显示符合第一个真正显示的页面。 - splash关闭后才显示开屏广告 -### 不同启动方式对splash的影响@starttype - -应用的启动有冷启动、温启动、切换到前台，这三种方式splash展示时间是有区别的。 - -1. 应用冷启动 -指首次启动或被kill掉进程后的启动，冷启动时初始化环境，数据加载等会占用一些启动时间，所以splash展示时间长一些。 - -2. 切换至前台 -应用未被关闭，再次启动只是激活到前台，此时不显示splash。 - -3. 温启动 -指应用的activity退出但进程仍未被手机系统回收。此时启动，由于不会再初始化环境，加载数据等操作，所以相对启动时间较少，splash展示时间也会缩短。 - -由于uni-app x默认在app.uvue里使用了uni.exit，这种退出方式只关闭了activity，没有关闭应用进程。如果rom没有回收掉App进程时再启动该App，就会触发温启动。此时splash会一闪而过。 - -当然App如何退出是开发者自己定义的。很多Android App直接单击back隐藏在后台，不弹toast询问用户是否退出。此时也可以避免温启动的splash快闪。这种方式的开发详见[切换应用到后台](../api/exit.md#back)。 - +### 不同启动方式对splash的影响@starttype + +应用的启动有冷启动、温启动、切换到前台，这三种方式splash展示时间是有区别的。 + +1. 应用冷启动 +指首次启动或被kill掉进程后的启动，冷启动时初始化环境，数据加载等会占用一些启动时间，所以splash展示时间长一些。 + +2. 切换至前台 +应用未被关闭，再次启动只是激活到前台，此时不显示splash。 + +3. 温启动 +指应用的activity退出但进程仍未被手机系统回收。此时启动，由于不会再初始化环境，加载数据等操作，所以相对启动时间较少，splash展示时间也会缩短。 + +由于uni-app x默认在app.uvue里使用了uni.exit，这种退出方式只关闭了activity，没有关闭应用进程。如果rom没有回收掉App进程时再启动该App，就会触发温启动。此时splash会一闪而过。 + +当然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) -- GitLab