AKSoftware.Localization.MultiLanguages 5.8.0

.NET Standard 2.0
dotnet add package AKSoftware.Localization.MultiLanguages --version 5.8.0
NuGet\Install-Package AKSoftware.Localization.MultiLanguages -Version 5.8.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="AKSoftware.Localization.MultiLanguages" Version="5.8.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add AKSoftware.Localization.MultiLanguages --version 5.8.0
#r "nuget: AKSoftware.Localization.MultiLanguages, 5.8.0"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install AKSoftware.Localization.MultiLanguages as a Cake Addin
#addin nuget:?package=AKSoftware.Localization.MultiLanguages&version=5.8.0

// Install AKSoftware.Localization.MultiLanguages as a Cake Tool
#tool nuget:?package=AKSoftware.Localization.MultiLanguages&version=5.8.0

AKSoftware.Localization.MultiLanguages

Version 5.8 is here Check out What's New

Nuget

Build awesome .NET applications that supports more than 69+ languages with just a few lines of code, in addition to an easy translation tool that helps you translate all your content to any language you want with just one click

Could be used for all type of .NET Apps (Blazor, UWP, Xamarin, Windows, ASP.NET Core MVC, Razor Pages ....)

https://akmultilanguages.azurewebsites.net

Build with Love by Ahmad Mozaffar

http://ahmadmozaffar.net

YouTube Session

https://youtu.be/Xz68c8GBYz4

Simple UI supports German

Blazor UI with Japanease

What's new in Version 5.8.0

Finally Blazor Server is here you can get started now. The only change that you need to do that is different from others is in your program.cs file make sure to use the following function to register the Language Container

...
// Register the language container for Blazor Server
builder.Services.AddLanguageContainerForBlazorServer<EmbeddedResourceKeysProvider>(Assembly.GetExecutingAssembly(), "Resources");
...

Check out the following Blazor Server Sample

UWP Support in Version 5.0.0

Special thanks for the contributor Michael Gerfen for updating the library to add support to the UWP.

This version contains a major update that adds support for a new package under the name AKSoftware.Localization.MultiLangauges.UWP you can install it from Nuget with the following command


Install-Package AKSoftware.Localization.MultiLangauges.UWP

What's new in Version 5.0.0

In the latest version of the library because right it started to support UWP and not only Blazor a new interface and abstract type has been introduced that allows you to easily create a keys provider to fetch your keys not only from the embedded resources, also from any source you would like (External folder, FTP, Azure Blob Storage ...etc)

By default there is the EmbeddedResourceKeysProvider to fetch the files from the resources and you can create your own by inhereting from the interface IKeysProvider

More about the implementation in the Wiki soon

Getting Started

For Nuget Package Manager install the package

(Nuget Package Manager Console)


Install-Package AKSoftware.Localization.MultiLanguages

(Using dotNet CLI)


dotnet add package AKSoftware.Localization.MultiLanuages

For Blazor additional package is required that helps managing the state of the component when changing the language

(Nuget Package Manager Console)


Install-Package AKSoftware.Localization.MultiLanguages.Blazor

(Using dotNet CLI)


dotnet add package AKSoftware.Localization.MultiLanuages.Blazor

Create the Resources Folder

Inside your project create a folder called "Resources"

and inside it create a file called "en-US.yml" which is a YAML file

then set your keywords inside the file like this


HelloWorld: Hello World

Welcome: Welcome

...

We chose YAML files because it's very light comparing it to XML or JSON and make the output dll very small, in addition to that it's much way faster in serialization and deserialization

Set the build action of the file to EmbeddedResource

Select the file in the Solution Explorer window and from the properties window set the build action property to "Embeded Resources"

Translate the file

Visit the online translation tool on the following link

https://akmultilanguages.azurewebsites.net

Go to translate app page

Upload your YAML file and click submit

All the languages will be available with just one click - install all the languages you want to support in your application

Import the files to the Resources folder

Import the files to the resources folder you have just created and set the build action property for them as Embedded Resources also

Coding time

Blazor Demo:

Go to program.cs and register the Language Container Service in the Dependency Injection container

Import the library


using  AKSoftware.Localization.MultiLanguages

Register the service


// Specify the assembly that has the langauges files, in this situation it's the current assembly

builder.Services.AddLanguageContainer<EmbeddedResourceKeysProvider>(Assembly.GetExecutingAssembly());

// You can specify the default culture of the project like this

// builder.Services.AddLanguageContainer(Assembly.GetExecutingAssembly(), CultureInfo.GetCultureInfo("fr-Fr"));

Note:

If you don't specify a default culture the library will try to find the file that matches the culture of the current user, if it's not existing it will try to find any file that matches the same language, then if it's not there it will try to find the English file then the first file in the folder, otherwise it will throw an exception

Start dealing with components

In the _imports.razor file make sure to add the following namespaces


using  AKSoftware.Localization.MultiLanguages

using  AKSoftware.Localization.MultiLanguages.Blazor

With in your components that you want to localize inject the service


@inject  ILanguageContainerService  languageContainer

And start getting the values from your files just like this


<h1>@languageContainer.Keys["HelloWorld"]</h1>

And to be able to get the state updated for each component that contains localized text call the extension method in the OnInitialized or OnInitializedAsync overriden methods for each component as following


protected  override  void  OnInitialized()

{

// This will make the current component gets updated whenever you change the language of the application

languageContainer.InitLocalizedComponent(this);

}

Change the language from the UI

You are able to change the language and choose any language you have added from the UI like this

Inject the service in the component


@inject  ILanguageContainerService  languageContainer

Add a button and set the @onclick method


<button @onclick="SetFrench">French</button>

@code

{

void SetFrench()

{

languageContainer.SetLanguage(System.Globalization.CultureInfo.GetCultureInfo("fr-FR"));

}

}

Interpolation Feature

Starting from version 4.0 now there is the ability to create dynamic values to replace their values at runtime using Interpolation feature:

Following you can see how to use this feature

Language File en-US:


Welcome: Welcome {username} to our system {version}

In C# to replace the value of username and version parameters at runtime you can use the new indexer that allows to pass an object for with these values as following:


_language["Welcome", new

{

Username = "aksoftware98",

Version = "v4.0"

}]

Check the Sample Folder

Check the sample project here to see how to develop a full Blazor WebAssembly project with storing the last selected language with more than 8 languages available for one UI:

Full Blazor WASM Sample

Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows net7.0 net7.0-android net7.0-ios net7.0-maccatalyst net7.0-macos net7.0-tvos net7.0-windows
.NET Core netcoreapp2.0 netcoreapp2.1 netcoreapp2.2 netcoreapp3.0 netcoreapp3.1
.NET Standard netstandard2.0 netstandard2.1
.NET Framework net461 net462 net463 net47 net471 net472 net48
MonoAndroid monoandroid
MonoMac monomac
MonoTouch monotouch
Tizen tizen40 tizen60
Xamarin.iOS xamarinios
Xamarin.Mac xamarinmac
Xamarin.TVOS xamarintvos
Xamarin.WatchOS xamarinwatchos
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on AKSoftware.Localization.MultiLanguages:

Package Downloads
AKSoftware.Localization.MultiLanguages.Blazor

AKSoftware.Localization.MultiLanguages is a .NET library that allows .NET developers to build applications that targets multiple languages very easy just with few lines of code, Blazor extensions helps the library to track the status of the components and update them whenever the SetLanguage function being called

AKSoftware.Localization.MultiLangauges.UWP

AKSoftware.Localization.MultiLanguages is a .NET library that allows .NET developers to build applications that targets multiple languages very easy just with few lines of code

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
5.8.0 2,307 9/17/2022
5.3.0 13,563 2/10/2022
5.2.0 6,854 8/7/2021
5.1.0 4,306 5/15/2021
5.0.0 5,462 2/10/2021
4.2.0 6,237 12/3/2020
4.1.0 528 11/25/2020
4.0.0 324 11/24/2020
3.2.0 2,874 10/27/2020
3.1.0 2,499 10/3/2020
3.0.5 376 10/27/2020
3.0.1 4,230 7/2/2020
3.0.0 440 7/2/2020
2.0.0 1,364 4/14/2020
1.1.0 553 3/25/2020
1.0.0-CI-20200322-164256 371 3/22/2020

Fix bugs and improve the library to support Blazor Server projects