1. Easy Steps: Successfully Applying Changes with the WiX Toolset Installation Process

Inno Setup WiX Toolset InstallShield MSIX Packaging Tool

Check your inbox and confirm the
subscription

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 Implement Updates Using WiX Toolset Installer

Written by Radu Popescu · June 7th, 2021

In this post, we will address installer updates with a focus on the most common scenarios you may encounter when performing a small, minor, or major upgrade.

First, we will see what is inside your WiX Toolset base application and move on to the different types of updates that you can execute for your WiX installers.

What Is Inside Your WiX Toolset Base Application?

To better understand how an application upgrade works, we should first know what its components are and how they interact with each other.

For the scenarios presented in this article, we are using WiX Toolset version 3.11.2. Our base sample application contains an executable file “CMtrace.exe” and a text file“guide.txt” which has the information shown below.

Take note of the ProductID,UpgradeCode, and PackageID in the code below. It will be helpful for future references since they are the ones that are modified through the upgrading process.

Our base application has the following code inside the WiX installer project.

Copy

What Are The Main Types of WiX Update Installers?

Small Updates

Small Updates are used to perform small alterations to one or a few files without changing the product version (major.minor.build) or Product ID GUID.

If you look at our example below, you can observe that the only modification to the package is the text inside the guide.txt file. Since this is a quick fix, you can consider Small Update as a hotfix.

In this case, the element changed in the code is: Package GUID

Copy

Minor Updates

Minor Updates are used to perform minor changes to a package increasing its version.

Since the product remains the same, you don’t need to change the Product GUID.

The only elements changed in the code are the Version attribute and Package GUID.

Copy

Major Updates

Major Updates are used to perform crucial changes to a package, upgrading them from the full version to another.

Let’s assume we perform a Major Upgrade to our application which has the main executable CmTrace2.exe and the 1.0.0 version. Once the upgrade is done, and the functionality is added, the application version will also change to 2.0.0.

The elements changed in the code compared to our base application are Version attribute, Product, and Package GUID.

As a best practice, the UpgradeCode should also be changed every time you make a Major upgrade to your package.

Copy

You can check the types of upgrades and the differences between them in our article on Updates Deployment .

How to Implement WiX Installer Upgrades - Common Scenarios

Updates are meant to keep track of changes performed to previous versions. No matter what scenario you follow, you should always have the UpgradeCode from the previous version in hand.

Here are some of the common scenarios we will encounter when implementing WiX installer updates.

Detecting and Replacing Files and Versions

In this scenario, we want our new package todetect the previous version and include the additional files that we added to our new package.

To do this, we need to add the section below to the code:

Copy

Upgrade Id should have the value ofUpgradeCode from our base application (the one mentioned at the beginning of this article).

OnlyDetect must be set to yes. If set to no, it will remove the previous version.

Minimum and maximum attributes define the version range in which the update will be applied (if found).

Detecting and Replacing the Previous Version Completely

Here, we want our package to remove the previous version. Also, the package can be installed as a standalone. This is mostly used for Major Upgrades.

The only change here is the OnlyDetect value and the maximum value, since now our version range is different (our new application is now version 2.0).

The code should now look like this:

Copy

More about WiX Toolset: We have a dedicated resource page about the WiX Toolset , which includes various topics related to your installer, using custom actions in WiX, and setting a WiX installer build to the current version .

Advanced Installer #1 alternative to the WiX Toolset

We decided to focus on our main goal to save precious time of our developers.

HANS-LEO TEULINGS
PHD – CEO, NEUROSCRIPT, LLC

You might find useful:

Get the most from packaging with Advanced Installer

Try the 30-day fully-featured edition absolutely free!

Download Free Trial

No credit card required

Some Tips

1. Easy Steps: Successfully Applying Changes with the WiX Toolset Installation Process