Kodgenerering på mobila enheter ändras från Mono till CoreCLR

.NET 11 mobilappar kan använda CoreCLR JIT, ReadyToRun (R2R) och CoreCLR-tolken. Vilka lägen som är tillgängliga beror fortfarande på målplattformen och byggkonfigurationen.

Version som introducerades

.NET 11

Tidigare beteende

.NET 10 mobilappar kan använda Mono JIT, Mono AOT, Mono AOT med LLVM och Mono-tolken. Vilka lägen som är tillgängliga berodde på mål- och byggkonfigurationen.

Vissa appar använde Mono-tolken för endast en vald lista med samlingar. Detta hjälpte apparna att balansera kompatibilitet och hastighet.

Nytt beteende

.NET 11 mobilappar kan använda CoreCLR JIT, ReadyToRun (R2R) och CoreCLR-tolken. Vilka lägen som är tillgängliga beror fortfarande på målplattformen och byggkonfigurationen.

R2R är en AOT-teknik, men det är inte ett nytt namn för Mono AOT. Den behåller IL och metadata i appen och kan använda JIT eller tolken när målplattformen tillåter det.

Android Release-versioner använder CoreCLR R2R för att förkompilera en del av appen och använder JIT för resten. MauiEnableFullReadyToRun=true tillämpar R2R på hela appen. Appen kan fortfarande använda JIT vid körning för dynamiskt beteende. Felsökningsversioner använder mindre R2R, så större delen av appen körs med JIT.

Apple Release-versioner förkompilerar hela appen med R2R och kan använda tolken vid körning för dynamiskt beteende. Felsökningsversioner använder mindre R2R, så större delen av appen körs med tolken.

NativeAOT är ett annat alternativ för kodgenerering på mobila plattformar. Det skiljer sig från både Mono AOT och CoreCLR R2R. Android NativeAOT är experimentellt i .NET 11.

Typ av kompatibilitetsbrytande ändring

Den här ändringen kan påverka källkodskompatibilitet och beteende.

Orsak till ändringen

CoreCLR använder en egen kompilator och körningsmodell. Mono AOT-inställningar styr inte CoreCLR R2R.

  • Använd R2R-standardvärdena från den mobila arbetslasten.
  • Försök inte översätta varje Mono AOT-inställning till en R2R-inställning.
  • Använd MauiEnableFullReadyToRun först efter att du har mätt appen.
  • Mät starttid, hastighet, minnesanvändning och appstorlek.
  • Om du överväger NativeAOT kan du läsa riktlinjerna för distribution med .NET MAUI Native AOT eftersom det är en separat distributionsmodell med olika begränsningar. Behandla Android NativeAOT som experimentellt i .NET 11.

Berörda API:er

Inga hanterade API:er tas bort. Följande MSBuild-egenskaper och -objekt ger inte längre sin monokodgenereringseffekt när appen använder CoreCLR:

  • Android:RunAOTCompilation, AotAssemblies, EnableLLVM, AndroidEnableProfiledAot, AndroidAotMode, AndroidAotAdditionalArguments, AndroidExtraAotOptions, @(AndroidAotProfile), AndroidAotEnableLazyLoad, AndroidUseInterpreter, UseInterpreteroch AndroidEnableMarshalMethods.
  • iOS, tvOS och Mac Catalyst:UseInterpreter, MtouchInterpreter, MtouchUseLlvm, MtouchFloat32, MonoUseCompressedInterfaceBitmap, RunAotCompilation, AotAssembliesoch AotCompileMaxDegreeOfParallelism.

De här inställningarna konfigurerar Mono AOT-kompilering, LLVM, tolkval, AOT-indata eller genererade marshalmetoder. De konfigurerar inte CoreCLR ReadyToRun-pipelinen. Detaljerad information om migrering och byggdiagnostik finns i Mono-projektegenskaper konfigurerar inte längre mobilappar.