Files - Defining Installation Components |
|
On this tab you can optionally define installation components.
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. |
|
On the left side you configure a tree of
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
To internationalize the name of the component for different media files, please use custom localization keys. |
|
When using the install4j API, you reference installation components
with IDs. You can show IDs in the component tree by activating the
[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.
This ID can be used in expressions, scripts and custom code when you want to check if the installation component has been selected for installation. A typical condition expression for an action would be 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.
|
|
The right pane displays the properties of the selected element in the component tree. The options are organized
into several tabs. There are different configuration options, depending on whether you've selected an
installation component or a component folder:
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 |
|
Note: The user can only select which installation components should be installed if the "Installation components" screen
or the "Installation type" screen is part of the screen sequence.
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. |