二.简单的NSIS安装包

新建脚本&＃xff1a;向导

我们先从一个简单的NSIS安装包开始吧&＃xff0c;就像前面&＃xff08;NSIS介绍&＃xff09;所说&＃xff0c;我们虽然看过用户手册&＃xff0c;可要写安装脚本无从下手&＃xff0c;那我们的编辑工具HM NIS Edit就派上用场了。

打开HM NIS Edit&＃xff0c;点击菜单“文件”->“新建脚本&＃xff1a;向导”&＃xff0c;会有向导一步步让我们输入信息&＃xff0c;最后根据我们的输入生成.nsi脚本文件&＃xff0c;下面我们一步步演示&＃xff1a;

新建脚本&＃xff1a;脚本文件

最后生成的脚本文件我们保存为MyApp.nsi&＃xff0c;打开查看脚本&＃xff08;对照着上面截图中设置的项再配合用户手册查看&＃xff0c;你会知道一个完整的脚本文件的基本结构和基本的指令用法&＃xff09;

; Script generated by the HM NIS Edit Script Wizard.; HM NIS Edit Wizard helper defines
!define PRODUCT_NAME "My application"
!define PRODUCT_VERSION "1.0"
!define PRODUCT_PUBLISHER "My company, Inc."
!define PRODUCT_WEB_SITE "http://www.mycompany.com"
!define PRODUCT_UNINST_KEY "Software\Microsoft\Windows\CurrentVersion\Uninstall\${PRODUCT_NAME}"
!define PRODUCT_UNINST_ROOT_KEY "HKLM"; MUI 1.67 compatible ------
!include "MUI.nsh"; MUI Settings
!define MUI_ABORTWARNING
!define MUI_ICON "${NSISDIR}\Contrib\Graphics\Icons\modern-install.ico"
!define MUI_UNICON "${NSISDIR}\Contrib\Graphics\Icons\modern-uninstall.ico"; Welcome page
!insertmacro MUI_PAGE_WELCOME
; License page
!insertmacro MUI_PAGE_LICENSE "E:\ZZL\ADWeb\安装包制作\Licence.txt"
; Directory page
!insertmacro MUI_PAGE_DIRECTORY
; Instfiles page
!insertmacro MUI_PAGE_INSTFILES
; Finish page
!insertmacro MUI_PAGE_FINISH; Uninstaller pages
!insertmacro MUI_UNPAGE_INSTFILES; Language files
!insertmacro MUI_LANGUAGE "SimpChinese"; MUI end ------Name "${PRODUCT_NAME} ${PRODUCT_VERSION}"
OutFile "Setup.exe"
InstallDir "$PROGRAMFILES\My application"
ShowInstDetails show
ShowUnInstDetails showSection "MainSection" SEC01SetOutPath "$INSTDIR"SetOverwrite tryFile "E:\ZZL\ADWeb\安装包制作\Release\404.aspx"File "E:\ZZL\ADWeb\安装包制作\Release\Default.aspx"File "E:\ZZL\ADWeb\安装包制作\Release\Error.aspx"SetOutPath "$INSTDIR\Images"File "E:\ZZL\ADWeb\安装包制作\Release\Images\1_close.png"File "E:\ZZL\ADWeb\安装包制作\Release\Images\1_open.png"File "E:\ZZL\ADWeb\安装包制作\Release\Images\add.png"SetOutPath "$INSTDIR\Scripts"File "E:\ZZL\ADWeb\安装包制作\Release\Scripts\CommonScript.js"SetOutPath "$INSTDIR\SystemLog"File "E:\ZZL\ADWeb\安装包制作\Release\SystemLog\LogStatisticsDetail.aspx"File "E:\ZZL\ADWeb\安装包制作\Release\SystemLog\SystemLogList.aspx"File "E:\ZZL\ADWeb\安装包制作\Release\SystemLog\SystemLogStatistics.aspx"SetOutPath "$INSTDIR"File "E:\ZZL\ADWeb\安装包制作\Release\Web.config"
SectionEndSection -PostWriteUninstaller "$INSTDIR\uninst.exe"WriteRegStr ${PRODUCT_UNINST_ROOT_KEY} "${PRODUCT_UNINST_KEY}" "DisplayName" "$(^Name)"WriteRegStr ${PRODUCT_UNINST_ROOT_KEY} "${PRODUCT_UNINST_KEY}" "UninstallString" "$INSTDIR\uninst.exe"WriteRegStr ${PRODUCT_UNINST_ROOT_KEY} "${PRODUCT_UNINST_KEY}" "DisplayVersion" "${PRODUCT_VERSION}"WriteRegStr ${PRODUCT_UNINST_ROOT_KEY} "${PRODUCT_UNINST_KEY}" "URLInfoAbout" "${PRODUCT_WEB_SITE}"WriteRegStr ${PRODUCT_UNINST_ROOT_KEY} "${PRODUCT_UNINST_KEY}" "Publisher" "${PRODUCT_PUBLISHER}"
SectionEndFunction un.onUninstSuccessHideWindowMessageBox MB_ICONINFORMATION|MB_OK "$(^Name) 已成功地从你的计算机移除。"
FunctionEndFunction un.onInitMessageBox MB_ICONQUESTION|MB_YESNO|MB_DEFBUTTON2 "你确实要完全移除 $(^Name) &＃xff0c;其及所有的组件&＃xff1f;" IDYES &＃43;2Abort
FunctionEndSection UninstallDelete "$INSTDIR\uninst.exe"Delete "$INSTDIR\Web.config"Delete "$INSTDIR\SystemLog\SystemLogStatistics.aspx"Delete "$INSTDIR\SystemLog\SystemLogList.aspx"Delete "$INSTDIR\SystemLog\LogStatisticsDetail.aspx"Delete "$INSTDIR\Scripts\CommonScript.js"Delete "$INSTDIR\Images\add.png"Delete "$INSTDIR\Images\1_open.png"Delete "$INSTDIR\Images\1_close.png"Delete "$INSTDIR\Error.aspx"Delete "$INSTDIR\Default.aspx"Delete "$INSTDIR\404.aspx"RMDir "$INSTDIR\SystemLog"RMDir "$INSTDIR\Scripts"RMDir "$INSTDIR\Images"RMDir "$INSTDIR"DeleteRegKey ${PRODUCT_UNINST_ROOT_KEY} "${PRODUCT_UNINST_KEY}"SetAutoClose true
SectionEnd

值得注意的是&＃xff0c;从新建脚本向导的第三步有选项用户图形界面我们默认选择的是“现代”&＃xff0c;对应脚本中引入了NSIS现代用户界面头文件&＃xff08;!include "MUI.nsh"&＃xff09;&＃xff0c;对应的安装页面中都是以!insertmacro MUI_PAGE_***开头&＃xff08;如&＃xff1a;欢迎页面!insertmacro MUI_PAGE_WELCOME&＃xff09;&＃xff0c;详细的说明请查看NSIS Modern User Interface。

安装包&＃xff1a;现代界面

下面我们看下安装包的效果&＃xff0c;在HM NIS Edit界面&＃xff0c;点击菜单“NSIS”->“编译并运行”&＃xff0c;输出窗口会显示编译过程&＃xff0c;如果没有出错&＃xff0c;会直接执行编译生成的Setup.exe&＃xff0c;安装截图如下&＃xff1a;

从上面截图可以看到我们的安装包共有5个用户界面&＃xff0c;这个和脚本文件中是对应的&＃xff1a;

; Welcome page
!insertmacro MUI_PAGE_WELCOME
; License page
!insertmacro MUI_PAGE_LICENSE "E:\ZZL\ADWeb\安装包制作\Licence.txt"
; Directory page
!insertmacro MUI_PAGE_DIRECTORY
; Instfiles page
!insertmacro MUI_PAGE_INSTFILES
; Finish page
!insertmacro MUI_PAGE_FINISH

其中“安装记录页面”将实际执行安装区段中的指令&＃xff0c;这些指令可以解压文件读取&＃xff0c;读写注册表、INI文件或普通文件&＃xff0c;执行Powershell脚本&＃xff0c;创建目录&＃xff0c;创建快捷方式等等。如果一个安装程序有多个组件&＃xff0c;每个组件都有它自己的代码块&＃xff0c;当用户选择了安装该组件&＃xff0c;那么安装程序就会执行对应的代码&＃xff0c;那么每个组件就需要对应一个区段&＃xff0c;具体关于可选组件的信息会在以后章节介绍。我们目前只有一个安装区段&＃xff0c;是把部署包文件放入安装目录&＃xff1a;

Section "MainSection" SEC01SetOutPath "$INSTDIR"SetOverwrite tryFile "E:\ZZL\ADWeb\安装包制作\Release\404.aspx"File "E:\ZZL\ADWeb\安装包制作\Release\Default.aspx"File "E:\ZZL\ADWeb\安装包制作\Release\Error.aspx"SetOutPath "$INSTDIR\Images"File "E:\ZZL\ADWeb\安装包制作\Release\Images\1_close.png"File "E:\ZZL\ADWeb\安装包制作\Release\Images\1_open.png"File "E:\ZZL\ADWeb\安装包制作\Release\Images\add.png"Sleep 20000SetOutPath "$INSTDIR\Scripts"File "E:\ZZL\ADWeb\安装包制作\Release\Scripts\CommonScript.js"SetOutPath "$INSTDIR\SystemLog"File "E:\ZZL\ADWeb\安装包制作\Release\SystemLog\LogStatisticsDetail.aspx"File "E:\ZZL\ADWeb\安装包制作\Release\SystemLog\SystemLogList.aspx"File "E:\ZZL\ADWeb\安装包制作\Release\SystemLog\SystemLogStatistics.aspx"SetOutPath "$INSTDIR"File "E:\ZZL\ADWeb\安装包制作\Release\Web.config"
SectionEnd

关于界面上的信息都是我们在脚本向导中设置的&＃xff08;如应用程序名称、版本、公司、图标、授权信息、语言等&＃xff09;&＃xff0c;可以在脚本中修改&＃xff1a;

; HM NIS Edit Wizard helper defines
!define PRODUCT_NAME "My application"
!define PRODUCT_VERSION "1.0"
!define PRODUCT_PUBLISHER "My company, Inc."
!define PRODUCT_WEB_SITE "http://www.mycompany.com"
!define PRODUCT_UNINST_KEY "Software\Microsoft\Windows\CurrentVersion\Uninstall\${PRODUCT_NAME}"
!define PRODUCT_UNINST_ROOT_KEY "HKLM"; MUI 1.67 compatible ------
!include "MUI.nsh"; MUI Settings
!define MUI_ABORTWARNING
!define MUI_ICON "${NSISDIR}\Contrib\Graphics\Icons\modern-install.ico"
!define MUI_UNICON "${NSISDIR}\Contrib\Graphics\Icons\modern-uninstall.ico"

还有一些是关于安装包本身的信息&＃xff08;如&＃xff1a;名称、默认安装路径、生成安装包名称、是否显示安装详情等&＃xff09;&＃xff1a;

Name "${PRODUCT_NAME} ${PRODUCT_VERSION}"
OutFile "Setup.exe"
InstallDir "$PROGRAMFILES\ADWebManager"
InstallDirRegKey HKLM "${PRODUCT_DIR_REGKEY}" ""
ShowInstDetails show
ShowUnInstDetails show
BrandingText "　MyCompany Ltd."

其中注意加一行命令BrandingText "　Prolliance Ltd."&＃xff0c;这样用户安装界面中就不是NSIS的信息了&＃xff0c;前后对比如下&＃xff1a;

修改脚本&＃xff1a;标准界面

上面我们使用HM NIS Edit的向导创建了具有“现代界面”的安装包&＃xff0c;其中脚本文件中引入了NSIS现代用户界面头文件&＃xff08;!include "MUI.nsh"&＃xff09;&＃xff0c;现在我们不要引入额外的头文件&＃xff0c;改成NSIS标准的界面试试&＃xff0c;就像我们查看用户手册看到的&＃xff0c;我们可以通过Page命令&＃xff08;或更多高级设置如PageEx&＃xff09;。我们修改后的脚本文件如下&＃xff1a;

; Script generated by the HM NIS Edit Script Wizard.; HM NIS Edit Wizard helper defines
!define PRODUCT_NAME "My application"
!define PRODUCT_VERSION "1.0"
!define PRODUCT_PUBLISHER "My company, Inc."
!define PRODUCT_WEB_SITE "http://www.mycompany.com"
!define PRODUCT_UNINST_KEY "Software\Microsoft\Windows\CurrentVersion\Uninstall\${PRODUCT_NAME}"
!define PRODUCT_UNINST_ROOT_KEY "HKLM"; pages
PageEx licenseLicenseText "许可页面"LicenseData "E:\ZZL\ADWeb\安装包制作\Licence.txt";LicenseForceSelection
PageExEnd
PageEx directoryDirText "目录选择页面" "目标文件夹" "浏览..."
PageExEnd
Page instfiles
UninstPage uninstConfirm
UninstPage instfiles; MUI end ------Name "${PRODUCT_NAME} ${PRODUCT_VERSION}"
OutFile "Setup.exe"
InstallDir "$PROGRAMFILES\My application"
ShowInstDetails show
ShowUnInstDetails show
BrandingText "　MyCompany Ltd."Section "MainSection" SEC01SetOutPath "$INSTDIR"SetOverwrite tryFile "E:\ZZL\ADWeb\安装包制作\Release\404.aspx"File "E:\ZZL\ADWeb\安装包制作\Release\Default.aspx"File "E:\ZZL\ADWeb\安装包制作\Release\Error.aspx"SetOutPath "$INSTDIR\Images"File "E:\ZZL\ADWeb\安装包制作\Release\Images\1_close.png"File "E:\ZZL\ADWeb\安装包制作\Release\Images\1_open.png"File "E:\ZZL\ADWeb\安装包制作\Release\Images\add.png"Sleep 20000SetOutPath "$INSTDIR\Scripts"File "E:\ZZL\ADWeb\安装包制作\Release\Scripts\CommonScript.js"SetOutPath "$INSTDIR\SystemLog"File "E:\ZZL\ADWeb\安装包制作\Release\SystemLog\LogStatisticsDetail.aspx"File "E:\ZZL\ADWeb\安装包制作\Release\SystemLog\SystemLogList.aspx"File "E:\ZZL\ADWeb\安装包制作\Release\SystemLog\SystemLogStatistics.aspx"SetOutPath "$INSTDIR"
SectionEndSection -PostWriteUninstaller "$INSTDIR\uninst.exe"WriteRegStr ${PRODUCT_UNINST_ROOT_KEY} "${PRODUCT_UNINST_KEY}" "DisplayName" "$(^Name)"WriteRegStr ${PRODUCT_UNINST_ROOT_KEY} "${PRODUCT_UNINST_KEY}" "UninstallString" "$INSTDIR\uninst.exe"WriteRegStr ${PRODUCT_UNINST_ROOT_KEY} "${PRODUCT_UNINST_KEY}" "DisplayVersion" "${PRODUCT_VERSION}"WriteRegStr ${PRODUCT_UNINST_ROOT_KEY} "${PRODUCT_UNINST_KEY}" "URLInfoAbout" "${PRODUCT_WEB_SITE}"WriteRegStr ${PRODUCT_UNINST_ROOT_KEY} "${PRODUCT_UNINST_KEY}" "Publisher" "${PRODUCT_PUBLISHER}"
SectionEndFunction un.onUninstSuccessHideWindowMessageBox MB_ICONINFORMATION|MB_OK "$(^Name) 已成功地从你的计算机移除。"
FunctionEndFunction un.onInitMessageBox MB_ICONQUESTION|MB_YESNO|MB_DEFBUTTON2 "你确实要完全移除 $(^Name) &＃xff0c;其及所有的组件&＃xff1f;" IDYES &＃43;2Abort
FunctionEndSection UninstallDelete "$INSTDIR\uninst.exe"Delete "$INSTDIR\Web.config"Delete "$INSTDIR\SystemLog\SystemLogStatistics.aspx"Delete "$INSTDIR\SystemLog\SystemLogList.aspx"Delete "$INSTDIR\SystemLog\LogStatisticsDetail.aspx"Delete "$INSTDIR\Scripts\CommonScript.js"Delete "$INSTDIR\Images\add.png"Delete "$INSTDIR\Images\1_open.png"Delete "$INSTDIR\Images\1_close.png"Delete "$INSTDIR\Error.aspx"Delete "$INSTDIR\Default.aspx"Delete "$INSTDIR\404.aspx"RMDir "$INSTDIR\SystemLog"RMDir "$INSTDIR\Scripts"RMDir "$INSTDIR\Images"RMDir "$INSTDIR"DeleteRegKey ${PRODUCT_UNINST_ROOT_KEY} "${PRODUCT_UNINST_KEY}"SetAutoClose true
SectionEnd

安装包&＃xff1a;标准界面

下面我们看下标准界面的脚本生成的安装包效果&＃xff0c;执行后在HM NIS Edit界面&＃xff0c;点击菜单“NSIS”->“编译并运行”&＃xff0c;输出窗口会显示编译过程&＃xff0c;如果没有出错&＃xff0c;会直接执行编译生成的Setup.exe&＃xff0c;安装截图如下&＃xff1a;

是不是比较起来“现代用户界面”&＃xff0c;标准的界面会很丑&＃xff0c;而且NSIS内置的标准安装界面没有欢迎、完成界面&＃xff08;只有许可、目录选择、组件、安装记录页面&＃xff09; &＃xff0c;另外“上一步”、“下一步”、“取消”等按钮需要额外的语言包文件来载入&＃xff0c;不如“现代用户界面”只需要一个指令&＃xff08;!insertmacro MUI_LANGUAGE "SimpChinese"&＃xff09;来指定采用的语言&＃xff0c;所以接下来我们还是采用“现代用户界面”来制作安装包&＃xff0c;当然这些界面上的图标&＃xff0c;任何地方的文字都是可以定制的。

下面章节就以实际中的应用作为例子&＃xff0c;然后由该例子展开来说明页面的定制、PowerShell命令的调用、SQL Server数据库的访问、Web应用程序的部署、失败的回滚和卸载程序的执行等等。