Differences

This shows you the differences between two versions of the page.

--- systems:innosetup_installer [2011/04/04 13:06]
smayr
+++ systems:innosetup_installer [2020/08/26 12:06] (current)
ajdavis
@@ Line 1: / Line 1: @@
-== InnoSetup Installer ==
+= InnoSetup Installer =
-=== Detected .NET Framework ===
+== Detected .NET Framework ==
 Source: [[http://www.blackhillsoftware.com/blog/2006/06/26/using-innosetup-with-the-dotnet-framework|Using InnoSetup with the DotNet Framework]] ([[http://www.timesprite.com/BlogEntries/dotnet.iss|script]])
-Using Inno Setup with the .NET Framework
+** Using Inno Setup with the .NET Framework **
 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.
@@ Line 13: / Line 13: @@
 The script uses some of the third party add-ons to Innosetup, I think the QuickStart Pack includes what you need.
-Requirements
+** Requirements **
 Having the .NET Framework as a dependency makes the installation requirements somewhat complex.
-    You need to detect whether the framework is already installed.
+  * You need to detect whether the framework is already installed.
-    The Framework needs to be installed by an administrator, but applications normally do not.
+  * 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 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.
+  * 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 installation of the product should not go ahead if the .NET Framework installation fails or is cancelled.
-The Script
+** The Script **
 The script that I ended up with performs the following processing:
-    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.
+  * 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.
-    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.
+  * 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.
-    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.
+  * 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.
-    Installs the .NET Framework if required.
+  * Installs the .NET Framework if required.
-    If the .NET Framework installation was successful or it was already installed, installs the application.
+  * 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.
@@ Line 38: / Line 39: @@
 Notes:
-    The script is based on .NET Framework 1.1 but changes for other versions should be simple.
+  * 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.
+  * 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.
+  * 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…).
+  * 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).
+  * 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.
+  * 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
@@ Line 50: / Line 51: @@
 These are the registry entries I used:
+<code>
 [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: 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
+Root: HKCU; Subkey: "Software\Classes\applications\MyApp.exe\shell\open\command";
+    ValueType: string; ValueData: """{app}\MyApp.exe"" ""%1"""; Flags: uninsdeletekey
+</code>
 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
+** 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.
-Script:
+** Script: **
 <code inno>
 [_ISTool]
@@ Line 106: / Line 109: @@
 function isxdl_SetOption(Option, Value: PChar): Integer;
 external 'isxdl_SetOption@files:isxdl.dll stdcall';
 const
@@ Line 114: / Line 116: @@
 function InitializeSetup(): Boolean;
 begin
   Result := true;
@@ Line 157: / Line 158: @@
       isxdl_SetOption('label', 'Downloading Microsoft .NET Framework');
-      isxdl_SetOption('description', 'MyApp needs to install the Microsoft .NET Framework. Please wait while Setup is downloading extra files to your computer.');
+      isxdl_SetOption('description', 'MyApp needs to install the Microsoft .NET Framework. '+
+           'Please wait while Setup is downloading extra files to your computer.');
       if isxdl_DownloadFiles(hWnd) = 0 then Result := false;
     end;
@@ Line 174: / Line 176: @@
 end;
-function UpdateReadyMemo(Space, NewLine, MemoUserInfoInfo, MemoDirInfo, MemoTypeInfo, MemoComponentsInfo, MemoGroupInfo, MemoTasksInfo: String): String;
+function UpdateReadyMemo(Space, NewLine, MemoUserInfoInfo, MemoDirInfo, MemoTypeInfo,
+    MemoComponentsInfo, MemoGroupInfo, MemoTasksInfo: String): String;
 var
   s: string;
 begin
-  if memoDependenciesNeeded <> '' then s := s + 'Dependencies to install:' + NewLine + memoDependenciesNeeded + NewLine;
+  if memoDependenciesNeeded <> '' then begin
+    s := s + 'Dependencies to install:' + NewLine + memoDependenciesNeeded + NewLine;
+  end;
   s := s + MemoDirInfo + NewLine + NewLine;
@@ Line 186: / Line 191: @@
 </code>
-=== Tips ===
+== Detecting .NET 4.0 Framework & Installing It If Missing ==
-==== Restart Computer ====
-When an installer, after its installation, asks to restart the computer, you can avoid doing so by deleting (or renaming) the following Windows registry value:
+=== Method 1 ===
+Source: http://www.vbforums.com/showthread.php?t=620221
+<code inno>
+[CustomMessages]
+dotnetmissing=This application requires Microsoft Framework 4.0 which is not yet installed on this computer. Would you like to download it now?
+. . .
+[Code]
+function InitializeSetup(): Boolean;
+var
+  ErrorCode: Integer;
+  netFrameWorkInstalled : Boolean;
+  isInstalled: Cardinal;
+begin
+  result := true;
+  // Check for the .Net 4.0 framework
+  isInstalled := 0;
+  netFrameworkInstalled := RegQueryDWordValue(HKLM, 'SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\client', 'Install', isInstalled);
+  if ((netFrameworkInstalled) and (isInstalled <> 1)) then begin
+    netFrameworkInstalled := false;
+  end;
+  if netFrameworkInstalled = false then begin
+    if (MsgBox(ExpandConstant('{cm:dotnetmissing}'), mbConfirmation, MB_YESNO) = idYes) then
+    begin
+      ShellExec('open',
+         'http://www.microsoft.com/downloads/details.aspx?familyid=9CFB2D51-5FF4-4491-B0E5-B386F32C0992&displaylang=en',
+         '','',SW_SHOWNORMAL,ewNoWait,ErrorCode);
+    end;
+    result := false;
+  end;
+end;
+</code>
+=== Method 2 ===
+Source: http://www.vbforums.com/showthread.php?t=620221
+This code checks, downloads and installs it if needed. Verify the file ''isxdl.dll'' (InnoSetup third-party tool) is also deployed.
+<code inno>
+[CustomMessages]
+dotnetfx40_title=.NET Framework 4.0
+dotnetfx40_size=48.1 MB
+. . .
+[Code]
+const
+  dotnetfx40_url = 'http://download.microsoft.com/download/9/5/A/95A9616B-7A37-4AF6-BC36-D6EA96C8DAAE/dotNetFx40_Full_x86_x64.exe';
+procedure dotnetfx40();
+var
+  version: cardinal;
+begin
+  RegQueryDWordValue(HKLM, 'Software\Microsoft\NET Framework Setup\NDP\v4\Full', 'Install', version);
+  if version <> 1 then begin
+    AddProduct('dotNetFx40_Full_x86_x64.exe',
+      '/q /norestart',
+      CustomMessage('dotnetfx40_title'),
+      CustomMessage('dotnetfx40_size'),
+      dotnetfx40_url);
+  end;
+end;
+</code>
+== Installer Tips ==
+=== Restart Computer ===
+When an installer, after its installation, asks to restart the computer, you can avoid doing so removing the pertinent pending operations from the following Windows registry value:
 <code>HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\PendingFileRenameOperations</code>
-==== Blue Screen of Death ====
+=== Blue Screen of Death ===
 Issue: A "Blue Screen of Death" shows up when trying to start the installer.
 > He starts the setup and a a random point it gets killed (not an normal stop)....
@@ Line 202: / Line 278: @@
 ------------------------------------------------------------------
-===== How To Do A Clean Boot Using the System Configuration Utility =====
+==== How To Do A Clean Boot Using the System Configuration Utility ====
-. Click "Start", click "Run", type "msconfig" (without the quotation marks), and then click "OK".
+ # Click "Start", click "Run", type "msconfig" (without the quotation marks), and then click "OK".
-. In "System Configuration Utility", click the "Services" tab, and then click to select the "Hide all Microsoft Services" check box.
+ # In "System Configuration Utility", click the "Services" tab, and then click to select the "Hide all Microsoft Services" check box.
-. Click "Disable All"
+ # Click "Disable All"
-. Click "Startup" tab.
+ # Click "Startup" tab.
-. Click "Disable All"
+ # Click "Disable All"
-. Click "Apply" then "Close"
+ # Click "Apply" then "Close"
-. Restart computer
+ # Restart computer
-. Insert the <product> CD and install the program.
+ # Insert the <product> CD and install the program.
 When the installation is complete you must restore your computer from a clean boot.
-. Click "Start", click "Run", type "msconfig" (without the quotation marks), and then click "OK".
+ # Click "Start", click "Run", type "msconfig" (without the quotation marks), and then click "OK". Note: you can choose to do the following steps or just click "Normal Startup" on the General tab.
-Note: you can choose to do the following steps or just click "Normal Startup" on the General tab.
+ # In "System Configuration Utility", click the "Services" tab, and then click "Enable All"
-. In "System Configuration Utility", click the "Services" tab, and then click "Enable All"
+ # Click "Startup" tab.
-. Click "Startup" tab.
+ # Click "Enable" All
-. Click "Enable" All
+ # Click "Apply" then Close
-. Click "Apply" then Close
+ # Restart computer
-. Restart computer
 ------------------------------------------------------------------
@@ Line 229: / Line 304: @@
 > With a customer we run in to the following problem.
 >
-> He starts the setup and a a random point it gets killed (not an normal
+> He starts the setup and at a random point it gets killed (not an normal
 > stop)....
 >
-> Weh I use the /LOG option the log also just stops at a point en no
+> When I use the /LOG option, the log also just stops at a point and no
-> closing/stop info of inno setup is loggen. Also the temporary created
+> closing/stop info of inno setup is logged. Also the temporary created
-> folders are still there. This suggest that (probebly some other process -
+> folders are still there. This suggest that (probably some other process -
 > aka virusscanner) is killing the installer process...
+== Plugin: File Downloader IDP ==
+  * Download: [[https://mitrichsoftware.wordpress.com/inno-setup-tools/inno-download-plugin/]]
+  * Uses: FTP, HTTP and HTTPS protocols
+Example:
+<code inno>
+#include <idp.iss>
+[Files]
+Source: "{tmp}\file1.xyz"; DestDir: "{app}"; Flags: external; ExternalSize: 1048576
+Source: "{tmp}\file2.xyz"; DestDir: "{app}"; Flags: external; ExternalSize: 1048576
+Source: "{tmp}\file3.xyz"; DestDir: "{app}"; Flags: external; ExternalSize: 1048576
+[Icons]
+Name: "{group}\{cm:UninstallProgram,My Program}"; Filename: "{uninstallexe}"
+[Code]
+procedure InitializeWizard();
+begin
+    idpAddFileSize('http://127.0.0.1/file1.xyz', ExpandConstant('{tmp}\file1.xyz'), 1048576);
+    idpAddFileSize('http://127.0.0.1/file2.xyz', ExpandConstant('{tmp}\file2.xyz'), 1048576);
+    idpAddFileSize('http://127.0.0.1/file3.xyz', ExpandConstant('{tmp}\file3.xyz'), 1048576);
+    idpDownloadAfter(wpReady);
+end.
+</code>