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.
  • Accept all SSL certificates [Error Handling]
    If the protocol of the URL starts with "https" and this property is selected, the SSL certificate will not be checked for validity. This is only recommended for testing purposes when working with self-signed certificates.
  • 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 in single bundle [macOS]
    This option only applies to single bundle media types. If selected, files will be resolved inside the bundle. In this case, the behavior is equivalent to the "Install files" action. If unselected files will be resolved like specified in the distribution tree. A "Directory resolver" script can be used to specify a useful installation location.
 Execute previous uninstaller
     
Uninstalls the previous installation of this application in the selected installation directory by executing the previous uninstaller.
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.
  • Uninstall services
    If selected, the uninstaller will auto-uninstall services. Deselect this option if you want to retain previous service settings like the user account setting on Windows. Works only with uninstallers built with install4j 6.1+.
  • Installer variables
    Specify installer variables that should be passed to the uninstaller.

    Use the button on the right side to open a dialog for easy entry or enter a list of definitions separated by semicolons like var1=value1;var2=value2. Use installer variables from the installer with the usual syntax var1=${installer:otherVar}.

 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.
  • Accept all SSL certificates [Error Handling]
    If the protocol of the URL starts with "https" and this property is selected, the SSL certificate will not be checked for validity. This is only recommended for testing purposes when working with self-signed certificates.
  • 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