Wix使用整理(二)

1)         安装卸载时进行日志记录

Wix 制作的 Installer 的调试很麻烦，没有直接的 Bug 工具，可以通过记录安装日志的方式进行间接调试。命令为 msiexec /i package.msi /l log.txt
详细参考： msiexec /Option <Required Parameter> [Optional Parameter] 安装选项         </package | /i> <Product.msi>                  安装或配置产品         /a < Product.msi>                 管理安装 - 在网络上安装产品         /j<u|m> <Product.msi> [/t <Transform  List>] [/g <Language ID>]                 播发产品 - m 播发到所有用户， u 播发到当前用户         </uninstall | /x> <Product.msi |  ProductCode>                 卸载产品 显示选项         /quiet                 安静模式，无用户交互         /passive                 无从参与模式 - 只显示进程栏         /q[n|b|r|f]                 设置用户界面级别                 n - 无用户界面                 b  - 基本界面                 r - 精简界面                 f - 完整界面 ( 默认值 )         /help                 帮助信息 重新启动选项          /norestart                 安装完成后不重新启动         /promptrestart                 提示用户重新启动 ( 如果必要 )         /forcerestart                 安装后总是重新启动计算机 日志选项         /l[i|w|e|a|r|u|c|m|o|p|v|x|+|!|*] <LogFile>                  i - 状态消息                 w  - 非致命警告                 e - 全部错误消息                 a - 操作的启动                 r  - 操作特定记录                 u - 用户请求                 c - 初始界面参数                 m  - 内存不足或致命退出信息                 o - 磁盘空间不足消息                 p - 终端属性                 v  - 详细输出                 x - 额外调试信息                 + - 扩展到现有日志文件                 ! - 每一行刷新到日志                 *  - 记录所有信息，除了 v 和 x 选项         /log < LogFile>                 与 /l* < LogFile> 相同 更新选项         /update <Update1.msp>[;Update2.msp]                  应用更新          /uninstall <PatchCodeGuid>[;Update2.msp] /package < Product.msi | ProductCode>                 删除产品的更新 修复选项         /f[p|e|c|m|s|o|d|a|u|v] <Product.msi |  ProductCode>                 修复产品                 p - 仅当文件丢失时                 o  - 如果文件丢失或安装了更旧的版本 ( 默认值 )                 e - 如果文件丢失或安装了相同或更旧的版本                 d - 如果文件丢失或安装了不同版本                 c - 如果文件丢失或较验和与计算的值不匹配                 a - 强制重新安装所有文件                 u - 所有必要的用户特定注册表项 ( 默认值 )                 m - 所有必要的计算机特定注册表项 ( 默认值 )                 s - 所有现有的快键方式 ( 默认值 )                 v - 从源运行并缓存本地数据包 设置公共属性         [PROPERTY=PropertyValue]

2)         安装默认位置的修改

安装包一般默认安装在系统盘的 Program Files 文件夹下，此文 件在 Wix 中为 ProgramFilesFolder ，使 用形式为： <Directory  Id="ProgramFilesFolder"></Directory >     还有很多内置的文件夹描述属 性，比如桌面 ——DesktopFolder 、开始菜单的程序 ——ProgramMenuFolder ，这些都可以直接用。     有时候安装程序限定要装在某个盘 的根目录中，这时候可以用 WindowsVolume 来代替系统盘，但是使用方法上有一定的区别：     < SetDirectory Id="WINDOWSVOLUME"  Value="[WindowsVolume]"/>     < Directory  Id="WINDOWSVOLUME"></Directory>     不加上 SetDirectory 会报错，最好加 上。
    要想使用自己定义的安装目录， 则要对 Wix 自带 的属性 WIXUI_INSTALLDIR 进行包装。      < Property Id="WIXUI_INSTALLDIR" Value="INSTALLLOCATION" />

自定义 CustomAction( 一 )

CustomAction 在 Wix 中扮演着很重要的角色，这里讲讲它的其中一个用途 —— 根据条件设置属性的值。 例子： <Property Id="IDEVC71" Value="not detected"/> < Property Id="VC71PATH">       <RegistrySearch Id="VC71" Type="raw"  Root="HKLM" Key="SOFTWARE\Microsoft\VisualStudio\7.1"  Name="InstallDir"/> < /Property> < CustomAction  Id="MyAction.SetVC71Property" Return="check" Property="IDEVC71"  Value="detected">VC71PATH</CustomAction>
用途：一旦在注册表中找到相关 的值，那么属性 IDEVC71 的值将被设为 detected ，否则为 not detected

3)         如何在安装时设置注册表和环境变量

设置注册表： <RegistryValue Root="HKCU" Key="Software\Developer"  Name="installed" Type="integer" Value="1" KeyPath="yes"/>     设置环境变量：（这里将环境变量的设置作为一个 Component ） <Component  Id="ProductEnvironment" Guid="" KeyPath="yes">       <Environment Id='UpdatePath' Name='PATH' Action='set' System='yes' Part='first' Value='[INSTALLLOCATION]bin'/>       <Environment Id='SetTclLibraryPath' Name='TCL_LIBRARY' Action='set' System='yes'  Part='all' Value='[INSTALLLOCATION]msys\lib'/> < /Component>     前者是添加到系统变量 PATH 中，后者是新建系统环境变量 TCL_LIBRARY

4)         自定义 CustomAction( 二 )

调用本机应用程序： <Property Id="NOTEPAD">Notepad.exe</Property> < CustomAction Id="LaunchReadme" Property="NOTEPAD"  ExeCommand="[INSTALLLOCATION]README.txt" Return="asyncNoWait"/>     用途：调用 Notepad 程序（记事本）打开安装目录下的 README.txt 文件。

5)         INI 文件的操作

Wix 提供对标准 INI 文件的操作，包括新建、编辑等。 例子： <IniFile Id="WriteIntoFile" Action="addLine" Key="InstallDir" Name="Foobar.ini" Sections="Paths" Value="[INSTALLDIR]"/> 用途：在文件 Foobar.ini 文件中 Paths 段下添加一行 “InstallDir = 安装目录 ” 。 Action 中的操作包括添加、删除、新建等。在实际编写代码时会有自动提示。

6)         Heat 的特殊用法

Heat 工具用于 harvest 文件或者文件夹，是比较基础的 Wix 工具，这里讲讲它的一个特殊用法：配合 candle 使用 var 传递参数。      例如：       heat.exe  dir  VC80 -gg -nologo -ke -sfrag -template:fragment  -dr INSTALLLOCATION  -cg VC80ComponentGroup -var var.VC80Dir -out build\VC80.wxs     用途：将文件夹 VC80 下的所有文件和文件夹打包进 VC80ComponentGroup 里，源文件根目录 SourceDir 用（ $var.VC80Dir ）代替。      编译的时候使用 candle  -dVC80Dir="VC80" 即可，这样就可以同时对不同文件夹下的 文件进行一次性处理。 -d 参数可以有多个，也可以在 light 的时候调用，尝试成功。

7)         Wix 自动化 Build 流程

heat

candle

light 目前可以考虑使用基本的 BAT 批处理命令进行自动化的 Build 过程，以后可以考虑引入 Build 系统。

8)         关于 FilesInUse 的使用

Wix 中自带了 FilesInUse 和 MsiRMFilesInUse2 个错误处理的对话框 一般不需要开发人员去处理，只需要在 Install UI Sequence 前引用这两个对话框即可 <DialogRef Id = "FilesInUse"> 这样卸载或者其他操作时，当前安 装的文件正在被使用时会出现提示框，要求用户选择操作