Table of Contents
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.
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.
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.
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.
Default install 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 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
Install as administrator
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
When you add a check mark to this field, then the installer will simply stop the installation.
Check if newer version
You must also have the Save install environment" check box clicked to use this feature.
Track conversion events