为何windowLayoutInDisplayCutoutMode在themes.xml不生效？如何使XML配置生效？

原因分析 #

1. API 兼容性限制：android:windowLayoutInDisplayCutoutMode 是 Android 9（API 28）新增的属性。如果你的应用 minSdkVersion 低于 28，XML 中未标注版本兼容标签时，系统会直接忽略该属性；而代码中直接设置时，运行在 API 28+ 设备（如 S24 Ultra，API 34）上会正常执行，因此能生效。
2. 主题配置未被实际使用：你定义了 Theme.AppName 和 Base.Theme.AppName 两个主题，需确认 AndroidManifest.xml 中 <application> 或 <activity> 的 android:theme 属性是否指向了配置了 windowLayoutInDisplayCutoutMode="always" 的主题。如果实际应用的是未配置该属性的主题，自然不会生效。
3. Material3 主题的默认逻辑：Theme.Material3.DayNight.NoActionBar 自带窗口Insets处理逻辑，若未正确覆盖属性，可能导致你的配置被父主题默认值覆盖。

解决办法 #

• 适配低 minSdkVersion 场景：在 XML 属性中添加 tools:targetApi="p" 标注，确保高版本设备识别该属性（需在根标签引入 xmlns:tools="http://schemas.android.com/tools"）：

<item name="android:windowLayoutInDisplayCutoutMode" tools:targetApi="p">always</item>

• 确认主题使用正确性：打开 AndroidManifest.xml，检查应用或目标 Activity 的主题配置是否正确。示例：

<!-- 全局应用主题 -->
<application
    android:theme="@style/Base.Theme.AppName"
    ...>

<!-- 单个Activity主题 -->
<activity
    android:name=".MainActivity"
    android:theme="@style/Theme.AppName"
    ...>

• 验证主题属性最终值：通过 Android Studio 的「Theme Editor」查看主题的最终属性，确认 windowLayoutInDisplayCutoutMode 是否被正确设置为 always，排查是否被父主题覆盖。

• 配合全屏属性（可选）：如果使用的是 Base.Theme.AppName（未设置全屏），若希望内容完全延伸至挖孔区域，可添加全屏属性：

<item name="android:windowFullscreen">true</item>

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