Customizing the New Update Available Dialog

InstallShield 2024

Project: This information applies to the following project types:

•

Advanced UI

•

Suite/Advanced UI

The Suite/Advanced UI project type is available in the Premier edition of InstallShield. For information about the differences between these two project types, see Advanced UI Projects vs. Suite/Advanced UI Projects

The New Update Available dialog box is a runtime interface displayed when an update or newer version of an application is available for download on the target system. This dialog box is typically triggered as scheduled, based on the update configuration specified in the App Updates Check area on the Updates tab of the Releases explorer in the Media view. The New Update Available dialog box typically includes the following:

•

A message stating that an update is available.

•

Action buttons such as Remind Me Later, Skip This Update, and Download Now.

To configure the New Update Available dialog box, which is displayed during an Advanced UI or Suite/Advanced UI installer installation, you can add the following properties with their required values in the isupdate.xml file, and then reupload the updated XML file to the designated location:

•

DialogBackgroundColor—Use this property to specify the background color in the New Update Available dialog box.

•

DialogHeaderFontSize—Use this property to define the font size of the dialog header in the New Update Available dialog box. It is recommended that you define the size above 28 for better readability.

•

DialogBodyFontSize—Use this property to define the font size of the dialog text and button text in the New Update Available dialog box. It is recommended that you define the size above 18 for better readability.

•

DialogTextColor—Use this property to specify the color of the dialog text, button text, and dialog header in the New Update Available dialog box.

The color values should be defined in hexadecimal format, such as 0xRRGGBB, where:

•

0x indicates that the following characters are in hexadecimal.

•

RR, GG, and BB represent the red, green, and blue components of the color, respectively, each ranging from 00 to FF.

For example:

•

0xFF0000 represents red.

•

0x00FF00 represents green.

•

0x0000FF represents blue.

•

0xFFFFFF represents white.

•

0x000000 represents black.

You can add the properties with their respective values to the isupdate.xml file as shown in the example below: