Supported Properties in the BuildProperties.xml File

InstallAnywhere 2020

Many of the settings that you can configure in the Advanced Designer can also be set in a BuildProperties.xml file. The following tables correlate the options in the Advanced Designer with settings in the BuildProperties.xml file.

Project Page > General Settings View Settings

The following table correlates settings in the General Settings view on the Project page with settings in the BuildProperties.xml file.

Project Page > General Settings View Settings

Option

BuildProperties.xml File Setting

Send stderr to

InstallerStdErrRedirect="<path_to_file>"

Send stdout to

InstallerStdOutRedirect="<path_to_file>"

Project Page > Platforms View Settings

The following table correlates settings in the Platforms view on the Project page with settings in the BuildProperties.xml file.

Project Page > Platform View Settings

Platform

Setting

BuildProperties.xml File Setting

UNIX

Default UNIX Installer UI Mode > Installer UI Mode

UnixDefaultUI="<Silent/GUI/Console>"

Windows

Default Windows UI Mode > Installer UI Mode

WindowsDefaultUI="<Silent/GUI/Console>"

Windows, pure 64-bit

Default Windows UI Mode > Installer UI Mode

Windows64DefaultUI="<Silent/GUI/Console>"

Project Page > JVM Settings View Settings

The following table correlates settings in the JVM Settings view on the Project page with settings in the BuildProperties.xml file.

Project Page > JVM Settings View Settings

Option

BuildProperties.xml File Setting

Valid VM list

InstallerValidVMList="<1.3+, 1.6*>"

Minimum Heap Size

InstallerInitialHeapSize="<16777216>"

Maximum Heap Size

InstallerMaxHeapSize="<50331648>"

Installer UI Page > Look & Feel View Settings

The following table correlates an setting in the List of Labels for Installer Steps setting in the Look & Feel view on the Installer UI page with a setting in the BuildProperties.xml file:

Installer UI Page > Look & Feel View Settings

Option

BuildProperties.xml File Setting

Auto populate labels when saving

AutoPopulateLabels="<true/false>"

Organization Page > Components View Settings

The following table correlates an setting in the Components view on the Organization page of the Advanced Designer with a setting in the BuildProperties.xml file:

Organization Page > Components View Settings

Option

BuildProperties.xml File Setting

Auto-clean when building

AutoCleanComponents="<true/false>"

Build Page > Build Installers View Settings

Build Configurations Tab

The following table correlates the settings on the Build Configurations tab in the Build Installers view on the Build page of the Advanced Designer with settings in a BuildProperties.xml file:

Build Page > Build Installers View > Build Configurations Tab Settings

Option

BuildProperties.xml File Setting

Select Build Configuration

Create a <configuration> element for each build configuration that you want to build, using the following syntax:

<configuration name="name_of_build_configuration">

    <webInstaller enable="true/false" optimize="true/false">

        <language>en/ja</language>

    </webInstaller>

    <cdRomInstaller enable="true/false" optimize="true/false" />

    <mergeModule enable="true/false" optimize="true/false"

        readOnly="true/false" />

    <target platform="aix/hpux/solaris/hpux/unixwithvm/macosx

        /java/unix/windows"

        buildWithVM="true/false"

        buildWithNoVM="true/false"

        outputDir="myOutputDir"

        bundledVM="path_to_file"

        />

</configuration>

Regarding each <target> element, note the following:

Each <target> element appends one new target to those already in the build configuration.
There can be multiple <target> elements.
The outputDir and bundledVM attributes are optional.
Each <target> element must include a buildWithVM attribute, a buildWithNoVM attribute, or both.

Important • The following subelements of the <configuration> element can also be specified outside of a <configuration> element. However, those elements defined within a <configuration> element override those defined elsewhere.

Build Output Location

BuildOutputLocation="<path_to_directory>"

[Working Directory]

BuildWorkdirLocation="<path_to_directory>"

Note • The working directory, which is used to store all temporary files (such as the build log and the locales directory) is set by default to the InstallAnywhere project directory. It is not specifically set in the Advanced Designer user interface.

Build Targets Subtab

The following table correlates the settings on the Build Targets subtab of the Build Configurations tab (Build page > Build Installers view) of the Advanced Designer with settings in a BuildProperties.xml file:

Build Page > Build Installers View > Build Configurations Tab > Build Targets Subtab Settings

Option

BuildProperties.xml File Setting

OS X

BuildMacOSX="<true/false>"

WantAuthenticationMacOSX="<true/false>"

WantAuthenticationMacOSXShowGUI="<true/false>"

Windows

BuildWindowsWithVM="<true/false>"

BuildWindowsWithoutVM="<true/false>"

WindowsVMpackLocation="<path_to_file>"

WindowsConsoleLauncher="<true/false>"

Windows_Pure_64_Bit

BuildWindows64WithVM="<true/false>"

BuildWindows64WithoutVM="<true/false>"

Windows64VMpackLocation="<path_to_file>"

AIX

BuildAIXWithVM="<true/false>"

BuildAIXWithoutVM="<true/false>"

AIXVMpackLocation="<path_to_file>"

HP-UX

BuildHPUXWithVM="<true/false>"-

BuildHPUXWithoutVM="<true/false>"

HPUXVMpackLocation="<path_to_file>"

Linux

BuildLinuxWithVM="<true/false>"

BuildLinuxWithoutVM="<true/false>"

LinuxVMpackLocation="<path_to_file>"

Solaris

BuildSolarisWithVM="<true/false>"

BuildSolarisWithoutVM="<true/false>"-

SolarisVMpackLocation="<path_to_file>"

Unix (All)

BuildUnixAll="<true/false>"

UNIX_with_VM

BuildNamedUnixWithVM="<true/false>"

BuildNamedUnixWithoutVM="<true/false>"

NamedUnixVMpackLocation="<path_to_file>"

NamedUnixTitle="<name_of_unix>"

Other Java-Enabled Platforms

BuildPureJava="<true/false>"

[Not available in the Advanced Designer]

OverrideAllPlatformSettings="<true/false>"

Distribution Subtab

The following table correlates the settings on the Distribution subtab of the Build Configurations tab (Build page > Build Installers view) of the Advanced Designer with settings in a BuildProperties.xml file:

Build Page > Build Installers View > Build Configurations Tab > Distribution Subtab Settings

Option

BuildProperties.xml File Setting

Build Web Installers

BuildWebInstaller="<true/false>"

Optimize [Web] Installer Size by Platform and Tags

OptimizeWebInstaller="<true/false>"

Web page displays in

This option is set within a <webInstaller> element inside of a build configuration element, <configuration>:

<configuration name="<name_of_build_configuration>">

    <webInstaller>

        <language><en/ja></language>

    </webInstaller>

    …

</configuration>

Note • See Select Build Configuration for more information.

Build CD-ROM installers

BuildCDROMInstaller="<true/false>"

Optimize [CD-ROM] Installer Size by Platform and Tags

OptimizeCDROMInstaller="<true/false>"

Build Merge Module Template

BuildMergeModule="<true/false>"

Optimize Merge Module/Template Size by Platform and Tags

OptimizeMergeModule="<true/false>"

Read Only

BuildReadOnlyMergeModule="<true/false>"

See Also