InstallShield 2012 Express Edition User Guide - Knowledge Base ...

Chapter 10: Customizing Installation Behavior
Using Custom Actions
Adding an .exe Custom Action to Your Project
The items in the Custom Actions view are organized by chronological order, according to when they are
launched during installation or uninstallation. When you add a custom action to your project, you
specify when the custom action should be launched by adding the action to the appropriate installation
or uninstallation item.
Task To add an .exe custom action to your project:
1. In the View List under Define Setup Requirements and Actions, click Custom Actions.
2. In the Custom Actions During Installation explorer, the Custom Actions During
Maintenance explorer, or the Custom Actions During Uninstallation explorer, click the item
that should contain the custom action that you want to create.
3. Right-click the item and click New EXE. InstallShield adds a new custom action with the name
NewCustomActionn (where n is a successive number).
4. Type a name for the custom action.
5. Configure the settings for the custom action.
Configuring an .exe Custom Action’s Settings
When you add an .exe file custom action to your project, you need to configure its settings.
Task To configure the settings for an .exe custom action in your project:
1. In the View List under Define Setup Requirements and Actions, click Custom Actions.
2. In the Custom Actions During Installation explorer, the Custom Actions During
Maintenance explorer, or the Custom Actions During Uninstallation explorer, click the
custom action that you want to configure.
3. Configure the settings in the grid on the right.
VBScript and JScript Custom Actions
Depending on your installation’s requirements, you may need to create a custom action that calls an
existing VBScript file (.vbs) or JScript (.js). To learn how to create this type of custom action, see Adding
a VBScript or JScript Custom Action to Your Project.
VBScript Custom Action Example
The following is an example of a VBScript custom action that determines the value of INSTALLDIR and
changes it depending on the presence of a file.
' Get the value of INSTALLDIR
Dim sInstalldir
228 ISE-1800-UG01 InstallShield 2012 Express Edition User Guide