Mastering MSI Creation: A Step-by-Step Guide Using WiX Toolset

Versus

Inno SetupWiX ToolsetInstallShieldMSIX Packaging Tool

Check your inbox and confirm the
subscription

Exclusive Newsletter

Exclusive Newsletter

Get the latest WiX insights direct to your inbox. Subscribe now!

Disclaimer: This post includes affiliate links

If you click on a link and make a purchase, I may receive a commission at no extra cost to you.

How to create an MSI installer with WiX

Written by Renato Ivanescu · June 20th, 2023

The MSI format is a widely recognized standard in the software industry for distributing software packages to Windows-based devices. MSI packages offer numerous advantages over alternative software installation methods, including enhanced reliability and improved performance.

WiX is an open-source toolset to build MSI packages. It enables developers to create a software installation by writing XML that describes components, registry entries, and other resources.

In this article, I’ll show you how to use WiX to create an MSI installer for a Windows Forms application. Let’s dive in!

Add the setup project to your application

Once you have created the Windows Forms application, the next step is to add the setup package to it.

1. Right-click on the project solution → Add → New project.
2. From the project list, choose Setup Project for WiX. You will find this template only if you have the Wix Toolset Visual Studio Extension installed. Need help installing it? We’ve got you – check out this tutorial.

After creating the setup project, you should see it in _Solution Explore_r. The Product.wxs file is the one containing the setup project logic.

Add project output to your setup project

Next, we need to include the deployable files in the setup project. To achieve this, we can use the Wix Setup Editor.

Wix Setup Editor is an interactive GUI used to manage the setup files. It is available only if you have the Wax extension installed. If you want to see how to add the extension, you can also read this article.

To open the editor, go to Tools → WiX Setup Editor. Here we have to make some configurations:

• Select the setup project in the ‘Setup project to edit’ section. In our case, it is AppSetup.
• For the ‘Root directory’, select INSTALLFOLDER.
• In the ‘Projects to install section’, select your Window Forms application. We selected MyApp, as this is our application.

Make sure the files have the resolved state like in the image above. If they have the unmapped state as shown below, update it to resolved by pressing the ‘+’ button under the warning sign.

How to edit product details

To modify the product details, navigate to the Product.wxs file and make the necessary edits to the relevant fields. For example, we set the version to 1.2 and the manufacturer to Caphyon.

Copy

How to create Shortcuts for your application?

In order to create a shortcut, we will need to make edits to the XML file since the Wix Setup Editor does not provide direct shortcut creation functionality.

Follow the next steps to add a shortcut on the Desktop and one in the Programs Menu:

1. Define the directory structures.