Assemblies (Setup Architecture)

The Assemblies page lets you install .NET assemblies into the Global Assembly Cache or a custom folder on the target system.

Adding an Assembly

To add an assembly to your setup:

1. Click the Add button.
2. Browse and select the assembly to add.
3. The assembly is added to the Global Assembly Cache for the installation.
4. To change the assembly installation location, read below.

Updating an Assembly

To update an assembly that has been added to setup:

1. Select the assembly to update.
2. Click the Edit button.
3. Update the dialog fields in the Install Assembly dialog.

Configuring Additional Assembly Options

To configure additional options for one or more assemblies:

1. Select the assemblies to configure the additional options for.
2. Check the Generate Native Images (ngen) check-box to generate native images for the selected assemblies. Otherwise, clear this check-box.
3. Check the Register Assembly (regasm) check-box to register selected assemblies with COM Interop. Otherwise, clear this check-box.
4. Check the Run Installer Class (installutil) check-box to run the (un)installer classes contained in the selected assemblies. Otherwise, clear this check-box.

If the check-box for a particular selection of assemblies is shaded (neither checked nor un-checked), this indicates that some of the selected assemblies have the option enabled, while others have the option disabled. Checking/un-checking the check-box when it is shaded will apply the changes to all selected assemblies uniformly.

To configure whether assemblies should be forcefully removed from the Global Assembly Cache at uninstall time when there are no more applications referencing those assemblies, check the Force uninstall of unpinned assemblies from the GAC check-box. This setting applies to all assemblies globally.

Removing an Assembly

To remove an assembly from your installation:

1. Select the assembly to remove. You may select multiple assemblies.
2. Click the Delete button.

Scripting Details

The two-way integrated IDE emits or updates the underlying setup script every time the visual view is used. If you are using InstallAware scripting in your setups, the following information identifies the changes made by this visual page to your setup script.

Commands Used

This page emits the following types of scripting commands: Install Assembly, Generate Native Images, Register Assembly, Run .NET Installer Class, Remove Assemblies. Additional general scripting commands may be emitted.

Commands Required

This page requires the following scripting commands to be already present in your setup script: Apply Install, Apply Uninstall.