怎樣實現WPF Prism Module的國際化和本地化？

English | 簡體中文

上一篇有簡單介紹主工程的國際化，使用的資源字典(XAML)實現的。
這幾天我添加了幾個Prism模塊(Module)，發現子模塊使用資源字典的方式實現國際化和本地化不好做，沒有找到比較好的參考文章，所以換了一種方式，使用資源文件實現了。

一、本文概述

子模塊的國際化和本地化要求：

• 1. 各模塊需要有自己單獨的語言文件。
• 2. 在主工程中動態切換語言時，子模塊也需要跟着切換。
• 3. 使用了Prism實現模塊化框架，即要求主工程與各子模塊不能有引用關系，即松耦合，不能直接在主工程中切換子模塊的語言文件。

基於上面的要求，我嘗試在各模塊(Module)中也定義了語言文件(XAML)，主窗體切換語言時，加載模塊語言文件老是提示不存在對應的資源字典文件，我惱火呀，后面還是參考“Accelerider.Windows”國際化的方式，使用資源文件實現本地化和國際化了，不糾結Xaml的方式了，唉。

下面是修改后的效果：

和上一版異同：

• 1. 標題欄國際化無變化，只是文字綁定換了種方式，實現效果一致。
• 2. 左側添加了三個子模塊(Home\Client\Server)，使用Prism動態加載的，並且跟隨主工程主窗體語言切換而切換語言。

下面簡單介紹怎么創建模塊，以及主窗體和模塊國際化怎么做的，真的是很簡單的介紹，具體的實現可以拉代碼看看。

二、 添加三個Prism模塊(Module)

可安裝Prism模板，快速創建模塊工程，當然手工創建.Net Core工程也是可以的，就是多了幾個步驟而已（需要用Nuget安裝Prism.Wpf包(7.2.0.1422)），我使用得的Prism模板快速創建的。

2.1 創建模塊之前的准備工作

下載上圖搜索到的Prism模板，重啟VS，它會自動安裝，新建項目時，就有Prism模塊模板選擇了：

注意要選擇.NET Core 3的版本，因為我是使用.NET Core創建的WPF項目。

2.2 創建模塊

下面是已經創建好的三個模塊工程截圖：

目前三個模塊文件組織結構類似:

• I18nResources:資源文件夾，放3個語言資源文件和一個T4模板文件（用於引用語言Key），其中T4模板文件在3個模塊和主工程中定義是一樣的，具體可從github下載源碼查看。
• Views放置視圖文件，現在只使用到了主工程主窗體中顯示的TabItem視圖，即MainTabItem.xaml，繼承自TabItem。
• xxxxModule.cs：prism模板定義文件，prism發現模塊使用。

三個模塊關鍵點需要注意：

• 1. 編輯模塊工程文件，修改模塊文件輸出目錄：

// 省略部分代碼,下面這一行設置為False，代表輸出目錄不帶.NET Core版本信息
<AppendTargetFrameworkToOutputPath>Flase</AppendTargetFrameworkToOutputPath>
// 省略部分代碼，修改Debug與Release編譯輸出目錄，方便主工程統一加載模塊
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|AnyCPU'">
  <OutputPath>..\Build\Debug\Modules</OutputPath>
</PropertyGroup>
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|AnyCPU'">
  <OutputPath>..\Build\Release\Modules</OutputPath>
</PropertyGroup>  
// 省略部分代碼

• 2. XXXModule中需要將資源文件的ResourceManager引用添加到另一個庫中保存，待切換語言時需要使用，如在HomeModule的構造函數中添加代碼如下，只添加這一句代碼就好，模塊的國際化及本地化就算完事了：

I18nManager.Instance.Add(TerminalMACS.Home.I18nResources.UiResource.ResourceManager);

• 3. XXXModule的RegisterTypes方法中注冊視圖"MainTabItem"到"RegionNames.MainTabRegion"，主窗體使用"RegionNames.MainTabRegion"關聯模塊視圖顯示加載。

_regionManager.RegisterViewWithRegion(RegionNames.MainTabRegion, typeof(MainTabItem));

• 4. UI控件國際化文字綁定，其中markup使用的一個開源庫命名空間，后面會給出鏈接，本項目直接將該庫加載進了解決方案中；i18NResources:Language即T4模板文件生成的類，關聯文字翻譯的Key。綁定文字部分代碼如下：

<TextBlock Grid.Row="2" Text="{markup:I18n {x:Static i18NResources:Language.MainTabItm_Header}}"

三、 主工程

主工程目錄組織結構如下：

3.1 動態加載Prism模塊

配置加載3個模塊的關鍵代碼在App.xaml.cs文件中，看上面的代碼，我將三個模塊輸出到了Modules目錄下，主工程直接加載此目錄即可，其他加載方式還有使用配置文件等，可以參考Prism官方例子，文末給出鏈接：

protected override IModuleCatalog CreateModuleCatalog()
{
    string modulePath = @".\Modules";
    if (!Directory.Exists(modulePath))
    {
        Directory.CreateDirectory(modulePath);
    }
    return new DirectoryModuleCatalog() { ModulePath = modulePath };
}

主窗體顯示子模塊注冊的TabItem視圖,prism:RegionManager.RegionName即在各子模塊中注冊過的區域字符串，他與模塊對應的TabItem視圖關聯，代碼如下：

<TabControl Grid.ColumnSpan="2" SelectedIndex="0"
    Style="{StaticResource MainTabControlStyle}" 
    ItemContainerStyle="{StaticResource MainTabItemStyle}"
    prism:RegionManager.RegionName="{x:Static ui:RegionNames.MainTabRegion}"/>

主窗體以TabControl的控件形式展示子模塊視圖：

主工程要能正常加載子模塊，主工程的工程文件也需要修改其輸出目錄：

// 省略部分代碼,下面這一行設置為False，代表輸出目錄不帶.NET Core版本信息
<AppendTargetFrameworkToOutputPath>Flase</AppendTargetFrameworkToOutputPath>
// 省略部分代碼，修改Debug與Release編譯輸出目錄，方便主工程統一加載模塊
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|AnyCPU'">
  <OutputPath>..\Build\Debug</OutputPath>
</PropertyGroup>
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|AnyCPU'">
  <OutputPath>..\Build\Release</OutputPath>
</PropertyGroup>  
// 省略部分代碼

3.2 修改語言文件格式

刪除了原有的XAML語言文件，替換為resx的資源文件，和三個模塊的資源文件類型類似，下面是主工程的資源文件：

替換成資源文件，編輯是要比XAML文件要方便點，起初是有考慮使用資源文件實現國際化的，作死想嘗試XAML文件。

3.3 語言切換核心代碼

動態切換語言的關鍵代碼改為：

public static void SetLanguage(string language = "")
{
    if (string.IsNullOrWhiteSpace(language))
    {
        language = ConfigHelper.ReadKey(KEY_OF_LANGUAGE);
        if (string.IsNullOrWhiteSpace(language))
        {
            language = System.Globalization.CultureInfo.CurrentCulture.ToString();
        }
    }

    ConfigHelper.SetKey(KEY_OF_LANGUAGE, language);
    _lastLanguage = language;

    var culture = new System.Globalization.CultureInfo(language);
    I18nManager.Instance.CurrentUICulture = culture;
}

核心的語言切換代碼是最后一句，不詳細說了，解決方案中有庫、有源碼：

I18nManager.Instance.CurrentUICulture = culture;

四. 源碼

• 1. 源碼地址，歡迎star：https://github.com/dotnet9/TerminalMACS/tree/master/src/TerminalMACS.Manager/TerminalMACS.ManagerForWPF
• 2. 官方網站：https://terminalmacs.com
• 3. 合作網站：https://dotnet9.com

五. 參考資料

• 1. Prism Template Pack（Prism模板）：https://marketplace.visualstudio.com/items?itemName=BrianLagunas.PrismTemplatePack
• 2. WPF國際化開源輔助庫：https://github.com/DingpingZhang/WpfExtensions
• 3. Accelerider.Windows（子模塊加載參考開源項目）：https://github.com/Accelerider/Accelerider.Windows
• 4. Prism-Samples-Wpf（官方Demo）：https://github.com/PrismLibrary/Prism-Samples-Wpf