nisi安装包打印日志语法_NSIS 打包脚本基础

简介

NSIS(Nullsoft Scriptable Install System)是一个开源的Windows系统下安装程序制作程序。它提供了安装、卸载、系统设置、文件解压缩等功能。这如其名字所指出的那样，NSIS是通过它的脚本语言来描述安装程序的行为和逻辑的。NSIS的脚本语言和通常的编程语言有类似的结构和语法，但它是为安装程序这类应用所设计的。

工具：

HW VNISEdit(NSIS脚本编辑器)

1、使用编辑器中NSIS脚本向导功能，自动生成对应的nsi脚本。

点击文件->新建脚本：向导，接下来根据向导页面的设置选项一步步设置你需要的安装条件。

2、也可以在编辑器中编写nsi脚本，然后再编译生成exe安装包文件。

脚本结构

NSIS脚本(下称nsi脚本)主要包含安装程序属性、页面、区段、函数。

属性

用来定义安装程序的行为和界面风格，这些属性大部分是编译时刻属性，即不能在运行时刻改变。

页面

安装程序的向导页面

例：

Page license

Page components

Page directory

Page instfiles

UninstPage uninstConfirm

UninstPage instfiles

区段

是对应某种安装/卸载选项的处理逻辑，该段代码仅当用户选择相应的选项才被执行。卸载程序的区段名用"un."作为前缀。

例：

Section "Installer Section"

SectionEnd

Section "un.Uninstaller Section"

SectionEnd

区段名的修饰符/o表示该区段默认不选上，-表示隐藏区段(匿名区段也是隐藏区段)，！表示需要粗体显示的区段。

SectionIn表示该区段和安装类型之间的关系

SubSection表示子区段

SectionIn insttype_index [insttype_index] ... [RO]

;RO修饰符表示不可修改。

SubSection [/e] Caption [subsection_name index output]

;修饰符/e用于该子区段的所有区段是否默认展开。

函数

包含了模块化的安装逻辑。

在nsi脚本中函数分为两种：用户自定义函数和回调函数。

用户自定义函数

用户自定义函数仅当是Call指令调用时才被执行，如果函数体中没有abort语句，则安装程序执行完了用户自定义函数，继续运行Call语句和指令。

用户自定义函数的语法：

Function

# some commands

FunctionEn

回调函数

回调函数则是由在特定的时间点触发的程序段。

例：

Function .onInit

MessageBox MB_YESNO "This will install My Program. Do you wish to continue?" IDYES gogogo

Abort

gogogo:

FunctionEnd

安装逻辑回调函数

NSIS对于安装逻辑定义以下回调函数：

.onGUIInit、.onInit、.onInstFailed、.onInstSuccess、.onGUIEnd、.onMouseOverSection、.onRebootFailed、.onSelChange、.onUserAbort、.onVerifyInstDir

卸载逻辑回调函数

NSIS对于卸载逻辑定义以下回调函数：un.onGUIInit、un.onInit、un.onUninstFailed、un.onUninstSuccess、un.onGUIEnd、un.onRebootFailed、un.onUserAbort

基本语法

变量

nsi脚本用var关键字来定义变量，使用$来引用变量。

注意：变量是全局的并且是大小写敏感的。

除了用户自定义的变量外，nsi脚本中定义了寄存器变量009,R0R0R9用于参数传递，以及系统变量用于特定用途，这些变量主要有：$INSTDIR用户定义的解压路径。$PROGRAMFILES程序文件目录(通常为C:\Program Files但是运行时会检测)。$COMMONFILES公用文件目录。这是应用程序共享组件的目录(通常为C:\Program Files\Common Files但是运行时会检测)。$DESKTOP

Windows桌面目录(通常为C:\windows\desktop但是运行时会检测)。该常量的内容(所有用户或当前用户)取决于SetShellVarContext设置。默认为当前用户。$EXEDIR安装程序运行时的位置。(从技术上来说你可以修改改变量，但并不是一个好方法)。${NSISDIR}包含NSIS安装目录的一个标记。在编译时会检测到。常用于在你想调用一个在NSIS目录下的资源时，例如：图标、界面……$WINDIR

Windows目录(通常为C:\windows或C:\winnt但在运行时会检测)$SYSDIR

Windows系统目录(通常为C:\windows\system或C:\winnt\system32但在运行时会检测)$TEMP系统临时目录(通常为C:\windows\temp但在运行时会检测)$STARTMENU开始菜单目录(常用于添加一个开始菜单项，使用CreateShortCut)。该常量的内容(所有用户或当前用户)取决于SetShellVarContext设置。默认为当前用户。$SMPROGRAMS开始菜单程序目录(当你想定位$STARTMENU\程序时可以使用它)。该常量的内容(所有用户或当前用户)取决于SetShellVarContext设置。默认为当前用户。$SMSTARTUP开始菜单程序/启动目录。该常量的内容(所有用户或当前用户)取决于SetShellVarContext设置。默认为当前用户。$QUICKLAUNCH在IE4活动桌面及以上的快速启动目录。如果快速启动不可用，仅仅返回和$TEMP一样。$DOCUMENTS文档目录。一个当前用户典型的路径形如C:\Documents and Settings\Foo\My Documents。这个常量的内容(所有用户或当前用户)取决于SetShellVarContext设置。默认为当前用户。该常量在Windows 95且Internet Explorer 4没有安装时无效。$SENDTO该目录包含了“发送到”菜单快捷项。$RECENT该目录包含了指向用户最近文档的快捷方式。$FAVORITES该目录包含了指向用户网络收藏夹、文档等的快捷方式。这个常量的内容(所有用户或当前用户)取决于SetShellVarContext设置。默认为当前用户。该常量在Windows 95且Internet Explorer 4没有安装时无效。$MUSIC用户的音乐文件目录。这个常量的内容(所有用户或当前用户)取决于SetShellVarContext设置。默认为当前用户。该常量仅在Windows XP、ME及以上才有效。$PICTURES用户的图片目录。这个常量的内容(所有用户或当前用户)取决于SetShellVarContext设置。默认为当前用户。该常量仅在Windows 2000、XP、ME及以上才有效。$VIDEOS用户的视频文件目录。这个常量的内容(所有用户或当前用户)取决于SetShellVarContext设置。默认为当前用户。该常量仅在Windows XP、ME及以上才有效。$NETHOOD该目录包含了可能存在于我的网络位置、网上邻居文件夹的链接对象。该常量在Windows 95且Internet Explorer 4和活动桌面没有安装时无效。$FONTS系统字体目录。$TEMPLATES文档模板目录。这个常量的内容(所有用户或当前用户)取决于SetShellVarContext设置。默认为当前用户。$APPDATA应用程序数据目录。当前用户路径的检测需要Internet Explorer 4及以上。所有用户路径的检测需要Internet Explorer 5及以上。这个常量的内容(所有用户或当前用户)取决于SetShellVarContext设置。默认为当前用户。该常量在Windows 95且Internet Explorer 4和活动桌面没有安装时无效。$PRINTHOOD该目录包含了可能存在于打印机文件夹的链接对象。该常量在Windows 95和Windows 98上无效。$INTERNET_CACHE

Internet Explorer的临时文件目录。该常量在Windows 95和Windows NT且Internet Explorer 4和活动桌面没有安装时无效。$COOKIES

Internet Explorer的Cookies目录。该常量在Windows 95和Windows NT且Internet Explorer 4和活动桌面没有安装时无效。$HISTORY

Internet Explorer的历史记录目录。该常量在Windows 95和Windows NT且Internet Explorer 4和活动桌面没有安装时无效。$PROFILE用户的个人配置目录。一个典型的路径如C:\Documents and Settings\Foo。该常量在Windows 2000及以上有效。$ADMINTOOLS一个保存管理工具的目录。这个常量的内容(所有用户或当前用户)取决于SetShellVarContext设置。默认为当前用户。该常量在Windows 2000、ME及以上有效。$RESOURCES该资源目录保存了主题和其他Windows资源(通常为C:\Windows\Resources但在运行时会检测)。该常量在Windows XP及以上有效。$RESOURCES_LOCALIZED该本地的资源目录保存了主题和其他Windows资源(通常为C:\Windows\Resources\1033但在运行时会检测)。该常量在Windows XP及以上有效。$CDBURN_AREA一个在烧录CD时储存文件的目录。.该常量在Windows XP及以上有效。$HWNDPARENT父窗口的十进制HWND。$PLUGINSDIR该路径是一个临时目录，当第一次使用一个插件或一个调用InitPluginsDir时被创建。该文件夹当解压包退出时会被自动删除。这个文件夹的用意是用来保存给InstallOptions使用的INI文件、启动画面位图或其他插件运行需要的文件。

编译器指令

nsi脚本的编译器指令主要指仅在编译时刻执行的命令。这些命令主要用来包含文件、条件化编译、定义常量、定义宏等。定义常量和宏是编译器指令的最主要应用。

常用指令

文件、目录操作

File

作用：释放文件到当前输出路径。

如果使用了/nonfatal开关且当文件未找到时使用警告来代替错误

如果使用了/a开关，则被添加的文件的属性将会保持

如果使用了/r开关，匹配的文件将会在子目录里被递归的搜索。如果目录名匹配则所有包含的内容都会被递归添加，目录结构也会被保持

使用/x开关可以用来来排除文件或目录

例：

将ProjectFiles目录下的所有文件释放到输出目录

SetOutPath "$INSTDIR"

SetOverwrite ifnewer

File /r "ProjectFiles\*.*"

Delete

作用：从目标系统删除文件

例：删除文件

Delete "$SMPROGRAMS\Test.exe"

Rename

作用：把源文件重命名为目标文件

例：

重命名文件

Rename INSTDIR\file.extINSTDIR\file.extINSTDIR\file.dat

CreateDirectory

作用：创建(递归创建)指定的目录。当目录不能创建时会放置一个错误标记。你也可以指定一个绝对路径。

例：在默认Program Files目录下创建一个Temp目录

CreateDirectory "$SMPROGRAMS\Temp"

RMDir

作用：删除目录

例：

删除Resources及其子目录

RMDir /r $INSTDIR\Resources

SetOutPath

作用：设置输出路径($OUTDIR)且当路径不存在时创建(需要时会递归创建)。必须为绝对路径名，通常都使用 $INSTDIR。

例：

将用户定义的解压路径作为输出目录

SetOutPath $INSTDIR

CreateShortCut

作用：创建快捷文件.lnk目标文件

例：

设置Test.exe的快捷方式Test.lnk，图标为Test.ico。

CreateShortCut "DESKTOP\Test.lnk""DESKTOP\Test.lnk""INSTDIR\Test.exe" "" "$INSTDIR\Resources\Picture\Icon\ Test.ico"

注册表操作

WriteRegStr、WriteRegExpandStr

作用：把字符串写入注册表。根键必须为下面列表之一：

HKCR或HKEY_CLASSES_ROOT

HKLM或HKEY_LOCAL_MACHINE

HKCU或HKEY_CURRENT_USER

HKU或HKEY_USERS

HKCC或HKEY_CURRENT_CONFIG

HKDD或HKEY_DYN_DATA

HKPD或HKEY_PERFORMANCE_DATA

SHCTX或SHELL_CONTEXT

如果字串不能写入注册表则放置一个错误的标记。字串的类型为REG_SZ对应WriteRegStr，或REG_EXPAND_STR对应WriteRegExpandStr。如果注册表键不存在则会自动创建。

例：

将程序信息写入注册表

Section -Post

WriteUninstaller "$INSTDIR\uninst.exe"

WriteRegStr HKLM "PRODUCTDIRREGKEY""""PRODUCTDIRREGKEY""""INSTDIR\Test.exe"

WriteRegStr PRODUCTUNINSTROOTKEY"PRODUCTUNINSTROOTKEY"{PRODUCT_UNINST_KEY}" "DisplayName" "$(^Name)"

WriteRegStr PRODUCTUNINSTROOTKEY"PRODUCTUNINSTROOTKEY"{PRODUCT_UNINST_KEY}" "UninstallString" "$INSTDIR\uninst.exe"

WriteRegStr PRODUCTUNINSTROOTKEY"PRODUCTUNINSTROOTKEY"{PRODUCT_UNINST_KEY}" "DisplayIcon" "$INSTDIR\Test.exe"

WriteRegStr PRODUCTUNINSTROOTKEY"PRODUCTUNINSTROOTKEY"{PRODUCT_UNINST_KEY}" "DisplayVersion" "${PRODUCT_VERSION}"

WriteRegStr PRODUCTUNINSTROOTKEY"PRODUCTUNINSTROOTKEY"{PRODUCT_UNINST_KEY}" "URLInfoAbout" "${PRODUCT_WEB_SITE}"

WriteRegStr PRODUCTUNINSTROOTKEY"PRODUCTUNINSTROOTKEY"{PRODUCT_UNINST_KEY}" "Publisher" "${PRODUCT_PUBLISHER}"

SectionEnd

ReadRegDWORD

作用：读取注册表信息

例：

在注册表中读取.net版本

Function GetNetFrameworkVersion

Push $1

Push $0

ReadRegDWORD $0 HKLM "SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full" "Install"

ReadRegDWORD $1 HKLM "SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full" "Version"