更新Android Studio至4.2RC1后透明Activity失效下层黑屏问题

核心触发逻辑 #

Android Studio 4.2 RC1 配套的AGP（Android Gradle Plugin）4.2 RC1版本，默认开启了多项针对Activity渲染的优化逻辑，其中两项默认变更会直接冲突原有透明窗口的实现：

• 编译期自动为所有非全屏声明的Activity追加系统默认不透明背景属性，覆盖你在style中手动配置的透明背景值
• 硬件加速渲染链路中，对透明Activity的下层窗口做了强制内存缓存优化，导致下层窗口内容被擦除为纯黑

分步修复操作 #

• 第一步：先核对Manifest中Activity的注册配置
  找到侧滑菜单Activity的<activity>节点，确认两个关键点：
  • android:theme 确实指向你自定义的Sidemenu样式，没有被AS升级过程自动替换为全局默认AppTheme
  • 手动显式给该节点追加 android:hardwareAccelerated="true"，避免AGP升级后默认给透明Activity关闭硬件加速引发的渲染异常
• 第二步：补全样式的兼容配置
  你当前的样式缺少4.2版本之后兼容渲染的必填属性，补全后的完整样式参考如下：

  <style name="Sidemenu" parent="Usual">
      <item name="android:windowBackground">@android:color/transparent</item>
      <item name="android:windowIsTranslucent">true</item>
      <item name="android:windowContentOverlay">@null</item>
      <item name="android:backgroundDimEnabled">false</item>
      <item name="android:colorBackgroundCacheHint">@null</item>
      <!-- 4.2版本兼容新增属性 -->
      <item name="android:windowIsFloating">false</item>
      <item name="android:windowAnimationStyle">@null</item>
      <!-- 关闭系统强制边到边渲染的背景填充逻辑 -->
      <item name="android:windowOptOutEdgeToEdgeEnforcement">true</item>
  </style>
  

• 第三步：调整Gradle配置关闭冲突优化
  打开项目根目录下的gradle.properties文件，追加以下两行配置，关闭AGP 4.2 RC1默认开启的透明窗口校验规则：

  # 关闭编译期自动给Activity追加默认不透明背景的逻辑
  android.enableTranslucentActivityValidation=false
  # 关闭透明窗口的强制内存缓存优化
  android.optimizeTranslucentWindows=false
  

• 第四步：排除AS运行配置的干扰
  升级AS后默认开启的「快速部署」增量编译逻辑，可能会引发渲染缓存异常。你可以打开运行配置的「Deployment」选项卡，取消勾选「Deploy using APK from bundle」选项，重新Clean项目后编译安装，验证透明效果是否恢复。

补充验证技巧：如果补全所有配置后仍然存在下层纯黑的问题，可以临时把该Activity的android:hardwareAccelerated属性设置为false做对照测试。如果关闭硬件加速后透明效果恢复，说明是当前版本RenderThread和透明窗口的兼容问题，只需把样式中的android:windowBackground从直接引用@android:color/transparent，替换为自定义的透明drawable资源即可解决。

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