Classpath entry dialog

## Classpath entry dialog |
previous | up | next

The class path entry dialog is shown when clicking on the add button in the "configure java invocation" step of the launcher wizard. Upon closing this dialog with the [Ok] button, a new class path entry will be appended to the bottom of the class path list of that step.

To define a class path entry, you first select the entry type, then check the `fail if an error occurs with this class path entry` checkbox in case you want the startup to be terminated if this class path entry is faulty and finally fill out the `Detail` section of the dialog which is dependent on the selected entry type. The following entry types are available:

- Scan directory
  Scan a directory for archives with the extensions `*.jar` and `*.zip` to be added to the class path. In the `Detail` section of the dialog you must choose a directory either by entering the path in the text field or by clicking [...] and choosing it with a file chooser.

  Error handling:
  If `fail if an error occurs with this class path entry` is checked, the application will terminate with an error message if this directory does not exist.

- Directory
  Add a directory to the class path. In the `Detail` section of the dialog you must choose a directory either by entering the path in the text field or by clicking [...] and choosing it with a file chooser.

  Error handling:
  If `fail if an error occurs with this class path entry` is checked, the application will terminate with an error message if this directory does not exist.

- Archive
  Add an archive with the extension `*.jar` or `*.zip` to the class path. In the `Detail` section of the dialog you must choose an archive either by entering the path in the text field or by clicking [...] and choosing it with a file chooser.

  Error handling:
  If `fail if an error occurs with this class path entry` is checked, the application will terminate with an error message if this archive does not exist.

- Environment variable
  Add the contents of an environment variable to the class path. In the `Detail` section of the dialog you must enter the name of an environment variable.

  Error handling:
  If `fail if an error occurs with this class path entry` is checked, the application will terminate with an error message if this environment variable is not defined.

Except for the "Environment variable" classpath type, you can use environment variables in the text field with the following syntax: `${VARIABLE_NAME}` where you replace VARIABLE_NAME with the desired environment variable.

Note that for path selections by means of a file chooser ([...] buttons), install4j will try to convert the path to be relative to the distribution source directory.