Android14 Beta中Dialog主题Activity背景变黑而非透明问题求助

问题详情 #

我有一个使用Theme_Dialog主题的Activity，在Android 12、13等版本设备上，Activity以外的屏幕区域显示为透明，但在Android 14 Beta版本的物理设备上测试时，该区域变成了黑色。模拟器中显示正常（外部区域保持透明）。

我尝试过显式设置backgroundDimAmount和backgroundDimEnabled属性，黑色背景并未消失，只有Activity与黑色背景之间的小部分白色区域的暗度会随属性值变化。

预期效果：

Android 14物理设备实际效果：

解决方案 #

1. 自定义透明Dialog主题 #

在res/values/styles.xml中定义继承自Theme.Dialog的自定义主题，强制设置窗口背景为透明：

<style name="TransparentDialogTheme" parent="Theme.Dialog">
    <item name="android:windowBackground">@android:color/transparent</item>
    <item name="android:backgroundDimEnabled">false</item>
    <item name="android:windowIsFloating">true</item>
</style>

然后在Manifest中为目标Activity指定该主题：

<activity
    android:name=".YourDialogActivity"
    android:theme="@style/TransparentDialogTheme" />

2. Android 14单独适配 #

如果仅在Android 14出现问题，可在res/values-v34/styles.xml中单独覆盖主题属性：

<style name="TransparentDialogTheme" parent="Theme.Dialog">
    <item name="android:windowBackground">@android:color/transparent</item>
    <item name="android:windowTranslucentStatus">true</item>
    <item name="android:windowTranslucentNavigation">true</item>
    <item name="android:backgroundDimEnabled">false</item>
</style>

3. 代码动态调整窗口属性 #

在Dialog Activity的onCreate方法中，针对Android 14及以上版本动态设置窗口背景：

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
        getWindow().setBackgroundDrawable(new ColorDrawable(Color.TRANSPARENT));
        getWindow().setDimAmount(0f);
    }
    // 其他初始化代码
}

原因分析 #

Android 14 Beta对Theme.Dialog主题的窗口背景默认处理逻辑做了调整，物理设备上默认启用了不透明的底层背景，而模拟器的行为暂未完全对齐正式版本。通过显式设置窗口背景为透明并关闭背景暗化，可以恢复低版本系统中的透明效果。

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