极力推荐文章：欢迎收藏

Android 干货分享 

文章转载网络：

目前市面上的刘海屏和水滴屏手机越来越多了，颜值方面是因人而异，有的人觉得很好看，也有人觉得丑爆了，我个人觉得是还可以。但是作为移动开发者来说，这并不是一件好事，越来越多异形屏手机的出现意味着我们需要投入大量精力在适配上（就不提之后会出的折叠屏手机了）。本文总结了当下主流手机的刘海屏适配方案，鉴于目前Android碎片化的情况，想要覆盖所有的机型是不可能的，但是能适配一些是一些，总比什么都不做要好。

所谓刘海屏，指的是手机屏幕正上方由于追求极致边框而采用的一种手机解决方案。因形似刘海儿而得名——来自百度百科，水滴屏也是类似，为了简单起见，下文就统称这两种为刘海屏了。

这里先上一张官方的图

从图中可以看出，刘海区域是镶嵌在状态栏内部的，刘海区域的高度一般是不超过状态栏高度的。因此，当我们的应用布局需要占据状态栏来显示时，就需要考虑到刘海区域是否会遮挡住页面上的控件或者背景，这就是为什么将状态栏区域称为危险区域。如果应用不需要占据状态栏显示，全部显示在安全区域内，那么恭喜你，不需要做任何适配处理。总结来说，只有当应用需要全屏显示时才需要进行适配。

方法二：在Activity的onCreate()中为Window添加Flag

页面的布局很简单，只包含一个按钮，为了明显，我为根布局设置了一个背景。activity_immersive.xml

运行之后发现按钮会被刘海区域所遮挡，如图所示：

image

再说第二种情况，全屏风格，状态栏不可见。同样有两种设置方法：

方法二：在Activity的OnCreate()中添加代码：

补充说明一点，现在的手机屏幕高宽比例越来越大，我们还需要额外做一下适配才能使应用在所有手机上都能全屏显示，具体方式有两种：

或者

说明：以上两种接口可以二选一，ratio_float = 屏幕高 / 屏幕宽 （如oppo新机型屏幕分辨率为2280 x 1080， ratio_float = 2280 / 1080 = 2.11，建议设置 ratio_float为2.2或者更大）

也可以通过设置targetSdkVersion>=24（即Android 7.0）,该属性的值会默认为true，就不需要在AndroidManifest.xml中配置了。

image

上文中已经展示了刘海屏中全屏显示带来的问题，那么如何去解决呢？

其实沉浸式状态栏带来的遮挡问题与刘海屏无关，本质上是由于设置了透明状态栏导致布局延伸到了状态栏中，就算是不具有刘海屏，一定程度上也会造成布局的遮挡。不过既然刘海屏是处在状态栏当中的，那么我们就把这种情况也包含在刘海屏的适配中。清楚了原因之后，解决起来就很简单了，我们只需要让控件或布局避开状态栏显示就可以了，具体的解决方法有三种。方法一.利用fitsSystemWindows属性android:fitsSystemWindows="true"属性后，当设置了透明状态栏或者透明导航栏后，就会自动给View添加paddingTop或paddingBottom属性，这样就在屏幕上预留出了状态栏的高度，我们的布局就不会占用状态栏来显示了。activity_immersive.xml

方法二.根据状态栏高度手动设置paddingTop

方法三.在布局中添加一个和状态栏高度相同的View

适配之后成功地将控件避开了状态栏（危险区域），如下图所示：

image

对于全屏显示的情况，处理起来要相对麻烦一些，下面重点说一下这种情况下的适配方案。

谷歌官方从Android P开始给开发者提供了刘海屏相关的API，可以通过直接调用API来进行刘海屏的适配处理。DisplayCutout类可以获得安全区域的范围以及刘海区域（官方的叫法是缺口）的信息，需要注意只有API Level在28及以上才可以调用。

这里我在测试时也发现了一个问题，就是如果是在style中设置了全屏模式，在适配之前，顶部状态栏区域显示一条黑边，这时候调用getDisplayCutout()获取DisplayCutout对象返回的结果是null，其实这也不难理解，因为这时候是看不出刘海区域的，但是这样会导致在适配之前无法通过DisplayCutout判断是否存在刘海屏，只能在适配后才能获取到刘海区域信息，因此只能对于所有设备都添加适配代码。layoutInDisplayCutoutMode，该属性有三个值可以取：

LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT：默认的布局模式，仅当刘海区域完全包含在状态栏之中时，才允许窗口延伸到刘海区域显示，也就是说，如果没有设置为全屏显示模式，就允许窗口延伸到刘海区域，否则不允许。LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER：永远不允许窗口延伸到刘海区域。LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES：始终允许窗口延伸到屏幕短边上的刘海区域，窗口永远不会延伸到屏幕长边上的刘海区域。

还有一个LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS模式，目前已经被LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES所取代，不允许使用了，这里就不提了。

三种模式下的显示效果如下图所示：

image

image

image

可以看出，当在全屏显示情况下，LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT和LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER的效果是一样的，都是在状态栏显示一条黑边，也就是不允许窗口布局延伸到刘海区域，而LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES则允许窗口布局延伸到了刘海区域，这里需要注意是短边刘海区域，不过一般市面上的手机刘海区域都是在短边上的，我是没见过刘海长在“腰”上的，因此利用这个模式就实现适配了。LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT在此时是允许窗口布局延伸到刘海区域的，因此更证实了只有在全屏显示的情况下该模式才不允许窗口布局延伸到刘海区域。

image

我这里为了简单没有添加任何控件，实际开发中在全屏显示后我们仍然需要考虑刘海区域是否会遮挡显示的内容和控件，同样需要避开危险区域来显示。做法和沉浸式状态栏的适配相同，原理同样是将布局下移，预留出状态栏的高度，这里就不一一列举了。

目前市面上的刘海屏手机可以说是琳琅满目，各大厂商都在追求极致的屏占比，推出的新机型也基本上都有刘海屏，针对Android P以下的手机，我们只能依照各个厂商提供的适配方案来进行适配。我也查阅了网上的一些适配文章，主要还是针对目前主流的手机品牌，本文总结了华为、小米、Vivo和Oppo的适配方案，其他品牌的手机之后有时间的话可能会再考虑。

华为官方提供的适配文档：华为刘海屏手机安卓O版本适配指导判断是否有刘海屏

应用页面设置使用刘海区显示方案一.使用新增的meta-data属性android.notch_support，在应用的AndroidManifest.xml中增加meta-data属性，此属性不仅可以针对Application生效，也可以对Activity配置生效。

可以在Application下添加，意味着该应用的所有页面，系统都不会做竖屏场景的特殊下移或者是横屏场景的右移特殊处理。

也可以针对指定的Activity添加，意味着可以针对单个页面进行刘海屏适配，设置了该属性的Activity系统将不会做特殊处理。

方案二.使用给window添加新增的FLAG_NOTCH_SUPPORT

* 通过添加窗口FLAG的方式设置页面使用刘海区显示 * * @param window 应用页面window对象 */ public static void setFullScreenWindowLayoutInDisplayCutout(Window window) { if (window == null) { return; } WindowManager.LayoutParams layoutParams = window.getAttributes(); try { Class layoutParamsExCls = Class.forName("com.huawei.android.view.LayoutParamsEx"); Constructor con = layoutParamsExCls.getConstructor(WindowManager.LayoutParams.class); Object layoutParamsExObj = con.newInstance(layoutParams); Method method = layoutParamsExCls.getMethod("addHwFlags", int.class); method.invoke(layoutParamsExObj, FLAG_NOTCH_SUPPORT); } catch (ClassNotFoundException | NoSuchMethodException | IllegalAccessException | InstantiationException | InvocationTargetException e) { Log.e("test", "hw add notch screen flag api error"); } catch (Exception e) { Log.e("test", "other Exception"); } }

官方提供的所有方法我已经放到了工具类HwNotchUtils里，可以根据需求来使用。

小米官方提供的适配文档：小米刘海屏水滴屏 Android O 适配判断是否有刘海屏

应用页面设置使用刘海区显示方案一.Application级别的控制接口

其中，value的值可以是以下四种

虽然官方文档上说的是Application级别的，但是我觉得也可以针对某一个Activity来配置，不过由于手头上的手机条件不满足，我并没有验证，如果有小伙伴测试过的话可以反馈一下，我再修正一下这里的说法。方案二.Window级别的控制接口

* 通过添加窗口FLAG的方式设置页面使用刘海区显示 * * @param window 应用页面window对象 */ public static void setFullScreenWindowLayoutInDisplayCutout(Window window) { // 竖屏绘制到耳朵区 int flag = FLAG_NOTCH_SUPPORT | FLAG_NOTCH_PORTRAIT; try { Method method = Window.class.getMethod("addExtraFlags", int.class); method.invoke(window, flag); } catch (Exception e) { Log.e("test", "addExtraFlags not found."); } }

官方提供的所有方法我已经放到了工具类XiaomiNotchUtils里，可以根据需求来使用。

image

至于Android P以下版本的小米手机，我并没有测试，如果有哪位大佬测试过了发现有问题可以反馈一下。

Vivo官方提供的适配文档：Vivo全面屏应用适配指南Vivo判断是否有刘海屏

Oppo判断是否有刘海屏

至于全屏显示的适配方案，通过阅读官方文档和网上的其他适配文章，我个人总结一下就是这两种品牌的手机在设置全屏显示时都无需做任何处理（前提是适配了全面屏，上文中提到过如何配置），也就是不会产生黑边，我们只需要避免布局中的内容或控件不被刘海区域所遮挡就可以了。具体的做法和沉浸式状态栏的适配相同，基本原理还是将窗口布局下移，预留出状态栏的高度。注：由于手头没有这两种厂商的手机，因此并没有验证，这一点确实是我做得不够严谨，有好心的大佬验证之后欢迎指正。

还有一点需要注意的地方，如果目标页是应用的启动页面，采用这种添加代码的适配方案（我是在Activity的onCreate()中添加的），会先显示出黑边，然后变为全屏显示，就像下图这样：

image

如果我们使用在AndroidManifest.xml中增加meta-data属性的方案呢，上文也提到了，这种方案对于Android P版本的小米手机是没有效果的，当然了，谷歌官方提供的适配方案也无法通过这种方式配置，因此我们无法避免通过代码来适配。出现这种问题的原因是app在点击图标启动后，会先执行创建进程、应用初始化等操作，虽然时间可能很短，但还是会耗时，这会让用户认为点击应用图标没有反应，为了提升用户体验，在这期间系统会根据AndroidManifest.xml指定的主题来展示出一个Preview Window（预览窗口），常见的应用启动白屏/黑屏就是该原因导致的。1.设置android:windowIsTranslucent属性

设置该属性表示该窗口是半透明的，这样就不会在启动页还未加载之前显示出预览窗口，但是这样会导致点击了应用图标后不会马上显示出应用程序窗口，相当于禁用了官方的优化方案，如果应用初始化进行了过多操作，会延迟几秒才显示应用窗口，用户体验非常不好。2.设置android:windowDisablePreview属性

该属性的作用很明显，就是禁用预览窗口，也就是说系统不会使用窗口的主题来显示一个Preview Window，和windowIsTranslucent属性的效果相同，该属性同样会影响用户体验。

虽然文中介绍了很多适配的内容，但其实在开发中需要我们适配刘海屏的情况并不多，只有两种情况需要我们进行考虑：