InstallShield 2013 Express Edition
The General Information settings are organized into the following main categories:
• | General |
• | Summary Information Stream |
• | Add or Remove Programs |
• | Software Identification Tag |
Use the General area of the General Information view to specify details such as product name and product version. The following settings are available in this area.
Setting |
Description |
||||||||||||||||||
Product Name |
Enter the name of the product. For information on how the product name is used, see Specifying a Product Name. |
||||||||||||||||||
Product Version |
Enter the version number for your product. The version must contain only numbers. It is typically in the format aaa.bbb.ccccc or aaa.bbb.ccccc.ddddd, where aaa represents the major version number, bbb represents the minor version number, ccccc represents the build number, and ddddd represents the revision number. The maximum value for the aaa and bbb portions is 255. The maximum value for ccccc and ddddd is 65,535. Note that although you can include the fourth field (ddddd), the installation does not use this part of the product version to distinguish between different product versions. To learn more, see Specifying the Product Version. If your release includes a Setup.exe file, the product version that you specify is displayed on the Properties dialog box for Setup.exe. For more information, see Customizing File Properties for the Setup Launcher. |
||||||||||||||||||
Product Code |
Enter a GUID that uniquely identifies this product. To have InstallShield generate a different GUID for you, click the Generate a new GUID button ({...}) in this setting. Since this code uniquely identifies your product, changing the product code after you have already distributed your release is not recommended. For more information, see Setting the Product Code. |
||||||||||||||||||
Upgrade Code |
Enter a GUID that uniquely identifies this product. To have InstallShield generate a different GUID for you, click the Generate a new GUID button ({...}) in this setting. The product GUID is used to associate uninstallation or maintenance with the original installation. A new GUID is automatically generated for each new project that you create, including copies of existing projects. Once you have changed a project’s product GUID, its previous GUID cannot be recovered. For these reasons, changing a project’s product GUID is typically not necessary and should be approached with caution. For more information, see Setting the Upgrade Code. |
||||||||||||||||||
INSTALLDIR |
Specify the value of the Windows Installer property INSTALLDIR, which indicates the destination directory where most of the files of the product will be installed at run time. The default value is as follows: [ProgramFilesFolder]My Company Name\My Product Name Instead of hard-coding a path, you can enter a directory property as part of the path. To select a directory property, click the ellipsis button (...) in this setting. This enables you to select the appropriate directory from a list, or to create a new directory within a predefined directory. Separate further levels of subdirectories with a backslash—for example, [ProgramFilesFolder]MyApp\Bin. Windows Logo Guideline: To comply with the Windows logo program, your product's default destination should be a subfolder of the Program Files folder ([ProgramFilesFolder]), which can vary depending on the system’s locale and user settings. For more information, see Setting the Default Product Destination Folder (INSTALLDIR). |
||||||||||||||||||
Locked-Down Permissions |
Select the type of permissions that you want to use for securing files, folders, and registry keys for end users who run your product in a locked-down environment. Available options are:
It is often more advantageous to use the custom InstallShield handling than the traditional Windows Installer handling. For example:
This is a project-wide setting that affects all new permissions that you set for files, folders, and registry keys in your project. If you have already configured some permissions in your project and then you change the value of this setting, InstallShield lets you specify whether you want to use the alternate handling method for those already-existing permissions. For more information about configuring this setting, see Securing Files, Folders, and Registry Keys in a Locked-Down Environment. |
||||||||||||||||||
Specify the default destination folder for all of your application’s database files. Note: When you are specifying a destination folder for your application’s database files, you cannot include a space after the closing square bracket (]), or before or after a backslash (\). For example, the following paths are not valid: [ProgramFilesFolder] \MyApp\Bin [ProgramFilesFolder]MyApp\ Bin It is important to note when using an installer folder property such as DATABASEDIR that you are specifying a default value. An end user could change this value by setting a property when launching Msiexec.exe at the command line or by selecting a new destination folder for a feature in the Database Folder dialog. |
|||||||||||||||||||
Default Font |
To select the font that you want your installation to use in its user interface, click the ellipsis button (...) in this setting. If you do not select a font, the installer uses the default system font. |
||||||||||||||||||
Specify how the Windows Installer property ALLUSERS should be set in your project. The ALLUSERS property specifies whether Windows Installer should attempt to perform a per-machine or per-user installation. Valid options are:
On Windows Vista and later systems, if User Account Control is enabled and the user does not have administrative privileges, the user must be able to provide administrative credentials in order to install the product. On other systems, if the user does not have administrative privileges, the installation displays an error message and exits.
The default value for all new projects is ALLUSERS=1 (Per-machine installation). Note: The value that you specify here for ALLUSERS could be overwritten at run time. For more information, see Per-User vs. Per-Machine Installations. |
|||||||||||||||||||
To specify whether Windows Installer 4.0 or later should log your installation, click the ellipsis button (...) in this setting, which launches the Logging Options for Windows Installer 4.0 and Later dialog box. This dialog box is where you specify whether Windows Installer should log your installation. You can also use this dialog box to customize the types of messages that are logged. There are three possible values for this setting:
If the value of this setting is Yes or Custom, and if the installation is run with Windows Installer 4.0 or later, as well as Windows Vista or later or Windows Server 2008 or later, the following occurs:
The Create MSI Logs setting applies to installations that are run with Windows Installer 4.0 or later on Windows Vista and later systems or Windows Server 2008 and later systems. The Show the Windows Installer log check box is not visible in run-time dialogs that are displayed on earlier systems that are running earlier versions of Windows Installer. For more information, including details on how to customize the types of messages that are logged, see Specifying Whether Windows Installer Installations Should Be Logged. |
|||||||||||||||||||
If you want to reduce the time that is required to install a large Windows Installer package, consider selecting the check boxes for one or more of the following options:
This setting configures the Windows Installer property MSIFASTINSTALL, which can be set at the command line. Windows Installer 5 includes support for this setting. Earlier versions of Windows Installer ignore it. |
Summary Information Stream Settings
Windows Installer databases are implemented as COM structured storage, and COM structured storage files usually contain a Summary Information Stream. The Summary Information Stream contains information about your company and the product that is being installed.
The following settings are available in the Summary Information Stream area in the General Information view.
Setting |
Description |
Title |
Specify the type of database that you are creating. For a product installation, the default value is Installation Database, which is the recommended value. The value that you enter is used on the Summary tab of the Properties dialog box that is displayed if you right-click the Windows Installer database and then click Properties. |
Subject |
Enter the name of the product. The value that you enter is used on the Summary tab of the Properties dialog box that is displayed if you right-click the Windows Installer database and then click Properties. |
Author |
Specify your company name. The value that you enter is used on the Summary tab of the Properties dialog box that is displayed if you right-click the Windows Installer database and then click Properties. |
Keywords |
Specify keywords that describe the Windows Installer database for your product. The value that you enter is used on the Summary tab of the Properties dialog box that is displayed if you right-click the Windows Installer database and then click Properties. |
Summary Information Stream Comments |
Enter any comments about your product. A typical value for this setting is as follows: This installer database contains the logic and data required to install MyProduct. The value that you enter is used on the Summary tab of the Properties dialog box that is displayed if you right-click the Windows Installer database and then click Properties. |
Schema |
This setting lets you specify the integer that identifies the minimum Windows Installer version that is required for your installation package. For a minimum of Windows Installer 2.0, enter 200. For a minimum of Windows Installer 3.0, enter 300. For a minimum of Windows Installer 3.1, enter 301. For a minimum of Windows Installer 4.5, enter 405. If the end user’s system has a Windows Installer version earlier than the minimum requirement that you specify for the Schema setting—for example, if you specify a schema value of 405 because your installation uses Windows Installer 4.5 features, but an end user has Windows Installer 3.1—the installation displays an error message and exits. The value that you enter for the Schema setting is used for the Page Count Summary property of your Windows Installer database. |
Require Administrative Privileges |
Specify whether your installation requires administrative privileges. The default is Yes. If you set this to No, InstallShield sets bit 3 in the Word Count Summary property to indicate that elevated privileges are not required to install the .msi package. Note that if you select No but your .msi package tries to perform a task for which it does not have adequate privileges, Windows Installer may display a run-time error. This setting applies to installations that are run with Windows Installer 4.0 or later on Windows Vista and later systems or Windows Server 2008 and later systems. Earlier versions of Windows Installer and Windows ignore this setting. Note that an end user’s installation experience is more secure when installations are run with only the permissions that they need. Unless an application is designed to be run only by system administrators, it should be run with the least privilege. |
Add or Remove Programs Settings
Add or Remove Programs (which is called Programs in the latest versions of Windows) in the Control Panel provides end users with technical support links and telephone numbers, product update information, and information about a product’s manufacturer. Depending on how the installation is configured, the end user may have the option of removing, repairing, or changing the installation with the click of a button. You can specify this information in your project by configuring the Add or Remove Programs settings in the General Information view.
Setting |
Description |
||||||
Show Add or Remove Programs Entry |
Indicate whether you want to show your product's entry in Add or Remove Programs in the Control Panel. Available options are:
|
||||||
Display Icon |
Enter the path on your development system to the icon file (.ico or .exe) that you want to be used for your product’s entry in Add or Remove Programs. Instead of manually typing the path and file name, you can click the ellipsis button (...) in this setting to browse to the file. |
||||||
Disable Change Button |
Specify whether you want to disable the Change button for your product’s entry in Add or Remove Programs. The Change button enables end users to change installation options after the product has been installed. End users can remove or add features as needed. |
||||||
Disable Remove Button |
Specify whether you want to disable the Remove button for your product’s entry in Add or Remove Programs. The Remove button enables end users to remove the product by clicking one button, which runs your uninstaller with a reduced user interface. If the end user clicks the Remove button to remove your product, actions in the User Interface sequence of the project are executed. |
||||||
Disable Repair Button |
Specify whether you want to disable the Repair button for your product’s entry in Add or Remove Programs. The Repair button enables end users to run the Windows Installer repair option if any files have been deleted or corrupted. |
||||||
Publisher |
Specify the name of the company that created the product. This information is displayed for your product’s entry in Add or Remove Programs. The value that you enter is stored in the Windows Installer Manufacturer property. Windows Logo Guideline: If you want to meet the requirements of the Windows logo program, you must specify the publisher. |
||||||
Publisher/Product URL |
Enter a general URL for your company or product—for example, http://www.installshield.com. On some versions of Windows, the publisher name on the Support Info dialog box is a hyperlink to this URL. The Support Info dialog box is displayed when an end user clicks the support information hyperlink for your product’s entry in Add or Remove Programs. |
||||||
Support Contact |
Enter the name of the person or department that end users should contact for technical support. On some versions of Windows, this information is displayed on the Support Info dialog box for your product’s entry in Add or Remove Programs. |
||||||
Support URL |
Enter the URL that you would like end users to visit for technical support information for your product. This URL is displayed for your product's entry in Add or Remove Programs. Windows Logo Guideline: If you want to meet the requirements of the Windows logo program, you must enter a valid URL. |
||||||
Support Phone Number |
Enter the technical support phone number for your product. On some versions of Windows, this information is displayed on the Support Info dialog box for your product’s entry in Add or Remove Programs. |
||||||
Read Me |
Enter the name or path of the Readme file for your product. As an alternative, you can link to a Readme file located on the Internet by specifying a valid URL. On some versions of Windows, this information is displayed on the Support Info dialog box for your product’s entry in Add or Remove Programs. Note: You do not need to use a backslash (\) between a directory identifier that you select from the list and the file or folder name. For example, [INSTALLDIR]MyFolder\Readme.txt is a valid path format. |
||||||
Product Update URL |
Specify a URL where end users can get information about product updates or download the latest version. On some versions of Windows, this information is displayed on the Support Info dialog box for your product’s entry in Add or Remove Programs. |
||||||
Add or Remove Programs Comments |
Enter comments about your product. This information is displayed for your product’s entry in Add or Remove Programs. |
Software Identification Tag Settings
Use the Software Identification Tag area of the General Information view to specify whether you want to include an ISO/IEC 19770-2 software identification tag in your installation. If a tag is included, this area also lets you specify the identification information that is not already specified in other areas of the General Information view.
For more information, see Including a Software Identification Tag for Your Product.
Setting |
Description |
||||||||||||
Use Software Identification Tag |
Specify whether you want to include an ISO/IEC 19770-2 software identification tag in your installation. If you select Yes, use the other tag-related settings in this area of the General Information view to specify the identification information that is not already specified in other areas of the General Information view. |
||||||||||||
Require Software Entitlement |
Specify whether you want to require your product to have a corresponding software entitlement in order for software reconciliation to be considered successful. In general, if the software must be purchased, Yes should be selected for this setting; if the software is free, No should be selected for this setting. |
||||||||||||
Unique ID |
Enter a unique ID that identifies the specific version of this specific product. To have InstallShield generate a different GUID for you, click the Generate a new GUID button (...) in this setting. Note that InstallShield uses the value that you enter as part of the name of the tag file (TagCreatorID_UniqueID.swidtag). Therefore, the ID that you enter must not contain any characters that are invalid for file names. |
||||||||||||
Tag Creator |
Enter the name of the organization that created the tag. |
||||||||||||
Tag Creator ID |
Enter the registration ID of the organization that created the tag. This ID helps to differentiate between different legal organizations that have the same creator name but are in different countries. The convention for the registration ID is as follows: regid.YYYY-MM.ReversedDomainName,division The registration ID consists of the following parts:
Note that InstallShield uses the value that you enter as part of the name of the tag file (TagCreatorID_UniqueID.swidtag). Therefore, the ID that you enter must not contain any characters that are invalid for file names. |
||||||||||||
Software Creator |
Enter the name of the organization that created the software. This setting is optional. If you leave this setting blank, InstallShield uses the value of the Tag Creator setting for the name of the software creator. |
||||||||||||
Software Creator ID |
Enter the registration ID of the organization that created the software. This ID helps to differentiate between different legal organizations that have the same creator name but are in different countries. This setting is optional. If you leave this setting blank, InstallShield uses the value of the Tag Creator ID setting for the software creator ID. The convention for the registration ID is as follows: regid.YYYY-MM.ReversedDomainName,division The registration ID consists of the following parts:
|
||||||||||||
Software Licensor |
Enter the name of the organization that owns the copyright for the software. This setting is optional. If you leave this setting blank, InstallShield uses the value of the Tag Creator setting for the name of the software licensor. |
||||||||||||
Software Licensor ID |
Enter the registration ID of the organization that owns the copyright for the software. This ID helps to differentiate between different legal organizations that have the same licensor name but are in different countries. This setting is optional. If you leave this setting blank, InstallShield uses the value of the Tag Creator ID setting for the software licensor ID. The convention for the registration ID is as follows: regid.YYYY-MM.ReversedDomainName,division The registration ID consists of the following parts:
|
See Also
Configuring General Project Settings
Changing the Product Version During a Build
InstallShield Express Edition Help LibraryJune 2013 |
Copyright Information | Contact Us |