Super Prev Next

Step 3: Specifying Installation Settings

This step is intended to describe the appearance and behavior of the resulting installer.


Super Prev Next

Installer setup

Installer provides typical installation facilities, such as displaying an installation splash screen and end-user license agreement, creating shortcuts, setting file type associations, creating registry keys, etc.

Note: Installer setups have much smaller size, if you select the best compression level on the final Step (see Step 4: Creating The Installation Package.)

By default, the installer runs a GUI installation wizard that guides the user through the installation process step by step. Unattended (batch mode) installation/uninstallation are also supported.

Note that the uninstaller executable is automatically added to the package. However, the executable can be renamed or removed, if necessary.

This step is intended to describe the appearance and behavior of the resulting installer. Note that this page is accessible only if you opted for using Installer on the previous step.


Super Prev Next

Vendor information

First of all, you should specify a company name, a product name and a product version. For that, use the respective entry fields from the Vendor information pane at the top. As you type the values, Packager automatically fills the default values for other settings such as the registry keys and installation directory which you may change later, if necessary.

In addition, the values entered in the fields Product Name and Product Version are used to compose the product identifier that will be displayed in the resulting installer.


Super Prev Next

Registry keys

Installer creates two keys in the system registry solely for managing the installation. One key is created to make the installed program appear in the Add/Remove Programs applet of the Windows Control Panel.

The other key is created to store the necessary information, such as the installation directory, that will be used by the installer when installing updates. According to the Windows programming guidelines, the default pathname of the key ends with SOFTWARE/company-name/product-name/product-version and the key is placed in the respective part of the system registry /The registry subtree HKEY_LOCAL_MACHINE or HKEY_CURRENT_USER is used depending on the Common or Personal installation type that the user selects during installation./ . You may change the tail of the pathname by entering another value in the Create registry key field.


Super Prev Next

Installation directory

The wizard of Installer displays a dialog where the user selects an installation directory for the application. In Packager, you can specify a default value for the installation directory or force installation into a particular location not allowing the user to change it.


Super Prev Next

Specifying a default installation directory

If you need to set a default installation directory, select the desired option from the Installation directory radiobutton group. The following options are available:


Super Prev Next

Fixing the installation directory

If you do not want the user to change the default directory when installing the application, uncheck the respective checkbox displayed below the entry field.


Super Prev Next

Pathnames with international characters

If the pathname of the installation directory contains non-ASCII characters, your program may function improperly due to defects in the internationalization facilities existing in certain versions of the Java platform. If you enter such a character in the installation directory field, Packager shall display a warning message when you attempt to leave this page.

Click Ignore if you already have international characters in the trial run directory pathname.

Click Cancel to return to the Installation Settings page and correct the pathname so that it contains only ASCII characters.


Super Prev Next

Shortcuts

On the Shortcuts tab you can specify shortcuts which the resulting installer will create on the desktop and within Start Menu. There are three places where shortcuts can be created:

These options appear as the top-level nodes of the shortcut tree displayed on the left side of the tab.


Super Prev Next

Adding a shortcut

You specify a new shortcut as follows.

  1. Add a shortcut to the shortcut tree by doing one the following:
  2. Type the shortcut’s name and press Enter.

  3. Select the file from the package for which you want to create the shortcut: click Select next to the Target field. A dialog showing the package files will display. Choose the file and click Ok.


Super Prev Next

Shortcut’s icon

By default, a shortcut reuses the icon of its target file, but you may change the icon. For that, select the shortcut in the shortcut tree, click Select next to the Icon field and choose the desired .ico file from the package.


Super Prev Next

Working directory and arguments of shortcut’s target

You may also specify a working directory and command line arguments for the program that runs when the user clicks the shortcut. To do that, click Select next to the Start in field and select the required directory from the package. To specify arguments, type them in the Arguments entry field.


Super Prev Next

Installer appearance

On the Installer appearance tab you can set the language of the installation wizard interface, the end-user license agreement that the installer will display, and a splash screen that the installer will show when unpacking and copying package files.


Super Prev Next

Installation language

To set the language of the installation wizard, select the desired option from the Language combobox. Currently, English, French, German, Japanese, Spanish, Polish, and Russian are supported. The default value "Auto-detect" means automatic selection of the language at install time depending on the system locale settings.


Super Prev Next

License agreement

To add the license agreement dialog to the resulting installer, type the full path to the desired text file in the License agreement field, or click Browse to select it using a conventional file dialog.

The license agreement must be a plain text file in either Unicode or ANSI encoding. You can set the encoding by selecting the respective radiobutton below the field.


Super Prev Next

Splash screen

If you want the resulting installer to display a splash screen when unpacking and copying package files, type full path to the desired bitmap image (.bmp file) in the Installation splash screen field or click Browse next to the field and select the image using a conventional file dialog.


Super Prev Next

Extra facilities

On the Extra facilities tab you can specify a runnable file that will be executed just after the end of the installation process. It enables you to add extra functionality to the resulting installer/uninstaller.


Super Prev Next

After-install runnable

To specify the runnable file, click Select in the After-install runnable pane and select the desired file from the package. If you need to specify command line arguments to the runnable, type them in the Arguments field. Values of the arguments may contain references to root directories from the package in the form $(root-name). For example, if you specify an argument $(Root)\MyFiles\InstallStuff, the installer will expand $(Root) to the absolute path of the installation directory on the target system.

The selected runnable file will be started when the user pressed the Finish button on the last dialog of the installation wizard.

Note: You should not rely on that the runnable starts in a particular working directory. If it needs to access the package files, you can specify the necessary arguments for the runnable as described above.