分享两种实现Winform程序的多语言支持的解决方案
在国际化环境下,越来越多的程序需要做多语言版本,以适应各种业务需求的变化。在Winform应用程序中实现多语言也有常规的处理方式处理,不过需要针对每个语言版本,重新修改Winform界面的显示,对一些常规的辅助类,也需要引入一个统一的资源管理类来处理多语言的问题,相对比较繁琐。本篇随笔针对多语言的需求,希望尽量避免繁琐的操作,既能符合本地语种开发人员的开发习惯,又能快速实现Winform程序的多语言场景处理。
1、多语言开发的困惑和思路
在常规的多语言版本程序中,开发总是伴随着很多不愉快的事情,大概列举一些仅供参考:
1)对窗体的多语言处理时,维护多个语言版本的界面非常繁琐;
2)多语言处理的时候,以资源参照的时候,默认键值为一些英文字符串或者单词,不太符合如中文语境的开发,调整代码则需要很多工作量;
3)对于已开发好的程序,全面引入多语言的处理代码,需要大量修改;
4)对于大量中文的多语言处理,工作量望而却步;
5)对于常规Resx文件的处理觉得繁琐
6)缺乏一个统一处理多语言需求的方案
在多语言的处理上,我一直希望找出一种高效的处理方式,由于我的Winform开发框架中很多模块是现成的,希望能够使用继承处理的方式,实现最简化的处理;
同时大量中文的英文(针对英文版本)翻译也是一个头痛的事情,突然想到百度的翻译API接口可以利用,那么我们可以利用翻译接口实现开始的翻译,然后对资源进行一定的调整则可以提高效率和准确率。
对于编辑和承载多语言的信息,我一直觉得JSON格式挺好的,可以利用它序列化为字典集合,通过字典获取对应键值的多语言版本字符串也是很高效的一种方式,那么就决定用JSON来存储多语言信息了,易读好用。
对于多余的处理逻辑,尽量封装为独立的模块,可以在多个模块中进行调用处理。
2、多语言的处理实现
在思考多语言的合理处理方案过程中,参考了另一位博友的文章《)。
有了这些准备后,就可以利用C#代码进行翻译处理了。
百度翻译的接口处理代码如下所示。
/// <summary> /// 百度接口翻译 /// </summary> /// <param name="inputString">输入字符串</param> /// <param name="from">源内容语言</param> /// <param name="to">目标语言</param> /// <returns></returns> private static string BaiduTranslate(string inputString, string from = "zh", string to = "en") { string content = ""; string appId = "你的APPID"; string securityId = "你的秘钥"; int salt = 0; StringBuilder signString = new StringBuilder(); string md5Result = string.Empty; //1.拼接字符,为了生成sign signString.Append(appId); signString.Append(inputString); signString.Append(salt); signString.Append(securityId); //2.通过md5获取sign byte[] sourceMd5Byte = Encoding.UTF8.GetBytes(signString.ToString()); MD5 md5 = new MD5CryptoServiceProvider(); byte[] destMd5Byte = md5.ComputeHash(sourceMd5Byte); md5Result = BitConverter.ToString(destMd5Byte).Replace("-", ""); md5Result = md5Result.ToLower(); try { //3.获取web翻译的json结果 WebClient client = new WebClient(); string url = string.Format("http://api.fanyi.baidu.com/api/trans/vip/translate?q={0}&from=zh&to=en&appid={1}&salt={2}&sign={3}", inputString, appId, salt, md5Result); byte[] buffer = client.DownloadData(url); string result = Encoding.UTF8.GetString(buffer); var trans = JsonConvert.DeserializeObject<TranslationJson>(result); if (trans != null) { content = trans.trans_result[0].dst; content = StringUtil.ToProperCase(content); } } catch(Exception ex) { Debug.WriteLine(ex); } return content; }
其中把JSON转换为类对象需要两个类,对翻译结果进行转换,如下代码所示。
internal class TranslationJson { public string from { get; set; } public string to { get; set; } public List<TranslationResult> trans_result { get; set; } } internal class TranslationResult { public string src { get; set; } public string dst { get; set; } }
这样我们在多语言处理的时候,可以对默认输入为空的键值进行翻译即可(如英文翻译)。
//遍历集合进行翻译 var value = dict[key]; if (string.IsNullOrWhiteSpace(value)) { //如果值为空,那么调用翻译接口处理 var newValue = TranslationHelper.Translate(key, from, to); if (!string.IsNullOrWhiteSpace(newValue)) { dict[key] = newValue; } }
然后重新更新我们的资源文件就可以了
//不排序 var newContent = JsonConvert.SerializeObject(dict, Formatting.Indented); File.WriteAllText(file, newContent, Encoding.UTF8);
如果需要对键值进行排序,那么使用SortDictionary进行包装下即可
//进行排序 SortedDictionary<string, string> sortedDict = new SortedDictionary<string, string>(dict); var newContent = JsonConvert.SerializeObject(sortedDict, Formatting.Indented);
在多语言处理的时候,我们一般不必要一次填写完毕中英文对照的资源,我们可以先把字典键值的键写出来,值保留为空,如下文件所示。
运行程序的时候,让翻译的接口先行翻译,然后我们再对翻译的资源进行调整,适应我们程序的语境即可,翻译后的内容后如下所示。
好了,弹药都准备好了,就看我们如何使用, 下一步介绍如何使用这些资源。
3、多语言在界面中的应用
前面介绍都是为程序界面准备好对应的多语言资源内容,我们在程序启动的时候,可以通过常规的方式,设置界面的CurrentUICulture区域信息,如下代码所示。
//界面多语言 //System.Threading.Thread.CurrentThread.CurrentUICulture = new System.Globalization.CultureInfo("zh-Hans");//中文界面 System.Threading.Thread.CurrentThread.CurrentUICulture = new System.Globalization.CultureInfo("en-US");//英文界面
然后我们在Winform程序中开发设计我们的界面内容,例如设计一个普通的界面如下所示。
这个窗体我们添加了几个按钮,并设置它的中文显示内容,它的基类默认还是保持它的DevExpress基类 XtraForm,如下所示。
/// <summary> /// 测试多语言的窗体界面 /// </summary> public partial class Form1 : XtraForm
那么我们如果要自动实现多语言的处理,那么还需要在窗体的Load或者Shown事件里面实现处理,如下代码所示。
private void Form1_Shown(object sender, EventArgs e) { //窗体加载并显示后,对窗体实现多语言处理 if (!this.DesignMode) { LanguageHelper.InitLanguage(this); } }
如果我们为每个窗体都需要添加这些代码,也是繁琐的事情,那么我们可以把这个处理逻辑,放到我们常规自定义的窗体基类里面(如BaseForm),那么我们就不需要任何额外的代码了。
所需的就是集成窗体基类即可,这也是我们一般开发都做的事情,通过继承使得我们的代码又省去了。
/// <summary> /// 测试多语言的窗体界面 /// </summary> public partial class Form1 : BaseForm
那么我们真正关注的就是我们前面介绍的逻辑代码实现了
LanguageHelper.InitLanguage(this);
这个辅助类,主要就是在窗体初始化后,遍历界面的所有类型控件,对控件进行相应的多语言处理。
/// <summary> /// 对界面控件进行多语言的处理辅助类 /// </summary> public class LanguageHelper { /// <summary> /// 初始化语言 /// </summary> public static void InitLanguage(Control control) { //如果没有资源,那么不必遍历控件,提高速度 if (!JsonLanguage.Default.HasResource) return; //使用递归的方式对控件及其子控件进行处理 SetControlLanguage(control); foreach (Control ctrl in control.Controls) { InitLanguage(ctrl); } //工具栏或者菜单动态构建窗体或者控件的时候,重新对子控件进行处理 control.ControlAdded += (sender, e) => { InitLanguage(e.Control); }; }
通过递归的方式,我们可以对常规的如GridControl,工具栏、NavBar导航栏、菜单、按钮等资源进行统一的多语言处理,而这里面对于我们开发应用程序界面,都不需要额外的担心,极大的提高了效率。
下面是几个常规的界面,我们来体验下英文版本的界面效果。
这些英文界面我们只需要把界面的中文提取出来放到JSON文件中,自动翻译再调整即可,然后界面继承保持BaseForm或者BaseDock这些窗体基类不变,只是调整了这些基类的加载,增加一行代码就可以顺利实现了多语言的效果了。
这样我们就把核心的工作放在提取界面中的中文资源并进行整理即可,这是核心的工作但翻译也基本不用自己从头做,窗体代码几乎不需要做其他修改就实现了我们所需要的多语言效果了,这样做极大提高了开发效率,对于我们已经开发好的模块,更是四两拨千斤了。