Settings for Platforms and Platform Suites

InstallShield 2019

Project • This information applies to the following project types:

InstallScript
InstallScript MSI

Note that some of the settings apply to both of these project types, but some apply only to one of these project types.

InstallShield includes several settings for platforms, platform suites, and languages.

Specifying Platforms at the Project Level

One project-level setting enables you to specify the platforms that your project supports:

Platform Filtering—Use this setting to specify the platforms that you want to be available when you select operating system requirements for components or releases in your project. In general, if a platform is not listed for this setting at the project level, you cannot designate that a particular component or release in your project is targeted for that platform.

The Platforms setting is available for InstallScript projects. To access this setting, open the General Information view. You can also configure this setting through the Project Settings dialog box: on the Project menu, click Settings, and click the Platforms tab.

Note • Specifying platforms at the project level does not create target system requirements for running the installation. If you want to create target system requirements in an InstallScript project, use the SYSINFO structure to identify the operating platform of the target system.

For information on how to specify target system requirements for InstallScript MSI projects, see Specifying Operating System in the Project Assistant.

Specifying Operating Systems and Platform Suites at the Component Level

Two component-level settings enable you to specify platform information for a component:

Operating Systems—If a component is specific to one or more operating systems, use this setting to indicate those operating systems. If the target machine’s operating system does not match one of the operating systems that are specified for this setting, the component is not installed.

By default, components are operating system independent, meaning that none of the component’s data are specific to certain operating systems.

The Operating Systems setting is available for InstallScript and InstallScript MSI projects. To access this setting, open the Components view and select a component.

Platform Suite(s)—If a component is specific to one or more platform suites, use this setting to indicate the suites. If you specify more than suite, you can indicate whether all or any of the suites must be present on the target machine in order for the component to be installed.

By default, components are platform suite independent, meaning that none of the component’s data are specific to a particular platform suite.

This setting provides an additional layer of filtering beyond the Operating Systems setting. Set the Platform Suite(s) setting only if necessary, and be sure to select only those platform suites that are required for the proper functioning of your application. For example, if a component should be installed on both the Home and Professional editions of Windows XP, you can leave Suite Independent as the value for this setting; selecting Windows XP for the Operating Systems setting encompasses both editions.

The Platform Suite(s) setting is available for InstallScript projects. To access this setting, open the Components view and select a component.

Specifying Platforms at the Release Level

One release-level setting enable you to specify platform information for a release:

Platform(s)—If a release is specific to one or more platforms, use this setting to indicate the platforms. If the platform specified for a component does not match one of the platforms that is selected for this setting, InstallShield does not include the component in the release.

The default value for this setting is Use Project Setting. This value indicates that the release supports the platforms that are specified at the project level.

The Platform(s) setting is available for InstallScript projects. To access this setting, open the Releases view and select a release. You can also configure this setting through the Platforms panel in the Release Wizard.

Controlling Support for Platforms and Platform Suites at Run Time for InstallScript Projects

During run time of InstallScript installations, you can control the platforms and platform suites that your installation supports by calling the FeatureFilterOS function.

In the OnFilterComponents event handler, the framework typically calls this function with the platforms and platform suites that match the target system so that only the appropriate components are installed. By calling FeatureFilterOS, you can override this default behavior to install or prevent the installation of components based on any platform or platform suite criteria that you specify.

For more information, see FeatureFilterOS.

See Also