Importing Setup Factory 6.0 Projects

As stated in the previous section, both the Archive and CD-ROM file lists and many other project settings will be converted from your Setup Factory 6.0 project to Setup Factory 8.0. However given the subtle and dramatic differences between Setup Factory 6.0 and Setup Factory 8.0, some options cannot be converted, most notably among these are actions and screens.

This topic outlines the elements of a Setup Factory 6.0 project that are not converted automatically. Choose one of the areas below for a description of its non-converted content:

 

Actions

Actions will not be converted from Setup Factory 6.0 to Setup Factory 8.0. Given the vastly different way in which actions and variables are handled in Setup Factory 8.0, as opposed to Setup Factory 6.0, a conversion between the two is next to impossible.

In order to make the conversion process easier for you, all of the actions from your Setup Factory 6.0 project (except screen actions) will be converted as comments on the appropriate events in the converted Setup Factory 8.0 project. In cases where there is no one-to-one conversion between events (as in the uninstall events) the action code from Setup Factory 6.0 will be converted to the most appropriate Setup Factory 8.0 event. You can use the Converting Actions topic as a reference for converting your actions script.

Screens

Screens and screen actions will not be converted from Setup Factory 6.0 to Setup Factory 8.0. Given that all of the language translations are encapsulated in each screen, the importing of screens were impossible. Another complexity involved in the conversion was the introduction of project themes that are applied to all screens in the setup.

General Design

Settings Tab:

  1. The “Verify archive before installing” option is not converted. In Setup Factory 8.0, the archive will always be verified for single setups. If a multi-segment install is created, this option is automatically disabled.

  2. The “Progress screen image” is not converted. In Setup Factory 8.0, the progress screen can be configured as any other install screen. This screen can be found on the While Installing tab of the screen manager.

  3. The “Show Setup Factory logo on initial splash screen” is not converted because this feature no longer exists in Setup Factory 8.0.

Languages Tab:

  1. While each language that was supported by the version 6.0 project will be listed as supported in the converted Setup Factory 8.0 project, the internal messages of the language module will not be converted. This is due to the difference in messages required for the new screens and feature set.

Runtime Modules

The runtime modules included in the project are not converted. In Setup Factory 8.0 runtime modules were replaced with the new feature called Dependency Modules. While runtime modules were installed with your setup files, dependency modules are detected and installed at the beginning of the setup, before your application files are installed. Runtime modules in version 6.0 often contained multiple technologies, while in Setup Factory 8.0 they were designed to be stand alone modules that can be installed in any order you wish.

Project Settings

Directories Tab:

The folders defined as your base directories are not converted. Base directories are not explicitly set in Setup Factory 8.0 and have instead been replaced by internal logic that makes these decisions based on what makes most sense.

File Properties

Conditions Tab:

The “Run-time install condition” and “Build-time include conditions” are not converted to Setup Factory 8.0. Setup Factory 8.0 offers a user friendly check box tree for selecting the supported operating system. For non-operating system conditions the Setup Factory 6.0 condition has been replaced with a Lua script that will determine the outcome. These must be recreated.

Build-time include conditions have been replaced by the addition of Build Configurations in Setup Factory 8.0. This allows you to define different types of builds, such as debug and release builds, all with their own design-time constants and output settings.

Uninstall

Settings Tab:

  1. The “Wizard image” setting in Setup Factory 6.0 is not converted to Setup Factory 8.0. Setup Factory 8.0 allows additional screens to be created in the uninstall. As with the install screens, these can also be themed.

Preferences

The preference settings will not be converted from Setup Factory 6.0 to Setup Factory 8.0 since they are program wide, not project specific. The project converter only converts those options that are project specific.

Gotcha’s

  1. System requirements do not need to be handled through action conditions any longer. In Setup Factory 8.0, system requirements are defined on the Requirements tab located on the Project Settings dialog.

  2. In addition to the new action script in Setup Factory 8.0, variables have changed in Setup Factory 8.0. Any variables that are used for display purposes or destinations for files are now called session variables. Another type of variable mainly used in action script is called a Lua variable.

  3. If you have used a particular language module in Setup Factory 6.0 and converted your project, there may not be a language message file available for that language. In this case, the text “Same as Default Language” will appear in place of the message file path on the Languages tab. If a language message file is currently not available, you can certainly create one yourself by translating the messages to the desired language. All language files are in .XML format can be found in the Languages directory located within the main program directory. Simply make a copy of the file and start translating.