移动设备上的代码生成从 Mono 更改为 CoreCLR

.NET 11 移动应用可以使用 CoreCLR JIT、ReadyToRun(R2R)和 CoreCLR 解释器。 可用模式仍取决于目标和生成配置。

引入的版本

.NET 11

以前的行为

.NET 10 个移动应用可以使用 Mono JIT、Mono AOT、结合 LLVM 的 Mono AOT 和 Mono 解释器。 可用模式取决于目标和生成配置。

某些应用仅对选定的一组程序集使用 Mono 解释器。 这有助于这些应用平衡兼容性和速度。

新行为

.NET 11 移动应用可以使用 CoreCLR JIT、ReadyToRun(R2R)和 CoreCLR 解释器。 可用模式仍取决于目标和生成配置。

R2R 是 AOT 技术,但它不是 Mono AOT 的新名称。 它在应用中保留 IL 和元数据,并在目标允许时使用 JIT 或解释器。

Android Release 版本使用 CoreCLR R2R 预编译应用的一部分,并将 JIT 用于其余部分。 MauiEnableFullReadyToRun=true 将 R2R 应用于整个应用。 应用仍可在运行时使用 JIT 进行动态行为。 调试版本使用较少的 R2R,因此大多数应用都使用 JIT 运行。

Apple 的 Release 构建版本使用 R2R 对整个应用进行预编译,并可在运行时使用解释器实现动态行为。 调试版本使用较少的 R2R,因此大多数应用都通过解释器运行。

NativeAOT 是移动平台上的另一个代码生成选项。 它与 Mono AOT 和 CoreCLR R2R 两者都不同。 Android NativeAOT 在 .NET 11 中是实验性的。

破坏性变更的类型

此更改可能会影响 源兼容性 和 行为。

更改原因

CoreCLR 使用自己的编译器和执行模型。 Mono AOT 设置不控制 CoreCLR R2R。

  • 使用移动工作负载中的 R2R 默认值。
  • 请勿尝试将每个 Mono AOT 设置转换为 R2R 设置。
  • 仅在测量应用后使用 MauiEnableFullReadyToRun。
  • 测量启动时间、速度、内存使用情况和应用大小。
  • 如果考虑 NativeAOT,请查看 .NET MAUI Native AOT 部署指南,因为它是具有不同限制的单独部署模型。 在 .NET 11 中将 Android NativeAOT 视为实验性。

受影响的 API

不会删除任何托管 API。 当应用使用 CoreCLR 时,以下 MSBuild 属性和项不再提供其 Mono 代码生成效果:

  • Android:RunAOTCompilation、AotAssemblies、AndroidEnableProfiledAot、EnableLLVM、AndroidAotMode、AndroidAotEnableLazyLoad、AndroidAotAdditionalArguments、@(AndroidAotProfile)、AndroidUseInterpreter、AndroidExtraAotOptions、UseInterpreter和AndroidEnableMarshalMethods。
  • iOS、tvOS 和 Mac Catalyst:UseInterpreter、MtouchInterpreter、MtouchUseLlvm、MtouchFloat32、MonoUseCompressedInterfaceBitmap、RunAotCompilation、AotAssemblies和AotCompileMaxDegreeOfParallelism。

这些设置配置 Mono AOT 编译、LLVM、解释器选择、AOT 输入或生成的封送方法。 它们不会配置 CoreCLR ReadyToRun 管道。 有关详细的迁移和生成诊断行为,请参阅 Mono 项目属性不再用于配置移动应用。