利用WIX制作安装包(1)

#installation

下载最新版本的WIX toolset 并安装DOWNLOAD

Wix toolset V3.5之后的版本已经可以集成到visual studio，我们可以直接在vs中编写代码，并借助vs进行编译。

#demo

首先打开 Visual Studio，然后选择创建WIX Setup Project. 创建完成之后的在项目中我们可以看到一个名为Product.wxs 的文件，其代码如下：

<?xml version="1.0" encoding="UTF-8"?>
<Wix xmlns="http://schemas.microsoft.com/wix/2006/wi">
    <Product Id="*" Name="SetupProject1" Language="1033" Version="1.0.0.0" Manufacturer="" UpgradeCode="8e1efb05-1e12-40e5-abca-c8bd7965bf2a">
        <Package InstallerVersion="200" Compressed="yes" InstallScope="perMachine" />

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

        <Feature Id="ProductFeature" Title="SetupProject1" Level="1">
            <ComponentGroupRef Id="ProductComponents" />
        </Feature>
    </Product>

    <Fragment>
        <Directory Id="TARGETDIR" Name="SourceDir">
            <Directory Id="ProgramFilesFolder">
                <Directory Id="INSTALLFOLDER" Name="SetupProject1" />
            </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> -->
        </ComponentGroup>
    </Fragment>
</Wix>

属性介绍:

 1. UpgradeCode 标签中的 UpgradeCode 是产品的版本id。产品的升级卸载全部要用到它，一旦指定之后就不要修改。
 2. product标签中的 id 是该产品当前版本的id。它每次在升级版本的时候都需要改变。
 3. Directory 定义产品安装目录的目录结构
 4. Feature 产品的功能列表
 5. MajorUpgrade 防止产品降级安装。
 6. Manufacturer 公司或者组织名称

#file

项目创建完成之后，我们需要往安装包里面添加文件。WIX添加文件的方法很方便，直接使用<File Source="文件路径" /> 就可以把一个文件添加到安装包中来。文件路径 可以用绝对路径和相对路径来表示，在Wix中相对路径的可能需要用到变量。例如：

$(var.ReferencedProjectName.TargetDir) 表示项目中引用的另一项目‘ReferencedProjectName‘的输出路径

$(env.WIXPATH) 表示系统的环境变量WIXPATH所指向的路径。

关于其它的表示方法请大家参阅官网。

在这里我们在项目中添加一个文件夹resource , 并在这个文件夹下添加一个TextFile1.txt，然后在上述代码中的//todo 注释的下面添加如下代码

<Component Id="ProductComponent" Guid="7B428173-1277-482B-BC2E-CC008F3B79F9">
    <File Source="resource/TextFile1.txt" />
</Component>

然后指定Manufacturer 后就进行编译，编译成功之后进行安装，之后大家在c:/programfiles(X86)/SetupProject1 的目录下就可以看到TextFile1.txt 文件了。就这样一个简单的安装包就制作成功了。 但是这一一个简单的安装包绝对不能满足我们日常的工作需要。下面我将为大家介绍如何实现一些另外的操作

#directory

自定义安装目录结构。修改directory结构目录为如下

<Fragment>
    <Directory Id="TARGETDIR" Name="SourceDir"
        <Directory Id="ProgramFilesFolder">
            <Directory Id="INSTALLFOLDER" Name="SetupProject1">
                <Directory id="LOG" name="log"/>
                <Directory id="DATA" name="data"/>
            </Directory>
        </Directory>
    </Directory>
    </Fragment>

然后重新编译安装。就会发现安装之后的目录结构已经变成了如下

    -ProgramFiles(x86)
    --SetupProject1
    ---log
    ---data

#ui

WIX默认为我们提供了五种UI类型。关于每种UI的样式。请大家自己尝试或者查看文档。

1. WixUI_Advanced Dialog Set
2. WixUI_FeatureTree Dialog Set
3. WixUI_Minimal Dialog Set
4. WixUI_Mondo Dialog Set
5. WixUI Dialogs

如果我们要引用任一UI，我们只需要在product.wxs 文件中添加如下代码

<UIRef id="WixUI_Advanced"/>

然后编译运行，就会看到UI已经发生了改变。如果需要自定义UI则需要重新编写一个UI，然后添加到WixUI_Advanced 的 UI Sequence中去.(请见下一篇)

#action

WIX 允许我们自定义Action。如果需要自定义Custom Action，我们需要另外创建一个类型为C# Custom Action Project 的项目。创建成功后，在项目中添加一个CustomAction.cs 然后编辑代码如下：

using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.Deployment.WindowsInstaller;

namespace CustomAction1
{
    public class CustomActions
    {
        [CustomAction]
        public static ActionResult CustomAction1(Session session)
        {
            session.Log("Begin CustomAction1");
            return ActionResult.Success;
        }
    }
}

这样一个自定义的方法就定义好了。然后编译项目。该项目编译成功之后会有两个输出文件CustomAction.dll 和 CustomAction.CA.dll. 其中以CA.dll 结尾的文件才是我们所需要的文件。 然后我们把CustomAction项目添加到之前创建的项目的引用中去。然后添加文件customAction.wxs 并添加如下代码

<?xml version="1.0" encoding="UTF-8"?>
<Wix xmlns="http://schemas.microsoft.com/wix/2006/wi">
    <Fragment>
    <Binary Id="BINARYFILE" SourceFile="$(var.CustomAction.TargetDir)CustomAction1.CA.dll" />
    <CustomAction Id="CustomAction1" BinaryKey="BINARYFILE" DllEntry="CustomAction1" />
    </Fragment>
</Wix>

这样一个CustomAction就创建并引入成功了。下面我们就可以调用这个方法了。在WIX中Action的执行时有顺序的。如果我们要添加一个自定义事件，我们必须要指定它在什么事件之前或者之后执行，见如下代码，关于WIX的事件顺序请参考事件顺序

<InstallExecuteSequence>
    <Custom Action="CustomAction1" After="InstallFiles"/>
  </InstallExecuteSequence>

上述代码指定了在InstallFiles 方法执行完成之后立马执行CustomAction1. 就这样，一个自定义的方法就定义成功，并且被成功调用了。

利用自定义的CustomAction我们可以做一些自定义操作。比如写log文件或者其它。

下一篇我将为大家介绍如何使用WIX制作自定义界面，并且将自定义界面添加到UI序列中去