Material3 MaterialCalendar夜间模式背景色不生效问题排查与解决

问题原因 #

• ThemeOverlay层级属性覆盖：ThemeOverlay.Material3.MaterialCalendar在夜间模式下内部默认的colorSurface适配值优先级高于自定义主题中的设置，而系统内置颜色（如@android:color/holo_orange_dark）因直接硬编码引用，不受父主题夜间配置影响。
• 主题昼夜变体缺失：若未为AppCalendar单独创建夜间模式主题变体，夜间模式下无法正确加载自定义colorSurface值。
• 属性映射差异：部分Material3版本中，MaterialCalendar的背景色实际绑定materialCalendarSurfaceColor属性，而非通用的colorSurface，直接设置后者可能无效。

解决方法 #

1. 创建夜间模式主题变体

在res/values-night/styles.xml中单独定义夜间模式的AppCalendar主题，确保夜间背景色被正确加载：

<style name="AppCalendar" parent="@style/ThemeOverlay.Material3.MaterialCalendar" tools:keep="@style/AppCalendar">
    <item name="colorSurface">@color/你的夜间目标背景色</item>
    <item name="colorPrimary">@color/colorPrimary_Accent</item>
    <item name="colorOnPrimary">@color/colorWhite_PrimaryDark</item>
    <item name="colorOnSurface">@color/colorPrimaryDark_White</item>
    <item name="colorOnSurfaceVariant">@color/colorPrimary_Accent</item>
    <item name="buttonBarPositiveButtonStyle">@style/DialogButtonStyle</item>
    <item name="buttonBarNegativeButtonStyle">@style/DialogButtonStyle</item>
    <item name="shapeAppearanceCornerExtraLarge">@style/ShapeAppearance.App.LargeComponent</item>
</style>

2. 使用MaterialCalendar专属背景属性

若通用colorSurface不生效，尝试使用专属属性materialCalendarSurfaceColor（需对应Material3版本支持）：

<style name="AppCalendar" parent="@style/ThemeOverlay.Material3.MaterialCalendar" tools:keep="@style/AppCalendar">
    <item name="materialCalendarSurfaceColor">@color/colorWhite_Primary</item>
    <item name="colorPrimary">@color/colorPrimary_Accent</item>
    <item name="colorOnPrimary">@color/colorWhite_PrimaryDark</item>
    <item name="colorOnSurface">@color/colorPrimaryDark_White</item>
    <item name="colorOnSurfaceVariant">@color/colorPrimary_Accent</item>
    <item name="buttonBarPositiveButtonStyle">@style/DialogButtonStyle</item>
    <item name="buttonBarNegativeButtonStyle">@style/DialogButtonStyle</item>
    <item name="shapeAppearanceCornerExtraLarge">@style/ShapeAppearance.App.LargeComponent</item>
</style>

3. 强制覆盖窗口背景色

通过android:windowBackground直接指定背景色，绕过主题层级限制：

<style name="AppCalendar" parent="@style/ThemeOverlay.Material3.MaterialCalendar" tools:keep="@style/AppCalendar">
    <item name="android:windowBackground">@color/colorWhite_Primary</item>
    <item name="colorSurface">@color/colorWhite_Primary</item>
    <item name="colorPrimary">@color/colorPrimary_Accent</item>
    <item name="colorOnPrimary">@color/colorWhite_PrimaryDark</item>
    <item name="colorOnSurface">@color/colorPrimaryDark_White</item>
    <item name="colorOnSurfaceVariant">@color/colorPrimary_Accent</item>
    <item name="buttonBarPositiveButtonStyle">@style/DialogButtonStyle</item>
    <item name="buttonBarNegativeButtonStyle">@style/DialogButtonStyle</item>
    <item name="shapeAppearanceCornerExtraLarge">@style/ShapeAppearance.App.LargeComponent</item>
</style>

4. 检查自定义颜色的夜间配置

确保@color/colorWhite_Primary在res/values-night/colors.xml中定义了正确的夜间模式值：

<!-- res/values-night/colors.xml -->
<color name="colorWhite_Primary">#你的夜间背景色十六进制值</color>

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