Configuring Screens


Screens are configured on the Installer->Screens & Actions step. A screen is a single step in an installer application. It displays information to the user or gathers user input.

If a screen has attached actions, there will be an expand control to the left of the screen icon that allows you to show the associated actions.

Some screens only make sense when corresponding actions are used later on in the installer or uninstaller. For example, the "Services" screen will only be displayed at runtime if there are "Install a service" actions present on a subsequent screen. If such a dependency is not fulfilled after adding a screen, a corresponding notification is displayed.

Properties of screens

Common properties of screens are:

Available screens

The following standard screens are available in install4j:

  Empty form

An empty form to which form components can be added. By default, form components are layouted along the vertical axis, but you can use layout groups for greater flexibility. Form components with user input are bound to installer variables that can by referenced by other elements in the installer, for example by actions.

  Category: Form templates

  Banner with header at the top

A form that has "Banner" as the default style and a configurable header label at the top.

  Directory selection

A form that asks the user to select a directory. All displayed messages are configurable.

  Display PDF file

A form that displays a PDF file in an embedded cross-platform PDF viewer.

  Display progress

A form that displays a progress bar with a status line capturing the progress information of associated actions. The default post-activation script executes any associated actions immediately when the screen is activated. All displayed messages are configurable.

  Display text

A form that displays text to the user, either plain text or HTML. All displayed messages are configurable.

  Program group selection

A screen that allows the user to select a program group on Microsoft Windows. All displayed messages are configurable.

  Category: Standard screens

  Welcome

A screen that welcomes the user to the installation of your application. This screen should be placed at the beginning of the installation

  Display license agreement

A screen that displays a license agreement to the user, either plain text or HTML. The license agreement must be accepted before the installation continues.

  Installation location

The screen that asks the user where to install the application. This determines the principal installation directory.

  Installation type

A screen that displays a list of installation types that correspond to configurable set of installation components. The default types "Full","Standard" and "Customize" are provided by default, with localized names and descriptions. Installation components are configured in the install4j IDE on the "Files->Installation Components" step

The "Installation components" screen may be hidden by this screen, depending on the installation type selected by the user. This screen will not be shown if no installation components are defined.

You can choose for each installation type if it should be customizable or not. If the installation type that is selected by the user is customizable, the "Installation components" screen will be shown if present, otherwise that screen will be skipped. This condition can also be checked by inspecting the boolean value of the installer variable sys.preventComponentCustomization.

  Installation components

A screen that displays all installation components and asks the user which components should be installed. This screen will not be shown if no installation components are defined.

  Create program group

A screen that allows the user to select the default program group. Under Windows, this screen sets installer variables that influence "Create program group" and "Create start menu entry" entry actions. Under Unix, the screen asks the user whether and where symbolic links to launchers should to be created. Under macOS, the screen is not shown.

  File associations

A screen that displays a list of all subsequent file association actions and asks the user which associations should be made. This screen will not be shown if there are no corresponding file association actions after this screen.

  Additional confirmations

A screen that displays a list of confirmations as check boxes whose results can be used in condition expressions for actions. While other types of form components can be added to this screen, only check boxes and other simple elements are consistent with the displayed text. For arbitrary forms, use the "Configurable form" screen instead.

  Installation

The screen that displays displays the installation progress. Where possible, installation actions should be added to this screen.

  Display information

A screen that displays text to the user, either plain text or HTML. In contrast to the "Display text" form template, all messages on this screen are pre-defined and localized.

  Finish

A screen that tells the user that the installation is finished. This screen should be placed at the end of the installation.

  Uninstall Welcome

A screen that welcomes the user to the uninstallation of your application. This screen should be placed at the beginning of the uninstallation.

  Uninstallation

The screen that displays displays the uninstallation progress. Where possible, uninstallation actions should be added to this screen.

  Uninstallation failure

The screen that is displayed if the uninstallation was not completed successfully. Further information regarding the uninstallation problems is displayed to the user. This screen is not shown if the uninstallation was completed successfully or if it is placed before the uninstallation screen. The uninstaller will terminate after showing this screen in case of failure.

  Uninstallation success

The screen that is displayed if the uninstallation was completed successfully.