Install Options

JExpress gives you complete control over your installer. Many of the options are defined on this panel or by clicking the More options button. Click on the jump point or just page down to learn more about the settings on this panel.

 


 

Installer style

JExpress supports 3 installer styles: wizard, click free, and silent.

A wizard installer presents multiple panels where the user fills in data and views information such as licenses and read me files.

A click free installer moves through all the steps of the installation without user intervention. There is one possible exception to this if you create a click free installer and include copy protection, then the user must fill in their credentials if they are installing the app for the first time.

A silent installer installs without giving any feedback to the user. If any errors occur, then they must look in the errors.log file for details.

Only a wizard installer will display the license and read me files, if you supply them. All other fields on the Install options panel are optional for a wizard installer.

Click free and silent installers require that you configure the Default install directory.

 


 

License filename

If you want the user to agree to your license before installing, then enter the filename for your license html filename or click the Browse button. If you do not want to require a license as part of the installation, then leave this field blank. This field is only available for a wizard installer.

We strongly recommend that you not use a generic name, such as license.html, but instead name the file something unique, such as [ApplicationName]License.html. Also, the filename should end in .html or .htm if you'd like the best formatting.

You can distribute separate license files for each international language that JExpress supports. Simply create an html file with the English version of the license in the filename you specify in this field, referred to as the base filename. Then create one html file for each other language that you want to distribute with the same base filename and the 2 letter extension matching the language. For example, if you name the base filename license.html, then you'd create the German version in a file called license.html.de and the French version in a file called license.html.fr. If you don't include a special file for a supported language, then JExpress simply displays the file specified in this field. All the international license files must be in the same directory as the base filename.

Check Java's documentation to learn what HTML elements are and are not supported. In general, you'll want to use basic HTML elements (e.g., h1, h2, strong) for formatting.

 


 

ReadMe filename

If you'd like your customers to view a ReadMe file during installation, then specify the filename, including the pathname, that contains the ReadMe html file or click the Browse button. Leave the field blank if you don't want a readme shown during the installation of your application. This field is only available for a wizard installer.

We strongly recommend that you not use a generic name, such as readme.html, but instead name the file something unique, such as [ApplicationName]Readme.html. Also, the filename should end in .html or .htm if you'd like the best formatting.

You can distribute separate ReadMe files for each international language that JExpress supports. Simply create an html file with the English version of the ReadMe in the filename you specify in this field, referred to as the base file. Then create one html file for each other language that you want to distribute with the same base filename and the 2 letter extension matching the language. For example, if you name the ReadMe file readme.html, then you'd create the Spanish version in a file called readme.html.es and the Polish version in a file called readme.html.pl. If you don't include a special file for a supported language, then JExpress simply displays the base file. All the international ReadMe files must be in the same directory as the base filename.

Check Java's documentation to learn what HTML elements are and are not supported. In general, you'll want to use basic HTML elements (e.g., h1, h2, strong) for formatting.

 


 

Default install directory

Fill in the default installation directory for your application. We strongly recommend that you enter the default directory without a leading directory separator (e.g., / or \) because most users on a networked Windows or Unix system can't install into the root directory.

If the default directory name starts with a directory separator (i.e., / or \), then the default directory is created in the root. If you do not include a leading directory separator, then the default directory is adapted to the local environment.

For example, if you specified the default directory as MyCompany/Application (i.e., without the leading directory separator), then the default directory on a Windows machine would be \Program Files\MyCompany\Application and on a Unix machine /usr/local/MyCompany/Application. But, if you specified the default directory as /MyCompany/Application (i.e., with the leading directory separator), then the default directory would be \MyCompany\Application on a Windows machine and /MyCompany/Application on a Unix machine.

You have the option of changing the parent directory of the default for the primary OSes if you click the Advanced button next to the Default directory field. This allows you to decide where the parent of the default directory is on each OS. For example, you could specify the home directory by using the variable: [$UserHomeDir] or the Windows directory by using the variable: [$WinDir].

This field is required for click free and silent installers. If you leave this field blank for a wizard installer, then JExpress uses the name of the project (i.e., the .jex filename) to determine the name of the default installation directory on the target machine. It also uses the target machine's OS to determine the logical place to create the directory.

For example, if your project name is Test.jex and your customer installs your application on a Windows machine, then the default directory is "\Program files\Test". If the customer installs your app on a Unix system, then the default directory is Test under their home directory.

If you create a multiple component installer or a multiple target directory installer, then the default directory will be adjusted to include the name of the component or target directory. For example, You have the components Hello, Goodbye, and SeeYa defined. The user selects the Hello component. The default directory for Hello will include Hello as a subdirectory of the standard default directory.

You can use the following variables at the beginning of the default directory and the installer will adapt them to the local system:

  • User's home directory: [$UserHomeDir]
  • Java's home directory: [$JavaHomeDir]
  • Programs files directory (Windows only): [$ProgFilesDir]
  • Windows directory (Windows only): [$WinDir]

 


 

Prompt user for install dir

If you don't want to ask the user where to install your application, then you can configure the Default directory and add a check mark to this field.

If the installer cannot use the default directory, then it will prompt the user for a directory name. If you would prefer the installer stop if the default directory cannot be used, then click the More button and add a check mark to the Abort option.

 


 

Save install environment

When you check this box, then JExpress saves your product's name, version, and installation directory in persistent storage on the target machine. On Windows, this information is stored in the registry; on Mac, it's in a file in the Preferences/denova directory; and on unix, it's in a file in the /var/local/denova.

 


 

Install as administrator

If you'd always like the installer to require it run as an administrator on Windows and Mac OS X 10.3 or later, then add a check mark to this option.

On Windows 7, Windows 8, and Windows Vista, the installer automatically requires administrative permissions, regardless whether this option has a check mark or not because Microsoft requires it.

Important:This option only works for native installers on Windows and Mac OS X 10.4 or later.

 


 

More Install Options

 


 

Abort if unable to use default dir

If you've configured the installer not to prompt for the install directory, but the installer has problems using the default install directory, then the standard behavior is to prompt the user for the installation directory.

When you add a check mark to this field, then the installer will simply stop the installation.

 


 

Check if newer version

JExpress can automatically check if a newer version of your product is already installed on the target machine. If it is, then a pop up warns the user and asks if they'd like to continue.

You must also have the Save install environment" check box clicked to use this feature.

 


 

Track conversion events

If you'd like JExpress to track when your customers start the auto-updater for your product, then add a check mark to this box. With DeNova's convert optimization service you can see how your customers use your product.

 


 

Installation password

If you'd like your installer password protected, then simply enter the password into this field. JExpress encodes your password in the installer for security. The installer cannot be operated until the correct password is entered.