Wix 安装部署（二）自定义安装界面和行为

       上一篇介绍了如何联合MSBuild来自动生成打包文件和对WIX的一些初步认识，http://www.cnblogs.com/stoneniqiu/p/3355086.html 。

        这篇会在上篇的基础上继续探索Wix的自定义界面和行为的功能，以下都是个人的小结，不当之处欢迎指正，与君共勉！

一、安装向导

       Wix提供了五种安装向导风格,

•  WixUI Advanced
•  WixUI FeatureTree
•  WixUI InstallDir
•  WixUI Minimal
•  WixUI Mondo

    如何使用呢？需要两步,先不问为什么：

    1.需要使用UIRef 元素  ，在Product中引入

  <UI> <UIRef Id="WixUI_Minimal" /></UI>

 

   2.再在安装工程上右键添加引用,引入WixUIExtension.dll ，这个dll就在你安装的wix的bin目录下面。我们再生成以下，这个时候点击安装文件，安装向导页面就出现了，先是同意许可证，再是上一步,下一步等按钮知道完成，比上一篇中的安装明显像样了些。先不着急往下走，再回头看以下 

     UI元素是专门用来规范安装UI的，在其中可以定义你选择的风格，设置自定义的行为等。UIRef 用来选择安装向导风格,把Id中Minmal换掉就可以了，Minmal是最简洁的。当然不能出现两个UIRef,不然WIx就凌乱了。

   Advance和InstallDir 还需要其他的设置。

    InstallDir 需要一个属性，让用户定义安装的地方。如下：

<Directory Id="TARGETDIR" Name="SourceDir">
  <Directory Id="ProgramFilesFolder" Name="PFiles">
    <Directory Id="TESTFILEPRODUCTDIR" Name="Test File">
      ...
    </Directory>
   </Directory>
</Directory>
...
<Property Id="WIXUI_INSTALLDIR" Value="TESTFILEPRODUCTDIR" />
<UIRef Id="WixUI_InstallDir" />

   当然要记得修改 

<ComponentGroup Id="ProductComponents" Directory="TESTFILEPRODUCTDIR"> 

   安装的时候，就会让用户选择安装位置。

   

     WixUIExtension.dll是wix自带的链接库,还有其他的链接库如WixUtilExtension，WixNetFxExtension，WixIISExtension等，会在后面一一探索。

二、自定义风格

    这里主要讲的是加入自己的文字和图片，默认的是带有Wix的一些背景图片，正式发布的时候，当然要换成自己产品相关的。

    1.修改许可证书。许可证书需要rtf的富文本格式，我们可以用word先把内容写好，然后文件另存为选择rtf格式的保存就行了，再直接粘贴到工程目录下。然后在Product标签中加入以下代码,license.rtf就是你的许可证书。再次生成，安装的时候就在第一页看到了。

  不要直接修改后缀，要用word转换，不然会不显示或者报错

    <WixVariable Id="WixUILicenseRtf" Value="license.rtf" />

 

 WixVariable是wix比较先进的个功能，Value不能为空。同样我们可以换掉图片及其他。WixUIDialogBmp的图片会出现在欢迎页和安装完成页，规格是 493 × 312。

WixUIBannerBmp 的图片会出现正上方。规格493 × 58,用bmp格式 xp才会显示正常。也不要直接改后缀，用图片处理软件转换。  

 <WixVariable Id="WixUIDialogBmp" Value="bb.bmp"/>
 <WixVariable Id="WixUIBannerBmp" Value="top.bmp"/>

还有WixUIInfoIco，WixUINewIco，WixUIUpIco，WixUIExclamationIco 来更换一些图标。

 2.定义退出页。

  ExitDlg 成功安装后显示，可以加入文字，复选框，让用户选择是否马上执行，我们在安装软件的时候经常看到这个提示。

  我们先加入一条感谢语，在Product元素中插入以下内容，WIXUI_EXITDIALOGOPTIONALTEXT 专门用来展示文字。

<Property Id="WIXUI_EXITDIALOGOPTIONALTEXT" Value="Thank you for installing this product." />

 同理加入一个复选框，用来提示用户运行是否当前程序。

<Property Id="WIXUI_EXITDIALOGOPTIONALCHECKBOXTEXT" Value="Launch My Application Name" />

界面让我改成这个样子了，觉得这个背景透明度也是个问题，这个问题先记下。

 但这个时候 还是不能运行的，我们再看下一节。

三、执行自定义Action

  这里小小的分开下，是因为Action是wix中的一大功能，这次先尝下滋味。需要三步

  1.先引入WixUtilExtension.dll 

  2.用WixShellExecTarget 和 CustomAction来定义这个行为 （在Product元素中加入）

<Property Id="WixShellExecTarget" Value="[#myapplication.exe]" />
<CustomAction Id="LaunchApplication" BinaryKey="WixCA" DllEntry="WixShellExec" Impersonate="yes" />

 WixShellExecTarget 是专门用来运行一个应用程序的，这里的Value中的#号表示的是全路径，而这个myapplication.exe是个id，指向你安装组件的中File的id。相当于这个Property定义了要执行程序的位置。CustomAction定义了这个行为Id就是LanuchApplication,DllEntry表示是入口。深入的认识还是要到后面继续研究。

 3.在UI元素中加入Publish元素来告诉UI如何执行这个行为。

  <UI>
    <UIRef Id="WixUI_Minimal" />
    <Publish Dialog="ExitDialog"
    Control="Finish" 
    Event="DoAction" Value="LaunchApplication">WIXUI_EXITDIALOGOPTIONALCHECKBOX = 1 and NOT Installed</Publish>
  </UI>

 上面两个元素完成了方法的定义，这里的Publish就是触发这个行为。Dialog属性表示是哪个框(dialog)，Control=“Finish” 表示是点击完成键触发这个行为，Event=“DoAction” 表示点击后执行这个行为，应该还有其他的值，现在还不知道。而这个Value 正好指向了CustomAction的Id。 WIXUI_EXITDIALOGOPTIONALCHECKBOX = 1 表示要checkbox 选中后执行。于是乎，仿佛碎片的世界又联系在了一起。这个时候，我们重新生成后，安装一遍，选择复选框，就能执行了。回头想想，为什么是这样，wix这个相当于全部都是配置文件，不像C#的语言那么优雅,语义化。所以开始看起来确实有些恼火呢。理解了才能记得住，每个元素就相当于一张表，而这个Id对于每个元素来说都是唯一的，这样通过Value和Id彼此关联，而且生产MSI文件其实就是个数据库。

 如果要立即执行某个程序，比如bat文件 可以将这个行为加到安装序列中执行

   <CustomAction Id='LaunchFile' FileKey='installdog' ExeCommand=''  Return='asyncNoWait' />
    <InstallExecuteSequence>
      <Custom Action='LaunchFile' After='InstallFinalize'>1</Custom>
    </InstallExecuteSequence>

    <File Source='$(var.Dev)HMIRun\SenseLockDrivers\install.bat' Id='installdog' KeyPath='yes' />

 如果要立即执行某个程序。

<CustomAction Id='LaunchDog'    FileKey='install.bat' ExeCommand=''  Execute="immediate"  Impersonate="yes"  Return="asyncNoWait" />

<InstallExecuteSequence>
      <Custom Action='LaunchDog'   After='InstallFinalize'   >1</Custom>
    </InstallExecuteSequence>

fliekey指向的是一个bat文件，但奇怪的是，直接运行这个bat瞬间就执行完了，在安装过程中执行却要个10秒钟，推测是因为 After='InstallFinalize' 等待整个安装完成，但是我修改成其他的InstallExecuteSequence中的行为，却没有触发安装，在卸载的时候却安装了。

还有一种方法，静默的触发bat文件。不会弹出黑色的框。

    <CustomAction Id="service_start_cmd" Property="QtExecCmdLine" Value="&quot;[dirAD8BC174523EABBBEA5FE139FD0C5127]install.bat&quot;"/>
    <CustomAction Id="service_start" BinaryKey="WixCA" DllEntry="CAQuietExec" Execute="immediate" Return="check" />
    <InstallExecuteSequence>
      <Custom Action="service_start_cmd" After="InstallFinalize" Overridable="yes">NOT Installed</Custom>
      <Custom Action="service_start" After="service_start_cmd" Overridable="yes">NOT Installed</Custom>
    </InstallExecuteSequence>

不过windows系统在非管理员下 又会弹出提示：正在安装这个驱动。。。 这个驱动是否正确安装。  虽然比黑框好了一点，但还是不完美。

 

四、定义文字

 所有安装过程中的文字都是可以重载的， 可以通过增加一个String 指定对应的Id 就可以重载，这个可以用来做一个分离工作。需要两步

  1.需要加入localization  文件，右键，添加新建项，选择localization File . 再用String 来定义你的文字。

<?xml version="1.0" encoding="utf-8"?>
<WixLocalization Culture="en-us" xmlns="http://schemas.microsoft.com/wix/2006/localization">
    <String Id="ApplicationName">**My Application Name</String>
        <String Id="ManufacturerName">My Manufacturer Name</String>
</WixLocalization>

  2.修改你的Product.wxs ,这里的Name 后的表达式就指向localization文件中的Id="Application" 的String。 

<Product Id="*" Name="!(loc.ApplicationName)" .......

    再次安装的时候文件名就变成了**My Application Name，其他地方同理。这样可以避免多次重复的修改，做到文字和配置的分离。

    这一节先到这里，今天眼睛都看花了，自定义的还不止这些，明天继续.....

 全部代码：

<?xml version="1.0" encoding="UTF-8"?>
<Wix xmlns="http://schemas.microsoft.com/wix/2006/wi">
    <Product Id="*" Name="!(loc.ApplicationName)"
   Language="1033" Version="1.0.0.0" Manufacturer="RJStone" UpgradeCode="3486eddf-0957-45cf-8c26-3de8bceca2b4">
        <Package InstallerVersion="200" Compressed="yes" InstallScope="perMachine" />

        <MajorUpgrade DowngradeErrorMessage="A newer version of [ProductName] is already installed." />
        <MediaTemplate />

        <Feature Id="ProductFeature" Title="Setup07" Level="1">
            <ComponentGroupRef Id="ProductComponents" />
        </Feature>
  
  <UI>
    <UIRef Id="WixUI_Minimal" />
    <Publish Dialog="ExitDialog"
    Control="Finish" 
    Event="DoAction" 
    Value="LaunchApplication">WIXUI_EXITDIALOGOPTIONALCHECKBOX = 1 and NOT Installed</Publish>
  </UI>
 
    <WixVariable Id="WixUILicenseRtf" Value="lisences.rtf" />
    <WixVariable Id="WixUIDialogBmp" Value="bb.jpg"/>
    <WixVariable Id="WixUIBannerBmp" Value="top.jpg"/>
    
    <Property Id="WIXUI_EXITDIALOGOPTIONALTEXT" Value="Thank you for installing this product." />
    <Property Id="WIXUI_EXITDIALOGOPTIONALCHECKBOXTEXT" Value="Launch this Application " />
      
    <Property Id="WixShellExecTarget" Value="[#myapplication.exe]" />
    <CustomAction Id="LaunchApplication" BinaryKey="WixCA" DllEntry="WixShellExec" Impersonate="yes" />

 
    </Product>

    <Fragment>
        <Directory Id="TARGETDIR" Name="SourceDir">
            <Directory Id="ProgramFilesFolder">
                <Directory Id="INSTALLFOLDER" Name="Setup07" />
            </Directory>
        </Directory>
    </Fragment>

    <Fragment>
        <ComponentGroup Id="ProductComponents" Directory="INSTALLFOLDER">
            <!-- TODO: Remove the comments around this Component element and the ComponentRef below in order to add resources to this installer. -->
            <!-- <Component Id="ProductComponent"> -->
                <!-- TODO: Insert files, registry keys, and other resources here. -->
      <Component Id="ProductComponent">
        <File Id="myapplication.exe"  Source="$(var.MyApplication.TargetPath)" />
      </Component>
    </ComponentGroup>
    </Fragment>
</Wix>

 

    还是那句话，如果对你有帮助，就顶一下吧