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

《牛牛安装包界面控件使用说明》由会员上传分享，免费在线阅读，更多相关内容在工程资料-天天文库。

1、牛牛安装包界面控件使用说明本说明文档旨在对nsNiuniuSkin.dll控件的使用进行说明，指导调用者顺利的将牛捉安装包界面控件控件集成进安装包中，使第三方产品也能拥有完美的安装包的UI体验功能。官方网址：http://www.ggniu.cn/牛牛安装包界面控件是一个可集成于NSIS的插件，采用Duilib开发，在使用时，安装包制作者只需要做如下两件事情：1.通过配置Duilib的资源，设计好界面显示的元素2.在NSIS的脚本中，通过NSIS脚本调用nsNiuniuSkin.dll的相关接口，集成UI及安装包的业务功能在控件的资源中，采用的是通过TAB控件来实现不同阶段的

2、安装界面，比如：选择路径、许可协议、安装进度、完成、卸载等，在实际使用中，通过NSIS脚本来设置当前需要显示的TAB页，即可完美的呈现出需要的界面UI了。在我们的示例中，提供了两份安装的界面如下：注意，最新版本的控件已经将可用的NSIS及7z的相关文件包含在示例包中，可以通过一键打包批处理脚本进行打包了，具体如下：1).将要打包的文件复制到FilesToInstall目录下，可以包含文件及若干层的目录2).修改相关项目下的skin目录下的资源文件及xml脚本来配置UI3).添加相关（或者在我原来的示例上修改，这样更快）的NSIS脚本文件，并与UI相匹配4).指定好相关的ICO

3、、licence等信息5).执行build.bat脚本，一键打包，build脚本会做三件事：将FilesToInstall目录下的文件打包成app.7z；将skin目录下的文件打包成skin.zip；调用nsis编译程序，编译nsi文件，输出安装包。以上描述的build脚本为全自动执行，可以轻松集成进您现有的软件发布流程中，实现自动化打包发布。牛牛安装包界面控件包含的接口较多，以下逐一进行介绍[以下接口调用及参数说明按在NSIS脚本中的调用示例来说明]：1.接口初始化接口InitSkinPage此接口函数用于初始化nsNiuniuSkin.dll控件的配置信息.调用示例：ns

4、NiuniuSkin::InitSkinPage"$PLUGINSDIR""${INSTALL_LICENCE_FILENAME}"参数说明：参数序号参数类型参数说明备注1字符串用于指定NSIS安装包的插件释放路径此路径的指定非常重要，在脚本中指定的插件以及UI资源包将会释放至此目录下，只有正确指定后，界面控件才能调用资源显示窗口2字符串许可协议的文件名这是一个txt文档，在界面控件加载时，将会加载此文件来显示许可协议2.设置安装包标题SetWindowTile此接口函数用于指定安装包的标题。调用示例：nsNiuniuSkin::SetWindowTile$hInstall

5、Dlg"${PRODUCT_NAME}安装程序"参数说明：参数序号参数类型参数说明备注1整型用于指定要设置标题的窗口句柄调用init时返回（可传递子窗口弹窗口的句柄）2字符串用于指定安装包的标题3.设置当前显示的TAB页nsNiuniuSkin::ShowPageItem$hInstallDlg"wizardTab"${INSTALL_PAGE_CONFIG}参数序号参数类型参数说明备注1整型用于指定要设置标题的窗口句柄调用init时返回（可传递子窗口弹窗口的句柄）2字符串指定的TAB控件的name3int需要显示的tab页序号以0为初始值1.路径选择相关接口4.1通知接口来

6、浏览安装路径nsNiuniuSkin::SelectInstallDirPop$0通知界面控件来浏览安装路径，并且将路径获取到变量中。再调用此接口后，应该再调用SetControlAttribute接口来将安装的路径设置到控件界面上。2.显示界面控件nsNiuniuSkin::ShowPage0当界面绑定事件完成后，通过此接口来调用显示控件，此接口将会阻塞运行。参数序号参数类型参数说明备注1整型用于指定显示前要回调的NSIS函数如果为0，则表示不回调3.弹出提示框接口1)以下代码用于初始化子窗口弹窗，同时返回其句柄：nsNiuniuSkin::InitSkinSubPage"

7、msgBox.xml""btnOK""btnCancel,btnClose"pop$hInstallSubDlg参数序号参数类型参数说明备注1字符串指定弹窗要用到的UI配置xml文件2字符串指定点击后弹窗退出时返回IDOK的按钮ID号如果使用BindCallBack绑定了此按钮回调的NSIS函数，则此设置失效3字符串指定点击后弹窗退出时返回IDCANCEL的按钮ID号如果使用BindCallBack绑定了此按钮回调的NSIS函数，则此设置失效2)以下代码用于根据弹窗窗口的句柄设置其UI控件的属性，控制显