Command Reference

Command Line Options

Installer Options
Uninstaller Options
Design Environment (Build) Options


Installer Options

The following command line options are supported by the Setup Factory installer:

Language (/L)

The /L option forces the installer to use the messages associated with a specific language ID, instead of using the messages that correspond with the user's system locale settings. This allows you to test your installer in multiple languages without having to change your system language and reboot.

(More info)

The syntax for the /L option is:

/L:#

Replace # with the language ID for the language you want Setup Factory to "detect." The installer will configure itself as though that language was the current system language.

Example:

setup.exe /L:17
(forces the installer to "detect" Japanese as the system language)

TIP

 

A complete list of language IDs can be found in the C:\Program Files\Setup Factory\Languages\langids.ini file.

Silent Mode (/S)

You can force the installer to run in silent mode by using the /S option. In silent mode, no screens, errors, or any other parts of the interface will be shown. This includes any messages displayed using the Show Message Box and Yes/No Message Box actions.

Example:

setup.exe /S

NOTE

 

The built-in variable %SilentMode% is set to TRUE when the installer is running in silent mode.

Temp Path (/T)

Every setup executable requires some temporary space on the user's hard drive during the installation process. By default, Setup Factory uses the user's TEMP directory for extracting temporary files and other miscellaneous operations. You can force the setup executable to use an alternate directory by using the /T command line option.

The syntax for the /T option is:

/T:path

Replace "path" with the path to the folder you want the setup executable to use for its temporary files. (Be sure to put quotes around the entire argument if the path includes any spaces.) If the folder doesn't already exist on the user's system, it will be created automatically.

Example:

C:\Downloads\setup.exe "/T:C:\My Temp Dir"
(forces the installer to use "C:\My Temp Dir" for temporary files)

Wait for Return (/W)

Use the /W option to have the Setup Factory launcher wait for the setup executable to return before exiting. This is useful if you're running the installer from another process and you want that process to wait for Setup Factory to finish before proceeding.

(More info)


Uninstaller Options

The following command line option is supported by the Setup Factory uninstaller:

Silent Mode (/S)

You can force the uninstaller to run in silent mode by using the /S option. In silent mode, no screens, errors, or any other parts of the interface will be shown. This includes any messages displayed using the Show Message Box and Yes/No Message Box actions.

Example:

iun600.exe "C:\Program Files\Foobar 2002\irunin.ini" /S

NOTE

 

The built-in variable %SilentMode% is set to TRUE when the uninstaller is running in silent mode.


Design Environment (Build) Options

The following command line options are supported by the Setup Factory design environment:

Unattended Build (/B)

Performs an unattended build of a project. This allows you to build a setup executable "automatically" from a batch file.

The syntax for the /B option is:

/B:unattended-build INI file

Replace "unattended build INI file" with the path and filename of an INI file containing the unattended build settings you want Setup Factory to use. (Be sure to put quotes around the entire argument if the path or filename includes any spaces.)

Example:

SUF60Design.exe D:\foo.sf6 "/B:D:\release build.ini"

NOTE

 

The project file name should always be passed as the first command line parameter.

The unattended-build INI file allows you to pass values into your project in the form of design-time constants. You can define as many design-time constants as you want in the INI file, with each constant on a separate line beneath the [Constants] section. For example:

   [Constants]
#OUTPUTDIR#=C:\Output\Foobar 2002\Release
#SETUPNAME#=foobar2002setup.exe
#BUILD#=release

When you use the /B option, the specified project file is loaded into Setup Factory, the constants described in the specified unattended-build INI file are set, and the setup executable is generated-all without any interaction.

The SUF60Design.exe process returns an exit code of 1 if an error occurred during the unattended build, or 0 if the build was successful. You can use this return code to make your batch files respond to the success or failure of the Setup Factory build process.

TIP

 

The unattended build option is usually used in conjunction with the Minimize (/M) option.

Minimize (/M)

Minimizes the Setup Factory design environment when used with the unattended build (/B) option.

Example:

SUF60Design.exe C:D:\xyz.sf6 /B:D:\autobuild.ini /M