Adding an InstallScript Package to an Advanced UI or Suite/Advanced UI Project

InstallShield 2015

Project: This information applies to the following project types:

Advanced UI
Suite/Advanced UI

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

Requirements for Adding an InstallScript Installation as an InstallScript Package (Instead of as an Executable Package) to an Advanced UI or Suite/Advanced UI Project

InstallShield lets you add an InstallScript package to an Advanced UI or Suite/Advanced UI project if the InstallScript package meets the following requirements:

The InstallScript package is uncompressed.
InstallShield 2012 Spring or later is used to build the InstallScript package and the Advanced UI or Suite/Advanced UI installation.
The InstallScript package uses an event-based script; it should not use the program...endprogram style script. For information on converting a script that uses a program...endprogram block to an event-based script, see OnShowUI.

If any of these conditions cannot be met, you can include the InstallScript installation as an executable file package (.exe) in your Suite/Advanced UI project, instead of as an InstallScript package. However, including the InstallScript installation as an InstallScript package instead of as an executable package (.exe) is preferred. For more information, see Guidelines for Adding Packages to an Advanced UI or Suite/Advanced UI Project.

Note: If you include an InstallShield 2012 or earlier InstallScript installation as a package in an Advanced UI or Suite/Advanced UI installation, the Advanced UI or Suite/Advanced UI installation encounters a run-time error when it attempts to launch the InstallScript package.

Instructions for Adding an InstallScript Package to an Advanced UI or Suite/Advanced UI Project

To add an InstallScript package to your Advanced UI or Suite/Advanced UI project:

1. In the View List under Organization, click Packages.
2. Right-click the Packages explorer and then click InstallScript Package (.hdr). The Select the installation file for this package dialog box opens.
3. Select the data1.hdr file of the InstallScript installation, and then click Open. The data1.hdr file must be in the same folder as the remaining files of the uncompressed InstallScript installation that you want to include as a package in your Advanced UI or Suite/Advanced UI project.

Tip: When you select the data1.hdr file for the InstallScript installation, InstallShield automatically includes the necessary .cab files, InstallScript files (.rul), and other files that the Advanced UI or Suite/Advanced UI installation needs to launch the InstallScript package in an Advanced UI or Suite/Advanced UI installation.

InstallShield adds the package, plus any additional folders and files, in the Packages explorer.

Tip: To learn more about the inclusion of InstallScript packages in Advanced UI and Suite/Advanced UI projects, see Special Considerations for InstallScript Packages in Advanced UI and Suite/Advanced UI Projects.

See Also