Android 刘海屏、水滴屏全面屏适配方案

Support display cutouts

通过全新的 DisplayCutout 类，可以确定非功能区域的位置和形状，这些区域不应显示内容。 要确定这些凹口屏幕区域是否存在及其位置，请使用 getDisplayCutout() 函数。

1. 全新的窗口布局属性 layoutInDisplayCutoutMode 让您的应用可以为设备凹口屏幕周围的内容进行布局。 您可以将此属性设为下列值之一：

• LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT
  

• LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES
  

• LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER
  

默认值是LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT，刘海区域不会显示内容，需要将值设置为LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES

2. 您可以按如下方法在任何运行 Android P 的设备或模拟器上模拟屏幕缺口：

3. 启用开发者选项。

4. 在 Developer options 屏幕中，向下滚动至 Drawing 部分并选择 Simulate a display with a cutout。

5. 选择凹口屏幕的大小。

6. 适配参考：

// 延伸显示区域到刘海 WindowManager.LayoutParams lp = window.getAttributes();lp.layoutInDisplayCutoutMode = WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES;window.setAttributes(lp);// 设置页面全屏显示 final View decorView = window.getDecorView();decorView.setSystemUiVisibility(View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN | View.SYSTEM_UI_FLAG_LAYOUT_STABLE);

其中延伸显示区域到刘海的代码，也可以通过修改 Activity 或应用的 style 实现，例如：

<?xml version="1.0" encoding="utf-8"?><resources><style name="AppTheme" parent="xxx"><item name="android:windowLayoutInDisplayCutoutMode">shortEdges</item></style></resources>

Android O 适配

因 Google 官方的适配方案到 Android P 才推出，因此在 Android O 设备上，各家厂商有自己的实现方案。

我这里主要适配了华为、小米、oppo，这三家都给了完整的解决方案。至于 vivo，vivo 给了判断是否刘海屏的 API，但是没用设置刘海区域显示到 API，因此无需适配。

适配华为 Android O 设备

方案一：

1. 具体方式如下所示：

<meta-data android:name="android.notch_support" android:value="true"/>

2. 对 Application 生效，意味着该应用的所有页面，系统都不会做竖屏场景的特殊下移或者是横屏场景的右移特殊处理：

<applicationandroid:allowBackup="true"android:icon="@mipmap/ic_launcher"android:label="@string/app_name"android:roundIcon="@mipmap/ic_launcher_round"android:testOnly="false"android:supportsRtl="true"android:theme="@style/AppTheme"><meta-data android:name="android.notch_support" android:value="true"/><activity android:name=".MainActivity"><intent-filter><action android:name="android.intent.action.MAIN"/><category android:name="android.intent.category.LAUNCHER"/></intent-filter></activity>

3. 对 Activity 生效，意味着可以针对单个页面进行刘海屏适配，设置了该属性的 Activity 系统将不会做特殊处理：

<applicationandroid:allowBackup="true"android:icon="@mipmap/ic_launcher"android:label="@string/app_name"android:roundIcon="@mipmap/ic_launcher_round"android:testOnly="false"android:supportsRtl="true"android:theme="@style/AppTheme"><activity android:name=".MainActivity"><intent-filter><action android:name="android.intent.action.MAIN"/>

<category android:name="android.intent.category.LAUNCHER"/></intent-filter></activity><activity android:name=".LandscapeFullScreenActivity" android:screenOrientation="sensor">

《Android学习笔记总结+最新移动架构视频+大厂安卓面试真题+项目实战源码讲义》
浏览器打开：qq.cn.hn/FTe 免费领取

</activity><activity android:name=".FullScreenActivity"><meta-data android:name="android.notch_support" android:value="true"/></activity></application>

方案二

对 Application 生效，意味着该应用的所有页面，系统都不会做竖屏场景的特殊下移或者是横屏场景的右移特殊处理

我的NotchScreenTool中使用的就是方案二，如果需要针对 Activity，建议自行修改。

1. 设置应用窗口在华为刘海屏手机使用刘海区

/刘海屏全屏显示 FLAG/public static final int FLAG_NOTCH_SUPPORT=0x00010000;/**

• 设置应用窗口在华为刘海屏手机使用刘海区

• @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(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");}}

2. 清除添加的华为刘海屏 Flag，恢复应用不使用刘海区显示

/**

• 设置应用窗口在华为刘海屏手机使用刘海区

• @param window 应用页面 window 对象*/public static void setNotFullScreenWindowLayoutInDisplayCutout (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(LayoutParams.class);Object layoutParamsExObj=con.newInstance(layoutParams);Method method=layoutParamsExCls.getMethod("clearHwFlags", int.class);method.invoke(layoutParamsExObj, FLAG_NOTCH_SUPPORT);} catch (ClassNotFoundException | NoSuchMethodException | IllegalAccessException |InstantiationException| InvocationTargetException e) {Log.e("test", "hw clear notch screen flag api error");} catch (Exception e) {Log.e("test", "other Exception");}}

适配小米 Android O 设备

1. 判断是否是刘海屏

private static boolean isNotch() {try {Method getInt = Class.forName("android.os.SystemProperties").getMethod("getInt", String.class, int.class);int notch = (int) getInt.invoke(null, "ro.miui.notch", 0);return notch == 1;} catch (Throwable ignore) {}return false;}

2. 设置显示到刘海区域

@Overridepublic void setDisplayInNotch(Activity activity) {int flag = 0x00000100 | 0x00000200 | 0x00000400;try {Method method = Window.class.getMethod("addExtraFlags",int.class);method.invoke(activity.getWindow(), flag);} catch (Exception ignore) {}}

3. 获取刘海宽高

public static int getNotchHeight(Context context) {int resourceId = context.getResources().getIdentifier("notch_height", "dimen", "android");if (resourceId > 0) {return context.getResources().getDimensionPixelSize(resourceId);}return 0;}

public static int getNotchWidth(Context context) {int resourceId = context.getResources().getIdentifier("notch_width", "dimen", "android");if (resourceId > 0) {return context.getResources().getDimensionPixelSize(resourceId);}return 0;}

适配 oppoAndroid O 设备

1. 判断是否是刘海屏

@Overridepublic boolean hasNotch(Activity activity) {boolean ret = false;try {ret = activity.getPackageManager().hasSystemFeature("com.oppo.feature.screen.heteromorphism");} catch (Throwable ignore) {}return ret;}

2. 获取刘海的左上角和右下角的坐标

/**

• 获取刘海的坐标

• <p>

• 属性形如：[ro.oppo.screen.heteromorphism]: [378,0:702,80]

• <p>

• 获取到的值为 378,0:702,80

• <p>

• <p>

• (378,0)是刘海区域左上角的坐标

• <p>

• (702,80)是刘海区域右下角的坐标*/private static String getScreenValue() {String value = "";Class<?> cls;try {cls = Class.forName("android.os.SystemProperties");Method get = cls.getMethod("get", String.class);Object object = cls.newInstance();value = (String) get.invoke(object, "ro.oppo.screen.heteromorphism");} catch (Throwable ignore) {}return value;}

Oppo Android O 机型不需要设置显示到刘海区域，只要设置了应用全屏就会默认显示。

因此 Oppo 机型必须适配。

适配总结

根据上述功能，我将其整理成了一个依赖库：NotchScreenTool

使用起来很简单：

// 支持显示到刘海区域 NotchScreenManager.getInstance().setDisplayInNotch(this);// 获取刘海屏信息 NotchScreenManager.getInstance().getNotchInfo(this, new INotchScreen.NotchScreenCallback() {