$IA_BROWSE_FOLDERS$ Variable

InstallAnywhere 2018

The $IA_BROWSE_FOLDERS$ variable controls whether InstallAnywhere-generated installers use Swing or native resources to render the Browse for Folder dialog box (also called the Select Folder dialog box). This distinction is important when localizing an installer.

$IA_BROWSE_FOLDERS$ Variable Values

Value

Description

Native

When the $IA_BROWSE_FOLDERS$ variable is set to Native, the installer renders a Browse for Folder dialog box that has a look and feel consistent with the end user’s operating system. However, if you choose the Native option, installers that are running in languages other than the target system’s locale display text in that system’s locale rather than in the installer-selected language.

For example, if an end user who is installing an application on a target operating system using the English locale chooses German as the selected language in the installer, some English strings appear on the Browse for Folder dialog box.

Swing

When the $IA_BROWSE_FOLDERS$ variable is set to Swing, the installer renders a Browse for Folder dialog box that uses the correct locale for all languages, and it is consistent across different platforms. However, the dialog box may not provide a fully native experience for end users. It may have a different layout than the standard Browse for Folder dialog box that is rendered by the end user’s operating system.

Note • If the $IA_BROWSE_FOLDERS$ variable is set to any value other than Native or Swing, the installer uses native resources.

Comparison Between Native and Swing Settings

The following images illustrate the differences between the Browse for Folder dialog box that is rendered with native resources versus one that is rendered with Swing resources on Windows-based and Linux-based systems.

Native (Left) vs. Swing (Right) on Windows

Native (Left) vs. Swing (Right) on Linux

Changing the Look and Feel for macOS or OS X–Based Systems with Certain Versions of JRE

The Change Media run-time panel has a Browse button that should enable end users to browse to the next installation media that they want to use. Apple macOS or OS X–based systems that use Oracle Java 7 with an update earlier than update 45 do not support native resources for the button on that panel, so the browse button does not work as expected. If you want to use Swing resources instead of native resources for that panel and avoid problems with the browse button, you can set the ia.mac.filechooser.substituteSwingInsteadOfNativeForOlderJRE7 variable to true for installers that target macOS or OS X–based systems that use Oracle Java 7 with an update earlier than update 45. The default value for this property is false.

To specify that you want to use the Swing Version of the Change Media panel:

1. In the Advanced Designer, on the Project page, click JVM Settings. The JVM Settings view opens.
2. Click the Installer Settings tab.
3. In the Optional Installer Arguments area, in the Additional Arguments box, enter the following:

-Dia.mac.filechooser.substituteSwingInsteadOfNativeForOlderJRE7=true