收藏本站
切换到窄版

杉宫竹苑工作室

 找回密码
 立即注册
搜索
热搜: 活动 交友 discuz
杉宫竹苑工作室»论坛 › 软件封包 › Other Releases › Wix打包系列（四） 自定义UI
返回列表 发新帖
查看: 2543|回复: 0

Wix打包系列（四） 自定义UI

[复制链接]
admin
发表于 2018-5-24 21:25:09 | 显示全部楼层 |阅读模式

正式会员享受无限制浏览网站功能和高速网盘下载，赶快加入本站吧！

您需要 登录 才可以下载或查看，没有账号？立即注册

x
   除了标准的安装界面，如果我们要在安装时需要提供一些额外的信息时，这时就需要自定义界面来显示和录入这些信息。

    4.1  自定义对话框

    如上一章中我们测试数据库的连接串在源文件中定义的，如果我们需要用户安装时输入数据库信息，就需要添加一个如图的对话框。

    开始之前，我们先看看标准的WixUI_Mondo UI包含哪些对话框：

   1: BrowseDlg
   2: CustomizeDlg
   3: DiskCostDlg
   4: LicenseAgreementDlg
   5: SetupTypeDlg
   6: WelcomeDlg
    这些标准对话框都有Back和Next按钮，他们通过类似双向链表的方式连接起来，新添加的对话框需要插入到这个双向链表中；这里我们需要添加DbConfigDlg对话框，就需要重新定义链表的Back和Next节点。

    首先我们创建一个DbConfigDlg.wxs文件，文件内容如下：

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <Wix xmlns="http://schemas.microsoft.com/wix/2006/wi">
  3. <Fragment>
  4. <UI>
  5. <Dialog Id="DBConfigDlg" Width="370" Height="270" Title="[ProductName] [Setup]" NoMinimize="yes">
  6. <Control Id="DBNameLabel" Type="Text" X="45" Y="56" Width="200" Height="15" TabSkip="no" Text="数据库名称：" />
  7. <Control Id="DBNameEdit" Type="Edit" X="45" Y="71" Width="280" Height="15" Property="DBNAME" Text="{32}" />
  8. <Control Id="ServerLabel" Type="Text" X="45" Y="94" Width="200" Height="15" TabSkip="no" Text="服务器（名称或者IP地址）：" />
  9. <Control Id="ServerEdit" Type="Edit" X="45" Y="109" Width="280" Height="15" Property="SERVERNAME" Text="{32}" />
  10. <Control Id="UserNameLable" Type="Text" X="45" Y="131" Width="280" Height="10" TabSkip="no">
  11. <Text>用户名：</Text>
  12. </Control>
  13. <Control Id="UserNameEdit" Type="Edit" X="45" Y="146" Width="280" Height="15" Property="DBUSERNAME" Text="{32}" />
  14. <Control Id="PasswordLabel" Type="Text" X="45" Y="169" Width="200" Height="15" TabSkip="no" Text="密码：" />
  15. <Control Id="PasswordEdit" Type="Edit" Password="yes" X="45" Y="184" Width="280" Height="15" Property="DBPASSWORD" Text="{32}" />
  16. <Control Id="TestConnect" Type="PushButton" X="45" Y="206" Width="66" Height="17" Text="测试连接(&T)">
  17. < Publish Event="DoAction" Value="ConnectDB" Order="2" >1</Publish>
  18. < Publish Event="SpawnDialog" Value="InvalidDBDlg" Order="3">1</Publish>
  19. </Control>
  20. <Control Id="Back" Type="PushButton" X="180" Y="243" Width="56" Height="17" Text="!(loc.WixUIBack)">
  21. < Publish Event="NewDialog" Value="LicenseAgreementDlg">1</Publish>
  22. </Control>
  23. <Control Id="Next" Type="PushButton" X="236" Y="243" Width="56" Height="17" Default="yes" Text="!(loc.WixUINext)">
  24. <Condition Action="disable"><![CDATA[CONNECTSUCCESS <> "1"]]></Condition>
  25. <Condition Action="enable">CONNECTSUCCESS = "1"</Condition>
  26. < Publish Event="NewDialog" Value="SetupTypeDlg">1</Publish>
  27. </Control>
  28. <Control Id="Cancel" Type="PushButton" X="304" Y="243" Width="56" Height="17" Cancel="yes" Text="!(loc.WixUICancel)">
  29. < Publish Event="SpawnDialog" Value="CancelDlg">1</Publish>
  30. </Control>
  31. <Control Id="BannerBitmap" Type="Bitmap" X="0" Y="0" Width="370" Height="44" TabSkip="no" Text="WixUI_Bmp_Banner" />
  32. <Control Id="Description" NoWrap="no" Type="Text" X="25" Y="23" Width="280" Height="30" Transparent="yes" NoPrefix="yes">
  33. <Text>继续安装应用程序需要填写以下信息，确保数据库能够被正确安装，并且使应用程序能够在该数据库上运行。</Text>
  34. </Control>
  35. <Control Id="BottomLine" Type="Line" X="0" Y="234" Width="370" Height="0" />
  36. <Control Id="Title" Type="Text" X="15" Y="6" Width="200" Height="15" Transparent="yes" NoPrefix="yes">
  37. <Text>{/WixUI_Font_Title}数据库配置</Text>
  38. </Control>
  39. <Control Id="BannerLine" Type="Line" X="0" Y="44" Width="370" Height="0" />
  40. </Dialog>
  41. < Property Id="DBNAME" Value="test" />
  42. < Property Id="SERVERNAME" Value="(local)" />
  43. < Property Id="DBUSERNAME" Value="sa" />
  44. < Property Id="DBPASSWORD" Value="123456" />
  45. </UI>
  46. </Fragment>
  47. <Fragment>
  48. <UI>
  49. <Dialog Id="InvalidDBDlg" Width="250" Height="85" Title="[ProductName] [Setup]" NoMinimize="yes">
  50. <Control Id="Return" Type="PushButton" X="100" Y="57" Width="56" Height="17" Default="yes" Cancel="yes" Text="返回(&R)">
  51. < Publish Event="EndDialog" Value="Return">1</Publish>
  52. </Control>
  53. <Control Id="ConnError" Type="Text" NoWrap="no" X="48" Y="15" Width="194" Height="30" TabSkip="no">
  54. <Text>数据库连接失败。</Text>
  55. <Condition Action="show"><![CDATA[CONNECTSUCCESS <> "1"]]></Condition>
  56. <Condition Action="hide">CONNECTSUCCESS = "1"</Condition>
  57. </Control>
  58. <Control Id="ConnYes" Type="Text" NoWrap="no" X="48" Y="15" Width="194" Height="30" TabSkip="no">
  59. <Text>数据库连接成功。</Text>
  60. <Condition Action="show">CONNECTSUCCESS = "1"</Condition>
  61. <Condition Action="hide"><![CDATA[CONNECTSUCCESS <> "1"]]></Condition>
  62. </Control>
  63. </Dialog>
  64. </UI>
  65. </Fragment>
  66. </Wix>
复制代码

    代码中一共有2个对话框，主要由Control组成，由Type属性区分Control类型。InvalidDBDlg对话框用来弹出连接提示信息；DbConfigDlg对话框接受用户录入的数据，包括文本框、输入框和按钮等；我们可以看到每个PushButton类型的Control都包含一个Publish标记，它定义了Event事件属性，Publish的Event属性值包含如下可能：

    1、DoAction ，表示按钮事件执行一个Action动作，value属性值是Action的标识
    2、NewDialog， 表示按钮事件将当前操作界面定位到新的界面，value属性值是界面的标识
    3、SpawnDialog，表示按钮事件将弹出一个模式对话框，value属性值是界面的标识
    4、如果Publish标记没有定义Event属性，则必须定义Property属性，但不可同时定义；定义Property属性表示按钮事件会给Property赋值，value属性值是给Property设置的值。

    我们来看看这些按钮的作用：
    TestConnect 按钮包含两个Publish事件，第一个事件是执行ConnectDB的Action，这个Action也就是我们上节定义的Action;它的第二个事件是弹出InvalidDBDlg对话框，提示连接数据库的提示信息。
    Back、Next、Cancel是安装界面的标准按钮，Back按钮的Publish事件将界面跳转到LicenseAgreementDlg欢迎界面；Next按钮的Publish事件将界面跳转到SetupTypeDlg 安装类型选择界面，Next按钮包含两个Condition条件，第一个Condition表示当CONNECTSUCCESS <> "1"时，Next按钮将被禁用，第二个Condition表示当CONNECTSUCCESS <> "0"时，Next按钮将被激活；Cancel的Publish事件将弹出CancelDlg对话框，CancelDlg对话框是windows installer内置的，用户可以选择是否终止或退出安装。
    Text和Edit类型的Control相当于我们熟悉的Lable和TextBox。不同的是，Edit编辑控件必须定义Property属性，这样我们在安装过程或者Action中都可以引用该Property值；需要注意的是，这里Property的值才能正确反映编辑框的值，而“Text="{32}”仅表示允许输入的文本框长度，如果想给Control赋初始值，通过Text设置是不起作用的，需要显示定义Property，如：

< Property Id="DBNAME" Value="master" />
    ConnError文本框的Condition表示只有在连接失败时才显示，ConnYes文本框的Condition表示只有在连接时时才显示。
   
     这样，新的对话框已经创建好了，我们还需修改下Sample.wxs，修改后的Product部分内容如下：
  1. < Product ...>   

  3. < Package .../>   

  5.     ...

  7. <Feature...>  
  8.         ...
  9.         ...
  10. </Feature>

  12. <Binary Id='ConnectDBClass' SourceFile='$(var.Version)/SampleCustomAction.CA.dll' />

  14. <CustomAction Id='LaunchFile'  FileKey='filFoobarEXE' ExeCommand='' Return='asyncNoWait' />
  15. <CustomAction Id='ConnectDB' BinaryKey='ConnectDBClass' DllEntry='ConnectDataBase' />

  17. <UI Id="MyWixUI_Mondo">
  18. <UIRef Id="WixUI_Mondo" />
  19. <UIRef Id="WixUI_ErrorProgressText" />

  21. <DialogRef Id="DBConfigDlg" />
  22. < Publish Dialog="DBConfigDlg" Control="TestConnect" Property="CONNECTIONSTRING"
  23. Value="data source=[SERVERNAME];user=[DBUSERNAME];password=[DBPASSWORD];initial catalog=[DBNAME];Persist Security Info=;"
  24. Order="1" >NOT Installed</Publish>

  26. < Publish Dialog="LicenseAgreementDlg" Control="Next" Event="NewDialog" Value="DBConfigDlg" Order="2">
  27.             LicenseAccepted = "1"
  28. </Publish>
  29. < Publish Dialog="SetupTypeDlg" Control="Back" Event="NewDialog" Value="DBConfigDlg">1</Publish>

  31. < Publish Dialog="ExitDialog" Control="Finish" Event="DoAction" Value="LaunchFile" Order="1">1</Publish>
  32. </UI>

  34. < Property Id="WIXUI_INSTALLDIR" Value="INSTALLDIR" />

  36. </Product>  
复制代码


    上面代码中我们自定义了一个UI标签MyWixUI_Mondo，把要引用的UI和界面元素都放到这个元素里，如果不定义新的UI标签的话，那么后面定义的Publish 事件就只能定义到DBConfigDlg.wxs的UI下面。DBConfigDlg对话框下定义了Back和Next的跳转的界面，但这还只定义了双向链表的其中一端，SetupTypeDlg的Back按钮和LicenseAgreementDlg的Next按钮行中定义链表的另一端，都跳转到DBConfigDlg界面。

    我们还为TestConnect按钮添加一个Publish 事件，这个事件用来给CONNECTIONSTRING赋值，Value属性中可以直接引用其他属性的值（用方括号引起来），它的Order等于1，而ConnectDB的Order等于2，说明在ConnectDB之前执行；我们这里只阐述一种用法，对于设置连接串也可以不这么写，一般我们可以在'ConnectDB'方法中 中获取输入的数据库连接串的属性然后生成连接串。

    最后，我们需要在编译和链接时候添加DBConfigDlg对话框：

candle.exe -dVersion=1.0.0  1.0.0/Sample.wxs DbConfigDlg.wxs -out 1.0.0/
light.exe -loc WixUI_zh-cn.wxl  -ext WixUIExtension -out 1.0.0/Sample.msi 1.0.0/Sample.wixobj 1.0.0/DbConfigDlg.wixobj

    我们可以看到wix中允许为任何UI（包括windows installer内置的UI、wixUI和自定义UI）的Control添加事件处理的方法，这样我们就可以更方便的控制安装流程。下一章节我们将介绍如何如何在安装时部署数据库。
回复

使用道具 举报

返回列表 发新帖
高级模式
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

QQ|小黑屋|手机版|Archiver|SgzyStudio

GMT+8, 2024-5-3 12:50 , Processed in 0.107000 second(s), 18 queries .

Powered by Discuz! X3.4

© 2001-2023 Discuz! Team.

快速回复 返回顶部 返回列表