The Select Files tab lets specify all the files and directories you want deployed from your installer. If you're finding classes automatically, then do not include the class files that JExpress finds automatically in this panel.
On the left side of the tab is a list of the local files and directories you selected. On the right side is the layout on an end user's computer, excluding the class files that JExpress automatically finds.
If you want to limit the files included in a subdirectory, then highlight the directory name and click the Edit button. Click on the jump point or just page down to learn more about each setting on this panel.
Important: If you are having trouble selecting a network drive, then click here.
Important Note: If you can't select a network drive, then you will need to modify the start up command for JExpress.
There's no need to prepare your distributable files into a single directory tree because you can select individual files or entire directories from multiple directories. If you select a directory in your list, then JExpress can automatically include all of its files and its subdirectories. You can also include or exclude files within the selected directory and its subdirectories by extensions. Simply enter the file types, without the period, in the Extensions field and click the radio button that specifies whether to include or exclude files matching the masks. If you want multiple extensions, then use a space as a separator.
As a directory: Creates a directory by the same name in the target machine's installation directory. It also maintains the subdirectory tree on the target machine. In our example, this means that the user's installation directory, called /NewApplication, would contain a subdirectory called Manual, with its associated files, and that the Manual subdirectory would contain the subdirectories Chapter1 and Chapter2 with their associated files.
Files and subdirectories: Stores the files from the selected directory in the user's installation directory and maintains the subdirectory tree on the target machine. In our example, this means that all the files in your /Example/Manual directory would be stored in the user's /NewApplication installation directory. Plus, the subdirectories Chapter1 and Chapter2, with their associated files, would be created in the user's /NewApplication installation directory.
Files only: Stores all the files from the selected directory, and its subdirectories, in the user's installation directory. In other words, the original directory tree is not maintained. In our example, this means that all the files in /Example/Manual, /Example/manual/Chapter1, and /Example/manual/Chapter2 are stored in the customer's /NewApplication directory. No subdirectories are created with this option.
Advanced options If you're building an installer for multiple platforms, then you'll probably want to be sure to specify the files in your project that are text files so JExpress can automatically convert the line endings to the local system.
Also, JExpress makes it easy to create a project on one machine and then move that project to another machine and run it, even if that new machine is operating on a different OS or has a different file structure. Both machines must use the same basic directory structure for your project files, but the directory tree may differ from the base.
Please remember that if JExpress is operated from multiple machines, you may need to purchase multiple licenses. This means that if you design the installers, but someone else or another department runs JExpress to create the installers for distribution, then you need at least 2 licenses to JExpress. See the license or send e-mail to our "sales" email account if you have any questions about licensing.
Additionally, JExpress can automatically compress all of the JAR files that you distribute with your installer if JRE 1.5 is used to create and run the installer and updater. When JExpress installs and updates your application, it automatically expands the JAR files back to their standard format.
Text file extensions
During the installation, any files with a matching extension are automatically converted to the target system's end of line character. For example, if you created your files under Windows and you specify txt as a text file extension, then your JExpress installer automatically changes carriage return/line feeds into line feeds for all txt files if the target system's OS is Unix.
Pack Jar Files
Simply add a check mark to the Pack JAR files field on the Advanced options to use Pack 200.
If you'd like to configure the properties Pack200 uses, then create a properties file in JExpress' config subdirectory named pack200.properties. There is an example in that directory which gives more details about configuring the properties.
Save file permissions
Warning: This really can slow down the building and installing process. If you use the same file permissions for the entire install directory, then you may find it easier to adapt the example custom class named ChangePermissions.
The base directory is similar to "ant's" basedir.
Let's assume you have 3 machines that are licensed to operate JExpress. By setting the Base directory to C:\Projects\MyProject you can make it easy to move your project between environments.
|Machine||Project Files||Base Directory|
Notice that all 3 environments use the same file layout below a certain point in the directory tree. You want your Base directory set to the unique part of the directory tree.
Important: The base directory must be an exact match, so we strongly recommend that you use the Browse button to select the directory name. Also, remember that when you select the directory in the browse dialog box, the directory name must appear in the "File name" field because of a quirk in Swing.
Selecting a Network Drive
Windows with JRE 1.5.x or later
Exit JExpress and load the JExpress.properties file (located in the JExpress subdirectory of your JExpress install directory) into a text editor. Change the property for the args attribute so you prepend the following information (following the =):
For example, if the args line looked like this before you made any changes:
then the line should look like this after your changes:
Save the changes and start JExpress again. You should be able to select network drives from the drop down menu.
Unix Systems with JRE 1.5.x or later
Load the jexpress script into a standard text editor and add the following switch before the -cp switch:
Save the file and restart JExpress.
Any OS with JRE 1.5.x
If you're running JExpress version 4.1.0 or earlier, then you'll need to get an update to the latest version. DeNova's development team fixed a bug in Sun's Swing code that prevented Swing from letting users on Windows select network drives. The latest version of JExpress includes this change. DeNova has supplied the changes to the code to Sun's development team and we hope they'll release a new version of Swing that includes the fix.