[Breaking change]: Renaming the config switch environment variable from CLR_ICU_VERSION_OVERRIDE to DOTNET_ICU_VERSION_OVERRIDE #43828
Description
Description
.NET has long supported a configuration switch environment variable called CLR_ICU_VERSION_OVERRIDE, which allows users to specify the preferred ICU library version for apps running on Linux. In .NET, this environment variable has been renamed to DOTNET_ICU_VERSION_OVERRIDE to align with the naming convention of other configuration switch environment variables in .NET.
Version
.NET 10 Preview 1
Previous behavior
The CLR_ICU_VERSION_OVERRIDE environment variable is used to specify the preferred ICU version to be loaded in the application.
New behavior
The DOTNET_ICU_VERSION_OVERRIDE environment variable is used to specify the preferred ICU version to be loaded in the application.
Type of breaking change
- Binary incompatible: Existing binaries might encounter a breaking change in behavior, such as failure to load or execute, and if so, require recompilation.
- Source incompatible: When recompiled using the new SDK or component or to target the new runtime, existing source code might require source changes to compile successfully.
- Behavioral change: Existing binaries might behave differently at run time.
Reason for change
This change ensures the environment variable is consistent with the naming convention used for all .NET environment variables.
Recommended action
Users running .NET 10 apps who previously used the CLR_ICU_VERSION_OVERRIDE environment variable will now need to use DOTNET_ICU_VERSION_OVERRIDE instead.
Feature area
Globalization
Affected APIs
No response