Setup Factory 10

Folder Reference Properties

Folder Reference Properties

Previous topic Next topic  

Folder Reference Properties

Previous topic Next topic  

OverviewGeneralAdvancedConditionsPackagesNotes

Settings

Compress files

Compress the files when they're added to the setup executable. If unchecked, the files will not be compressed when they're added.

Turning off compression will decrease the time it takes to install the files, but will result in a larger setup. You may want to turn the compression off if you are distributing your setup on CD-ROM or over a Network where the size is not restricted or if the files are already compressed and you know that you will not be able to get much more compression out of them.

If your installer is being distributed on a very slow medium, such as Zip disks, it may actually be faster to leave compression on, because reading the extra data saved by compression would take more time than it does to decompress it.

Note: The Compress files option is not available for folder references on the External tab.

Suppress "In-Use" notices

Suppress a warning if one of the files is in use during installation and needs to be overwritten. If a file is in use, the built-in global variable _NeedsReboot will automatically be set to true to notify the setup that a reboot needs to take place.

If unchecked, a message will appear to warn the user if the file is in use and will ask them to shut down any running programs.

Use failsafe copy method

Extract the files to a temporary location, and then copy them to their final destination. This feature helps prevent the files from being corrupted if the install is aborted or if the user's system crashes midway through installing the file.

Note: This feature adds extra time to your installation, and will also increase the amount of temporary disk space required on the user's system during the installation. You should only use this feature for mission critical files, such as system files.

Create backups

Create backups of the existing files (if present), before overwriting them during the installation. The existing files will be renamed to filename.bak. If filename.bak already exists, it will be named filename.bk1, or filename.bk2, etc. The new files will only be installed after the existing ones have been backed up.

Tip: By default, each backed up file is created in the same directory as the target file. However there is a global variable called _BackupFolder that can be set as the backup directory for all files with this option enabled.

Note: Setup Factory does not restore backed up files during the uninstall, however the framework is available if you wish to perform this type of restoration. The full path and filename to each backed up file is stored with the information of the file being installed in the uninstall and can be accessed using the UninstallData.GetItem action.

Disable CRC checks

Do not perform the usual CRC value integrity check on the files during installation. In general, you should not turn this option on. The CRC checking that is performed during setup is meant to ensure that your files are properly and completely installed and are not corrupted.

The only reason to turn this option on is if the file that you are installing will change from CD-ROM to CD-ROM and you do not want to re-build the setup each time the file changes. An example of such a file would be a customized data file that changes for each of your customers.

Attributes

 

This section allows you to specify the attributes of the files when they're installed on the user’s system. By default, the Use original option will be selected. This will ensure that each file's attributes will be the same on the user’s system as on yours.

Note: Changing the file attributes in this section does not affect the files on your development system. The attributes are only applied to the files when they're installed.

Use original

Preserve the attributes of the source files when the they're installed. If unchecked, you must specify the attributes for the installed files.

Read-only

Set the read-only file attribute when installed.

Archive

Set the archive file attribute when installed.

Hidden

Set the hidden file attribute when installed.

System

Set the system file attribute when installed.

Priority

Install order:

The order in which these files are installed onto the user's system. Install order defaults to 1000. Files with lower install order values are installed first. This option is useful if certain files need to be installed and registered before others in your install archive.

Note: Archive files are always installed before External files in the install sequence. This install order value only applies to the files on the current tab.

Uninstall

Never remove files

Do not remove these files during the uninstall process.

Shared/System files

Update the usage count for these files during installation and uninstallation. This feature should only be used for files that are shared by multiple programs, such as system files.

OLE/ActiveX

Register supported COM interfaces

Try to register the file if it is a COM Interface file. This will only work for controls that properly support the DLLRegisterServer interface. This option should properly register ActiveX controls (OCX) and other OLE inproc servers.

Tip: By default if the registration fails, an error dialog is shown (if the install is not running in silent mode). If an error occurs, the function g_OnRegisterFileFailed is called. If you would like to suppress this error message or change the way Setup Factory handles this situation, you can modify this function defined in the file _SUF70_Global_Functions.lua located in the Includes\Scripts folder of the main Setup Factory folder. The preferred method is to redefine the function in your project by copying and pasting it into the Resources > Global Functions and then making the desired modifications.

Register supported TypeLibs

Try to register the file if it's a TypeLib file.

Font

Register all TrueType fonts

Try to automatically register and implement all font files as TrueType fonts during installation. This means that the font will be registered with the operating system and will be made available to the user. In order for this to work, the file must be a valid Windows .TTF file.

Note: At build-time, Setup Factory will automatically try to get the font name from its resources. If the font name cannot be determined, this setting will be turned off for that particular file. In the case where the font name cannot be determined, the file must be added manually so you can specify the font name using the Single File Properties dialog.


Learn More: Indigo Rose Software - Setup Factory - Buy Now - Contact Us