Android 11/12三星设备如何通过代码实现应用全屏显示

三星全屏应用列表筛选规则 #

系统判定应用是否支持全屏切换的核心依据是应用声明的最大支持宽高比：未主动声明适配大比例屏幕、targetSdkVersion低于24的应用，会被系统默认判定为不支持全屏，直接以兼容模式（带黑边）运行，不会出现在「设置-显示-全屏应用」的可切换列表中。

具体实现步骤 #

1. 声明全屏支持，跳过系统兼容模式 #

在AndroidManifest.xml的<application>节点下添加以下配置，声明应用适配大比例屏幕，默认启用全屏模式，无需用户手动在设置中切换：

<!-- 适配Android 12及以上版本 -->
<property
    android:name="android.window.PROPERTY_MAX_ASPECT_RATIO"
    android:value="2.4" />

<!-- 兼容Android 11及以下版本 -->
<meta-data
    android:name="android.max_aspect"
    android:value="2.4" />

2.4为当前主流挖孔、曲面屏的通用最大宽高比阈值，覆盖市面绝大多数三星机型的屏幕比例。

2. 配置边到边显示，消除导航栏白边 #

单独设置导航栏为黑色的方案仅适配纯色场景，要完整实现沉浸全屏效果，需要在Styles.xml的AppTheme中添加以下配置：

<!-- 允许内容延伸到挖孔区域，适配短边全屏 -->
<item name="android:windowLayoutInDisplayCutoutMode">shortEdges</item>
<!-- 透明导航栏、状态栏，消除默认白边 -->
<item name="android:navigationBarColor">@android:color/transparent</item>
<item name="android:statusBarColor">@android:color/transparent</item>
<!-- 关闭系统强制内容边距限制 -->
<item name="android:windowOptOutEdgeToEdgeEnforcement">true</item>

如果使用Kotlin/Java代码编写逻辑，在对应Activity的onCreate方法中，setContentView调用前添加一行配置，允许内容绘制到系统栏区域：

WindowCompat.setDecorFitsSystemWindows(window, false)

注：WindowCompat属于AndroidX Core库，使用前请确认项目已引入对应AndroidX依赖。

3. 老版本One UI兼容配置 #

针对部分未更新到最新补丁的Android 11/12三星机型，可以额外添加窗口标志位强制启用沉浸模式，避免特殊ROM下配置失效：

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

效果说明 #

以上配置完成后，应用安装后默认就会以短边全屏模式运行，和手动在系统设置中开启全屏模式的效果完全一致，内容会铺满整个屏幕短边，导航栏不会出现白色背景，不需要用户额外操作。

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