AvaloniaUI在Android平台上的全屏显示问题解析与解决方案

问题背景

在AvaloniaUI 11.1.1版本中，开发者反馈在Android平板上出现了全屏显示异常的问题。具体表现为：虽然设置了WindowState为FullScreen，但应用界面并未真正占满整个屏幕，底部和顶部仍然可见系统状态栏和导航栏。这个问题在11.0.11版本中并不存在，属于版本升级后出现的回归问题。

技术分析

经过深入调查，发现这个问题源于AvaloniaUI 11.1.1版本中引入的一项新特性——自动安全区域填充(AutoSafeAreaPadding)。这项特性默认启用，旨在为应用界面提供更好的安全区域支持，确保内容不会被设备的不规则边缘或系统UI遮挡。

自动安全区域填充机制

自动安全区域填充的工作原理是：

1. 顶层容器(TopLevel)会自动检测设备的屏幕安全区域
2. 为子内容添加适当的内边距(padding)，确保内容显示在安全区域内
3. 同时允许父容器填充整个屏幕空间

这种机制在大多数情况下能提供更好的用户体验，但对于需要真正全屏显示的应用来说，却可能导致意外的显示效果。

解决方案

要解决这个问题，开发者可以通过以下两种方式之一：

方法一：禁用自动安全区域填充

在需要全屏显示的用户控件(UserControl)上设置TopLevel.AutoSafeAreaPadding属性为False：

<UserControl ...
             TopLevel.AutoSafeAreaPadding="False">
    <!-- 内容 -->
</UserControl>

这个设置会禁用自动安全区域填充功能，使内容能够真正占满整个屏幕空间。

方法二：结合InsetsManager使用

对于更精细的控制，可以结合使用InsetsManager：

protected override void OnLoaded(RoutedEventArgs e)
{
    base.OnLoaded(e);
    
    var insetsManager = TopLevel.GetTopLevel(this)?.InsetsManager;
    if (insetsManager != null)
    {
        insetsManager.DisplayEdgeToEdge = true;
        insetsManager.IsSystemBarVisible = false;
    }
}

这种方法提供了对系统UI可见性的直接控制，适合需要动态调整显示模式的应用。

版本差异说明

AvaloniaUI 11.1.1与11.0.11版本的主要区别在于：

• 11.0.11版本没有自动安全区域填充功能
• 11.1.1版本默认启用了该功能，以提供更好的安全区域支持

最佳实践建议

1. 对于需要真正全屏显示的应用，建议禁用自动安全区域填充
2. 对于需要考虑设备安全区域的应用，保留默认设置
3. 在升级到11.1.1版本时，检查全屏相关的显示效果
4. 测试在不同Android设备和版本上的表现

通过理解这些机制，开发者可以更好地控制应用在Android设备上的显示效果，确保提供一致的用户体验。