当前位置:主页 > 公司动态 >

安装包UI美化之路-nsNiuniuSkin多语言配置

浏览记录: 80次日期:2022-12-05

今天给大家带来的多语言配置功能,算是nsNiuniuSkin的一次质的提升,希望对大家有所帮助。

nsNiuniuSkin通过自研多语言配置引擎,让安装包的多语言配置不再复杂,直接设置语言翻译配置文件,即可实现安装包整体的多语言切换支持!

先来看一下英文版本的界面吧:

背景介绍

一直以来都说要提供安装包美化控件的多语言支持功能,但一直没有太多时间,即便如此,还是有很多朋友自己通过脚本的配置实现了多语言功能。

前几天认真看了一下网友们实现的语言功能,也亲自实验了一下,发现纯粹基于脚本的方案有几个缺点:

nsNiuniuSkin多语言实现原理

基于对这些缺点的考虑,我们认为这不是一个好的多语言方案。所以我立即着手对nsNiuniuSkin的多语言实现方案进行调研与实现,我们的目标是:在非特殊需求下,用户不需要手功的根据语言不同而调整脚本,而是将不同语言的配置全部放到配置文件中。

经过各种尝试,我们实现了这个目标,能够最大限度的节省安装包开发者在面对多语言时的开发工作量;为了减少在处理多语言时的人工介入,减少脚本的编写,我们参考了NSIS的多语言文件配置,结合nsNiuniuSkin新实现了一个多语言引擎,核心思路如下:

在实际使用中,只需要配置要翻译的语言文件,将相应语言下的[msgid]进行翻译,一键打包即可。

nsNiuniuSkin多语言配置方法

说了这么多,我们来看下实际配置流程,以下以我们的nsNiuniuSkin界面在线设计引擎的安装包为例来说明,只需要简单几步,即可完成:

  1. 在nsi文件中定义不同语言下的产品名称

    这个产品名称,是相对严谨的,后续翻译文本也将引用不同语言下的产品名称,需要谨慎的定义

    # ====================== 自定义宏 产品信息==============================
    !define PRODUCT_NAME           		"利洽科技截图控件"
    !define PRODUCT_NAME_EN           	"Leeqia ScreenCapture"
    
    
  2. 在lang_name.ini中配置当前有哪几种语言

    [lang_names]
    1033=English
    2052=简体中文
    

    我们基于语言的LanguageID来作为多语言中的标识KEY(比如简体中文是2052,英文是1033),与系统获取到的当前LanguageID匹配,此处我们只提供中文和英文的展示,如果有更多的语言类型,则添加相应的语言ID和对应的语言名称即可(不同语言的LanguageID在网上有很多资料,请自行查阅!)。

  3. 配置不同语言的消息翻译

    中文翻译文件(lang_msg_2052.ini)如下:

    [lang_msgs]
    msg.title=${PRODUCT_NAME}安装程序
    msg.productname=${PRODUCT_NAME} 
    msg.welcome=欢迎使用
    msg.install=快速安装
    msg.install_short=安装
    msg.cancel=取消
    msg.agree=我已阅读并同意
    msg.agree1=接受<c #0091FF>《用户许可协议》</c>
    msg.licence=《用户许可协议》
    msg.autostart=开机自动启动
    msg.createshortcut=添加桌面快捷方式
    msg.customize=自定义选项
    msg.browse=浏览
    msg.browsetitle=请选择安装路径
    msg.finish=完成
    msg.open=打开
    msg.installing=正在安装...
    msg.back = 返回
    msg.uninstall=卸载
    msg.uninstall_ex="卸载"
    msg.uninstalling=正在卸载...
    msg.welcomeback=感谢使用
    msg.spaceneed=所需空间:
    msg.spcaceleft=剩余空间:
    msg.illegalpath=路径非法
    msg.illegalpath1=路径非法,请使用正确的路径安装!
    msg.alreadyrunwarn=正在运行,请退出后重试!
    msg.spacenotenough=目标磁盘空间不足,请使用其他的磁盘安装!
    msg.downloading=正在下载安装包...
    msg.downloading1=正在下载安装包:
    msg.totalsize=总大小:
    msg.installnotfinish=安装尚未完成,您确定退出安装么?
    msg.uninstallnotfinish=卸载尚未完成,您确定退出卸载么?
    msg.notice=提示
    msg.readconfigfailed=读取配置文件失败
    msg.downloadfailed=下载失败
    msg.wrongdownloadsize=初始设定的安装包大小不正确
    msg.serverstatuserror=服务器状态错误:
    msg.ok=确定
    
    

    英文翻译文件(lang_msg_1033.ini)如下:

    [lang_msgs]
    msg.title=${PRODUCT_NAME_EN} Setup
    msg.productname=${PRODUCT_NAME_EN} 
    msg.welcome="Welcome to use "
    msg.install=Install
    msg.install_short=Install
    msg.cancel=Cancel
    msg.agree=I have agreed 
    msg.agree1=Accept<c #0091FF>《License Agreement》</c>
    msg.licence=《License Agreement》
    msg.autostart=Auto Start
    msg.createshortcut=Add Shortcut
    msg.customize=Customize
    msg.browse=Browse
    msg.browsetitle=Please select install path
    msg.finish=Finish
    msg.open=Open
    msg.installing=Installing...
    msg.back = Back
    msg.uninstall=Uninstall
    msg.uninstall_ex="Uninstall "
    msg.uninstalling=Uninstalling...
    msg.welcomeback="Thanks to use "
    msg.spaceneed=Space Required: 
    msg.spcaceleft=Space Left: 
    msg.illegalpath=Illegal Path
    msg.illegalpath1=Illegal path, please use the right path!
    msg.alreadyrunwarn=is running, please close and retry!
    msg.spacenotenough=Splace is not enough, please change to other Disk!
    msg.downloading=Downloading...
    msg.downloading1="Downloaded: "
    msg.totalsize="Total Size: "
    msg.installnotfinish=Install is not finished, quit now?
    msg.uninstallnotfinish=Uninstall is not finished, quit now?
    msg.notice=Notice
    msg.readconfigfailed=Read config failed
    msg.downloadfailed=download failed
    msg.wrongdownloadsize=package size invalid
    msg.serverstatuserror="server status error: "
    msg.ok=OK
    

    这里有几点要注意一下:

    • 在引用产品名称常量的地方,不同的语言需要引用不同的常量。

    • 如果有更多的语言类型,则添加相应的语言翻译文件,将消息ID对应的文字进行翻译出来即可。

    • 对于翻译的文字前后带空格的情况,需要用双引号包含起来

    • 在已经应用模板的前提下,有了前面三步已经足够,后面的步骤已经在模板中完成。

  4. 在脚本中将文本替换成使用消息ID

    在我们的模板脚本中,已经替换所有与显示文字相关的脚本,以下仅做示例:

    nsNiuniuSkin::SetControlAttribute $hInstallDlg "instinfo" "text" "[msg.productname]"
    
  5. 在界面配置文件的XML文件中,将文字固定的控件增加msgid属性,由引擎自动进行更新

    在我们的模板脚本中,已经替换所有与显示文字相关的脚本,以下仅做示例:

    <CheckBox name="chkAutoRun" width="95" font="0" msgid="msg.autostart" text="开机自动启动" />
    <CheckBox name="chkShotcut" padding="20,0,0,0" width="118" font="0" msgid="msg.createshortcut" text="添加桌面快捷方式" />
    

    按此设置后,相应控件上的文字将自动根据语言配置文件中对应的msgid的文字来进行显示,不需要人为设置。

  6. 使用新的打包引擎,直接进行打包,即可生成带多语言功能的安装包

    在生成过程中,我们会一些与语言设置的相关工作,比如:

    • 生成相应的展开常量宏后的不同语言下的文字,注入安装包引擎
    • 根据根据配置的语言数量,决定是否显示语言选择下拉框
    • 引擎自动识别选择的语言,设置相应控件文字属性

这里使用者不用再担心配置一种语言和两种以上语言时的UI处理差异,均由我们的多语言引擎自动处理,只有当配置了两种或两种语言以上时,我们才会显示语言选择下拉框。

整体操作过程是不是很简单呢? 卸载过程中,会自动识别安装时使用的语言,进而使用相应的语言包来显示卸载界面噢!

在不同语言切换时,实际上我们的nsis脚本需要处理的代码是很少的,主要是用于设置窗口的标题,重新设置许可协议等:要增加新的语言,也不再需要调整脚本,只需要添加新的语言,进行文字翻译即可了。

Function ResetUIByLanguage
   nsNiuniuSkin::GetCurrentLangId
   Pop $0
   nsNiuniuSkin::ResetLicenseFile $hInstallDlg "licence_$0.rtf"
   #通过插件得到当前真实的产品名称,后续写注册表,添加快捷方式等会要用到
   nsNiuniuSkin::TranslateMsg "[msg.productname]"
   Pop $PRODUCT_NAME
   nsNiuniuSkin::TranslateMsg "[msg.uninstall_ex]"
   Pop $UNINSTALL_NAME
   
   nsNiuniuSkin::AutoChangeControlTextByLanguage

   #设置一些在开始界面要修改的功能项 
   nsNiuniuSkin::SetControlAttribute $hInstallDlg "instinfo" "text" "[msg.productname]"
   nsNiuniuSkin::SetControlAttribute $hInstallDlg "welcomeinfo" "text" "[msg.welcome][msg.productname]"
   nsNiuniuSkin::SetControlAttribute $hInstallDlg "title" "text" "[msg.productname]"
   nsNiuniuSkin::SetWindowTitle $hInstallDlg "[msg.title]"
   
   Call ResetUIByLanguageEx
FunctionEnd

nsNiuniuSkin多语言安装包效果

根据上述配置,打出来的安装包效果如下:

安装界面,自动识别当前语言,同时支持切换不同的语言(轮播图未替换):

卸载界面,自动识别安装时使用的语言并加以应用:

您也可以直接安装nsNiuniuSkin界面在线设计引擎来实际看看效果:

http://www.leeqia.com/download/NSNiuniuSKin_DuiDesigner_Setup.exe

结语

在安装包安装过程中,精美的UI往往能让客户对所安装产品的印象更加深刻,更能体现出软件服务商在用户体验上的专注与用心! 希望我们的努力,能够让安装包制作再容易一点,再快乐一点!

愿天下没有难做的安装包!

Copyright © 2015 - 2023 深圳市利洽科技有限公司 All Rights Reserved 粤ICP备15043258号-2