...
which might embed a couple of possible nested elements describing the pack.
<pack>
Attributes
Attribute | Usage |
|---|---|
id | unique id for the pack to be used for internationalization via packsLang.xml file |
| the user-friendly name that will be displayed during the installation |
| specifies whether the pack must be installed ( |
| optional. Lets you make the pack targeted to a specific operating system, see OS Restrictions. |
| optional. Lets you choose whether the pack is selected for installation by default or not. Possible values are yes and no. A pack which is not preselected needs to be explicitly selected by the user during installation to get installed |
| optional. |
Indicates that the files are not located in the installer Jar. The possible values are true or false, the default being false. For example, your application could be distributed on a CD so that the users could run it directly from the CD. In order to install the software locally without duplicating the files in a jar, you can set When using | |
| optional. reference to a resource that defines the pack's image for the ImgPacksPanel. The resource should be defined in the <resources> element of the installation XML using the same value for the |
| optional. ID of a condition which has to be fulfilled to enable this package to be selected by the user. If the condition evaluates to false the package will be "greyed out" in the PacksPanel user view. The condition interacts with required in the following way: |
Notice: if a package condition evaluates to false but it is marked required the pack remains unselected. Vice versa, a pack's required attribute forces the package to be selected just in case an optional pack condition isn't used or evaluates true. | |||||||||
| optional. takes true or false and specifies whether the pack shall be shown in the packs panel. The size of a hidden pack will be used to calculate the required space, but the pack itself won't be shown. A hidden pack can be preselected or selected conditionally. For the latter, you have to specify a | ||||||||
| size | optional. Specifies the size of the pack, in bytes. If not specified, the size will default to the sum of all file lengths in the pack. Since 5.0 | ||||||||
installGroups | optional. A comma separated list of groups, see InstallationGroupPanel for using them. | ||||||||
uninstall | optional. If set "true", the according pack gets into the uninstaller's list of files to be uninstalled. This attribute has effect just in case of <uninstaller write="true"/>. Default: true |
Nested Elements
<singlefile> - Adding/renaming a Single Pack File
...
This tag takes the following attribute:
| The name of the pack that this one depends on |
<onSelect> - Select/Deselect a pack when this pack is selected
<onDeselect> - Select/Deselect a pack when this pack is deselected
Gives you the ability to select or deselect other packs upon selection or deselection of this pack.
Allows for flexible pack management.
These tags take may take the following attributes:
| Required. |
| condition | Optional. |
<parsable> - mark text files for variable replacement
...
This enables a model in which a single developer is responsible for maintaining the packs and resources (e.g. separate packsLang.xml_xyz files providing internationalization; see Internationalization of the PacksPanel) related to the development-package assigned to him. The main install XML references these xml-files to avoid synchronization efforts between the central installation XML and the developer-maintained installer XMLs.
Attributes
Attribute | Description |
|---|---|
| Relative path at compile-time to an externally defined packs-definition |
<refpackset>
The <refpackset> tag can be used in situations were there is no predefined set of <refpack> files, but a given directory should be scanned for <refpack> files to be included instead. This element takes the following parameters:
Attribute | Description |
|---|---|
| Relative base directory at compile-time for the refpackset |
| Pattern of files in |
Example:
| Code Block |
|---|
<refpackset dir="" includes="**/refpack.xml" /> |
...
| Code Block | ||
|---|---|---|
| ||
<pack name="Core files" required="yes" id="pack.core" condition="Install">
<description>Core files</description>
<fileset dir="@{staging.dir}" override="true">
<exclude name="*.zip" />
<exclude name="conf/*.properties" />
<exclude name="conf/*.xml" />
</fileset>
<fileset dir="@{staging.dir}/config_files" targetdir="${INSTALL_PATH}/conf" override="true" overrideRenameTo="*.configbak">
<include name="*.properties" />
<include name="*.xml" />
<exclude name="special.xml" />
</fileset>
<parsable encoding="UTF-8">
<fileset targetdir="${INSTALL_PATH}/conf">
<include name="wrapper.conf" />
</fileset>
</parsable>
<parsable>
<fileset>
<include name="**/*.bat" />
<include name="**/*.cmd" />
</fileset>
</parsable>
<parsable type="shell">
<fileset>
<include name="**/*.sh" />
</fileset>
</parsable>
<executable>
<fileset>
<include name="**/*.sh" />
</fileset>
</executable>
</pack> |
...
The dir attribute should no longer been parsed in <fileset> nested to <executable>, <parsable> at all.