Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-uni-app-x-zh
提交
5f7f53fe
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看板
提交
5f7f53fe
编写于
12月 15, 2023
作者:
shutao-dc
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
update manifest-splashscreen.md
上级
29a74b26
变更
2
隐藏空白更改
内联
并排
Showing
2 changed file
with
34 addition
and
95 deletion
+34
-95
docs/collocation/manifest-splashscreen.md
docs/collocation/manifest-splashscreen.md
+34
-3
docs/tutorial/app-splashscreen.md
docs/tutorial/app-splashscreen.md
+0
-92
未找到文件。
docs/collocation/manifest-splashscreen.md
浏览文件 @
5f7f53fe
...
...
@@ -16,9 +16,40 @@ uni-app x中,如不配置splash,则与计算器等应用一致,启动时
打开项目的manifest.json文件,在“App启动界面配置”中的“Android启动界面设置”项下配置各设备分辨率启动图:
![](
http://dcloud-chjh-native.oss-cn-hangzhou.aliyuncs.com/uni-app-x/doc/splash/splash_screen_android_1.png
)
> 提示:启动界面设置需提交云端打包后才能生效
![](
../static/splash_screen_android_1.png
)
#### Android 12 应用启动界面适配
Android 12(API 31)开始强制开启
[
SplashScreen
](
https://developer.android.google.cn/guide/topics/ui/splash-screen?hl=zh-cn
)
启动界面,启动界面默认应用图标居中,白色背景。启动界面支持自定义。
![](
../static/splash_screen_android_example.png
)
打开项目的manifest.json文件,在“App启动界面配置”中的“Android12启动界面设置”项下配置背景颜色及各设备分辨率的居中logo图标、底部品牌图标。
##### 配置启动界面背景颜色:
可选配置,默认白色
![](
../static/splash_screen_android_2.png
)
##### 配置启动界面中部logo图标:
可选配置,默认应用启动图标
![](
../static/splash_screen_android_3.png
)
##### 配置启动界面底部品牌图标:
可选配置,默认底部不显示品牌图标
![](
../static/splash_screen_android_4.png
)
**Tips**
+
Android启动图设置需提交云端打包后才能生效
+
配置Android 12应用启动界面后仅影响Android 12及以上版本应用启动界面,Android 12以下版本依然使用启动图展示splash
+
Android 12启动界面中部logo图标在部分系统设备会被裁剪成圆形,部分设备不会裁剪,需要注意圆形logo适配
+
部分国内 Android 12及以上版本设备不会强制开启 SplashScreen 启动界面,仅配置splash启动图也可展示,但考虑兼容性建议配置Android 12启动界面设置
#### Android平台splash关闭时机
...
...
docs/tutorial/app-splashscreen.md
已删除
100644 → 0
浏览文件 @
29a74b26
App启动时,系统加载应用渲染首页需要一定的时间,为了避免用户等待,手机操作系统提供了特殊的启动界面设计,让用户先看到一个简单的界面,等应用加载完成后正式进入应用首页。
这个界面,即被称为启动界面,也成称为 splash 或 lauch screen。
### Android启动图设置
打开项目的manifest.json文件,在“App启动界面配置”中的“Android启动界面设置”项下配置各设备分辨率启动图:
![](
../static/splash_screen_android_1.png
)
#### Android 12 系统应用启动界面适配
Android 12(API 31)开始强制开启
[
SplashScreen
](
https://developer.android.google.cn/guide/topics/ui/splash-screen?hl=zh-cn
)
启动界面,启动界面默认应用图标居中,白色背景。启动界面支持自定义。
![](
../static/splash_screen_android_example.png
)
打开项目的manifest.json文件,在“App启动界面配置”中的“Android12启动界面设置”项下配置背景颜色及各设备分辨率的居中logo图标、底部品牌图标。
##### 配置启动界面背景颜色:
可选配置,默认白色
![](
../static/splash_screen_android_2.png
)
##### 配置启动界面中部logo图标:
可选配置,默认应用启动图标
![](
../static/splash_screen_android_3.png
)
##### 配置启动界面底部品牌图标:
可选配置,默认底部不显示品牌图标
![](
../static/splash_screen_android_4.png
)
**Tips**
+
Android启动图设置需提交云端打包后才能生效
+
Android 12 启动界面中部logo图标在部分系统设备会被裁剪成圆形,部分设备不会裁剪,需要注意圆形logo适配
+
部分国内 Android 12 设备不会强制开启 SplashScreen 启动界面
#### Android平台splash关闭时机
splash关闭时机可控制,打开项目的manifest.json文件,选择源码视图,在app->splashScreen节点下设置autoClose值域,控制splash关闭时机,默认onShow
**autoClose取值范围:**
|值域|说明|
|--|--|
|onShow|首页页面生命周期触发onShow时关闭splash|
|onReady|首页页面生命周期触发onReady时关闭splash|
配置示例:
```
"app" : {
"splashScreen" : {
"autoClose" : "onReady"
}
}
```
#### Android平台splash注意事项
1.
splash关闭时机中描述的
`首页`
,指的是第一个真正显示的页面,如项目中pages.json第一个页面A在onLoad生命周期被关闭重新跳转了一个新页面B并显示,则B页面就是
`首页`
,原因是显示的是页面B,A页面并未显示,
如果是在页面A的onShow或更晚的生命周期关闭在跳转或直接跳转,则页面A是
`首页`
,因为页面A已经显示符合第一个真正显示的页面。
2.
应用冷启动与温启动的splash展示时间是有区别的。应用冷启动指首次启动或被kill掉进程后的启动,冷启动时初始化环境,数据加载等会占用一些启动时间,所以splash展示时间长一些。温启动指应用已启动后未kill进程再次的启动,由于不会再初始化环境,加载数据等操作,所以相对启动时间较少,splash展示时间也会缩短。
#### Android平台使用.9.png启动图@9png
目前HBuilderX中仅定义几种标准分辨率的启动图配置,而实际上存在很多不同分辨率的手机,导致启动图在一些不常见的设备会进行拉伸或压缩引起变形,Android平台为了解决此问题就出现了可以适配各种尺寸的一种图片格式“.9.png”。这是一种特殊的图片格式,它可以指定特定的区域进行拉伸而不失真。
**使用.9.png的优点**
1.
避免在非标准分辨率手机上缩放变形
2.
可以只配置1张或多张图片适配更多分辨率,减少apk的体积(推荐至少配置1080P高分屏启动图片)
**.9.png图片和普通png图片的差异**
1.
.9.png图片和一般图片的区别在于.9.png图片有四条黑边,而一般的图片没有,这四条黑边就是用来拉伸和指定显示位置的
2.
使用.9.png图片后,整个图片应该是包裹着你想要显示的内容的,而没有使用的话整个图片将会被拉伸
**制作.9.png图片**
1.
在Android sdk目录下的tools目录下,有一个叫做draw9patch.bat的文件,双击打开就可以使用(最新android SDK该文件已经不存在,若电脑不没有安装android studio,可下载附件工具编辑.9.png图片)
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配置使用**
打开项目的manifest.json文件,在“App启动界面配置”中的“Android启动界面设置”项下,在各分辨率启动图设置框选择需要使用的.9.png图片(图片尺寸请按照提示尺寸对应上传),保存后提交云端打包即可。
> 不同尺寸的启动图是为了适配不同分辨率的手机,所以提交打包时请务必上传不同尺寸的启动图,切忌上传多张同尺寸启动图
可以参考开发者在
[
插件市场
](
https://ext.dcloud.net.cn/search?q=.9
)
做好的.9样例工程
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录