Click here to Skip to main content
Click here to Skip to main content

Modular InnoSetup Dependency Installer

By , 23 Sep 2011
 
Screenshot - dotnetfx_installer1.jpg

Screenshot - dotnetfx_installer3.jpg

Introduction

This article contains a modular InnoSetup install script that downloads (if setup files don't exist already) and installs various dependencies like .NET Framework 1.1/2.0/3.5/4.0 and others on 32-bit or 64-bit Windows.

Background

Once upon a time, I needed an installer for my .NET applications. I knew that I could use the "genius" ClickOnce installer, but in my opinion it has a bad interface and is not very handy. Then I came across a script for InnoSetup that had everything I wanted, but unfortunately it was only for .NET 1.1. So, I spent a few hours (became more over time) in InnoSetup and modified it to my needs.

Details

The source code is written modular. The folder structure looks like this:

Screenshot - dotnetfx_content.jpg

  • setup.iss - contains the basic setup where you include the modules (products) you need. They need to be included at the top like #include "scripts\products\dotnetfx11.iss" and then you only have to call their main function inside the [Code] part like dotnetfx11();
  • bin - contains the final output of the installer
  • src - contains the application files of your program
  • scripts
    • products.iss - contains the shared code for the product scripts. You only have to change the [CustomMessages] part and [Files] part (inclusion of isxdl language files)
    • isxdl - contains the downloader DLL for the setup (if there is something to download) and its language files (e.g. german.ini). This is the place where you can put your language files for the isxdl downloader in.
    • products - contains the scripts for products which are required by the application (e.g. .NET Framework 2.0)
      • dotnetfx11.iss - .NET Framework 1.1
      • dotnetfx11lp.iss - .NET Framework 1.1 Language Pack
      • dotnetfx11sp1.iss - .NET Framework 1.1 + Service Pack 1
      • dotnetfx20.iss - .NET Framework 2.0
      • dotnetfx20lp.iss - .NET Framework 2.0 Language Pack
      • dotnetfx20sp1.iss - .NET Framework 2.0 + Service Pack 1
      • dotnetfx20sp1lp.iss - .NET Framework 2.0 Service Pack 1 Language Pack
      • dotnetfx20sp2.iss - .NET Framework 2.0 + Service Pack 2
      • dotnetfx20sp2lp.iss - .NET Framework 2.0 Service Pack 2 Language Pack
      • dotnetfx35.iss - .NET Framework 3.5
      • dotnetfx35lp.iss - .NET Framework 3.5 Language Pack
      • dotnetfx35sp1.iss - .NET Framework 3.5 + Service Pack 1
      • dotnetfx35sp1lp.iss - .NET Framework 3.5 Service Pack 1 Language Pack
      • dotnetfx40client.iss - .NET Framework 4.0 Client Profile
      • dotnetfx40full.iss - .NET Framework 4.0 Full
      • ie6.iss - Internet Explorer 6
      • iis.iss - Internet Information Services (just a check if it is installed)
      • jet4sp8.iss - Jet 4 + Service Pack 8
      • kb835732.iss - Security Update (KB835732) which is required by .NET Framework 2.0 Service Pack 1 on Windows 2000 Service Pack 4
      • mdac28.iss - Microsoft Data Access Components (MDAC) 2.8
      • msi20.iss - Windows Installer 2.0
      • msi31.iss - Windows Installer 3.1
      • msi45.iss - Windows Installer 4.5
      • sql2005express.iss - SQL Server 2005 Express + Service Pack 3
      • sql2008express.iss - SQL Server 2008 Express R2
      • sqlcompact35sp2.iss - SQL Server Compact 3.5 + Service Pack 2
      • vcredist2010.iss - Visual C++ 2010 Redistributable
      • wic.iss - Windows Imaging Component
      • winversion.iss - helper functions to determine the installed Windows version including service packs
      • fileversion.iss - helper functions to determine the version of a file
      • stringversion.iss - helper functions to correctly parse a version string
      • dotnetfxversion.iss - helper functions to determine the installed .NET Framework version including service packs

Mostly you may have to tweak the setup.iss because of different Windows version / service pack version check depending on the version of .NET Framework you need.

If a dependency (product) is not installed, the script checks if the product's setup exists inside the dependencies directory which is configurable in products.iss. By default it is: .\MyProgramDependencies. If they don't exist there, it tries to download them (except for Windows Service Packs). This means a support for offline installing via CD or DVD is also possible. In the recent versions, there was also support for 32-bit (x86) and 64-bit (x64) OS including Itanium (ia64) added.

Screenshot - dotnetfx_installer2.jpg

Screenshot - dotnetfx_installer4.jpg

The installation routine of the dependencies is automatic, and they run in quiet or semi quiet mode. Therefore no user interaction is needed, except for Internet Explorer 6. This setup script uses [CostumMessages] so that you can easily add multi-language support to your setup and are easily able to configure settings (like the dependencies directory) without looking at the [Code] part.

Applications used for the script are:

  • Inno Setup - setup engine (version 5.4.2)
  • ISTool - extends Inno Setup but I just needed the isxdl.dll downloader (version 5.3.0)

Known Problems

If dependencies are needed, the required free hard drive size is incorrect.

Points of Interest

Special thanks go to Ted Ehrich who created the .NET Framework 1.1 script. Well, I am sure that this script will serve me in the future very well and I hope you may like it too.

History

  • 14 Oct, 2007
    • Initial version
  • 19 Oct, 2007
    • Minor update to code
  • 27 Oct, 2007
    • Minor update to code
  • 25 Jan, 2008
    • Minor update to code
  • 15 Aug, 2008
    • Now uses dotnetchk.exe to determine which version of .NET Framework and its language pack is installed
    • Added .NET Framework language pack(s) to script
    • Added translation for download page
    • Separated script code into multiple files to make it easier to update the script for different versions of the .NET Framework
  • 1 Jan, 2009
    • Wrote source code modular (each dependency now has one file)
    • Added code for Windows security updates, .NET Framework 1.1, 2.0sp1, 3.5, 3.5sp1 and their language packs
    • No more dotnetchk.exe
  • 1 Sep, 2009
    • Code for dependencies installation routine was completely rewritten and is now executed before the actual installation of the application. Setup also checks if all dependencies are installed successfully and if not, displays an error page
    • Added support for 32-bit (x86) and 64-bit (x64) OS including Itanium (ia64)
    • Added code for .NET Framework 2.0 SP2 and its language pack
    • Fixed windows version check bug and language pack check bug
  • 23 Sep, 2011
    • Added support for .NET Framework 4.0, Windows Installer 4.5, Visual C++ 2010 Redistributable, SQL 2008 Express and SQL 3.5 Compact Edition (community)
    • Added helper functions to determine the installed .NET Framework version which removed redundant code
    • Added version strings parser to fix wrong detection for version numbers above 9
    • Added delayed and forced mid-install restart support
    • Added usage of #define in setup.iss (community)
    • Added unicode version of Inno Setup as default for better multilanguage support
    • Fixed restart on 3010 resultcode from installers
    • Fixed missing check in Windows 2000 Security Update (KB835732)
    • Added support for offline files on x64 and IA64 OS

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

About the Author

stfx
Austria Austria
Member
No Biography provided

Sign Up to vote   Poor Excellent
Add a reason or comment to your vote: x
Votes of 3 or less require a comment

Comments and Discussions

 
You must Sign In to use this message board.
Search this forum  
    Spacing  Noise  Layout  Per page   
QuestionGoogle Chrome Installation Checkmemberkalpesh28041 Jan '13 - 19:14 
How can i Check chrome is installed or not.
 
if not i want to download and install.
QuestionJava Installation Checkmemberkalpesh28041 Jan '13 - 19:04 
I want to Install Java if not installed.
GeneralMy Vote Of 5+memberZac Greve18 Dec '12 - 17:19 
This is an awesome system. I know I will use this quite a bit.
 
If I could give a 10 I would!

Bob Dole
The internet is a great way to get on the net.

D'Oh! | :doh: 2.0.82.7292 SP6a

Question.net Framework 4.5memberairscape18 Dec '12 - 13:00 
Here are the changes to detect 4.5
 

dotnetfxversion.iss
 
[Code]
type
	NetFXType = (NetFx10, NetFx11, NetFx20, NetFx30, NetFx35, NetFx40Client, NetFx40Full, NetFx45Full);
 
const
	netfx11plus_reg = 'Software\Microsoft\NET Framework Setup\NDP\';
 
function netfxinstalled(version: NetFXType; lcid: string): boolean;
var
	regVersion: cardinal;
	regVersionString: string;
begin
	if (lcid <> '') then
		lcid := '\' + lcid;
 
	if (version = NetFx10) then begin
		RegQueryStringValue(HKLM, 'Software\Microsoft\.NETFramework\Policy\v1.0\3705', 'Install', regVersionString);
		Result := regVersionString <> '';
	end else begin
		case version of
			NetFx11:
				RegQueryDWordValue(HKLM, netfx11plus_reg + 'v1.1.4322' + lcid, 'Install', regVersion);
			NetFx20:
				RegQueryDWordValue(HKLM, netfx11plus_reg + 'v2.0.50727' + lcid, 'Install', regVersion);
			NetFx30:
				RegQueryDWordValue(HKLM, netfx11plus_reg + 'v3.0\Setup' + lcid, 'InstallSuccess', regVersion);
			NetFx35:
				RegQueryDWordValue(HKLM, netfx11plus_reg + 'v3.5' + lcid, 'Install', regVersion);
			NetFx40Client:
				RegQueryDWordValue(HKLM, netfx11plus_reg + 'v4\Client' + lcid, 'Install', regVersion);
			NetFx40Full:
				RegQueryDWordValue(HKLM, netfx11plus_reg + 'v4\Full' + lcid, 'Install', regVersion);
			NetFx45Full:
				RegQueryDWordValue(HKLM, netfx11plus_reg + 'v4\Full', 'Release', regVersion);
		end;
		Result := (regVersion <> 0);
	end;
end;
 
function netfxspversion(version: NetFXType; lcid: string): integer;
var
	regVersion: cardinal;
begin
	if (lcid <> '') then
		lcid := '\' + lcid;
 
	case version of
		NetFx10:
			//not supported
			regVersion := -1;
		NetFx11:
			if (not RegQueryDWordValue(HKLM, netfx11plus_reg + 'v1.1.4322' + lcid, 'SP', regVersion)) then
				regVersion := -1;
		NetFx20:
			if (not RegQueryDWordValue(HKLM, netfx11plus_reg + 'v2.0.50727' + lcid, 'SP', regVersion)) then
				regVersion := -1;
		NetFx30:
			if (not RegQueryDWordValue(HKLM, netfx11plus_reg + 'v3.0' + lcid, 'SP', regVersion)) then
				regVersion := -1;
		NetFx35:
			if (not RegQueryDWordValue(HKLM, netfx11plus_reg + 'v3.5' + lcid, 'SP', regVersion)) then
				regVersion := -1;
		NetFx40Client:
			if (not RegQueryDWordValue(HKLM, netfx11plus_reg + 'v4\Client' + lcid, 'Servicing', regVersion)) then
				regVersion := -1;
		NetFx40Full:
			if (not RegQueryDWordValue(HKLM, netfx11plus_reg + 'v4\Full' + lcid, 'Servicing', regVersion)) then
				regVersion := -1;
		NetFx45Full:
			if (not RegQueryDWordValue(HKLM, netfx11plus_reg + 'v4\Full' + lcid, 'Servicing', regVersion)) then
				regVersion := -1;
	end;
	Result := regVersion;
end;
 
dotnetfx45full.iss
 

// requires Windows Vista SP2 (x86 and x64), Windows 7 SP1 (x86 and x64), Windows Server 2008 R2 SP1 (x64), Windows Server 2008 SP2 (x86 and x64)
// requires Windows Installer 3.1
// requires Internet Explorer 5.01
// WARNING: express setup (downloads and installs the components depending on your OS) if you want to deploy it on cd or network download the full bootsrapper on website below
// http://www.microsoft.com/downloads/en/details.aspx?FamilyID=9cfb2d51-5ff4-4491-b0e5-b386f32c0992
 
[CustomMessages]
dotnetfx45full_title=.NET Framework 4.5 Full
 
dotnetfx45full_size=3 MB - 197 MB
 
;http://www.microsoft.com/globaldev/reference/lcid-all.mspx
en.dotnetfx45full_lcid=''
de.dotnetfx45full_lcid='/lcid 1031 '
 

[Code]
const
	dotnetfx45full_url = 'http://download.microsoft.com/download/B/A/4/BA4A7E71-2906-4B2D-A0E1-80CF16844F5F/dotNetFx45_Full_setup.exe';
 
procedure dotnetfx45full();
begin
	if (not netfxinstalled(NetFx45Full, '')) then
		AddProduct('dotNetFx45_Full_setup.exe',
			CustomMessage('dotnetfx45full_lcid') + '/q /passive /norestart',
			CustomMessage('dotnetfx45full_title'),
			CustomMessage('dotnetfx45full_size'),
			dotnetfx45full_url,
			false, false);
end;

SuggestionRe: .net Framework 4.5memberMember 967595128 Jan '13 - 0:01 
You also need to add the following lines to your setup.iss file:
 
#define use_dotnetfx45full
in the head
 
#ifdef use_dotnetfx45full
#include "scripts\products\dotnetfx45full.iss"
#endif
below the block starting with #ifdef use_dotnetfx40
 
and finally
#ifdef use_dotnetfx45full
   dotnetfx45full();
#endif
before the section #ifdef use_wic
GeneralMy vote 5memberDato001119 Nov '12 - 2:54 
Thank you very much for this excellent piece of work. Saved lot's of hours if not days.
QuestionKB835732 doesn't work in Windows 2000 setupmemberVinny Lawlor12 Nov '12 - 6:15 
You need to replace the following parameters (to "/passive /norestart") in the procedure below in kb835732.iss script - the installer switches were incorrect:
 
procedure kb835732();
begin
    if (exactwinversion(5, 0) and (minwinspversion(5, 0, 2) and maxwinspversion(5, 0, 4))) then begin
        if (not RegKeyExists(HKLM, 'SOFTWARE\Microsoft\Updates\Windows 2000\SP5\KB835732\Filelist')) then
            AddProduct('kb835732.exe',
                '/passive /norestart',
                CustomMessage('kb835732_title'),
                CustomMessage('kb835732_size'),
                kb835732_url,
                false, false);
    end;
end;

QuestionDirectX InstallationmemberTheRacerMaster26 Oct '12 - 17:47 
Is it possible for a DirectX version of this script? I am making an installer for a game, and need to install DirectX as a dependency.
Thanks!
AnswerRe: DirectX Installationmemberdaveaton9 Mar '13 - 16:40 
I was having the same issue.. there was nobody who had a working model that I could see.. so I just wrote my own...
 
http://stackoverflow.com/questions/15317563/inno-setup-trying-to-create-a-new-install-directx-template-product-for-modular-i
 
Please let me know if it helped you.
 
Thanks,
David Eaton
GeneralRe: DirectX Installationmemberstfx9 Mar '13 - 23:28 
Any reason why you did not use compareversion function of stringversion.iss file (need to be included in setup.iss)? Also MinVersion should be a parameter to allow having a different minimum required directX version
procedure directX(MinVersion: string);
begin
    if (compareversion(version, MinVersion) < 0) then

GeneralRe: DirectX Installationmemberdaveaton10 Mar '13 - 7:36 
Not really, that could explain alot.
 
I was using code based from this.. http://www.vincenzo.net/isxkb/index.php?title=DirectX_-_How_to_detect_DirectX_version[^]
 
I kept getting a conflict, so I renamed i to CompareDirectXVersion
 
Smile | :)
 
Does it work better with the min code.. if so post it.. I love making it better.
 
-David Eaton
Questiondependency file not added to output setup.exememberMember 80634354 Oct '12 - 13:23 
great tool btw. it is working fine other than i only require .net 4 framework client, so i disabled all others in setup.iss except
 
#define use_dotnetfx40
 
i then placed dotNetFx40_Client_setup.exe in the following folder
 
bin\MyProgramDependencies
 
but when i compile the setup.exe it is still only 5 mb in size which is all my app files it is not including the 40mb dotNetFx40_Client_setup.exe within the setup.exe??
AnswerRe: dependency file not added to output setup.exememberMember 80634355 Oct '12 - 1:38 
i even took you initial example program and just used it and did the same thing with the same results? i even copied the
 
MyProgram-4.0.exe
MyProgramDependencies
 
with the dotNetFx40_Client_setup.exe in the MyProgramDependencies folder, to the host witout .net client 4.0 and still it wanted to go download .net 4 client from msft??
AnswerRe: dependency file not added to output setup.exememberstfx5 Oct '12 - 22:26 
You got that a bit wrong - all it does is check if the dependencies exist in a subdirectory (MyProgramDependencies in this case) when the setup is run. This is useful for distribution over CDs/DvDs.
 
It does not mean that it will be included in your setup.exe. This could be changed however, and would actually make sense, but you need to check the Inno Setup docs to see exactly how.
AnswerRe: dependency file not added to output setup.exememberMember 905500031 Oct '12 - 4:37 
Make sure that you added the executable in the [Files] section if you want it included in your setup.exe
 
Also, I really need to install the dependencies offline. For my software, I only need dotNetFx40_Full_setup.exe. I placed the executable in bin/MyProgramDependencies, but it still just tries to download from the site regardless.
 
Is there something I'm missing?
GeneralMy vote of fivememberMichael Estwik12 Aug '12 - 11:53 
There is no word to say how thankful I am for this article.
 
I've been waiting for a software company for over one year to release a new version of their installer software (which I will be able to upgrade for free) and during this time I've been waiting for be able to realease my own software.
 
Now, thanks to you, I don't have to wait any longer. My software is complete and I can finally publish it. Thank you man, you are the best!Thumbs Up | :thumbsup:
SuggestionMS Compact Database Version 4.0 [modified]memberFreddyvdh12 Jul '12 - 3:44 
Hi,
 
I needed the compact database version 4.0 for my project. Here my code for use:
 
[CustomMessages]
sqlcompact40_title=SQL Server Compact 4.0
sqlcompact40_titlex64=SQL Server Compact 4.0 x64
 
en.sqlcompact40_size=2.5 MB
de.sqlcompact40_size=2.5 MB
en.sqlcompact40_sizex64=2.3 MB
de.sqlcompact40_sizex64=2.3 MB
 

[Code]
const
sqlcompact40_url = 'http://download.microsoft.com/download/0/5/D/05DCCDB5-57E0-4314-A016-874F228A8FAD/SSCERuntime_x86-ENU.exe';
sqlcompact40_urlx64 = 'http://download.microsoft.com/download/0/5/D/05DCCDB5-57E0-4314-A016-874F228A8FAD/SSCERuntime_x64-ENU.exe';
 
procedure sqlcompact40();
begin
 if (not IsWin64 and not RegKeyExists(HKLM, 'SOFTWARE\Microsoft\Microsoft SQL Server Compact Edition\v4.0\ENU')) then 
  begin
    AddProduct('SSCERuntime_x86-ENU.exe', ' /i /passive /norestart',
      CustomMessage('sqlcompact40_title'),
      CustomMessage('sqlcompact40_size'),
      sqlcompact40_url,
      false, false);
  end else if (IsWin64 and (not RegKeyExists(HKLM, 'SOFTWARE\Microsoft\Microsoft SQL Server Compact Edition\v4.0\ENU') and not RegKeyExists(HKLM, 'Wow6432Node\SOFTWARE\Microsoft\Microsoft SQL Server Compact Edition\v4.0\ENU'))) then 
  begin
    AddProduct('SSCERuntime_x64-ENU.exe', ' /i /passive /norestart',
      CustomMessage('sqlcompact40_titlex64'),
      CustomMessage('sqlcompact40_sizex64'),
      sqlcompact40_urlx64,
      false, false);
  end;
end;


modified 12 Jul '12 - 10:39.

QuestionDetecting/Installing VC++ 2010 RuntimememberMember 865677420 Jun '12 - 8:41 
patch for vcredist2010.iss - the two issues fixed are a) detection on x64/ia64 (note the second version check) and b) checking for "Installed" instead of "Install" entry:
 
procedure vcredist2010();
var
	version:  cardinal;
	version2: cardinal;
begin
	RegQueryDWordValue(HKLM, 'SOFTWARE\Microsoft\VisualStudio\10.0\VC\VCRedist\' + GetString('x86', 'x64', 'ia64'), 'Installed', version);
	RegQueryDWordValue(HKLM, 'SOFTWARE\Wow6432Node\Microsoft\VisualStudio\10.0\VC\VCRedist\' + GetString('x86', 'x64', 'ia64'), 'Installed', version2);
 
	if ((version <> 1) and (version2 <> 1)) then
		AddProduct('vcredist2010' + GetArchitectureString() + '.exe',
			CustomMessage('vcredist2010_lcid') + '/passive /norestart',
			CustomMessage('vcredist2010_title'),
			CustomMessage('vcredist2010_size' + GetArchitectureString()),
			GetString(vcredist2010_url, vcredist2010_url_x64, vcredist2010_url_ia64),
	
false, false);
end;
AnswerRe: Detecting/Installing VC++ 2010 RuntimememberMember 865677420 Jun '12 - 8:43 
BTW, I don't know if that affects all installations on x64/ia64 systems - or only such where at least once a x86 version of the runtime had been installed prior installation of the x64/ia64 version. At least on my system, the first node didn't have any entry - and the second node had one for x86+x64.
QuestionDanish translation for youmemberMember 80309463 Jun '12 - 9:32 
Hey stfx.
 
Amazing work!
 
Wanted to let you know I've added my own danish translation that I use for my projects. Message me privately if you wanna use it.
 
Best regards,
myl
QuestionAn error occured while installing...- messagememberelmi0111 May '12 - 10:55 
Hello,
i get the message "An error occured while installing..."
Maybe you have to answer this often, but i have no solution for my Inno Setup setup.
 
I use win7 and want to add the jet4 software to my program
How can i solve it?
QuestionHow to put a restart?memberandrescasta14 Apr '12 - 11:52 
Hi, great solution! I'm trying it but I need to restart my system before installing SQL Server 2008(one of my dependencies).
 
I read you add some feature about restarting the system. Could you tell me how to achieve this?
 
Thank's in advance.
 
Andres
Questionsql compact fails installmemberred2ltd5 Mar '12 - 9:55 
Hi -
 
When I try to have the SQLCompact3.5sp2 installed on a vista machine (and any other machine for that matter), I get a error message;
"
This installation could not be opened. Contact the application vendor to verify that this a valid Windows installer package.
"
 
I've done some reasearch and it looks like it's because the original script points to an MSI and the download now points to an EXE which extracts x86 and x86 MSI's... so which then don't run automatically.
 
I'm a bit stuck... anyone got over this problem before?
 
Thanks for any help.
QuestionRe: sql compact fails installmemberbastek7929 Mar '12 - 2:09 
Hi,
I have the same problem on WindowsXP.
Thanks for any help.
AnswerRe: sql compact fails installmemberstfx11 Apr '12 - 11:43 
Try changing
AddProduct('sqlcompact35sp2.msi',
to
AddProduct('sqlcompact35sp2.exe',
in sqlcompact35sp2.iss

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Permalink | Advertise | Privacy | Mobile
Web03 | 2.6.130523.1 | Last Updated 23 Sep 2011
Article Copyright 2007 by stfx
Everything else Copyright © CodeProject, 1999-2013
Terms of Use
Layout: fixed | fluid