Xamarin.Android项目迁移至MAUI时应用启动崩溃问题解析

背景介绍

在将Xamarin.Forms应用迁移到.NET MAUI框架的过程中，开发者可能会遇到一个特定的问题：当用户在设备上已安装旧版Xamarin应用的情况下，通过Play Store更新至MAUI版本后，应用会在启动时崩溃。而如果用户先卸载旧版再全新安装MAUI版本，则应用能正常运行。

问题现象

具体表现为应用启动后2-3秒内崩溃，日志中会出现以下关键信息：

• "Unable to open …/split_config.xxhdpi.dm: No such file or directory"
• "Entry not found"
• "AOT: NOT FOUND: MyCompany.MyApp.MyAppModule:Initialize ()"

值得注意的是，这些日志信息并不直接指向崩溃的根本原因，而是MAUI运行时的一些常规输出。

根本原因分析

经过深入调查，发现问题的根源在于应用启动流程中调用了MonkeyCache库来读取缓存数据。在从Xamarin升级到MAUI的过程中，旧版应用留下的缓存数据与新框架不兼容，导致读取操作失败，进而引发应用崩溃。

解决方案

开发团队最终采取的解决方案是：

1. 修改启动流程：在SplashActivity中暂时绕过对MonkeyCache的调用，特别是在应用升级后的首次启动时。

2. 版本兼容处理：在MAUI版本中增加对旧版缓存数据的兼容性检查，确保能正确处理升级场景。

3. 依赖项调整：将Microsoft.Maui.Controls和Microsoft.Maui.Controls.Compatibility的NuGet包版本从9.0.40降级至9.0.30，以解决ContentViewGroup相关的ObjectDisposedException问题。

技术建议

对于面临类似迁移问题的开发者，建议采取以下措施：

1. 全面审查启动流程：特别注意任何在应用启动早期阶段执行的持久化数据读取操作。

2. 实现升级检测机制：在应用启动时检测是否是从旧版升级而来，并据此调整初始化逻辑。

3. 分阶段测试：建立完整的测试流程，包括：

   • 全新安装测试
   • 从Xamarin版本升级测试
   • 从MAUI早期版本升级测试

4. 日志收集优化：确保能够捕获完整的崩溃日志，包括原生崩溃信息和托管异常堆栈。

经验总结

这个案例揭示了框架迁移过程中一个容易被忽视的问题点：应用数据的持久化存储可能成为版本间兼容性的绊脚石。开发者在进行框架迁移时，不仅需要考虑代码层面的兼容性，还需要特别关注持久化数据的处理策略。

对于MAUI迁移项目，建议在项目初期就规划好数据迁移策略，确保能够平滑处理从旧版应用升级的各种场景，为用户提供无缝的升级体验。