Flutter Unity View Widget在Android 8及以下版本崩溃问题解析

问题背景

在使用Flutter Unity View Widget插件时，开发者在特定环境下遇到了Unity视图崩溃的问题。这个问题主要出现在Android 8及以下版本的设备上，当使用Unity 2021.3.31及以上版本或Unity 2022.3.10至2022.3.18版本时，应用会立即崩溃并抛出NoSuchMethodError异常。

问题根源分析

经过深入调查，发现这个问题源于Unity引擎在2021.3.31和2022.3.10版本中引入的一个新特性：当应用从暂停状态恢复时，会显示最后一帧渲染的画面。这个改进原本是为了解决Android设备从锁屏状态返回时出现短暂黑屏的问题。

Unity引擎内部实现这一功能时，在原生代码中调用了hidePreservedContent()方法。然而，在Android 8及以下版本的设备上，由于方法查找机制的不同，当Unity尝试调用这个方法时，如果该方法不存在于自定义的UnityPlayer类中，就会导致崩溃。

影响范围

受影响的Unity版本

• 2021.3.31及以上版本
• 2022.3.10至2022.3.18版本

受影响的Android版本

• Android 8及以下版本（包括Android 6、7等）

已知受影响的设备

• 三星Galaxy J5（Android 6）
• Wileyfox Swift（Android 7）
• 华为Mate 10 Lite（Android 8）
• 三星Galaxy S7等

技术解决方案

临时解决方案

对于必须使用受影响Unity版本的项目，可以通过反射机制手动调用UnityPlayer中的私有方法：

// 在CustomUnityPlayer.kt中添加
fun hidePreservedContent() {
    UnityPlayer::class.java.declaredMethods
        .find { it.name == "hidePreservedContent" }
        ?.let {
            it.isAccessible = true
            it.invoke(this)
        }
}

这种方法利用了Java反射机制来访问UnityPlayer中的私有方法，虽然能够解决问题，但并不是最优雅的解决方案。

推荐解决方案

1. 升级Unity版本：对于使用Unity 2022.3.x的项目，建议升级到2022.3.19或更高版本，这些版本已经修复了此问题。

2. 降级Unity版本：如果项目必须使用Unity 2021.3.x，可以考虑降级到2021.3.30或更早版本。

3. 目标平台调整：如果应用不需要支持Android 8及以下版本，可以在build.gradle中设置minSdkVersion为24（Android 7.0）或更高。

问题演变与修复

有趣的是，这个问题在Unity 2022.3.19及更高版本中神秘地消失了，尽管官方变更日志中并没有明确提到这个修复。这表明Unity团队可能在内部进行了调整，但没有将其列为重要变更。

对于Unity 2021.3.x版本线，这个问题可能永远不会得到官方修复，因为Unity通常只会在LTS版本的最新更新中修复关键问题。

开发者建议

1. 在项目规划阶段，应充分考虑目标用户的设备分布情况，特别是Android版本分布。

2. 使用Flutter Unity View Widget插件时，建议进行全面的兼容性测试，特别是在较旧的Android设备上。

3. 对于必须支持旧版Android设备且必须使用受影响Unity版本的项目，反射解决方案是一个可行的临时方案，但需要注意这可能带来的性能影响和维护成本。

4. 长期来看，建议将项目迁移到已修复此问题的Unity版本，以获得更好的稳定性和维护性。

总结

这个问题的出现和解决过程展示了跨平台开发中常见的兼容性挑战。通过深入理解底层机制，开发者可以找到有效的解决方案。同时，这也提醒我们在引入新功能或升级依赖时需要全面考虑各种使用场景和兼容性问题。