.NET MAUI Blazor安卓端：状态栏遮挡应用顶部区域求助

• 检查Android平台的状态栏适配配置

  • 打开项目Platforms/Android/MainActivity.cs，在OnCreate方法中添加状态栏适配代码：

    protected override void OnCreate(Bundle savedInstanceState)
    {
        base.OnCreate(savedInstanceState);
        // 关闭系统自动适配，让布局可自主处理状态栏空间
        WindowCompat.SetDecorFitsSystemWindows(Window, false);
        // 根据需求设置状态栏文字颜色（true为深色，false为浅色）
        WindowInsetsControllerCompat insetsController = WindowCompat.GetInsetsController(Window, Window.DecorView);
        insetsController.AppearanceLightStatusBars = true;
    }
    

    配置后需要在Blazor布局中给顶部导航添加对应内边距，避免内容被状态栏覆盖。
  • 检查Platforms/Android/Properties/AndroidManifest.xml的主题设置，确保使用的主题支持状态栏适配，比如将android:theme设置为@style/Maui.SplashTheme或继承自Theme.Material3.DayNight.NoActionBar的自定义主题。

• 调整Blazor页面的顶部布局内边距

  • 在Blazor主布局（如MainLayout.razor）中，通过MAUI平台API获取状态栏高度，动态设置导航栏的顶部内边距：

    @code {
        private double statusBarHeight;
    
        protected override void OnInitialized()
        {
            base.OnInitialized();
            // 仅在Android平台获取状态栏高度
            if (DeviceInfo.Platform == DevicePlatform.Android)
            {
                statusBarHeight = Microsoft.Maui.ApplicationModel.Platform.CurrentActivity.Window.DecorView.RootWindowInsets.StableInsetTop;
            }
        }
    }
    
    <div class="top-nav" style="padding-top: @statusBarHeightpx;">
        <!-- 导航菜单内容 -->
    </div>
    

• 排查模拟器环境问题

  • 检查Android模拟器的显示设置，部分模拟器默认开启状态栏覆盖应用的模式，尝试切换为“沉浸式状态栏”或调整状态栏透明度；
  • 更换模拟器的API版本测试，比如暂时使用API 33/34，确认是否是API 35的兼容性问题。

• 验证MAUI框架配置

  • 确保项目使用的.NET 9 MAUI SDK是最新补丁版本，框架默认适配逻辑可能存在版本bug；
  • 检查项目csproj文件，确认Android目标版本配置正确，比如：

    <TargetFramework>net9.0-android</TargetFramework>
    <AndroidTargetSdkVersion>35</AndroidTargetSdkVersion>
    

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