WiX 标签使用介绍：打造专业安装程序的利器

===

在软件开发过程中，创建一个专业且功能强大的安装程序是提升用户体验的关键步骤之一。WiX（Windows Installer XML）工具集提供了一种灵活且强大的方式来构建安装程序。今天，我们就来深入探讨 WiX 中一些常用的标签及其使用方法，帮助你打造高质量的安装程序。

什么是 WiX？

WiX 是一个开源的工具集，用于构建 Windows 安装程序。它使用 XML 文件来描述安装程序的各个方面，包括文件、注册表项、快捷方式等。WiX 将这些 XML 文件编译成 Windows Installer 数据库，从而生成 .msi 安装包。

常用 WiX 标签介绍

1. <Product>

<Product> 标签是 WiX 项目的核心，它定义了安装程序的基本信息，如产品名称、版本、制造商等。

<Product Id="*" Name="MyApplication" Version="1.0.0.0" Manufacturer="MyCompany" UpgradeCode="PUT-GUID-HERE">
  <!-- Product contents go here -->
</Product>

• Id

  ：产品的唯一标识符，通常使用 * 表示自动生成。

• Name

  ：产品的名称。

• Version

  ：产品的版本号。

• Manufacturer

  ：产品的制造商。

• UpgradeCode

  ：用于升级的唯一标识符，必须保持不变。

2. <Package>

<Package> 标签定义了安装包的属性，如安装平台、压缩方式等。

<Package InstallerVersion="200" Compressed="yes" InstallScope="perMachine" />

• InstallerVersion

  ：安装程序的版本号，通常设置为 200 或更高。

• Compressed

  ：是否压缩安装包，通常设置为 yes。

• InstallScope

  ：安装范围，可以是 perMachine（系统级）或 perUser（用户级）。

3. <Directory>

<Directory> 标签用于定义安装目录结构。

<Directory Id="TARGETDIR" Name="SourceDir">
  <Directory Id="ProgramFilesFolder">
    <Directory Id="INSTALLFOLDER" Name="MyApplication">
      <!-- Files and components go here -->
    </Directory>
  </Directory>
</Directory>

• Id

  ：目录的唯一标识符。

• Name

  ：目录的名称。

• TARGETDIR

  ：根目录，通常设置为 SourceDir。

• ProgramFilesFolder

  ：程序文件夹。

• INSTALLFOLDER

  ：自定义的安装目录。

4. <Component>

<Component> 标签用于定义安装组件，每个组件可以包含一个或多个文件。

<Component Id="MyApplicationExe" Guid="PUT-GUID-HERE">
  <File Id="MyApplicationExeFile" Source="MyApplication.exe" KeyPath="yes" />
</Component>

• Id

  ：组件的唯一标识符。

• Guid

  ：组件的唯一 GUID，可以使用工具生成。

• KeyPath

  ：用于标识组件安装路径的文件。

5. <File>

<File> 标签用于定义要安装的文件。

<File Id="MyApplicationExeFile" Source="MyApplication.exe" KeyPath="yes" />

• Id

  ：文件的唯一标识符。

• Source

  ：文件的源路径。

• KeyPath

  ：是否将该文件作为组件的键路径。

6. <Feature>

<Feature> 标签用于定义安装功能，可以包含一个或多个组件。

<Feature Id="MainApplication" Title="Main Application" Level="1">
  <ComponentRef Id="MyApplicationExe" />
  <!-- Other components go here -->
</Feature>

• Id

  ：功能的唯一标识符。

• Title

  ：功能的标题。

• Level

  ：安装优先级，通常设置为 1。

• <ComponentRef>

  ：引用组件的标签。

7. <Shortcut>

<Shortcut> 标签用于创建快捷方式。

<Directory Id="ProgramMenuFolder">
  <Directory Id="ApplicationProgramsFolder" Name="MyApplication">
    <Component Id="ApplicationShortcut" Guid="PUT-GUID-HERE">
      <Shortcut Id="ApplicationStartMenuShortcut"
                Name="MyApplication"
                Description="MyApplication"
                Target="[#MyApplicationExeFile]"
                WorkingDirectory="INSTALLFOLDER" />
      <RemoveFolder Id="ApplicationProgramsFolder" On="uninstall" />
      <RegistryValue Root="HKCU" Key="Software\MyCompany\MyApplication" Name="installed" Type="integer" Value="1" KeyPath="yes" />
    </Component>
  </Directory>
</Directory>

• Id

  ：快捷方式的唯一标识符。

• Name

  ：快捷方式的名称。

• Description

  ：快捷方式的描述。

• Target

  ：快捷方式的目标文件，使用 [#FileId] 引用文件。

• WorkingDirectory

  ：快捷方式的工作目录。

8. <Property>

<Property> 标签用于定义安装属性，如安装路径、用户输入等。

<Property Id="WIXUI_INSTALLDIR" Value="INSTALLFOLDER" />

• Id

  ：属性的唯一标识符。

• Value

  ：属性的值。

9. <UI>

<UI> 标签用于定义用户界面，可以使用 WiX 提供的预定义界面或自定义界面。

<UI>
  <UIRef Id="WixUI_InstallDir" />
  <Publish Dialog="WelcomeDlg" Control="Next" Event="NewDialog" Value="InstallDirDlg">1</Publish>
  <Publish Dialog="InstallDirDlg" Control="Back" Event="NewDialog" Value="WelcomeDlg">1</Publish>
  <Publish Dialog="InstallDirDlg" Control="Next" Event="NewDialog" Value="VerifyReadyDlg">1</Publish>
</UI>

• <UIRef>

  ：引用预定义的用户界面。

• <Publish>

  ：定义用户界面的事件和动作。

实际应用示例

以下是一个完整的 WiX 项目示例，展示了如何使用上述标签创建一个简单的安装程序。

<?xml version="1.0" encoding="UTF-8"?>
<Wix xmlns="http://schemas.microsoft.com/wix/2006/wi">
<Product Id="*" Name="MyApplication" Version="1.0.0.0" Manufacturer="MyCompany" UpgradeCode="PUT-GUID-HERE">
    <Package InstallerVersion="200" Compressed="yes" InstallScope="perMachine" />

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

    <Feature Id="MainApplication" Title="Main Application" Level="1">
      <ComponentGroupRef Id="ProductComponents" />
    </Feature>

    <UI>
      <UIRef Id="WixUI_InstallDir" />
      <Publish Dialog="WelcomeDlg" Control="Next" Event="NewDialog" Value="InstallDirDlg">1</Publish>
      <Publish Dialog="InstallDirDlg" Control="Back" Event="NewDialog" Value="WelcomeDlg">1</Publish>
      <Publish Dialog="InstallDirDlg" Control="Next" Event="NewDialog" Value="VerifyReadyDlg">1</Publish>
    </UI>

    <Property Id="WIXUI_INSTALLDIR" Value="INSTALLFOLDER" />
</Product>

<Fragment>
    <Directory Id="TARGETDIR" Name="SourceDir">
      <Directory Id="ProgramFilesFolder">
        <Directory Id="INSTALLFOLDER" Name="MyApplication">
          <Component Id="MyApplicationExe" Guid="PUT-GUID-HERE">
            <File Id="MyApplicationExeFile" Source="MyApplication.exe" KeyPath="yes" />
          </Component>
        </Directory>
      </Directory>
    </Directory>
</Fragment>

<Fragment>
    <ComponentGroup Id="ProductComponents" Directory="INSTALLFOLDER">
      <Component Id="MyApplicationExe" Guid="PUT-GUID-HERE">
        <File Id="MyApplicationExeFile" Source="MyApplication.exe" KeyPath="yes" />
      </Component>
    </ComponentGroup>
</Fragment>
</Wix>

总结

通过上述介绍，你已经了解了 WiX 中一些常用的标签及其使用方法。这些标签帮助你定义产品的基本信息、安装目录、组件、文件、快捷方式、用户界面等，从而构建一个功能强大的安装程序。

希望这篇文章能帮助你更好地使用 WiX 工具集，提升你的软件安装体验。如果你有任何疑问或建议，欢迎在评论区留言。让我们一起在软件开发的道路上不断进步！