开发者技术前线 ,汇集技术前线快讯和关注行业趋势,大厂干货,是开发者经历和成长的优秀指南。
重磅! 华为发布折叠屏官方适配方案
点击上方“开发者技术前线”,选择“星标”
13:21 在看 真爱
作者: 覃云前端之巅 | 来源:华为开发者联盟
责编:可可
对于开发者来说,最关心的莫过于折叠屏的适配问题,对此,我们联系到了华为终端的相关技术专家,获取了折叠屏的官方适配方案,以下全文就是适配文档。(获华为官方授权发布)
此文档针对华为 Mate X 以及后续可能的折叠屏产品,提供应用适配的规格要求描述,以及适配指导。以确保应用在折叠屏显示各种形态下,皆可以布局正确,显示美观,并且屏幕物理形态切换时,应用尽可能做到不重启,不中断当前用户业务。
文档适用于 Android 平台 APP 相关的设计,开发,测试人员等。
对于通用软件,可能存在如下形态,即:
展开态,全屏点亮工作;
折叠主屏态:折叠态,主屏工作;
折叠副屏态:折叠态:副屏工作。
大屏静态显示规格:
大屏规格定义:应用在大屏展开下,可以撑满全屏显示,且在横竖屏切换形态下,布局和操作按键都正常,不出现任意方向的黑边。
如上图,A 图为撑满全屏,OK、BCD 都是错误的适配规格。
屏幕比例:19.5 : 9
参照下图:
副屏规格:25 :9
副屏下,默认不以全屏显示,以主屏比例显示,即在副屏下也显示 19.5:9 居下显示。应用只需要做好 19.5:9 的适配即可,副屏以 19.5:9 在屏幕下方显示由系统统一控制。
说明:
(1)任意形态下打开一个应用,满足以上静态显示规格;
(2)当用户物理形态切换时,应用需要做到不重启应用,并自动在新的设备形态下按照静态规格布局。
即:在用户进行展开,折叠等操作, 应用任务不中断,自动适应各种屏幕下的静态布局规格。
如下适配建议以及各应用适合适配类型,仅作为推荐性建议,具体由应用根据各自业务特性进行针对性设计。
说明:
即,尽量保持 Y 轴方向上元素不变,X 轴方向上自适应。
示例:
范围(推荐性):适用于界面元素相对单一,没有大量列表类、或较多显示元素的页面。
说明:参考 pad 布局显示更多内容,对于区分了手机和 pad 布局的应用,在展开态优先考虑参考 pad 的大屏布局适配展开态界面,显示更多内容;尽量保证 Y 轴方向元素的不变。
示例:
范围(推荐性):一般适用于 WEB 类应用,页面特征一般为元素多,适配原则以尽量显示较多元素优先。
说明:对于设计过分栏能力的模块,需要在展开态体现分栏布局。
示例:
范围:一般有明显 list 二级菜单的元素结构比较适合。
说明:考虑到展开态 8:7.1 的比例,展开态的横屏和竖屏建议一套布局。横竖一致;不对展开态的横屏特殊处理,挪移布局不用体现。
示例:
说明:具备 8:7.1, 19.5:9, 25:9, 三种可能的显示形态。
强烈建议应用支持可变比例显示(resizeable),在可预见的屏幕比例范围内,都可以做到良好适配。且在比例切换时,应用能够自己处理 screenSize 变化,不需要重走生命周期。总结来说,即要求应用可以完全支持自适应布局,无论静态还是场景切换下。
应用适配折叠屏需要做“屏幕比例适配”和“切换显示比例应用不重启适配”。
适配方式 1:应用支持自适应能力(推荐)
应用只要能做到自适应,在任意比例的屏幕都能做到全屏显示。
应用如何申明自适应
设置方法:在 manifest 文件的
或节点中设置 android:resizeableActivity 的值为 true,可声明应用支持自适应显示,Activity 将能以分屏和 freeform 模式启动。
android:resizeableActivity=["true" | "false"]
适配方式 2:设置应用支持的最大比例和最小比例适配
为保证应用在主副屏或者大屏态能保证满屏显示,请尽快确保应用可以支撑较高范围的宽高比,避免后续反复适配,华为建议最高宽高比支持到 2.4 或者更大(可以确保在主屏、辅屏下满屏显示,如果设置的比例小于 2.4 可能因为最终屏幕比例与当前规格存在差异引起应用无法全屏显示),最小宽高比为 1:1(可以确保在展开态大屏下满屏显示)。
最大宽高比申明:maxaspecratio:2.4(2.4 表明在主副屏下满屏显示)
Android 7.1 及以下版本,在 manifest 文件的<application>
节点中增加 <meta-data>
数据,设置最大支持比例:
<meta-data android:name="android.max_aspect" android:value="2.4" />
Android 8.0 及以上版本,在 manifest 文件的 <activity>
节点中增加 android:MaxAspectRatio 属性,声明最大支持比例:
< activity android:maxAspectRatio="2.4">
...
</activity>
最小宽高比申明:minaspectratio:1.0 (App | Activity Level )
Q 之前版本:在 manifest 文件的 <application>
节点中增加 <meta-data>
数据,设置最小支持比例(声明为 1.0 即表示在展开态大屏下满屏显示):
< meta-data android:name="android.min_aspect" android:value="1.0" />
Q 版本之后支持:在 manifest 文件的 <activity>
节点中增加 android:MinAspectRatio 属性,声明最小支持比例:
<activity android:minAspectRatio="1.0">
...
</activity>
应用如何自处理 screenSize 事件,确保热切换时不重走生命周期。
在 manifest 文件的 <activity>
节点中的 android:configChanges 属性增加 screenSize|orientation|smallestScreenSize 字符串,当屏幕比例变化时,系统会回调 Activity 的 onConfigurationChanged() 方法,而避免 Activity 重新启动。
android:configChanges="screenSize|orientation|smallestScreenSize"
应用复写 onConfigurationChanged() 方法,在方法中实现针对不同比例下界面布局的相应调整,如切换布局、调整控件位置和间距等。
如果开发者没有折叠屏手机,可以通过修改屏幕分辨率来模拟调试:
1 . 主屏(折叠)切全屏(展开)模拟方法:
预先将手机设置主屏分辨率:
adb shell wm size 1136x2480
通过修改手机分辨率为全屏分辨率模拟状态切换:
adb shell wm size 2200x2480
2 . 全屏(展开)切主屏(折叠)模拟方法:
预先将手机设置全屏分辨率:
adb shell wm size 2200x2480
通过修改手机分辨率为主屏分辨率模拟状态切换:
adb shell wm size 1136x2480
现在华为官网已经上线预约 Mate X 适配真机测试的活动,有兴趣的开发者可通过此链接了解:
https://developer.huawei.com/consumer/cn/activity/709