資源描述:
《牛牛安裝包界面控件使用說(shuō)明》由會(huì)員上傳分享,免費(fèi)在線閱讀,更多相關(guān)內(nèi)容在工程資料-天天文庫(kù)。
1、牛牛安裝包界面控件使用說(shuō)明本說(shuō)明文檔旨在對(duì)nsNiuniuSkin.dll控件的使用進(jìn)行說(shuō)明,指導(dǎo)調(diào)用者順利的將牛捉安裝包界面控件控件集成進(jìn)安裝包中,使第三方產(chǎn)品也能擁有完美的安裝包的UI體驗(yàn)功能。官方網(wǎng)址:http://www.ggniu.cn/牛牛安裝包界面控件是一個(gè)可集成于NSIS的插件,采用Duilib開發(fā),在使用時(shí),安裝包制作者只需要做如下兩件事情:1.通過(guò)配置Duilib的資源,設(shè)計(jì)好界面顯示的元素2.在NSIS的腳本中,通過(guò)NSIS腳本調(diào)用nsNiuniuSkin.dll的相關(guān)接口,集成UI及安裝包的業(yè)務(wù)功能在控件的資源中,采用的是通過(guò)TAB控件來(lái)實(shí)現(xiàn)不同階段的
2、安裝界面,比如:選擇路徑、許可協(xié)議、安裝進(jìn)度、完成、卸載等,在實(shí)際使用中,通過(guò)NSIS腳本來(lái)設(shè)置當(dāng)前需要顯示的TAB頁(yè),即可完美的呈現(xiàn)出需要的界面UI了。在我們的示例中,提供了兩份安裝的界面如下:注意,最新版本的控件已經(jīng)將可用的NSIS及7z的相關(guān)文件包含在示例包中,可以通過(guò)一鍵打包批處理腳本進(jìn)行打包了,具體如下:1).將要打包的文件復(fù)制到FilesToInstall目錄下,可以包含文件及若干層的目錄2).修改相關(guān)項(xiàng)目下的skin目錄下的資源文件及xml腳本來(lái)配置UI3).添加相關(guān)(或者在我原來(lái)的示例上修改,這樣更快)的NSIS腳本文件,并與UI相匹配4).指定好相關(guān)的ICO
3、、licence等信息5).執(zhí)行build.bat腳本,一鍵打包,build腳本會(huì)做三件事:將FilesToInstall目錄下的文件打包成app.7z;將skin目錄下的文件打包成skin.zip;調(diào)用nsis編譯程序,編譯nsi文件,輸出安裝包。以上描述的build腳本為全自動(dòng)執(zhí)行,可以輕松集成進(jìn)您現(xiàn)有的軟件發(fā)布流程中,實(shí)現(xiàn)自動(dòng)化打包發(fā)布。牛牛安裝包界面控件包含的接口較多,以下逐一進(jìn)行介紹[以下接口調(diào)用及參數(shù)說(shuō)明按在NSIS腳本中的調(diào)用示例來(lái)說(shuō)明]:1.接口初始化接口InitSkinPage此接口函數(shù)用于初始化nsNiuniuSkin.dll控件的配置信息.調(diào)用示例:ns
4、NiuniuSkin::InitSkinPage"$PLUGINSDIR""${INSTALL_LICENCE_FILENAME}"參數(shù)說(shuō)明:參數(shù)序號(hào)參數(shù)類型參數(shù)說(shuō)明備注1字符串用于指定NSIS安裝包的插件釋放路徑此路徑的指定非常重要,在腳本中指定的插件以及UI資源包將會(huì)釋放至此目錄下,只有正確指定后,界面控件才能調(diào)用資源顯示窗口2字符串許可協(xié)議的文件名這是一個(gè)txt文檔,在界面控件加載時(shí),將會(huì)加載此文件來(lái)顯示許可協(xié)議2.設(shè)置安裝包標(biāo)題SetWindowTile此接口函數(shù)用于指定安裝包的標(biāo)題。調(diào)用示例:nsNiuniuSkin::SetWindowTile$hInstall
5、Dlg"${PRODUCT_NAME}安裝程序"參數(shù)說(shuō)明:參數(shù)序號(hào)參數(shù)類型參數(shù)說(shuō)明備注1整型用于指定要設(shè)置標(biāo)題的窗口句柄調(diào)用init時(shí)返回(可傳遞子窗口彈窗口的句柄)2字符串用于指定安裝包的標(biāo)題3.設(shè)置當(dāng)前顯示的TAB頁(yè)nsNiuniuSkin::ShowPageItem$hInstallDlg"wizardTab"${INSTALL_PAGE_CONFIG}參數(shù)序號(hào)參數(shù)類型參數(shù)說(shuō)明備注1整型用于指定要設(shè)置標(biāo)題的窗口句柄調(diào)用init時(shí)返回(可傳遞子窗口彈窗口的句柄)2字符串指定的TAB控件的name3int需要顯示的tab頁(yè)序號(hào)以0為初始值1.路徑選擇相關(guān)接口4.1通知接口來(lái)
6、瀏覽安裝路徑nsNiuniuSkin::SelectInstallDirPop$0通知界面控件來(lái)瀏覽安裝路徑,并且將路徑獲取到變量中。再調(diào)用此接口后,應(yīng)該再調(diào)用SetControlAttribute接口來(lái)將安裝的路徑設(shè)置到控件界面上。2.顯示界面控件nsNiuniuSkin::ShowPage0當(dāng)界面綁定事件完成后,通過(guò)此接口來(lái)調(diào)用顯示控件,此接口將會(huì)阻塞運(yùn)行。參數(shù)序號(hào)參數(shù)類型參數(shù)說(shuō)明備注1整型用于指定顯示前要回調(diào)的NSIS函數(shù)如果為0,則表示不回調(diào)3.彈出提示框接口1)以下代碼用于初始化子窗口彈窗,同時(shí)返回其句柄:nsNiuniuSkin::InitSkinSubPage"
7、msgBox.xml""btnOK""btnCancel,btnClose"pop$hInstallSubDlg參數(shù)序號(hào)參數(shù)類型參數(shù)說(shuō)明備注1字符串指定彈窗要用到的UI配置xml文件2字符串指定點(diǎn)擊后彈窗退出時(shí)返回IDOK的按鈕ID號(hào)如果使用BindCallBack綁定了此按鈕回調(diào)的NSIS函數(shù),則此設(shè)置失效3字符串指定點(diǎn)擊后彈窗退出時(shí)返回IDCANCEL的按鈕ID號(hào)如果使用BindCallBack綁定了此按鈕回調(diào)的NSIS函數(shù),則此設(shè)置失效2)以下代碼用于根據(jù)彈窗窗口的句柄設(shè)置其UI控件的屬性,控制顯