牛牛安装包界面控件使用说明.doc

牛牛安装包界面控件使用说明
,指导调用者顺利的将牛捉安装包界面控件控件集成进安装包中,使第三方产品也能拥有完美的安装包的UI体验功能。
官方网址:/
牛牛安装包界面控件是一个可集成于NSIS的插件,采用Duilib开发,在使用时,安装包制作者只需要做如下两件事情:
1. 通过配置Duilib的资源,设计好界面显示的元素
2. 在NSIS的脚本中,,集成UI及安装包的业务功能
在控件的资源中,采用的是通过TAB控件来实现不同阶段的安装界面,比如:选择路径、许可协议、安装进度、完成、卸载等,在实际使用中,通过NSIS脚本来设置当前需要显示的TAB页,即可完美的呈现出需要的界面UI了。
在我们的示例中,提供了两份安装的界面如下:
注意,最新版本的控件已经将可用的NSIS及7z的相关文件包含在示例包中,可以通过一键打包批处理脚本进行打包了,具体如下:
1). 将要打包的文件复制到FilesToInstall目录下,可以包含文件及若干层的目录
2). 修改相关项目下的skin目录下的资源文件及xml脚本来配置UI
3). 添加相关(或者在我原来的示例上修改,这样更快)的NSIS脚本文件,并与UI相匹配
4). 指定好相关的ICO、licence等信息
5). ,一键打包,build脚本会做三件事:;;调用nsis编译程序,编译nsi文件,输出安装包。
以上描述的build脚本为全自动执行,可以轻松集成进您现有的软件发布流程中,实现自动化打包发布。
牛牛安装包界面控件包含的接口较多,以下逐一进行介绍[以下接口调用及参数说明按在NSIS脚本中的调用示例来说明]:
接口初始化接口
InitSkinPage
.
调用示例:
nsNiuniuSkin::InitSkinPage "$PLUGINSDIR\" "${INSTALL_LICENCE_FILENAME}"
参数说明:
参数序号
参数类型
参数说明
备注
1
字符串
用于指定NSIS安装包的插件释放路径
此路径的指定非常重要,在脚本中指定的插件以及UI资源包将会释放至此目录下,只有正确指定后,界面控件才能调用资源显示窗口
2
字符串
许可协议的文件名
这是一个txt文档,在界面控件加载时,将会加载此文件来显示许可协议
设置安装包标题
SetWindowTile
此接口函数用于指定安装包的标题。
调用示例:
nsNiuniuSkin::SetWindowTile $hInstallDlg "${PRODUCT_NAME}安装程序"
参数说明:
参数序号
参数类型
参数说明
备注
1
整型
用于指定要设置标题的窗口句柄
调用init时返回(可传递子窗口弹窗口的句柄)
2
字符串
用于指定安装包的标题
设置当前显示的TAB页
nsNiuniuSkin::ShowPageItem $hInstallDlg "wizardTab" ${INSTALL_PAGE_CONFIG}
参数序号
参数类型
参数说明
备注
1
整型
用于指定要设置标题的窗口句柄
调用init时返回(可传递子窗口弹窗口的句柄)
2
字符串
指定的TAB控件的name
3
int
需要显示的tab页序号
以0为初始值
路径选择相关接口
通知接口来浏览安装路径
nsNiuniuSkin::SelectInstallDir
Pop $0
通知界面控件来浏览安装路径,并且将路径获取到变量中。再调用此接口后,应该再调用SetControlAttribute接口来将安装的路径设置到控件界面上。
显示界面控件
nsNiuniuSkin::ShowPage 0
当界面绑定事件完成后,通过此接口来调用显示控件,此接口将会阻塞运行。
参数序号
参数类型
参数说明
备注
1
整型
用于指定显示前要回调的NSIS函数
如果为0,则表示不回调
弹出提示框接口
1) 以下代码用于初始化子窗口弹窗,同时返回其句柄:
nsNiuniuSkin::InitSkinSubPage "" "btnOK" "btnCancel,btnClose"
pop $hInstallSubDlg
参数序号
参数类型
参数说明
备注
1
字符串