Shaunebu.MAUI.LocalizationManager 1.0.0

Shaunebu.MAUI.LocalizationManager 🗄️✨

Shaunebu.MAUI.LocalizationManager provides a powerful and flexible way to manage localization in your .NET MAUI applications.
It is an enhanced version of the Xamarin Community Toolkit’s LocalizationResourceManager, adapted and improved for .NET MAUI.

🚀 Installation

Install via NuGet:

PM> Install-Package Shaunebu.MAUI.LocalizationManager

NuGet Link: Shaunebu.MAUI.LocalizationManager Compatible with .NET MAUI 8+ projects.

⚙ Setup

Configure localization with the builder extension:

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .UseLocalizationResourceManager(settings =>
    {
        settings.AddResource(AppResources.ResourceManager);
        settings.RestoreLatestCulture(true);
    });

Available settings methods

🧩 Features

• ✅ Multiple Resource Managers

• ✅ File-based resource manager support

• ✅ Stores and restores latest culture

• ✅ DI-ready ILocalizationResourceManager interface

• ✅ Supports TranslateExtension (XAML) & LocalizedString (Code)

• ✅ Culture-aware bindings (TranslateBindingExtension) with plural & format support

• ✅ Resource name dot support

• ✅ Placeholder text for missing resources

🔤 Use in XAML

Add namespace reference:

xmlns:localization="clr-namespace:Shaunebu.MAUI.LocalizationManager;assembly=Shaunebu.MAUI.LocalizationManager"

Use Translate for localized text:

<Label
    Text="{localization:Translate WelcomeToMAUI}"
    FontSize="18"
    HorizontalOptions="Center"/>

🔗 Custom Bindings with TranslateBindingExtension

Pluralization

<Button Text="{localization:TranslateBinding Count, TranslateFormat=ClickedManyTimes, TranslateOne=ClickedOneTime, TranslateZero=ClickMe}" />

Date / Time

<Label Text="{localization:TranslateBinding CurrentDateTime, TranslateFormat=DateIs}"/>
<Label Text="{localization:TranslateBinding CurrentDateTime, TranslateFormat=TimeIs}"/>

Currency

<Label Text="{localization:TranslateBinding Price, TranslateFormat=TotalPrice}" />

Collections

<CollectionView ItemsSource="{Binding Fruits}">
    <CollectionView.ItemTemplate>
        <DataTemplate>
            <Label Text="{localization:TranslateBinding ., TranslateValue=True}"/>
        </DataTemplate>
    </CollectionView.ItemTemplate>
</CollectionView>

Booleans

<Label Text="{localization:TranslateBinding OrderSent, TranslateTrue=Yes, TranslateFalse=No}" />

🖥️ Use in Code

Localized Strings

public LocalizedString HelloWorld { get; } = 
    new(() => $"{AppResources.Hello}, {AppResources.World}!");

With Dependency Injection

public MainPage(ILocalizationResourceManager resourceManager)
{
    HelloWorld = new(() => $"{resourceManager["Hello"]}, {resourceManager["World"]}!");
}

Bind in XAML:

<Label Text="{Binding HelloWorld.Localized}" FontSize="32"/>

Change Culture at Runtime

resourceManager.CurrentCulture = new CultureInfo("en");

🌐 Culture Management

🛠 Example Flow

public partial class MainPage : ContentPage
{
    private readonly ILocalizationResourceManager resourceManager;

    public MainPage(ILocalizationResourceManager resourceManager)
    {
        InitializeComponent();
        this.resourceManager = resourceManager;
    }

    void SwitchLanguage()
    {
        resourceManager.CurrentCulture = new CultureInfo("fr");
    }
}

🔍 Comparison & Advantages

Key Advantages:

1. Works seamlessly in .NET MAUI projects.

2. More powerful than the original XCT version.

3. DI-ready for ViewModels and services.

4. Format, pluralization, collections, booleans supported in XAML.