当前位置: 首页 > 文档资料 > NSIS 用户手册 >

2.6 插件

优质
小牛编辑
130浏览
2023-12-01

NSIS 支持可从脚本里调用的插件。插件是由一些 C、C++、Delphi 或其它程序语言写的 DLL 文件,可以提供基于 NSIS 的更多增强型代码。

一个插件的调用像这样:

DLL名::函数名 "参数1" "参数2" "参数3"

每一个插件的函数由它的参数有它自己的要求,一些不需要,一些则需要足够的参数。例子:

nsExec::ExecToLog '"${NSISDIR}\makensis.exe" /CMDHELP'
InstallOptions::dialog "$PLUGINSDIR\test.ini"
NSISdl::download http://download.nullsoft.com/winamp/client/winamp291_lite.exe $R0

NSIS 可识别的插件会列表于编译器输出的顶部。NSIS 会在 NSIS 目录下的 Plugins 目录里查找插件并且会列出所有可用的函数。你也可以使用 !addPluginDir 来告诉 NSIS 在另外的目录里查找插件。

NSIS 发布时已经包含了很多的插件。nsDialogs 是一个受欢迎的插件,它允许你建立自定义的页面,并与 NSIS 页面命令结合 (看页面)。开始菜单插件提供了一个可允许用户选择一个开始菜单目录的页面。这里还有许多不同用途的大量插件,查看 Contrib 目录里的帮助文件和例子。你也可以在线查找另外的插件:NSIS Wiki

你也可以创建你自己的插件。基础的插件编写例子你可以查看 NSIS 安装文件夹的 Examples\Plugin,可以在其中找到 C、C++ 和 Delphi 头文件。包括插件的源代码你也可以在源代码包里找到。