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

2021-07-27 02:11:59

上一篇介绍了如何联合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">

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

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

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

二、自定义风格

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

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

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

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

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

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" />

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

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

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

三、执行自定义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>

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

上一篇：Wix 安装部署教程(十二) -- 自动更新WXS文件


下一篇：php中soap的使用实例以及生成WSDL文件，提供自动生成WSDL文件的类库——SoapDiscovery.class.php类