解决.NET MAUI Android应用在Debug模式下使用CoreCLR启动失败的问题

问题背景

在使用.NET 10 Preview 6（每日构建版本）开发MAUI Android应用时，开发者可能会遇到一个特定的启动失败问题。当应用以Debug配置构建并指定使用CoreCLR运行时（通过/p:UseMonoRuntime=false参数），应用在启动时会崩溃并抛出异常："Didn't find class 'mono.MonoRuntimeProvider'"。

错误现象

应用构建过程顺利完成，但在Android设备上启动时立即崩溃。查看logcat日志可以看到以下关键错误信息：

java.lang.RuntimeException: Unable to get provider mono.MonoRuntimeProvider: 
java.lang.ClassNotFoundException: Didn't find class "mono.MonoRuntimeProvider" on path: ...

这个错误表明Android系统在尝试加载Mono运行时提供程序类时失败了，尽管应用配置要求使用CoreCLR而非Mono运行时。

问题原因

经过分析，这个问题与MAUI工作负载的版本有关。在.NET 10的某些早期每日构建版本中，Android工作负载的构建可能存在推送问题，导致开发者获取到的不是最新的构建版本。当使用较旧的工作负载版本时，MAUI应用的Android项目模板可能没有正确处理CoreCLR运行时的配置，错误地保留了Mono运行时的相关依赖。

解决方案

要解决这个问题，开发者需要确保获取最新的MAUI工作负载构建：

1. 首先创建一个新的nuget.config文件来添加dotnet10的NuGet源：

   <add key="dotnet10" value="https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet10/nuget/v3/index.json" />
   

2. 然后安装最新的MAUI工作负载：

   dotnet workload install maui
   

3. 确认安装的工作负载版本是最新的（如36.0.0-ci.main.140或更高）

技术深入

这个问题揭示了MAUI Android项目在运行时选择机制上的一个重要细节。在Debug模式下，即使指定了使用CoreCLR运行时，项目模板中的某些Android清单配置可能仍然保留了Mono运行时的依赖。最新版本的工作负载已经修复了这个问题，能够正确地区分两种运行时环境。

对于开发者来说，理解MAUI Android应用的运行时选择机制很重要：

• Mono运行时是传统的.NET移动应用运行时
• CoreCLR是.NET统一平台后的新运行时
• 两种运行时在Android平台上有不同的实现方式和启动流程

最佳实践

为了避免类似问题，建议开发者：

1. 始终使用最新的SDK和工作负载版本
2. 在切换运行时环境时，清理项目并重新构建
3. 定期检查工作负载更新
4. 在nuget.config中配置正确的NuGet源以确保获取最新构建

结论

这个问题的解决展示了.NET MAUI团队在持续改进跨平台开发体验方面的努力。随着.NET 10的不断演进，MAUI Android应用的运行时选择机制变得更加健壮和可靠。开发者只需确保使用最新的工具链，就能避免这类兼容性问题，享受CoreCLR运行时带来的性能优势。