MAUI Blazor学习8-支持多语言

MAUI Blazor系列目录

微软官网有Blazor项目多语言方案的详细介绍。

https://learn.microsoft.com/zh-cn/aspnet/core/blazor/globalization-localization?view=aspnetcore-7.0&pivots=server

《ASP.NET Core Blazor 全球化和本地化 _ Microsoft Learn.html》

试验发现，MAUI Blazor不支持注册服务builder.Services.AddLocalization，也不支持使用中间件app.UseRequestLocalization，所以不能使用Blazor Server的IStringLocalizer多语言方案。但是，MAUI Blazor可以使用Windows软件传统的设置语言方案：直接修改CultureInfo.CurrentCulture。

创建语言帮助类

LangHelper主要功能包括读写语言配置，设置软件当前的语言。

D:\Software\gitee\mauiblazorapp\MaBlaApp\Data\LangHelper.cs

/// <summary>
/// 语言帮助类
/// </summary>
public static class LangHelper
{
    /// <summary>
    /// 软件当前的语言
    /// </summary>
    public static string CurrentLang
    {
        get => Preferences.Get(nameof(CurrentLang), "en-US");
        set => Preferences.Set(nameof(CurrentLang), value);
    }

    /// <summary>
    /// 软件支持的语言
    /// </summary>
    public static string[] SupportLangs = new string[] { "en-US", "zh-CN", };

    /// <summary>
    /// 设置软件语言
    /// </summary>
    public static void SetCurrentLang(string lang)
    {
        var cultureInfo = new CultureInfo(lang);

        //影响razor页面字符串
        CultureInfo.CurrentCulture = cultureInfo;

        //影响类库字符串
        CultureInfo.CurrentUICulture = cultureInfo;

        System.Diagnostics.Debug.WriteLine($"{DateTimeOffset.Now}, 设置软件语言{lang}");
    }
}

增加语言字符串文件

在项目的Resources目录下再新建Langs目录，新建默认语言字符串文件AppRes.resx，文件名随意，但是文件名不能含有语言类型。添加几个英文字符串。访问修饰符选择Public，它会自动生成每个语言字符串的静态变量。

D:\Software\gitee\mauiblazorapp\MaBlaApp\Resources\Langs\AppRes.resx

然后新建中文语言字符串文件AppRes.zh-CN.resx，文件名跟默认语言字符串文件相比，多了中间的zh-CN语言类型。访问修饰符选择无代码生成。

使用语言字符串

在_Imports.razor添加对语言字符串命名空间的全局引用

D:\Software\gitee\mauiblazorapp\MaBlaApp\_Imports.razor

@using Resources.Langs

在项目中可以直接@AppRes.xxx的方式使用语言字符串。

D:\Software\gitee\mauiblazorapp\MaBlaApp\Shared\NavMenu.razor

@AppRes.Home

@AppRes.Chart

@AppRes.Todo

增加选择语言UI

在主页增加一个菜单，可以打开选择语言页面

D:\Software\gitee\mauiblazorapp\MaBlaApp\Pages\Index.razor

<a href="selectlang" class="btn btn-primary btn-sm">@AppRes.SelectLang</a>

</li>

增加选择语言页面，显示当前CurrentCulture，通过select组件选择语言后，保存到Preferences

D:\Software\gitee\mauiblazorapp\MaBlaApp\Pages\SelectLang.razor

@page "/selectlang"
@using System.Globalization

<h3>设置语言（重启APP生效）</h3>

<ul class="list-group">
    <li class="list-group-item d-flex justify-content-between mb-1">
        <strong>CurrentCulture</strong>
        <small>@CultureInfo.CurrentCulture</small>
    </li>
    <li class="list-group-item d-flex justify-content-between mb-1">
        <strong>CurrentUICulture</strong>
        <small>@CultureInfo.CurrentUICulture</small>
    </li>

    <li class="list-group-item d-flex justify-content-between mb-1">
        <strong class="align-self-center">@AppRes.SelectLang</strong>
        <select class="form-control" style="width: 50%;" @bind="LangHelper.CurrentLang">
            @foreach (var item in LangHelper.SupportLangs)
            {
                <option value=@item>@item</option>
            }
        </select>
    </li>
</ul>