Project Templates

Introduction

The WiX Visual Studio package provides the following Visual Studio project templates:

WiX Project

A WiX project provides a starting point that can be used to create a new Windows Installer package (.msi) file.

Each new WiX project includes a .wxs file that consists of a <Product> element that contains a skeleton with the WiX authoring required to create a fully functional Windows Installer package. The <Package> element includes <Package>, <Media>, <Directory>, <Component> and <Feature> elements.

WiX Library Project

A WiX library project provides a starting point that can be used to create a new WiX library (.wixlib) file. A .wixlib file is a library of setup functionality that can be easily shared across different WiX-based packages by including it when linking the setup package.

Each new WiX library project includes a .wxs file that consists of an empty <Fragment> element that can be populated with WiX authoring that can be shared by multiple packages.

WiX Merge Module Project

A WiX merge module project provides a starting point that can be used to create a new Windows Installer merge module (.msm) file. A merge module contains a set of Windows Installer resources that can be shared by multiple Windows Installer installation packages by merging the contents of the module into the .msi package.

Each new WiX merge module project includes a .wxs file that consists of a <Module> element that contains a skeleton with the WiX authoring required to create a fully functional merge module. The <Module> element includes <Package>, <Directory> and <Component> elements.

Creating WiX Projects

To create a new WiX project:

  1. In Visual Studio, click on the File menu and select New | Project...
  2. Click on WiX in the Project types tree control in the Add New Project dialog.
  3. Select the appropriate WiX project template, provide a name and location and click OK to create the new project.

To add a new WiX project to an existing solution:

  1. Right-click on the solution in the Visual Studio solution explorer, choose Add | New Project...
  2. Click on WiX in the Project types tree control in the Add New Project dialog.
  3. Select the appropriate WiX project template, provide a name and location and click OK to create the new project and add it to the solution.