Cordova-android 14 全屏模式与底部导航栏兼容性解决方案

问题背景

在Cordova-android 14开发环境中，开发者经常遇到全屏模式与底部导航栏的兼容性问题。当启用全屏模式时，底部导航栏会消失，导致用户无法正常退出应用；而禁用全屏模式后，又会出现底部导航栏背景色不一致的问题。

核心问题分析

这个问题的根源在于Cordova-android 14中两个关键配置项的互斥关系：

1. Fullscreen配置项：传统全屏模式实现方式
2. AndroidEdgeToEdge配置项：Android新式边缘到边缘显示模式

在Android API 34及以上版本中，这两种显示模式存在兼容性问题，不能同时正常工作。

解决方案

针对不同Android版本，应采用不同的配置策略：

对于API 34及以下版本

<preference name="Fullscreen" value="true" />
<preference name="AndroidEdgeToEdge" value="false" />

对于API 35及以上版本

<preference name="Fullscreen" value="false" />
<preference name="AndroidEdgeToEdge" value="true" />

技术原理

1. 传统全屏模式：通过隐藏系统UI实现全屏，但会同时隐藏导航栏
2. 边缘到边缘模式：Android新引入的显示方式，允许应用内容延伸到屏幕边缘，同时保持系统导航栏可见

在较新的Android版本中，Google推荐使用边缘到边缘模式替代传统的全屏实现，这能更好地适配现代Android设备的显示特性。

最佳实践建议

1. 根据目标用户群体的Android版本分布选择合适的显示模式
2. 在config.xml中可以通过条件判断实现自动适配
3. 建议在应用启动时检测API版本并动态调整显示模式
4. 对于需要沉浸式体验的应用，可以考虑使用Android原生API实现更精细的控制

常见问题排查

如果遇到显示异常，可以检查以下方面：

1. 确认config.xml中配置项没有冲突
2. 检查AndroidManifest.xml是否被正确修改
3. 验证设备/模拟器的Android版本
4. 清除应用缓存并重新构建项目

通过合理配置这些参数，开发者可以在保持应用美观的同时，确保用户操作的便捷性，实现最佳的用户体验。