This article describes the script used to automatically download and install the Microsoft .NET Framework during the TimeSprite installation. Developers of .NET applications may find this information useful for their own applications.

The script is based heavily on the script Ted Ehrich posted to the Inno Setup newsgroup in this post: http://news.jrsoftware.org/news/innosetup.isx/msg06108.html

The script uses some of the third party add-ons to Innosetup, I think the QuickStart Pack includes what you need.

Requirements
Having the .NET Framework as a dependency makes the installation requirements somewhat complex.

• You need to detect whether the framework is already installed.
• The Framework needs to be installed by an administrator, but applications normally do not.
• You don’t want to distribute the framework with your application.
• You don’t want to force people to download the Framework if they don’t need to, ie. they have a local copy.
• The installation of the product should not go ahead if the .NET Framework installation fails or is cancelled.

The Script

The script that I ended up with performs the following processing:

1. Requires Windows 98 or Windows NT4 or later. For simplicity it does not check for the required NT4 service pack or Internet Explorer 5.01 - I don’t think many systems that back level will be installing new software. However in testing I did verify that if the version of IE is too low, the .NET Framework installation asks for it to be upgraded.
2. If the .NET Framework is not installed and the user is not logged on as an administrator, it tells the user they need an administrator to install the .NET Framework.
3. If the .NET Framework is not installed, it looks for the dotnetfx.exe file in the same location as the setup file. If it is not found, it downloads it from Microsoft.
4. Installs the .NET Framework if required.
5. If the .NET Framework installation was successful or it was already installed, installs the application.

I haven’t programmed in Pascal, and this was my first shot at an Inno Setup script, so there are probably plenty of opportunities for tidying things up. A lot of what I did was just copying and modifying stuff. However the end result does seem to handle the .NET installation nicely.

Here is the script: dotnet.iss

Notes:

• The script is based on .NET Framework 1.1 but changes for other versions should be simple.
• The best way to check whether the .NET Framework is installed seems to be registry key ‘HKEY_LOCAL_MACHINE\Software\Microsoft\.NETFramework\policy\v1.1′. This key is accessible to regular users.
• If the .NET Framework download or installation fails or is cancelled, the installation goes back to the Ready to Install page. The user can restart the install, or cancel it.
• The URL for the .NET Framework download is hard coded. If it changes a new setup will be required. However it seems to be referenced in many places around the Internet, so hopefully Microsoft will think twice before changing it (famous last words…).
• If the user cancels the .NET Framework download partway through, then restarts the installation, the download resumes from where it was canceled. If they cancel the .NET Framework installation then restart the installation, it does not need to be downloaded again. (Both cases assume they did not exit the whole install).
• I have not tried to make the .NET install silent - I felt it was better to let the user see what is going on. The process can take a while.

Unrelated but perhaps useful information

I also have a digital photo program, Picnam, which I converted to the same process. Picnam adds entries to the “Open With” menu in Explorer, so that people can easily open images using Picnam but existing file associations are not affected.

These are the registry entries I used:

[Registry]
Root: HKCR; Subkey: “.jpg\OpenWithList\MyApp.exe”; Flags: uninsdeletekey noerror
Root: HKCR; Subkey: “.jpeg\OpenWithList\MyApp.exe”; Flags: uninsdeletekey noerror
Root: HKCR; Subkey: “applications\MyApp.exe\shell\open\command”; ValueType: string; ValueData: “”"{app}\MyApp.exe”" “”%1″”"; Flags: uninsdeletekey noerror

Root: HKCU; Subkey: "Software\Classes\.jpg\OpenWithList\MyApp.exe"; Flags: uninsdeletekey
Root: HKCU; Subkey: "Software\Classes\.jpeg\OpenWithList\MyApp.exe"; Flags: uninsdeletekey
Root: HKCU; Subkey: "Software\Classes\applications\MyApp.exe\shell\open\command"; ValueType: string; ValueData: """{app}\MyApp.exe"" ""%1"""; Flags: uninsdeletekey

The HKCR values install the “Open With” option for all users, but fail if the user is not an administrator. The HKCU values install it for the current user, and work even if the user is not an administrator.

VMWare

I used VMWare Workstation for the first time in testing the setup process, and I have to say it is a huge productivity booster for this type of thing. Using snapshots I was able to run the installation process with minor changes in various configurations over and over again - probably about 20 times in a couple of hours. It was a huge productivity gain, and I join those who say that VMWare or an equivalent product is an essential tool for software development.

This article describes the script used to automatically download and install the Microsoft .NET Framework during the TimeSprite installation. Developers of .NET applications may find this information useful for their own applications.

The script is based heavily on the script Ted Ehrich posted to the Inno Setup newsgroup in this post: http://news.jrsoftware.org/news/innosetup.isx/msg06108.html

The script uses some of the third party add-ons to Innosetup, I think the QuickStart Pack includes what you need.

Requirements
Having the .NET Framework as a dependency makes the installation requirements somewhat complex.

• You need to detect whether the framework is already installed.
• The Framework needs to be installed by an administrator, but applications normally do not.
• You don’t want to distribute the framework with your application.
• You don’t want to force people to download the Framework if they don’t need to, ie. they have a local copy.
• The installation of the product should not go ahead if the .NET Framework installation fails or is cancelled.

The Script

The script that I ended up with performs the following processing:

1. Requires Windows 98 or Windows NT4 or later. For simplicity it does not check for the required NT4 service pack or Internet Explorer 5.01 - I don’t think many systems that back level will be installing new software. However in testing I did verify that if the version of IE is too low, the .NET Framework installation asks for it to be upgraded.
2. If the .NET Framework is not installed and the user is not logged on as an administrator, it tells the user they need an administrator to install the .NET Framework.
3. If the .NET Framework is not installed, it looks for the dotnetfx.exe file in the same location as the setup file. If it is not found, it downloads it from Microsoft.
4. Installs the .NET Framework if required.
5. If the .NET Framework installation was successful or it was already installed, installs the application.

I haven’t programmed in Pascal, and this was my first shot at an Inno Setup script, so there are probably plenty of opportunities for tidying things up. A lot of what I did was just copying and modifying stuff. However the end result does seem to handle the .NET installation nicely.

Here is the script: dotnet.iss

Notes:

• The script is based on .NET Framework 1.1 but changes for other versions should be simple.
• The best way to check whether the .NET Framework is installed seems to be registry key ‘HKEY_LOCAL_MACHINE\Software\Microsoft\.NETFramework\policy\v1.1′. This key is accessible to regular users.
• If the .NET Framework download or installation fails or is cancelled, the installation goes back to the Ready to Install page. The user can restart the install, or cancel it.
• The URL for the .NET Framework download is hard coded. If it changes a new setup will be required. However it seems to be referenced in many places around the Internet, so hopefully Microsoft will think twice before changing it (famous last words…).
• If the user cancels the .NET Framework download partway through, then restarts the installation, the download resumes from where it was canceled. If they cancel the .NET Framework installation then restart the installation, it does not need to be downloaded again. (Both cases assume they did not exit the whole install).
• I have not tried to make the .NET install silent - I felt it was better to let the user see what is going on. The process can take a while.

Unrelated but perhaps useful information

I also have a digital photo program, Picnam, which I converted to the same process. Picnam adds entries to the “Open With” menu in Explorer, so that people can easily open images using Picnam but existing file associations are not affected.

These are the registry entries I used:

[Registry]
Root: HKCR; Subkey: “.jpg\OpenWithList\MyApp.exe”; Flags: uninsdeletekey noerror
Root: HKCR; Subkey: “.jpeg\OpenWithList\MyApp.exe”; Flags: uninsdeletekey noerror
Root: HKCR; Subkey: “applications\MyApp.exe\shell\open\command”; ValueType: string; ValueData: “”"{app}\MyApp.exe”" “”%1″”"; Flags: uninsdeletekey noerror

Root: HKCU; Subkey: "Software\Classes\.jpg\OpenWithList\MyApp.exe"; Flags: uninsdeletekey
Root: HKCU; Subkey: "Software\Classes\.jpeg\OpenWithList\MyApp.exe"; Flags: uninsdeletekey
Root: HKCU; Subkey: "Software\Classes\applications\MyApp.exe\shell\open\command"; ValueType: string; ValueData: """{app}\MyApp.exe"" ""%1"""; Flags: uninsdeletekey

The HKCR values install the “Open With” option for all users, but fail if the user is not an administrator. The HKCU values install it for the current user, and work even if the user is not an administrator.

VMWare

I used VMWare Workstation for the first time in testing the setup process, and I have to say it is a huge productivity booster for this type of thing. Using snapshots I was able to run the installation process with minor changes in various configurations over and over again - probably about 20 times in a couple of hours. It was a huge productivity gain, and I join those who say that VMWare or an equivalent product is an essential tool for software development.