Haze项目在Android API 31上的模糊效果冻结问题解析

在Android开发中，Haze是一个提供模糊效果支持的Compose库。开发者在使用过程中发现了一个特定于Android 12（API 31）的问题：当页面滚动时，模糊效果会冻结不动，只有在底部导航栏出现或消失时才会短暂更新。

问题现象

在API 31设备上，当用户滚动包含模糊效果的界面时，模糊区域不会实时更新，而是保持静态。只有当界面发生较大变化（如底部导航栏的显示/隐藏）时，模糊效果才会短暂刷新一次，然后又恢复冻结状态。这个问题在API 32及更高版本上表现正常。

问题根源

经过深入分析，发现问题出在Android的RenderNode实现上。具体来说：

1. 在API 31上，RenderNode的刷新机制存在缺陷
2. 当RenderNode的位置自上次绘制调用后没有变化时，JNI层的更新会失败
3. 这与Compose框架本身无关，而是Android平台层的限制

解决方案探索

开发团队尝试了多种解决方法：

1. 最初考虑完全禁用API 31上的模糊效果
2. 发现通过修改RenderNode的位置更新方式可以临时解决问题
3. 最终找到了更优雅的解决方案：将平移变换直接应用到setPosition方法中，而不是在record lambda中使用translation

兼容性考量

值得注意的是，这个问题在不同设备上的表现不一致：

1. 在Android 12模拟器上普遍存在
2. 部分真实设备（如Pixel 6、三星A51）表现正常
3. 某些厂商设备（如Oppo Reno 6）也存在问题

最终解决方案

Haze 1.6.0版本将包含以下改进：

1. 默认启用API 31的模糊效果支持
2. 提供blurEnabled配置选项，允许开发者灵活控制
3. 在底层实现上优化了RenderNode的位置更新机制

开发者建议

对于需要使用Haze库的开发者：

1. 升级到1.6.0或更高版本以获得最佳兼容性
2. 如果遇到特定设备问题，可以通过blurEnabled回调进行精细控制
3. 在低版本Android上，模糊效果会自动降级处理

这个问题的解决展示了开源社区协作的力量，也提醒我们在处理平台特定问题时需要全面考虑各种设备情况。