Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
In .NET 11, Mono runtime settings no longer configure mobile apps.
Version introduced
.NET 11
Previous behavior
Mono environment variables and launcher settings controlled logging, profiling, diagnostics, GC, the interpreter, the JIT, thread suspension, assembly lookup, and debugging.
Common settings included:
MONO_LOG_*MONO_PROFILEMONO_DIAGNOSTICSMONO_SDB_ENV_OPTIONSMONO_GC_*MONO_INTERPRETER_OPTIONSMONO_THREADS_SUSPENDMONO_PATHMONO_DEBUG
New behavior
CoreCLR doesn't use these Mono settings.
Android debug.mono.* system properties are being replaced by
debug.dotnet.* properties that work with CoreCLR. The old names remain as
fallbacks, but those fallbacks might be removed in .NET 12. Use the new names
when they are available.
Type of breaking change
This change can affect source compatibility and behavior.
Reason for change
CoreCLR and Mono use different runtime settings.
Recommended action
- Remove Mono environment variables and launcher settings.
- Don't replace the
MONO_*prefix withDOTNET_*orCOMPlus_*and assume that the setting has the same meaning. - Use a CoreCLR setting only when its documentation says that it provides the behavior you need.
- Shared settings such as
DOTNET_DiagnosticPortsstill work where the mobile workload supports them.
Affected APIs
None. This change affects runtime configuration.