北京网站建站推广,临海市建设规划局网站,佛山网站建设玲念建站,网站备案查询网址English | 简体中文上一篇有简单介绍主工程的国际化#xff0c;使用的资源字典(XAML)实现的。这几天我添加了几个Prism模块(Module)#xff0c;发现子模块使用资源字典的方式实现国际化和本地化不好做#xff0c;没有找到比较好的参考文章#xff0c;所以换了一种方式… English | 简体中文上一篇有简单介绍主工程的国际化使用的资源字典(XAML)实现的。这几天我添加了几个Prism模块(Module)发现子模块使用资源字典的方式实现国际化和本地化不好做没有找到比较好的参考文章所以换了一种方式使用资源文件实现了。让WPF项目走上国际化路线一、本文概述子模块的国际化和本地化要求各模块需要有自己单独的语言文件。在主工程中动态切换语言时子模块也需要跟着切换。使用了Prism实现模块化框架即要求主工程与各子模块不能有引用关系即松耦合不能直接在主工程中切换子模块的语言文件。基于上面的要求我尝试在各模块(Module)中也定义了语言文件(XAML)主窗体切换语言时加载模块语言文件老是提示不存在对应的资源字典文件我恼火呀后面还是参考“Accelerider.Windows”国际化的方式使用资源文件实现本地化和国际化了不纠结Xaml的方式了唉。此路不通我换条路走下面是修改后的效果和上一版异同标题栏国际化无变化只是文字绑定换了种方式实现效果一致。左侧添加了三个子模块(Home\Client\Server)使用Prism动态加载的并且跟随主工程主窗体语言切换而切换语言。下面简单介绍怎么创建模块以及主窗体和模块国际化怎么做的真的是很简单的介绍具体的实现可以拉代码看看。跌到爬起来继续趟坑二、 添加三个Prism模块(Module)可安装Prism模板快速创建模块工程当然手工创建.Net Core工程也是可以的就是多了几个步骤而已需要用Nuget安装Prism.Wpf包(7.2.0.1422)我使用得的Prism模板快速创建的。2.1 创建模块之前的准备工作VS2019下载Prism模板下载上图搜索到的Prism模板重启VS它会自动安装新建项目时就有Prism模块模板选择了Prism模板工程注意要选择.NET Core 3的版本因为我是使用.NET Core创建的WPF项目。2.2 创建模块下面是已经创建好的三个模块工程截图目前三个模块文件组织结构类似:I18nResources:资源文件夹放3个语言资源文件和一个T4模板文件用于引用语言Key其中T4模板文件在3个模块和主工程中定义是一样的具体可从github下载源码查看。Views放置视图文件现在只使用到了主工程主窗体中显示的TabItem视图即MainTabItem.xaml继承自TabItem。xxxxModule.csprism模板定义文件prism发现模块使用。三个模块关键点需要注意1. 编辑模块工程文件修改模块文件输出目录// 省略部分代码,下面这一行设置为False代表输出目录不带.NET Core版本信息
AppendTargetFrameworkToOutputPathFlase/AppendTargetFrameworkToOutputPath
// 省略部分代码修改Debug与Release编译输出目录方便主工程统一加载模块
PropertyGroup Condition$(Configuration)|$(Platform)Debug|AnyCPUOutputPath..\Build\Debug\Modules/OutputPath
/PropertyGroup
PropertyGroup Condition$(Configuration)|$(Platform)Release|AnyCPUOutputPath..\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.Row2 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.ColumnSpan2 SelectedIndex0Style{StaticResource MainTabControlStyle} ItemContainerStyle{StaticResource MainTabItemStyle}prism:RegionManager.RegionName{x:Static ui:RegionNames.MainTabRegion}/
主窗体以TabControl的控件形式展示子模块视图子模块的TabItem视图主工程要能正常加载子模块主工程的工程文件也需要修改其输出目录// 省略部分代码,下面这一行设置为False代表输出目录不带.NET Core版本信息
AppendTargetFrameworkToOutputPathFlase/AppendTargetFrameworkToOutputPath
// 省略部分代码修改Debug与Release编译输出目录方便主工程统一加载模块
PropertyGroup Condition$(Configuration)|$(Platform)Debug|AnyCPUOutputPath..\Build\Debug/OutputPath
/PropertyGroup
PropertyGroup Condition$(Configuration)|$(Platform)Release|AnyCPUOutputPath..\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;
四. 源码关于源码地址欢迎starhttps://github.com/dotnet9/TerminalMACS/tree/master/src/TerminalMACS.Manager/TerminalMACS.ManagerForWPF官方网站https://terminalmacs.com合作网站https://dotnet9.com四. 参考资料Prism Template PackPrism模板https://marketplace.visualstudio.com/items?itemNameBrianLagunas.PrismTemplatePackWPF国际化开源辅助库https://github.com/DingpingZhang/WpfExtensionsAccelerider.Windows子模块加载参考开源项目https://github.com/Accelerider/Accelerider.WindowsPrism-Samples-Wpf官方Demohttps://github.com/PrismLibrary/Prism-Samples-Wpf
