Installer - Installer Options

     


On this tab of the Installer step you can customize the appearance of the GUI installer and adjust other advanced settings. The installer options are grouped into several tabs at the top.
  "GUI Options" tab
 
  • Header image
    You can optionally choose a different image for the top right corner of the installer wizard. This image will be visible for all screens. The recommended size is 55x55 pixels.
  • Installer size
    You can optionally set a different initial size of the installer window. To specify a custom size, please check use custom size and enter width and height of the installer window in the corresponding text fields. A size of at least 500x390 is recommended. By default the installer window is resizeable, if you would like a fixed windows size you can uncheck the "make installer frame resizeable" check box.
  • Watermark
    Ba default, a watermark with the "install4j" product name is added to each installer screen. You can optionally disable this watermark.
  "Installer Icon" tab
 
If you would like to associate a custom icon with your installer, select the "customize installer icon" check box.
  • In the Cross platform section you then have to choose icon files in the PNG image format (extension *.png) in the sizes 16x16 and 32x32 pixels. On Microsoft Windows, the generated executable will have an icon with these images, on other platforms, these image files will be used for desktop integration. It is recommended to use 32-bit images with an alpha channel, 8 bit-palette images will be generated where required. Generated Windows icons contain traditional 256 color images and 32-bit images with an alpha channel ("Windows XP icons"). However, it is also possible to use 8 bit-palette images with a transparancy color for the input image files.
  • If you have an external icon file for Microsoft Windows, you can select the Use ICO file option in the Windows section and choose an icon file (extension *.ico) in the text field below. With the Generate from PNG files option, the icon will be generated as described in the Cross platform section.
  • If you have an external icon file for Mac OS X, you can select the Use ICNS file in the Mac OS X section and choose a Mac OS X icon file (extension *.icns) in the text field below. With the Use standard icon option, a standard icon provided by install4j will be used. No Mac OS X icon is generated by install4j, since the ICNS format is undocumented. Mac OS X icons have to be generated on Mac OS X with the Icon Composer application located in /Developer/Applications.

Note: If the project has already been saved, relative file paths will be interpreted as relative to the project file.

  "Advanced" tab
 
  • Supported Installer Modes
    By default, installers allow unattended installation as well as console installations. Please see the corresponding help topic on installer modes for more information. All standard actions and standard screens support unattended and console installations, form screens are also fully mapped to console installers. If your policy forbids these installer modes or if you include custom code that cannot handle these installer modes, you can disable them separately be deselecting the corresponding check box.
  • VM Parameters for Installer
    If you need to pass special VM parameters to your installers and uninstallers, you can enter them here. A common case would be to raise the maximum heap size with a different -Xmx parameter if your installers require a lot of memory.
  • Suppress initial progress dialog
    If you would not like to display the initial progress dialog, you can disable it for the installer.