Installation components can be used to allow the user to customize the installation. GUI installers will present a step that lists all available installation components in a tree with check boxes and lets the user choose which components to install. Console installers will also present a list of installation components to the user for selection. If no installation components are defined, that step will be omitted and the entire distribution tree is installed.
installation components and
component folders. To every component
folder you can add installation components and component folders as child nodes.
The component tree is drag-and drop enabled.
In the component tree you can
[Add Installation Component] action,
a new installation component is added to the currently selected component folder, or at the top-level if no
component folder is selected. The name of the installation component can be edited in-place immediately.
[Add Component Folder] action,
a new component folder is added to the currently selected component folder, or at the top-level if no
component folder is selected. The name of the component folder can be edited in-place immediately.
[Delete] action
or the DEL key, you can remove the currently selected installation component or component folder.
All child nodes of component folders are removed as well.
[Rename] action, you can
rename an installation component or a component folder.
To internationalize the name of the component for different media files, please use custom localization keys.
[Show IDs] button on the lower right side of
the component tree. The automatically generated numerical IDs are then shown in brackets.
The selection will be remembered across restarts of install4j.
context.getInstallationComponentById("123").isSelected() if the ID of
the component is "123". In this way you can conditionally execute actions depending
on whether a component is selected or not.
Both installation components and component folders also have a Description tab.
You can optionally display a description below each component in the installer. Any
component or component folder with a description will have a toggle button with help icon on the right side.
This toggle button controls whether the description is displayed below the element. You can also
use the F1 key to toggle the visibility of the description. The
Expand description automatically check box allows you to show descriptions by default.
The "Installation type" screen offers a selection between sets of installation components, such as "Full", "Standard" and "Custom", while the "Installation components" screen shows the tree of components that you define on this tab with check boxes in front of each node. The "Installation components" screen has a number of properties that let you customize the appearance of the descriptions. If both are present, the "Installation components" screen will only be shown if the selected installation type was configured to be customizable.