Android前台服务绘制全屏覆盖层问题：含状态栏及权限报错2003

一、为什么TYPE_SYSTEM_ALERT会触发权限崩溃 #

从Android 8.0（API 26）开始，WindowManager.LayoutParams.TYPE_SYSTEM_ALERT已被废弃，系统不再允许普通应用使用该窗口类型，强行使用会抛出SecurityException（错误码2003，权限拒绝）。官方推荐使用TYPE_APPLICATION_OVERLAY作为悬浮窗的标准类型。

二、用TYPE_APPLICATION_OVERLAY实现全屏覆盖（含状态栏） #

要让悬浮层覆盖状态栏，只需调整WindowManager.LayoutParams的参数，无需切换到废弃的窗口类型。具体修改如下：

1. 确保已获取SYSTEM_ALERT_WINDOW权限 #

该权限属于特殊权限，无法通过常规的requestPermissions申请，必须引导用户到应用设置页面手动开启：

// 检查权限是否已开启
if (!Settings.canDrawOverlays(this)) {
    // 跳转到权限设置页面
    val intent = Intent(
        Settings.ACTION_MANAGE_OVERLAY_PERMISSION,
        Uri.parse("package:${packageName}")
    )
    startActivity(intent)
}

2. 修改窗口布局参数 #

在你的服务onCreate方法中，更新WindowManager.LayoutParams，添加关键flags以允许覆盖状态栏：

val windowManager = getSystemService(WINDOW_SERVICE) as WindowManager
val params = WindowManager.LayoutParams(
    WindowManager.LayoutParams.MATCH_PARENT,
    WindowManager.LayoutParams.MATCH_PARENT,
    WindowManager.LayoutParams.TYPE_APPLICATION_OVERLAY,
    // 添加FLAG_LAYOUT_NO_LIMITS和FLAG_LAYOUT_IN_SCREEN，允许窗口延伸到状态栏区域
    WindowManager.LayoutParams.FLAG_NOT_TOUCH_MODAL 
        or WindowManager.LayoutParams.FLAG_NOT_TOUCHABLE 
        or WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE
        or WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS
        or WindowManager.LayoutParams.FLAG_LAYOUT_IN_SCREEN,
    PixelFormat.TRANSLUCENT
)
// 设置gravity为TOP|LEFT，确保窗口从屏幕最左上角开始布局
params.gravity = Gravity.TOP or Gravity.LEFT

windowManager.addView(GlowingBorderView(this), params)

3. 自定义View适配全屏 #

如果你的GlowingBorderView仍然无法绘制到状态栏区域，需要确保View本身不设置fitsSystemWindows=true（该属性会让View避开状态栏和导航栏）。在自定义View的构造方法中添加：

fitsSystemWindows = false

三、关键说明 #

• FLAG_LAYOUT_NO_LIMITS：允许窗口超出屏幕的常规布局边界，直接覆盖状态栏和导航栏区域
• FLAG_LAYOUT_IN_SCREEN：让窗口占据整个屏幕空间，包括系统UI预留的区域
• 必须确保用户已开启SYSTEM_ALERT_WINDOW权限，否则addView会抛出权限异常

内容的提问来源于stack exchange，提问作者Adnan Aslam