Xamarin.Android 隐藏导航栏配置失效？咨询有效实现方法

首先明确原代码失效的核心原因：你当前使用的Window.DecorView.SystemUiVisibility相关API是Google在Android 11（API 30）正式标记为全量废弃的接口，在API 30及以上的系统上无论怎么配置flag都不会生效；且低版本场景下你使用的flag组合不全，缺少关键控制项，也会导致看起来配置完全不生效的问题。

按API版本区分的适配逻辑 #

API 30（Android 11）及以上版本 #

必须使用官方替代的WindowInsetsController接口实现，旧的SystemUiVisibility接口在该版本以上无任何效果。
参考实现代码：

// 获取DecorView的Insets控制器
var insetsController = Window.DecorView.WindowInsetsController;
if (insetsController == null) return;

// 可选：设置系统栏交互行为，仅用户从屏幕边缘滑动时临时显示导航栏，不会常驻
insetsController.SystemBarsBehavior = WindowInsetsController.BehaviorShowTransientBarsBySwipe;
// 执行隐藏导航栏操作
insetsController.Hide(WindowInsets.Type.NavigationBars());

如果需要同时隐藏状态栏，只需要在Hide方法里追加对应的类型参数即可：

insetsController.Hide(WindowInsets.Type.NavigationBars() | WindowInsets.Type.StatusBars());

API 29（Android 10）及以下版本 #

该版本没有稳定的WindowInsetsController接口，仍需使用SystemUiVisibility的flag组合，但需要补全你之前遗漏的关键flag，否则会出现触摸屏幕导航栏就立刻弹出、看似配置失效的问题。
参考实现代码：

SystemUiFlags flags = SystemUiFlags.HideNavigation
    | SystemUiFlags.LayoutHideNavigation
    | SystemUiFlags.ImmersiveSticky // 关键：避免普通触摸操作直接唤起导航栏
    | SystemUiFlags.LayoutStable // 避免布局随系统栏显示跳动
    // 可选：如果不需要保留状态栏，追加下面的两个flag
    // | SystemUiFlags.Fullscreen
    // | SystemUiFlags.LayoutFullscreen
    ;
Window.DecorView.SystemUiVisibility = (StatusBarVisibility)flags;

容易导致配置失效的额外配置项 #

• 所有系统栏隐藏配置需要在OnCreate方法中SetContentView调用完成后执行，避免因为Window初始化未完成导致配置无法生效。
• 针对API 34（Android 14）及以上版本，系统要求应用必须先将Window设置为全屏模式，才允许隐藏导航栏，需要在隐藏操作前追加Flag配置：

Window.AddFlags(WindowManagerFlags.Fullscreen);

• 如果你的Activity绑定了带ActionBar的主题，ActionBar的存在会强制触发系统导航栏的显示，建议在项目的AndroidManifest.xml中给需要隐藏导航栏的Activity配置无ActionBar的全屏主题：

<activity 
    android:name=".对应Activity的完整类名"
    android:theme="@android:style/Theme.Material.NoActionBar.Fullscreen" />

• 旧文档中提到的直接设置SystemUiVisibility为单值HideNavigation的方式，本身就存在缺陷：没有sticky模式的加持，用户只要在屏幕上做任意点击滑动操作，导航栏就会立刻恢复显示，很容易被误判为配置失效。

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