Android刘海屏适配

代码生涯的第一个开源库，NotchAdapter 欢迎大家点评 Star

1.前言

自从2017年 iphone X 问世，刘海屏幕（Notch Screen）也开始流行。但是正如上图官方文档所介绍的，Android 官方是从 Android P （Android 9 API 28）开始才正式开始支持刘海屏幕的适配。也就造成了 “上面老大哥还没定好统一的规章制度，下面各个小弟已经开始各行其道了”的形象。
所以针对 Android 手机刘海屏的适配方案，我们需要分为Android 9及以上与Android 9以下两种方案。

1.1 什么时候需要适配刘海屏

Android 官方为了确保一致性和应用兼容性，搭载 Android 9 的设备必须确保以下刘海行为：

• 一条边缘最多只能包含一个刘海。
• 一台设备不能有两个以上的刘海。
• 设备的两条较长边缘上不能有刘海。
• 在未设置特殊标志的竖屏模式下，状态栏的高度必须至少与刘海的高度持平。
• 默认情况下，在全屏模式或横屏模式下，整个刘海区域必须显示黑边。

所以，当我们需要以全屏及沉浸的模式显示我们的页面时，我们就需要适配刘海屏。（关于Android沉浸式的理解可以参考 郭霖老师的 Android沉浸式状态栏完全解析）这一篇文章。

而且关于刘海屏的适配，官方提供了三种模式：

• LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT ： 这是默认行为，如上所述。在竖屏模式下，内容会呈现到刘海区域中；但在横屏模式下，内容会显示黑边。
• LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES ： 在竖屏模式和横屏模式下，内容都会呈现到刘海区域中。
• LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER ： 内容从不呈现到刘海区域中。

具体内容可以参考官方文档 支持刘海屏-选择您的应用如何处理刘海区域

2.适配方案

如上所述，我们需要分为Android 9及以上与Android 9以下两种方案。

2.1 Android 9及以上

我们可以分为两步，1.设置刘海模式。2.获取刘海坐标

/**
 * @author jere
 */
@RequiresApi(Build.VERSION_CODES.P)
class AndroidPNotchScreen : INotchScreen {
   

    override fun isContainNotch(activity: Activity): Boolean {
   
        var isContainNotch = false
        getNotchRectList(activity, object : GetNotchRectListener {
   
            override fun onResult(rectList: List<Rect>) {
   
                isContainNotch = rectList.isNotEmpty()
            }
        })
        return isContainNotch
    }

    override fun getNotchInfo(activity: Activity, notchInfoCallback: INotchScreen.NotchInfoCallback) {
   
        getNotchRectList(activity, object : GetNotchRectListener {
   
            override fun onResult(rectList: List<Rect>) {
   
                if (rectList.isNotEmpty()) {
   
                    //只支持只有一块刘海屏幕
                    notchInfoCallback.getNotchRect(rectList[0])
                }
            }

        })

    }

    private fun getNotchRectList(activity: Activity, notchRectListener: GetNotchRectListener) {
   
        //设置刘海区域展示的模式, 会允许应用程序的内容延伸到刘海区域。
        val window = activity.window
        // 延伸显示区域到耳朵区
        val lp = window.attributes
        //在竖屏模式和横屏模式下，内容都会呈现到刘海区域中
        lp.layoutInDisplayCutoutMode =
            WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES
        window.attributes = lp
        // 允许内容绘制到耳朵区
        val decorView =