Install Builder Command Line Options
Previous Topic  Next Topic 

InstallJammer can be started with several command-line options that make building installs easier for some jobs. In most cases, these are used to provide quick builds of a single project or build projects using scripts and other programs.


Usage:


      installjammer ?option option ... --build? ?ProjectFile?


If you are building from the command-line, it is generally recommended that --build be the last option before the project file name.  It tells InstallJammer where the options and switches end and where the project file name begins.  Every argument after the --build will be joined together to make the file name, so you can include spaces on the command-line, and InstallJammer will join them properly.


The same is true for other options.  Anytime an argument is encountered that doesn't match one of the given switches or options, its value will be appended to the value of the previous option.  This allows for spaces on the command-line, and InstallJammer will join them properly where it makes the most sense.


Example:


installjammer -DAppName My Application --quick-build --build /path/to/my/project file.mpi


The arguments of this command-line will be joined like this:


-DAppName "My Application" --quick-build --build "/path/to/my/project file.mpi"



Command-line Options


--build

This option specifies that the given project file should be loaded and built without loading the install builder GUI. This option is good for building installs from other programs or at regular times using scheduling.  This should generally be the last switch specified before the project file name.


--build-dir <directory>

Specifies a directory to use as the temporary directory when building.  InstallJammer will attempt to create the directory if it does not already exist.


--build-for-release

If this option is specified, the project file being built will be built for final release.


--build-log-file

Specifies a filename to save the build log information to.  The default is build.log in the project directory.


--control-script <scriptFile>

This option specifies a script to source in when InstallJammer is building from the command line.


-D<option> <value>

Set the value of option to value. Example:


-DAppName "My Software"


Will override the default value stored in AppName with the value My Software. This is useful for over-setting options in different installs during command-line builds so that a single project file can be manipulated to be many different builds.


Any number of options can be specified in this manner. Each one will be processed in the order in which it was specified on the command line.


--help

Displays usage information for InstallJammer.


--output-dir <directory>

Specifies the output directory to store the resulting installers in when they are built.  InstallJammer will attempt to create the directory if it does not already exist.


--platform <platform>

This option can be specified with the -b option to tell InstallJammer to only build certain platforms. Each platform name specified with a -p will be built instead of building all of the platforms (the default option). More than one -p platform can be specified, and each platform will be appended to the build list.


--quick-build

If this option is specified, the given project file will be rebuilt without repackaging the files for the installer just as a quick build in the GUI.


--quiet

Turn off messages from InstallJammer while building.  Errors will still be reported on stderr.


--test

This option can be specified with the --build option to tell InstallJammer to test the install once it has been built. The install builder GUI will still not be loaded, and the install will execute when the build is complete.


--verbose

This option tells InstallJammer to show verbose output when building.


--version

Display version information for InstallJammer and exit.