Installer - Available Actions



 Download and install component
     
Download a specified downloadable component and install it. This action only works for installation components that have been marked as "downloadable" on the "Options" tab of the installation component configuration.

Note: The "Install Files" action already downloads and installs all selected downloadable installation components.This action is intended for scenarios where an installation component has to be downloaded after the "Install files" action has run. For example, you could use this in a custom installer application to install optional files.

Applies to: Installation
Properties:
  • Installation component
    The installation component to be downloaded. Only downloadable installation components are displayed
  • Show progress
    If selected, and a progress bar is available on the current screen, the action will show its progress in the progress bar.
  • Show file names
    If selected, the names of the files that are installed will be shown during the installation.
  • File filter [Handlers]
    Expression or script that is invoked for each file to decide whether to install the file or not.
  • Directory resolver [Handlers]
    Expression or script that resolves the actual installation directory separately for each installed file. Return null, if you would like to choose the standard installation directory for a file.
  • Delay if necessary [Windows]
    If selected and a destination file cannot be replaced, the operation will be scheduled for the next reboot. The context method isRebootRequired() will return true in this case.
  • Trigger reboot if required [Windows]
    If selected and an operation is delayed until reboot, the user will be asked for a reboot automatically at the end of installation.
 Install files
     
Install all files in the distribution tree that are contained in the selected installation components.
Applies to: Installation
Properties:
  • Validate application id
    Check if another application is installed in the selected directory or if the application is not the correct target for an add-on installer. If you have an "installation location" screen, you don't have to select this option.
  • Insufficient disk space warning
    Show a warning message if there is not sufficient disk space for the installation on the selected target drive.
  • Install runtime
    Create the installation directory and install the install4j runtime. If your installer just modifies some folders and does not need launchers, an uninstaller or custom installer applications, you can deselect this option and use other installation roots in the distribution tree to install files.
  • Update bundled JRE
    Update a bundled JRE if it already exists. If your application uses the JRE outside the generated launchers, an update of a bundled JRE might fail. In that case you can deselect this property to keep the old JRE and skip the update.
  • Save downloaded files
    If this property is set and the action downloads files it will try to place them next to the media file. In this case, the installer won't have to download the files again if it is invoked another time.
  • Show file names
    If selected, the names of the files that are installed will be shown during the installation.
  • File filter [Handlers]
    Expression or script that is invoked for each file to decide whether to install the file or not.
  • Directory resolver [Handlers]
    Expression or script that resolves the actual installation directory separately for each installed file. Return null, if you would like to choose the standard installation directory for a file.
  • Installation size calculator [Handlers]
    Expression or script that calculates a custom installation size in bytes. The default size in bytes is passed as a parameter.
  • Delay if necessary [Windows]
    If selected and a destination file cannot be replaced, the operation will be scheduled for the next reboot. The context method isRebootRequired() will return true in this case.
  • Trigger reboot if required [Windows]
    If selected and an operation is delayed until reboot, the user will be asked for a reboot automatically at the end of installation.
 Uninstall files
     
Uninstall all installed files.
Applies to: Uninstallation
 Uninstall previous installation
     
Uninstalls the previous installation of this application in the selected installation directory.
Applies to: Installation
Properties:
  • Installation directory
    The installation directory for which the uninstaller should be run. Leave empty for the current installation directory.
  • Only if the same application ID is found
    If selected, the action will only be performed if the application ID found in the installation directory is the same as that of the currently executed installer.