Android Studio仅用XML设置明暗模式背景图时暗模式黑屏问题

1. 修正资源目录结构 #

Android的暗色模式资源必须放在限定符专属目录下，不能直接在默认res/drawable中创建不同名称的文件。正确的目录结构应为：

• 亮模式资源：res/drawable/bg_layer.xml、res/drawable/bg_light.png
• 暗模式资源：res/drawable-night/bg_layer.xml、res/drawable-night/bg_dark.png

注：drawable-night需手动创建，是系统识别暗色模式资源的标准目录。

2. 统一资源文件名，让系统自动匹配 #

无需给明暗模式的层列表设置不同名称，用同一个文件名即可，系统会根据当前模式自动加载对应目录的文件：

• 亮模式层列表（res/drawable/bg_layer.xml）：内部引用bg_light.png
• 暗模式层列表（res/drawable-night/bg_layer.xml）：内部引用bg_dark.png

3. 检查主题配置的正确性 #

确保明暗主题正确继承并设置背景属性，分别在对应目录的样式文件中配置：

• 亮模式主题（res/values/styles.xml）：

<style name="AppTheme" parent="Theme.MaterialComponents.Light.NoActionBar">
    <item name="android:windowBackground">@drawable/bg_layer</item>
</style>

• 暗模式主题（res/values-night/styles.xml）：

<style name="AppTheme" parent="Theme.MaterialComponents.DayNight.NoActionBar">
    <item name="android:windowBackground">@drawable/bg_layer</item>
</style>

注：如果使用DayNight主题，不要设置android:forceDarkAllowed="false"，否则系统会强制暗化背景，覆盖自定义图片。

4. 排查图片本身的问题 #

• 确认bg_dark.png不是纯黑背景（如果是，自然显示全黑），可临时替换为亮色系图片测试；
• 检查图片是否损坏，尝试重新导入或更换其他格式的图片；
• 确保图片的dpi适配正确，避免部分设备无法加载。

5. 清除缓存并重构项目 #

Android Studio缓存可能导致资源未更新，执行以下操作：

• 菜单栏选择 Build > Clean Project
• 再选择 Build > Rebuild Project
• 重启Android Studio后重新运行项目

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