Summary

Synopsis

When the .NET Precompile Assembly component property is set to Yes, at installation, the setup creates a native image from the .NET assembly included in the component and installs it to the native image cache on the target system. The .NET Framework is used in this process, and the setup automatically determines the version of the .NET Framework to use.

This article explains how to override the default version of the .NET Framework and manually specify your own version.

Discussion

When setting the .NET Precompile Assembly property for a component to the value of Yes, the version of the .NET Framework to use during the native image generation is selected by default. This version is determined by retrieving the version of the file InstallUtilLib.dll specified in the Tools > Option dialog. For example, if the version of this file is 1.1.4322.573, this process uses a minimum version of 1.1 for the .NET Framework. If no path is specified in the InstallUtilLib.dll location field, the default minimum version used is 1.1. This location of InstallUtilLib.dll can be modified using the following steps:

1. Select Tools > Options.

2. Select the .NET tab.

The version of the .NET Framework to be used can be set manually. This is helpful when multiple versions of the .NET Framework are on the machine and you'd like to specify a version prior to the latest version. Follow these steps:

1. Select the System Search view.

2. Right-click on the search item entitled ngen.exe and choose Modify.

3. In the How do you want to look for it? panel, click the Details button.

4. Specify a new Minimum Version and Maximum Version for the .NET Framework.

5. Rebuild the release.

Additional Information

The .NET Precompile Assembly property is discussed in further detail in the Help Library topic Component Settings.