Additional files

Applies to:

Description:

Additional files are files and folders, which you want to include with the application you create. They will be compiled with and included into the application during the build process.

Adding and managing Additional Files
Add and manage additional files to your project via View->Additional Files. How this is done in detail, is explained under: Additional files window

Linking your additional files to your project

Files added here can be easily linked to by choosing them from the parameter selection button, where all additional files will be added as you add them under View -> Additional files. This enables you to link these files to your project for example as startpage.

Relative links to additional files can be conveniently created via the parameter selection button next to each parameter field:

Example: you want to include a startpage (startpage.html) for your application. Add it under additional files, click on your Main Web and click on the parameter selection button next to the "startpage" entry. A dialog opens where you find all your additional files under the entry Additional files. Select the file you added as your startpage.

This will create an entry in the parameter field like follows: <_CurrentDir_>\Additional\startpage.html

<_CurrentDir_> is the placeholder for the working directory of the application.

Additional is the folder where all additional files will be placed during runtime

If you want to create these links manually, always link to your files seen from the working directory of your application.

TIP: you may enter relative links to any file, even if it's not included under additional files, given that you know where it is placed during runtime of the application, and given that you link it seen from the working directory. Testing will not work in that case, as during a test, all files will be copied to a temporary directory - relative links to non- additional files can't be found in that case.

Testing relative links within your program works only with additional files
The location of additional files that have been added under View -> Additional files will be known to your project. This enables you to test your application together with additional files. During a test of your application, all additional files will be copied to a temporary directory, where all application files will be generated.

Location of additional files during runtime:

All files you add here will be included with your application during the "build" process. The 'root' folder for additional files in your finished application will be in the folder "Additional" in the installation or working directory of the application.

Example: a file named "startpage.html" will be placed in directory: <_CurrentDir_>\Additional\startpage.html

Important note: In case you create your application as a single selfextracting executable, the application structure is exactly the same, all files needed will be extracted to a temporary directory on the users computer when the exe is launched. This may take a while, as all files need to be unpacked at that time. This is the reason why you would not use the exe method for huge data amounts or for launch of an application from CD. The working directory of the application will be on the harddrive, if a single exe is launched from a CD. Therefore, no files that are not included in the exe can be relatively linked in case of single exe programs - as the working directory of the application will be in a temporary folder on the harddrive.