InvariantGlobalization appears in ASP.NET Core WebAPI but is not stated in documentation

[patr543a]

Type of issue

Missing information

Description

The true is now included in the .csproj for ASP.NET Core WebAPI (Potentially others as well) which may break certain frameworks and it's not clear this is the cause (Took me 2 hours to find this was the problem personally), i belive if it was stated on the changes i might have noticed it

Page URL

https://learn.microsoft.com/en-us/dotnet/core/compatibility/8.0

Content source URL

https://github.com/dotnet/docs/blob/main/docs/core/compatibility/8.0.md

Document Version Independent Id

1dc7a986-52e6-3a88-0163-4a869afc75d3

Article author

gewarren

Metadata

• ID: 250b5b35-569a-c5fa-2bf8-9d951bc1bdb7
• Product: dotnet-fundamentals

[dalibormesaric]

I would also like to see docs explaining how to do this for the chiseled images.

[patr543a]

I would also like to see docs explaining how to do this for the chiseled images.

What exactly are you talking about? This has nothing to do with images at all

[eerhardt]

The true is now included in the .csproj for ASP.NET Core WebAPI (Potentially others as well) which may break certain frameworks

This wasn't intentional. InvariantGlobalization should only be enabled in the templates that target native AOT. The WebApi template doesn't support native AOT. Instead to get AOT support, there is a new template: dotnet new webapiaot, which sets InvariantGlobalization. We will fix the WebApi template to not set this by default.

I would also like to see docs explaining how to do this for the chiseled images.

The chiseled images don't contain ICU by default, and as such set DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=true environment variable. See

• https://devblogs.microsoft.com/dotnet/announcing-dotnet-chiseled-containers/
• https://github.com/dotnet/dotnet-docker/blob/2e4b5915486c96b4e5f7d49b01a767301f661790/src/runtime-deps/8.0/jammy-chiseled/amd64/Dockerfile#L50-L51

[patr543a]

The true is now included in the .csproj for ASP.NET Core WebAPI (Potentially others as well) which may break certain frameworks

This wasn't intentional. InvariantGlobalization should only be enabled in the templates that target native AOT. The WebApi template doesn't support native AOT. Instead to get AOT support, there is a new template: dotnet new webapiaot, which sets InvariantGlobalization. We will fix the WebApi template to not set this by default.

I would also like to see docs explaining how to do this for the chiseled images.

The chiseled images don't contain ICU by default, and as such set DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=true environment variable. See

• https://devblogs.microsoft.com/dotnet/announcing-dotnet-chiseled-containers/
• https://github.com/dotnet/dotnet-docker/blob/2e4b5915486c96b4e5f7d49b01a767301f661790/src/runtime-deps/8.0/jammy-chiseled/amd64/Dockerfile#L50-L51

I was shown a PR saying it should be enabled as most API's don't need it so i was told to report it as a docs problem instead.

[eerhardt]

I was shown a PR saying it should be enabled as most API's don't need it so i was told to report it as a docs problem instead.

That was the original intention with dotnet/aspnetcore#47066, but that decision was relaxed later to only set InvariantGlobalization when the project has native AOT enabled. See dotnet/aspnetcore#48238. We just missed a few places when relaxing this decision, which I'm fixing now. See dotnet/aspnetcore#52428.