| Property |
Description |
| UUID |
This field is display-only, and it represents the Universally Unique Identifier (UUID) for this assembly. This value, along with the Version property, was used to create the directory structure for the assembly:
<Universal home>/assemblygallery/<UUID>/<Version>/assembly.dat |
| Version |
This field is display-only, and comprises the version of this assembly. To view this information, click the ellipsis ("...") and the following properties display. Set them as described below.
- Major—This represents the official release number of the assembly or a major update to it. For example, the Major property of the first release of an assembly would be 1.
- Minor—This represents an update to the original assembly. For example, the Minor property of the first update to an assembly would be 1. If this is the first release of the assembly, then this property would be 0.
- Maintenance—This represents a patch to the current version of the assembly. If the Maintenance property of the assembly is greater than 0, then this version of the assembly is a patch. If this is the first release of the assembly, then this property would be 0.
- Update—This property is used to further define the Version of the assembly; its use is developer-defined.
- Formatted—This property is not used by InstallShield Universal. It is strictly for your use. For example, you could set it to represent the release date or date of the last update/patch to this assembly.
Versions of assemblies with the same UUID are backward compatible. For example, let's say that a product specifies that it requires version 1.0 of an assembly. When the product is installed, version 1.2 of an assembly with the same UUID is found to already be installed on the target machine. The product will consider the assembly to already be installed and will reference version 1.2. |
| Name |
This field is display-only, and is the name of the assembly as it was specified in the assembly project as the root product's Display Name property (in the Installation Design view). It is also the name of this assembly as it displays in the Assembly Gallery. |
| Location |
This assembly may have already been installed on the target machine by another Universal Installer, RPM Installer, or Dynamic Suite project. These properties indicate the location where you expect the assembly to be installed, and where/if to install it if it is not found.
Universal does not support multiple side-by-side installs of a single assembly within a single product or suite. It is an error condition at both build and run times for a single product or Dynamic Suite to require a specific assembly in more than one location on the target system. For more information, see Collaboration/Side-by-Side Assemblies (also known as "multi-instance assemblies").
Click the ellipsis ("...") and the Assembly Install Location dialog box opens. Set its properties as described below. Example scenarios and how these properties should be set for them are provided in Assembly Scenarios.
- Install Location—If Assembly is Global is checked (described below), it indicates that this product can use any installed instance of this assembly on the target machine. If this assembly is not installed anywhere, then it will be installed to the Install Location specified here.
If Assembly is Global is not checked, and this assembly is not installed at the location specified here, then the assembly will be installed here.
In both of these examples, the Source property must have some/all build configurations selected in order to include this assembly in all builds of this product and to be able to install the assembly.
A string resolver can be used for this property, for example, $D(install)/employee_database. If a relative path is specified, then the location will be relative to the Install Location of the product that is installing this assembly.
- Assembly is Global
The following examples further clarify these property settings (also see Assembly Scenarios):
- If Assembly is Global is checked, and the assembly is installed anywhere on the target machine, then the product does not install the assembly.
- If Assembly is Global is not checked, and the assembly is already installed in the location specified by the Install Location field, then the product does not install the assembly.
- If Assembly is Global is not checked, and the assembly is already installed on the target machine to a location other than the one specified in the Install Location field, then the product installs the assembly to the location specified in the Install Location field.
If the product should install the assembly, then the value of the Install Location field determines where the assembly will be installed:
- If the Install Location field is not blank, then the assembly is installed to that location.
- If the Install Location field is blank, the assembly is installed to the location defined in the assembly project—the assembly's root product's Install Location property.
|
| Source |
This property contains the location of the referenced assembly. It also enables you to select with which build configuration(s) this assembly should be referenced when you build this project. This property works in conjunction with the Product Build Configuration/Include Assemblies property (in the Releases view) to enable you to, for example, install an add-on to an existing installation.
Click the ellipsis ("..."), and the Include Assemblies dialog box opens. Set its properties as described below.
- Assembly Source Location—This field is display-only and contains the location of the referenced assembly in the Assembly Gallery.
- Select the build configuration in which you want to include this assembly—This is the property by which you specify which build configuration(s), if any, should include a reference to this assembly.
- "All build configurations"—If selected, a reference to this assembly will be included when you build this project using any of the Product Build Configurations in the Releases view. Select this option if every build of this project will need to reference/install this assembly.
- "Specific build configuration"—If selected, the list of Product Build Configurations becomes selectable. Click the check box next to each Product Build Configuration in which you want a reference to this assembly included. If you never want a reference to the assembly to be included in the build of this project, then select this option and do not select any of the build configurations in the list.
|
