NSIS 常用的命令及函数

最新推荐文章于 2025-10-01 21:06:46 发布

转载最新推荐文章于 2025-10-01 21:06:46 发布 · 8.6k 阅读

文章标签：

#NSIS #常用命令 #函数

NSIS使用总结专栏收录该内容

14 篇文章

订阅专栏

本文详细介绍了InnoSetup脚本的各项命令，包括文件操作、注册表编辑、路径设置等功能，并提供了具体的使用示例。

1：file [/nonfatal] [/a] ([/r] [/x 文件|通配符 [...]] (文件|通配符) [...] | /oname=输出路径\文件名输入路径\文件名)

释放文件到当前输出路径。
如果使用了 /nonfatal 开关且当文件未找到时使用警告来代替错误
如果使用了 /a 开关，则被添加的文件的属性将会保持
如果使用了 /r 开关，匹配的文件将会在子目录里被递归的搜索。如果目录名匹配则所有包含的内容都会被递归添加，目录结构也会被保持
使用 /x 开关可以用来来排除文件或目录

相对应卸载段命令：
Delete　 [/REBOOTOK] 文件
从目标系统删除文件

2：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。如果注册表键不存在则会自动创建。

相对应卸载段命令：
DeleteRegKey [/ifempty] 根键子键
删除一个注册表键。如果指定了 /ifempty，则该注册表键仅当它无子键时才会被删除(否则，整个注册表键将被删除)。有效的根键值在后面的 WriteRegStr 列出。如果该键不能被删除(或如果它不存在)则会放置一个错误的标记。

3：SetOutPath 输出路径

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

"InstallDir $PROGRAMFILES\QUHAIL"那么这就是我们的目录了!

对应卸载命令：
RMDir 要删除的目录

4：CreateDirectory 要创建的路径

创建 (递归创建) 指定的目录。当目录不能创建时会放置一个错误标记。
你也可以指定一个绝对路径。
CreateShortCut
快捷文件.lnk 目标文件 [参数 [图标文件 [图标索引号 [启动选项 [键盘快捷键 [描述]]]]]]

对应卸载命令：
Delete

5：RegDLL DLL文件 [入口点名称]

载入指定的 DLL 并且调用 DllRegisterServer (或入口点名称，当指定之后)。当产生一个错误的时候会置一个错误标记(例如不能载入 DLL，不能初始化 OLE，不能找到入口点，或者函数返回任何其它错误 ERROR_SUCCESS (=0))。
其实就是注册或加载你要的插件!
如：
RegDLL $INSTDIR\Codecs\h264dec.ax

对应的卸载命令：
UnRegDLL

6：Exec 命令

这应该算是常用的命令了,执行一个指定的程序并且立即继续安装,就是直接执行一个程序。
ExecWait 命令 [用户变量(返回代码)]
执行一个指定的程序并且等待运行处理结束。
如:运行一个安装文件 .inf
ExecWait "RunDll32 advpack.dll,LaunchINFSection skins.inf,DefaultInstall"

对应卸载：
ExecWait "RunDll32 advpack.dll,LaunchINFSection $windir\INF\skins.inf,DefaultunInstall"
当然DefaultunInstall是不定的,具体要看INF文件,它可以定义[unInstall]OR [DEL]或者别的,如果没有卸载段就无法卸载!

7：ReadINIStr 用户变量(输出) INI文件区段项

从 “INI文件” 的 “区段” 区段读取 “项” 的值并把该值输出到用户变量。如果该项未找到时会放置一个错误标记且该用户变量被赋为空值。

对应卸载：
DeleteINISec INI文件区段
从“INI文件” 里删除整个区段 “区段”
DeleteINISec $TEMP\something.ini Field 2
DeleteINIStr INI文件区段字串
从“INI文件” 里的 “区段” 区段删除 “字串” 字串。
DeleteINIStr $TEMP\something.ini Field 2 A 组件安装
比如：something.INI

[Field 1]
Type=Label
Text=A 组件安装
Left=8
Right=68
Top=6
Bottom=13

[Field 2]
Type=Label
Text=B 组件安装
Left=5
Right=65
Top=44
Bottom=51

8：ReserveFile [/nonfatal] [/r] [/x file|wildcard [...]] 文件 [文件...]

把文件保存在稍后使用的数据区块用于下面的调用。
有时，预先打包文件，方便安装加速释放之用。
如：ReserveFile "a.ini"

9：Function [函数名]

开始并打开一个新的函数。
Function func
............
FunctionEnd
;在这个段中定义函数"func"

10：StrCpy 用户变量(目标) 字串 [最大长度] [起始偏移]
StrCpy $0 "a bbbbbbbb" 就有$0 = "a bbbbbbbb"
StrCpy $0 "a bbbbbbbb" 3就有$0 = "a b"

11：StrCmp 字串1 字串2 相同时跳转的标记 [不相同时跳转的标记]

比较(不区分大小写)“字串1”和“字串2”，如果两者相等，跳转到“相同时跳转的标记”，否则跳转到“不相同时跳转的标记”。

12：Exch [用户变量 | 堆栈索引]

当不指定参数时，交换堆栈顶部的两个单元。

Push 字串
把一个字串压入堆栈，该字串可随后从堆栈里弹出。

Pop 用户变量(输出)
从堆栈里弹出一个字串到用户变量 $x。如果堆栈是空的，则会置一个错误标记。

如：
Push 1
Push 2
Exch
Pop $0 # = 1

13：if

（1） IfAbort 退出时要跳转的标记 [不是退出时要跳转的标记]
如果调用退出时它将返回 true
（2） IfErrors 错误时跳转的标记 [没有错误时跳转的标记]
检测并清除错误标记，如果设了错误标记，则跳转到“错误时跳转的标记”，否则跳转到“没有错误时跳转的标记”。
（3）IfFileExists 要检测的文件文件存在时跳转的标记 [文件不存在时跳转的标记]
检测“要检测的文件”是否存在(可以用通配符，或目录)，并当文件存在时跳转到“文件存在时跳转”，否则跳转到“文件不存在时跳转”。

14：Goto 要跳转的标记 | +偏移| -偏移| 用户变量(目标地址)

如果指定了标记，则跳转到 “要跳转的标记”。

15:MessageBox 消息框选项列表消息框文本 [/SD 返回] [检测返回值跳转到标记] [检测返回值2 跳转到标记2]

显示一个包含“消息框文本”的消息框。“消息框选项列表”必须为下面的一个或多个，多个使用 | 来隔开。
MB_OK - 显示 OK 按钮
MB_OKCANCEL - 显示 OK 和取消按钮
MB_ABORTRETRYIGNORE - 显示退出、重试、忽略按钮
MB_RETRYCANCEL - 显示重试和取消按钮
MB_YESNO - 显示是和否按钮
MB_YESNOCANCEL - 显示是、否、取消按钮
MB_ICONEXCLAMATION - 显示惊叹号图标
MB_ICONINFORMATION - 显示信息图标
MB_ICONQUESTION - 显示问号图标
MB_ICONSTOP - 显示终止图标
MB_TOPMOST - 使消息框在最前端显示
MB_SETFOREGROUND - 设置前景
MB_RIGHT - 右对齐文本
MB_RTLREADING - RTL 阅读次序
MB_DEFBUTTON1 - 默认为按钮 1
MB_DEFBUTTON2 - 默认为按钮 2
MB_DEFBUTTON3 - 默认为按钮 3
MB_DEFBUTTON4 - 默认为按钮 4