Install Options

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.

Click on the jump point or just page down to learn more about the other settings on this panel.

 


 

License filename

If you want the user to agree to your license before installing, then enter the filename for your license html file 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 the2 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.

 


 

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.

 


 

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 /bin/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.

This field is required for click free and silent installers. If you leave this field blank in 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.