NSIS多语言
NSIS官方手册多语言介绍
作为 2 版本的 NSIS 已经完全支持了多语言。一个安装程序的界面可以支持多语言。
对所有的语言使用 LoadLanguageFile 来载入默认的界面文本和语言属性。
默认的界面文本可以很容易的使用指令比如 ComponentText 等来更改。
你也可以在你自己的字串里使用标准语言字串的内容 (例如，$(^Name) 包含了 Name 指令设置的安装程序名称)。所有标准语言字串的名称作为注释列表于语言文件字串的上方。 语言文件在 Contrib\Language Files。
要建立你自己的语言字串，请使用 LangString。
使用多语言的一个安装程序例子，请看 languages.nsi。4.10.1 语言的选择
当安装程序启动时按如下步骤选择界面语言:
-
获取用户的默认 Windows 语言
-
查找一个最佳匹配的语言
-
如果没有最佳匹配的，则查找第一个匹配的语言
-
如果没有匹配的，使用脚本里定义的第一个语言 (确认你的第一个语言是一个通用的语言，比如英语)
-
如果语言变量 $LANGUAGE 在 .onInit 被更改，NSIS 将重新进行步骤 2 到 4。
多语言的使用
一 载入默认的界面文本和语言属性
NSIS有两种引入多语言的方法，其中：
- 使用缺省模式，引入代码如下
LoadLanguageFile "${NSISDIR}\Contrib\Language files\Czech.nlf" LoadLanguageFile "${NSISDIR}\Contrib\Language files\Dutch.nlf" LoadLanguageFile "${NSISDIR}\Contrib\Language files\French.nlf" LoadLanguageFile "${NSISDIR}\Contrib\Language files\German.nlf" LoadLanguageFile "${NSISDIR}\Contrib\Language files\Korean.nlf" LoadLanguageFile "${NSISDIR}\Contrib\Language files\Russian.nlf" LoadLanguageFile "${NSISDIR}\Contrib\Language files\Spanish.nlf" LoadLanguageFile "${NSISDIR}\Contrib\Language files\Swedish.nlf" LoadLanguageFile "${NSISDIR}\Contrib\Language files\TradChinese.nlf" LoadLanguageFile "${NSISDIR}\Contrib\Language files\SimpChinese.nlf" LoadLanguageFile "${NSISDIR}\Contrib\Language files\Slovak.nlf"
-
使用现代化界面，引入代码如下：
!include "MUI2.nsh" !insertmacro MUI_LANGUAGE "English" !insertmacro MUI_LANGUAGE "Czech" !insertmacro MUI_LANGUAGE "Dutch" !insertmacro MUI_LANGUAGE "French" !insertmacro MUI_LANGUAGE "Korean" !insertmacro MUI_LANGUAGE "Russian" !insertmacro MUI_LANGUAGE "SimpChinese" !insertmacro MUI_LANGUAGE "Slovak"
二、 提供语言选择对话框
多语言引入后，NSIS安装包是默认根据window系统本地语言环境选择最匹配语言，如果找不到，展示声明的第一种语言。
但是有时候需要提供一个多语言对话框（个人感觉多余），多语言对话框可以在安装程序加载时展示，代码如下：
!insertmacro MUI_LANGUAGE "English" !insertmacro MUI_LANGUAGE "SimpChinese" ;初始化函数 Function .onInit Push "" Push ${LANG_ENGLISH} ;添加英文代码 语言代码是系统变量，多语言引入后，自动加载，拼接方式是“LANG_语言”,可以查看NSIS手册，LANG_ENGLISH的编号为1033，LANG_SIMPCHINESE为2052； Push "English" Push ${LANG_SIMPCHINESE} ;添加简体中文选项 Push "简体中文" Push A ; A means auto count languages for the auto count to work the first empty push (Push "") must remain LangDLL::LangDialog "Installer Language" "Please select the language of the installer" ;显示语言选择对话框 Pop $LANGUAGE ;获得用户对于语言的选择结果 ‘$LANGUAGE’是多语言变量，在安装程序结束后，语言代码会存储在这个变量中，手动修改‘$LANGUAGE’的值后，安装包会重新选择最匹配的语言，参考最上面NSIS手册中选择界面语言步骤 StrCmp $LANGUAGE "cancel" 0 +2 Abort StrCmp $LANGUAGE 2052 ZH_INI EN_INI EN_INI: ;想干啥干啥 Goto END ZH_INI: ;想干啥干啥 END: FunctionEnd
三、 在其他函数中使用多语言
在'.onInit'和“un.onInit”函数中，由于程序处于初始化阶段，是没有多语言环境的，需要手动处理，“手动处理”的方法会在卸载程序多语言设置小节中介绍；程序初始化完成后，在其他函数和界面中，像证书展示界面、一些提示对话框中，可以使用多语言特性，让程序在不同语言环境下载，展示对应语言的信息。
下面依据一个自定义函数中的多语言界面说明文字，介绍如何操作；
（1）声明自定义字符串
可以使用LangString关键词声明多语言字符串
LangString INFO1 ${LANG_ENGLISH} " Prompt message 1"
LangString INFO1 ${LANG_SIMPCHINESE} "提示信息1。
LangString INFO2 ${LANG_ENGLISH} " Prompt message 2"
LangString INFO2 ${LANG_SIMPCHINESE} "提示信息2"。
（2）自定义函数中引入多语言提示词
Function CustomPageInitFunc InstallOptions::initDialog /NOUNLOAD "$PLUGINSDIR\dialog.ini" ;载入界面UI文件 !insertmacro MUI_HEADER_TEXT $(INFO1) $(INFO2) ;自定义界面说明文字，此处引用的 ‘$(INFO1)‘，‘$(INFO2)’是定义的多语言字符串 Pop $hwnd InstallOptions::show ;显示界面 Pop $0 Goto end FunctionEnd
上面引入的$(INFO1)，不同于变量引用，需要使用'$()',而不是'${}'
这是引用多语言字符串，NSIS支持多语言文件（LoadLanguageFile）、多语言字符串（LangString）、许可证书多语言等方式（LicenseLangString），可以参考官方手册。
四、卸载程序多语言
卸载程序如果不手动修改'$LANGUAGE '的值，默认根据windows系统语言展示提示信息，但是有很多希望手动控制，可以采用的策略是，在安装时，将用户选择的语言标识存储注册表中，待卸载时，读取注册表中语言标识，赋值给‘$LANGUAGE’，这样就可以在‘Section Uninstall’、“Function un.onUninstSuccess”中引用多语言字符串，但是在“un.onInit”中只能手动判断，不能使用NSIS自带的多语言机制，因为程序还没初始化成功。
（1）程序安装时保存语言标志到注册表
;初始化函数 Function .onInit ；内容见第二小节（二、 提供语言选择对话框） FunctionEnd Section -Post WriteRegStr HKCU ${LANGUAG_FLAG} "language" $LANGUAGE ;保存软件安装时选择的语言 ${LANGUAG_FLAG}是自定义的一个标识字段，可以为任意值 SectionEnd
（2）卸载程序初始化时，获取语言标志，并手动处理多语言
Function un.onInit ReadRegDWORD $LANGUAGE HKCU ${LANGUAG_FLAG} "language" ; 读取注册表获取程序安装时设置的语言 StrCmp $LANGUAGE ${LANG_SIMPCHINESE} ZH EN ; 在un.onInit函数中，多语言只能手动处理 EN: MessageBox MB_ICONQUESTION|MB_YESNO|MB_DEFBUTTON2 "Are you sure you want to completely remove $(^Name)?" IDYES +2 Abort Goto End ZH: MessageBox MB_ICONQUESTION|MB_YESNO|MB_DEFBUTTON2 "你确实要完全移除 $(^Name)?" IDYES +2 Abort Goto End End: FunctionEnd
（3）卸载过程中使用多语言字符串
Section Uninstall ; 检测程序是否在运行 FindProcDLL::FindProc "${PRODUCT_NAME}.exe" ;检测主程序 IntCmp $R0 1 0 +3 MessageBox MB_ICONSTOP "$(^Name) $(EXE_RUNNING_WARN)" ;此处的$(EXE_RUNNING_WARN)是声明的多语言字符串，声明方法见（第三节 在其他函数中使用多语言-> 声明自定义字符串） Quit ; 做些卸载程序的工作 SectionEnd
附件：NSIS官方中文手册
