CoreCLR sostituisce il runtime Mono per .NET app per dispositivi mobili

.NET 11 carichi di lavoro per dispositivi mobili usano CoreCLR come runtime supportato.

Versione introdotta

.NET 11

Comportamento precedente

I progetti Android, iOS, tvOS e Mac Catalyst supportati in .NET 10 usavano Mono per impostazione predefinita. È possibile impostare UseMonoRuntime=true per selezionare Mono.

Le app e gli strumenti possono anche visualizzare i nomi Mono nelle informazioni di runtime, nei file del pacchetto, nelle tracce dello stack, nei simboli e negli eventi di diagnostica.

Nuovo comportamento

I progetti Android, iOS, tvOS e Mac Catalyst supportati da .NET 11 usano CoreCLR. L'impostazione UseMonoRuntime=true causa l'errore di compilazione NETSDK1242.

Le app e gli strumenti possono vedere nuovi nomi di runtime. Ad esempio:

  • FrameworkDescriptionsegnala .NET anziché Mono.
  • I pacchetti Android contengono file CoreCLR anziché libmonosgen-2.0.
  • Le tracce dello stack, i simboli e gli eventi di diagnostica identificano CoreCLR.

Tipo di cambiamento che interrompe la compatibilità

Questa modifica può influire sulla compatibilità del codice sorgente, sulla compatibilità binaria e sul comportamento.

Motivo della modifica

.NET 11 carichi di lavoro per dispositivi mobili usano CoreCLR come runtime supportato.

  • Rimuovere UseMonoRuntime=true da progetti .NET 11.
  • Se un'app deve usare Mono, mantenerla su .NET 10.
  • Aggiorna gli strumenti che cercano file di pacchetto Mono, simboli, stack frame o nomi di diagnostica.
  • Non aggiungere codice che controlla se il runtime è Mono o CoreCLR. Controlla invece se è presente la funzionalità necessaria per l'app.

Le API interessate