Build Configurations Tab

InstallAnywhere 2017 » Advanced Designer » Build » Build Installers

The Build Configurations tab in the Build Installers view enables you to have total control over which software objects are included in a build. Each InstallAnywhere project can have multiple build configurations, each representing how the installer will be built for a particular set of locales, platforms, files, build distributions, JVMs, and other settings. You create and modify build configurations on the Build Configurations tab of the Build Installers view on the Build page. On this tab, you can add, edit, or delete a build configuration.

The Build Configurations tab contains the following subtabs:

Build Targets Subtab
Distribution Subtab
Tags Subtab
Locales Subtab

The Build Configurations tab includes the following controls:

Build Configurations Tab

Control

Description

Select Build Configuration

Select a build configuration in this list to view and modify its settings as needed.

In addition to new build configurations that you create, the following two values may be listed in the Select Build Configuration list:

Default Configuration—When a new InstallAnywhere project is created, from any of the templates, it is assigned the default build configuration, which is named Default Configuration. The Add to project build option is automatically selected for this configuration. All the build settings that are defined in the template are copied to the Default Configuration.
Migrated Configuration—Projects that are upgraded from earlier versions of InstallAnywhere have only one build configuration called Migrated Configuration, which has the same build settings that were found in the original project.

Add to project build

To include the selected build configuration in the project builds, select this check box. Each time that you click the Build Project button when this check box is selected, InstallAnywhere builds this build configuration.

Add Build Configuration

To create a new build configuration, click this button. The Add Configuration dialog box opens, prompting you to enter a name for the new build configuration.

Copy Build Configuration

To copy an existing build configuration, click this button. The Copy Configuration dialog box opens, prompting you to enter a name for the new build configuration.

Rename Build Configuration

To edit the name of an existing build configuration, click this button. The Rename Build Configuration dialog box opens, prompting you to enter a new name for the build configuration.

Remove Build Configuration

To delete the selected build configuration, click this button. InstallAnywhere displays a message box, prompting you to confirm that you want to delete the selected build configuration.

Add Build Target

Click to create a new build target. See Build Targets Subtab.

Build Output Location

For all of the build configurations in the project (regardless of how many are being built at the moment), there will be one subdirectory for each build configuration under the build output location. These subdirectories are named after the build configuration name.

For migrated projects, the build output location of the migrated configuration is as follows:

$IA_PROJECT_DIR$/$IA_PROJECT_NAME$_Build_Output

Open in Explorer

Opens a window to show the build output directory.

Build Project

To initiate the building of installers based on all of the build configurations that have been added to the project build (by having the Add to project build check box selected), click this button.

Build Selected

To build the selected build configuration, click this button.

Build All

To build all build configurations that have been added to the project, click this button.

[Target Installer Selection List]

This list appears between the Build All and Try Installer buttons if, after the project has been built, more than one supported target installer is available for the authoring platform. If there are none or only one supported target installer, this list is hidden.

Note • The name that is displayed for each target installer uses one of the following formats:

Without VM—OutputFolderName_BuildConfigurationName
With VM—OutputFolderName_BuildConfigurationName - BundledVMName

Try Installer

To run the default installer for your operating system, click this button. If two or more installers are built for your operating system, InstallAnywhere shows a control that lists the installers (by their Output label and bundled VM) that you can try.

Note • To assist in troubleshooting when running an installer on a Windows platform, it is possible to display debug output in a console window. To display debug output during installation, hold down the Control (Ctrl) key when clicking the Try Installer button.

Try Web Install

To test the Web installation, click this button. InstallAnywhere launches the InstallAnywhere Web install page that is generated by the build process in a Web browser, enabling you to test the Web installer.