We need you!

Icon

The IzPack documentation needs work, and you are invited to edit it!

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

This pages describes particular use cases which might come from an requirement to the installer.

Setting Default Installation Directories

IzPack offers the possibility to set a list of default installation directories depending on the target installation platform. When the compiled installer is executed IzPack chooses the one matching the assigned platform.

This can be achieved by explicitely setting variables with the prefix: TargetPanel.dir. IzPack recognizes this as built-in variable which can be user-modified.

For example, change the resources to variables:

Default path definition in IzPack 4.x

to

Default path definition in IzPack 5.x

This uses the following variable search order to determine the default directory to display:

  1. TargetPanel.dir.<platform symbolic name> e.g. TargetPanel.dir.windows_7
  2. TargetPanel.dir.<platform name> e.g. TargetPanel.dir.windows
  3. TargetPanel.dir.<parent platform> e.g. given platform "FEDORA_LINUX" looks for TargetPanel.dir.linux, followed by TargetPanel.dir.unix
  4. TargetPanel.dir
  5. DEFAULT_INSTALL_PATH
  6. SYSTEM_user_dir corresponds to the system property "user.dir"

Available platforms can be found in the class Platforms. The names are the lowercase versions of those defined.
Allowed names include:

  • aix
  • debian_linux
  • fedora_linux
  • freebsd
  • hp_ux
  • linux
  • mac
  • mac_osx
  • mandrake_linux
  • mandriva_linux
  • os_2
  • red_hat_linux
  • sunos
  • sunos_x86
  • sunos_sparc
  • suse_linux
  • unix
  • ubuntu_linux
  • windows
  • windows_7
  • windows_xp
  • windows_2003
  • windows_vista

Differences from 4.3.6

For 5.0 a better approach would be to use Platform to determine the appropriate variable (see IZPACK-829).
The range of values the variable can have has been significantly enhanced.

Differences from 4.3.5

In 4.3.5, resources were used rather than variables. Resources were searched for with the following names

  • "TargetPanel.dir." + lower case version of System.getProperty("os.name"), with any spaces replace with underscores
  • "TargetPanel.dir." + <platform> where platform is one of ("windows", "mac", "unix")
  • "TargetPanel.dir"

IZPACK-798 changed the above to use variables instead of text files, following the same naming convention.

  • No labels