CommunityToolkit.Maui 中 CameraView 在 .NET 9 上的 Android 兼容性问题分析

问题背景

在 .NET MAUI 项目中使用 CommunityToolkit.Maui 的 CameraView 组件时，部分开发者遇到了在 Android 平台上的崩溃问题。该问题主要出现在 .NET 9 环境下，当与其他使用较新版本 CameraX 库的 NuGet 包一起使用时。

崩溃现象

当应用尝试启动 CameraView 时，系统会抛出 MissingMethodException 异常，提示找不到 AndroidX.Camera.Core.Preview.SetSurfaceProvider 方法。这导致应用直接崩溃，无法正常使用相机功能。

根本原因分析

经过技术调查，发现问题的根源在于版本冲突：

1. CommunityToolkit.Maui.Camera 当前依赖的是较旧版本的 Xamarin.AndroidX.Camera.Camera2 和 Xamarin.AndroidX.Camera.View 库（v1.3.1.1）
2. 当项目中同时引用了其他需要较新版本 CameraX 库（如 v1.4.1）的 NuGet 包时
3. NuGet 的依赖解析机制会选择使用较高版本的库
4. 但 CommunityToolkit.Maui.Camera 的代码是针对旧版本 API 编写的，与新版本不兼容

技术细节

具体来说，在较新版本的 CameraX 库中，Preview.SetSurfaceProvider 方法的签名发生了变化，而 CommunityToolkit.Maui.Camera 仍然按照旧版本的 API 进行调用，导致了方法查找失败。

解决方案

目前有两种可行的解决方案：

1. 临时解决方案：手动修改 CommunityToolkit.Maui.Camera 的源代码，更新其依赖的 CameraX 库版本，并调整相应的 API 调用方式。

2. 官方修复：等待 CommunityToolkit.Maui 官方发布更新版本，统一使用较新版本的 CameraX 库，确保与其他组件的兼容性。

影响范围

这个问题主要影响以下场景：

• 使用 .NET 9 的 MAUI 项目
• 项目中同时使用了 CommunityToolkit.Maui.Camera 和其他依赖较新 CameraX 库的组件（如 BarcodeScanning.Native.Maui）
• 运行在 Android 平台上的应用

最佳实践建议

对于遇到此问题的开发者，建议：

1. 检查项目中所有依赖 CameraX 库的组件
2. 统一这些组件的 CameraX 库版本
3. 如果必须使用特定版本的组件，考虑暂时不使用 CameraView 功能
4. 关注 CommunityToolkit.Maui 的官方更新，及时升级到修复版本

未来展望

随着 .NET MAUI 生态系统的不断发展，类似的依赖冲突问题可能会减少。微软和社区正在努力改进依赖管理和版本兼容性机制，未来这类问题有望得到更好的解决。

对于组件开发者来说，这也提醒我们需要：

• 定期更新依赖库
• 考虑更灵活的版本兼容策略
• 提供更清晰的依赖声明

通过社区和开发者的共同努力，.NET MAUI 的生态系统将变得更加稳定和可靠。