用WiX编写MSI安装包

用WiX编写MSI安装包

WiX（Windows Installer XML）是Rob Mensching（Windows组的一个SDE）写的一个用来编写MSI安装包的工具集，已经被微软内部的很多产品组采用，例如Office组，以及我所在的MSN组，等等。

下面是WiX的一个简单例子（相当于高级的Hello World!的级别），在这个例子中编写了一个SimpleCopy.msi。安装SimpleCopy.msi将能够：

• 创建C:\Program Files\SimpleCopy目录并拷贝一系列文件；
• 创建HKEY_LOCAL_MACHINE\SOFTWARE\MPG Lab注册表键，该键下的DestPath变量存储了一个文件路径，DestPath可以在msiexec命令行中用DESTPATH来指定；
• 创建名为SimplyCopy的Scheduled Task，该任务每小时运行一次，执行C:\Program Files\SimpleCopy\SimpleCopy.exe，将该目录下data\source.xml拷贝到DestPath中指定的目录；
• Uninstall时，安装时拷贝的文件、创建的注册表键和Scheduled Task都将被删除。

下面就是用WiX编写SimpleCopy.msi的步骤：

1. 从http://sourceforge.net/projects/wix下载wix的2.0.3220.0版本并解压到硬盘，将candle.exe所在的路径添加到Path环境变量中；
2. 用C#编写SimpleCopy.cs并用csc.exe在同一目录下编译成SimpleCopy.exe:

 1using System;
 2using System.IO;
 3using System.Reflection;
 4using Microsoft.Win32;
 5
 6namespace SimpleCopy
 7{
 8    internal class Application
 9    {
10        [STAThread]
11        private static void Main(string[] args)
12        {
13            string sourcexml = GetExecutableLocation() + @"\data\source.xml";
14            if (File.Exists(sourcexml)){
15                DateTime now = DateTime.Now;
16                File.Copy(sourcexml, Application.QueryDestPath() +
17                            @"\source_" + now.ToString("yyMMdd_HH.mm.ss") + ".xml", true);
18            }
19            else{
20                StreamWriter writer = new StreamWriter(QueryDestPath() + @"\error.log", false);
21                writer.WriteLine(DateTime.Now.ToString());
22                writer.WriteLine("Cannot find source file: " + sourcexml);
23                writer.Close();
24            }
25        }
26
27        private static string QueryDestPath()
28        {
29            RegistryKey regkey = Registry.LocalMachine.OpenSubKey(@"SOFTWARE\MPG Lab");
30            if (regkey != null){
31                object obj = regkey.GetValue("DestPath");
32                if (obj != null){
33                    return obj.ToString();
34                }                
35            }
36
37            if (false == Directory.Exists(GetExecutableLocation() + @"\regkey_not_found")){
38                Directory.CreateDirectory(GetExecutableLocation() + @"\regkey_not_found");
39            }
40            return (GetExecutableLocation() + @"\regkey_not_found");
41        }
42
43        private static string GetExecutableLocation()
44        {
45            return Directory.GetParent(Assembly.GetEntryAssembly().Location).ToString();
46        }
47
48    }
49}

3. 在SimpleCopy.cs同一目录下创建"data"子目录，在data\下创建一个任意内容的source.xml；
4. 在SimpleCopy.cs同一目录下编写SimpleCopy.wxs，其Schema文件wix.xsd可以在wix下载解压后的doc目录中找到。SimpleCopy.wxs内容如下：

<?xml version='1.0'?>
<Wix xmlns='http://schemas.microsoft.com/wix/2003/01/wi'>
    <Product Id='c859431f-086d-4840-b2d7-a84b3bce50f2' Name='SimpleCopy' 
            Language='1033' Version='1.0.0.0' Manufacturer='MPG China'>
        <Package Id='2738eb03-978b-4712-8e21-7e1868c74c2f' InstallerVersion='200' Compressed='yes' />
        <Property Id='DESTPATH' Value ='C:\'/>
        <Media Id='1' Cabinet='product.cab' EmbedCab='yes' />
        <Directory Id='TARGETDIR' Name='SourceDir'>
            <Directory Id='ProgramFilesFolder' Name='PFiles'>
                <Directory Id='AppDirectory' Name='SimpleCp' LongName='SimpleCopy'>
                    <Component Id='ExecutableFile' DiskId='1' Guid='379ccaeb-a8c9-448e-a4b3-fa9884676492'>
                        <File Id='SimpleCopy_exe' Name='SimpleCp.exe' 
                            LongName='SimpleCopy.exe' src='SimpleCopy.exe' />
                    </Component>
                    <Directory Id='DataFolder' Name='data'>
                        <Component Id='SrcXml' DiskId='1' Guid='746496f1-d2b1-4334-9b6f-00f71938c459'>
                            <File Id='Source_xml' Name='source.xml' src='data\source.xml' />
                            <Registry Id='4e10403a-1976-447f-b38c-59839cb7c5cb' Root='HKLM' Type='string' 
                                Key='SOFTWARE\MPG Lab' Name='DestPath' Value ='[DESTPATH]'/>
                        </Component>
                    </Directory>
                </Directory>
            </Directory>
        </Directory>
        <Feature Id='AllFiles' Title='Simple Copy All Files' Level='1'>
            <ComponentRef Id='ExecutableFile' />
            <ComponentRef Id='SrcXml' />
        </Feature>
        <InstallExecuteSequence>
            <Custom Action='CreateScheduleTask' After='InstallFinalize'>NOT Installed</Custom>
            <Custom Action='DeleteScheduleTask' After='InstallFinalize'>Installed</Custom>
        </InstallExecuteSequence>
        <Property Id='SCHTASKS'>SCHTASKS.exe</Property>
        <CustomAction Id='CreateScheduleTask' Property='SCHTASKS' 
            ExeCommand='/Create /RU "" /SC HOURLY /TN SimplyCopy /TR "%ProgramFiles%\SimpleCopy\SimpleCopy.exe"'/>
        <CustomAction Id='DeleteScheduleTask' Property='SCHTASKS' 
            ExeCommand='/Delete /TN SimplyCopy /F'/>
    </Product>
</Wix>

 

5. 打开命令行，进入SimpleCopy.cs所在的目录，先后运行candle SimpleCopy.wxs以及light SimpleCopy.wixobj，然后就得到SimpleCopy.msi了：
                        图片略.....................

6. 在命令行运行“msiexec /i SimpleCopy.msi /quiet /log log.txt DESTPATH=d:\”就可以安装了。

相比较其他MSI编写工具（例如Visual Studio 2003/2005，以及InstallShield等），WiX的优点是：

1. 便于版本控制（wxs是纯文本的）；
2. 便于自动化（编辑工具candle.exe和light.exe都是命令行的）。