Android edge-to-edge兼容适配

适配Edge-to Edge的必要性

全面屏设计已成为主流，但传统Android应用的显示区域通常受限于系统状态栏和导航栏，造成屏幕空间浪费。Edge-to Edge适配允许应用内容延伸至屏幕边缘，提升沉浸感和用户体验。

启用Edge-to Edge的基本配置

在styles.xml或主题中设置透明系统栏：

<item name="android:statusBarColor">@android:color/transparent</item>
<item name="android:navigationBarColor">@android:color/transparent</item>

或在代码中动态设置：

window.statusBarColor = Color.TRANSPARENT
window.navigationBarColor = Color.TRANSPARENT

处理系统栏重叠问题

1. 使用WindowInsetsController（API 30+）

WindowInsetsControllerCompat(window, window.decorView).run {
    hide(WindowInsetsCompat.Type.systemBars())
    systemBarsBehavior = BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
}

2. 传统View适配方案
在布局中添加inset处理：

android:fitsSystemWindows="true"

或通过OnApplyWindowInsetsListener手动调整边距：

ViewCompat.setOnApplyWindowInsetsListener(view) { v, insets ->
    v.updatePadding(
        top = insets.getInsets(WindowInsetsCompat.Type.statusBars()).top,
        bottom = insets.getInsets(WindowInsetsCompat.Type.navigationBars()).bottom
    )
    insets
}

手势导航适配

1. 避免手势区域冲突
在AndroidManifest.xml中声明：

<meta-data 
    android:name="android.window.PROPERTY_OVERSCAN_LAYOUT_MARGINS" 
    android:resource="@null" />

2. 动态调整交互区域
使用WindowInsetsCompat.getMandatorySystemGestureInsets()获取手势敏感区域，避免在此范围内放置可交互元素。

沉浸模式最佳实践

1. 全屏内容场景

window.decorView.systemUiVisibility = (
    View.SYSTEM_UI_FLAG_LAYOUT_STABLE
    or View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION
    or View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
)

2. 临时退出沉浸模式
通过View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY实现轻触显示系统栏，自动隐藏的效果。

兼容性处理方案

1. 低版本兼容（API < 30）
结合ViewCompat.setOnApplyWindowInsetsListener和WindowInsetsCompat进行适配。

2. 厂商ROM检测
部分厂商系统（如MIUI、EMUI）可能需要特殊处理，可通过Build.MANUFACTURER进行分支逻辑。

测试验证要点

1. 在不同API等级设备上测试布局是否正常延伸至边缘
2. 验证手势操作与界面元素的交互无冲突
3. 检查深色/浅色模式下系统栏图标可见性
4. 测试全屏转场动画时系统栏的显示逻辑

通过系统化实施这些策略，可实现高质量的Edge-to Edge适配，同时保持与各种Android版本的兼容性。