Modifying the List of Available Windows Mobile Platforms or their Associated Settings

InstallShield 2012 Spring Express Edition

Project: This information applies to the following project types:

•

Express

•

Smart Device

The Windows Mobile Wizard and the Smart Device Setup Wizard let you set platform requirements for files that are to be installed to target devices. You can select platforms from a predefined list of platforms. If you want to target a platform that is not in the predefined list, or if you want to modify any of the configuration settings that are associated with one of the predefined platforms, you can do so. The following instructions explain how.

Caution: The following instructions require that you modify the Settings.xml file that is installed with InstallShield. This file contains critical data; if it is edited incorrectly, it can cause InstallShield to fail to work. Use extreme care when editing this file.

To modify the list of predefined mobile device platforms or to modify settings that are associated with one of the platforms:

Close InstallShield.

Find the Settings.xml file that is installed with InstallShield. Settings.xml is installed in one of the following locations, depending on which language version of InstallShield you are using:

•

English—InstallShield Program Files Folder\Support\0409

•

Japanese—InstallShield Program Files Folder\Support\0411

Create a back-up copy of the Settings.xml, in case you later need to revert to the original version.

Use a text editor or XML file editor to open the Settings.xml file.

Search for the <ISMobile> element and its child elements.

Modify the XML code under the <ISMobile> element as needed.

For example, to add a new platform, add a new <MobileDevice> child element with the appropriate attributes and child elements. To change the configuration settings that are associated with one of the already defined platforms, modify that platform's elements and attributes as needed.

Save the Settings.xml file.

Ensure that your XML code is well formed; if it is not well formed, you may have problems using InstallShield. In most cases, you can identify improperly formed XML code by opening the Settings.xml file in Internet Explorer. You should be able to expand and contract the major elements of the file; if you cannot, check the code for errors.

Important: Once you have modified mobile device settings in the Settings.xml file, thoroughly test your installation on multiple platforms to ensure that your mobile device application installs as expected.

The next time that you use InstallShield, the changes that you made are available in InstallShield.

Following are some sample lines in the Settings.xml file. The sample lines include <MobileDevice> elements for several platforms: Windows Mobile 6.x Professional and Classic, Windows Mobile 6.x Standard, Windows Embedded CE 6.x, Pocket PC Windows Mobile 5.x, and Windows CE 5.x.

<MobileDevice

Mask="65536"

DisplayName="Windows Mobile 6.x Professional and Classic"

PlatformMin="5.2"

PlatformMax="1000"

DeviceName="PPC600"

PlatformString="PocketPC">

</MobileDevice>

<MobileDevice

Mask="32768"

DisplayName="Windows Mobile 6.x Standard"

PlatformMin="5.2"

PlatformMax="1000"

DeviceName="SMARTPHONE600"

PlatformString="Smartphone">

</MobileDevice>

<MobileDevice

Mask="16384"

DisplayName="Windows Embedded CE 6.x"

PlatformMin="6.0"

PlatformMax="1000"

DeviceName="CE6">

</UnsupportedPlatforms>

</MobileDevice>

<MobileDevice

Mask="2048"

DisplayName="Pocket PC Windows Mobile 5.x"

PlatformMin="4.0"

PlatformMax="5.1"

DeviceName="PPC500"

PlatformString="PocketPC"

BuildMaxScreenSupport="0xE0000000">

</MobileDevice>

<MobileDevice Mask="4096"

DisplayName="Windows CE 5.x"

PlatformMin="5.0"

PlatformMax="5.9"

DeviceName="CE5">

</UnsupportedPlatforms>

</MobileDevice>

</MobileDevices>

</ISMobile>

The following table describes the attributes and child elements that are used in the sample XML code.

Attributes and Child Elements in the <ISMobile> Part of the Settings.xml File

Attribute or Child Element Name

Description

Mask attribute

The value of the mask attribute is the bit value that identifies the platform.

The following XML element shows an example of the Mask attribute and value:

</MobileDevice>

DisplayName attribute

The value of the DisplayName attribute is the text that InstallShield displays in the Windows Mobile Wizard and the Smart Device Setup Wizard for this platform.

The following XML element shows an example of the DisplayName attribute and value:

</MobileDevice>

PlatformMin attribute

The PlatformMin and PlatformMax attributes are used to limit which device versions are valid for the .cab file.

The following XML element shows an example of the PlatformMin and PlatformMax attributes, as well as their values:

</MobileDevice>

For information about values for the PlatformMin attribute, see Platform Type Reference on the MSDN Web site.

PlatformMax attribute

The PlatformMin and PlatformMax attributes are used to limit which device versions are valid for the .cab file.

The following XML element shows an example of the PlatformMin and PlatformMax attributes, as well as their values:

</MobileDevice>

For information about values for the PlatformMax attribute, see Platform Type Reference on the MSDN Web site.

DeviceName attribute

The DeviceName attribute indicates the name of the device.

The following XML element shows an example of the DisplayName attribute and value:

</MobileDevice>

PlatformString attribute

The PlatformString attribute indicates the platform name. Examples of valid values are Smartphone and PocketPC.

The following XML element shows an example of the PlatformString attribute and value:

</MobileDevice>

BuildMaxScreenSupport attribute

The BuildMaxScreenSupport attribute indicates screen-related support. Valid values are:

•

0xA0000000—Supports square screens.

•

0xC0000000—Supports screen rotation.

•

0xE0000000—Supports both square screens and screen rotation.

The following XML element shows an example of the BuildMaxScreenSupport attribute and value:

</MobileDevice>

If a file in the installation requires a square screen or a rotated screen but the target system's platform does not include that required support, the installation may display a warning such as the following one at run time:

The program you have installed may not display correctly because it was designed for a previous version of Windows Mobile software.

The installation suppresses this warning if the BuildMaxScreenSupport attribute is set for the platform and it indicates the required support. The warning is also suppressed in other scenarios. For more information, see Suppressing the Display Warning for Legacy Mobile Device Applications.

<UnsupportedPlatforms> child element

The <UnsupportedPlatforms> child element identifies platforms that are not supported.

The following XML element shows an example of the <UnsupportedPlatforms> element and some of its child elements:

</UnsupportedPlatforms>

</MobileDevice>

Modifying the List of Available Windows Mobile Platforms or their Associated Settings

InstallShield 2012 Spring Express Edition Help Library

May 2012