为何无法在透明导航栏与状态栏区域放置组件？

我想要实现完全透明的导航栏与状态栏，参考了安卓开发者官方关于手势导航边缘到边缘的指导内容，但遇到问题：无法让内容显示在导航栏或状态栏对应的边缘区域，效果表现为内容被限制在系统栏下方，无法填充到导航栏和状态栏所在的屏幕边缘位置。

已配置的代码 #

XML 主题配置 #

<item name="android:enforceNavigationBarContrast">false</item>
<item name="android:enforceStatusBarContrast">false</item>
<item name="android:navigationBarColor">@android:color/transparent</item>
<item name="android:statusBarColor">@android:color/transparent</item>

Java 代码 #

Window w = getWindow();
WindowCompat.setDecorFitsSystemWindows(w, false);

我已通过谷歌搜索并在Stack Overflow提问，仍未找到原因，请问问题出在哪里？

问题排查与解决方向 #

• 布局根容器未适配系统栏
  调用WindowCompat.setDecorFitsSystemWindows(w, false)后，系统不会自动为布局添加内边距适配系统栏，需要手动给根布局设置android:fitsSystemWindows="true"，或者通过代码动态计算系统栏高度并设置布局的padding，确保内容能延伸到系统栏下方区域。

• 导航栏手势模式适配缺失
  若设备开启手势导航，部分机型会默认限制内容延伸到导航栏区域，可尝试在主题中添加<item name="android:windowTranslucentNavigation">true</item>，同时针对手势导航场景，检查是否需要额外处理布局的底部内边距。

• 系统版本兼容性设置遗漏
  针对Android 10及以上版本，需确保主题中配置android:windowLayoutInDisplayCutoutMode为shortEdges（允许内容延伸到刘海/挖孔区域），避免屏幕特殊区域限制内容全屏显示。

• 布局层级或属性遮挡
  检查布局中是否存在固定高度、margin或clip属性的View（比如背景容器），这类属性可能会限制内容延伸到边缘区域，需调整相关布局参数。

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