{"id":146,"date":"2021-02-28T18:26:04","date_gmt":"2021-02-28T18:26:04","guid":{"rendered":"https:\/\/engy.us\/blog\/?p=146"},"modified":"2021-12-31T18:19:25","modified_gmt":"2021-12-31T18:19:25","slug":"installing-net-5-runtime-automatically-with-inno-setup","status":"publish","type":"post","link":"https:\/\/engy.us\/blog\/2021\/02\/28\/installing-net-5-runtime-automatically-with-inno-setup\/","title":{"rendered":"Installing .NET 5 Runtime Automatically with Inno Setup"},"content":{"rendered":"\n

In this guide I will walk through how to get the .NET 5 runtime to download and install on-the-fly in an Inno Setup installer.<\/p>\n\n\n\n

It works in 3 steps:<\/p>\n\n\n\n

  1. Detect if the desired .NET runtime is installed<\/li>
  2. Download the .NET Runtime bootstrap installer with Inno Download Plugin<\/li>
  3. Run the bootstrap installer in quiet mode, which will download and install the .NET Framework. This is better than downloading the full installer since it only downloads the files it needs for your platform.<\/li><\/ol>\n\n\n\n

    You can download the regular .NET Runtime or the .NET Desktop Runtime, which supports Windows desktop applications. If you install the Desktop Runtime you do not need to also install the normal .NET Runtime.<\/p>\n\n\n\n

    Here’s the full code I’m using, with the x64 .NET 5 Desktop Runtime:<\/p>\n\n\n\n

    #include <idp.iss>\n\n\/\/ Other parts of installer file go here\n\n[CustomMessages]\nIDP_DownloadFailed=Download of .NET 5 failed. .NET 5 Desktop runtime is required to run VidCoder.\nIDP_RetryCancel=Click 'Retry' to try downloading the files again, or click 'Cancel' to terminate setup.\nInstallingDotNetRuntime=Installing .NET 5 Desktop Runtime. This might take a few minutes...\nDotNetRuntimeFailedToLaunch=Failed to launch .NET Runtime Installer with error \"%1\". Please fix the error then run this installer again.\nDotNetRuntimeFailed1602=.NET Runtime installation was cancelled. This installation can continue, but be aware that this application may not run unless the .NET Runtime installation is completed successfully.\nDotNetRuntimeFailed1603=A fatal error occurred while installing the .NET Runtime. Please fix the error, then run the installer again.\nDotNetRuntimeFailed5100=Your computer does not meet the requirements of the .NET Runtime. Please consult the documentation.\nDotNetRuntimeFailedOther=The .NET Runtime installer exited with an unexpected status code \"%1\". Please review any other messages shown by the installer to determine whether the installation completed successfully, and abort this installation and fix the problem if it did not.\n\n[Code]\n\nvar\n  requiresRestart: boolean;\n\nfunction CompareVersion(V1, V2: string): Integer;\nvar\n  P, N1, N2: Integer;\nbegin\n  Result := 0;\n  while (Result = 0) and ((V1 <> '') or (V2 <> '')) do\n  begin\n    P := Pos('.', V1);\n    if P > 0 then\n    begin\n      N1 := StrToInt(Copy(V1, 1, P - 1));\n      Delete(V1, 1, P);\n    end\n      else\n    if V1 <> '' then\n    begin\n      N1 := StrToInt(V1);\n      V1 := '';\n    end\n      else\n    begin\n      N1 := 0;\n    end;\n    P := Pos('.', V2);\n    if P > 0 then\n    begin\n      N2 := StrToInt(Copy(V2, 1, P - 1));\n      Delete(V2, 1, P);\n    end\n      else\n    if V2 <> '' then\n    begin\n      N2 := StrToInt(V2);\n      V2 := '';\n    end\n      else\n    begin\n      N2 := 0;\n    end;\n    if N1 < N2 then Result := -1\n      else\n    if N1 > N2 then Result := 1;\n  end;\nend;\n\nfunction NetRuntimeIsMissing(): Boolean;\nvar\n  runtimes: TArrayOfString;\n  registryKey: string;\n  I: Integer;\n  meetsMinimumVersion: Boolean;\n  meetsMaximumVersion: Boolean;\n  minimumVersion: string;\n  maximumExclusiveVersion: string;\nbegin\n  Result := True;\n\n  minimumVersion := '5.0.0';\n  maximumExclusiveVersion := '5.1.0';\n  registryKey := 'SOFTWARE\\WOW6432Node\\dotnet\\Setup\\InstalledVersions\\x64\\sharedfx\\Microsoft.WindowsDesktop.App';\n  if RegGetValueNames(HKLM, registryKey, runtimes) then\n  begin\n    for I := 0 to GetArrayLength(runtimes)-1 do\n    begin\n      meetsMinimumVersion := not (CompareVersion(runtimes[I], minimumVersion) = -1);\n      meetsMaximumVersion := CompareVersion(runtimes[I], maximumExclusiveVersion) = -1;\n      if meetsMinimumVersion and meetsMaximumVersion then\n      begin\n        Log(Format('[.NET] Selecting %s', [runtimes[I]]));\n        Result := False;\n          Exit;\n      end;\n    end;\n  end;\nend;\n\nprocedure InitializeWizard;\nbegin\n  if NetRuntimeIsMissing() then\n  begin\n    idpAddFile('http:\/\/go.microsoft.com\/fwlink\/?linkid=2155258', ExpandConstant('{tmp}\\NetRuntimeInstaller.exe'));\n    idpDownloadAfter(wpReady);\n  end;\nend;\n\nfunction InstallDotNetRuntime(): String;\nvar\n  StatusText: string;\n  ResultCode: Integer;\nbegin\n  StatusText := WizardForm.StatusLabel.Caption;\n  WizardForm.StatusLabel.Caption := CustomMessage('InstallingDotNetRuntime');\n  WizardForm.ProgressGauge.Style := npbstMarquee;\n  try\n    if not Exec(ExpandConstant('{tmp}\\NetRuntimeInstaller.exe'), '\/passive \/norestart \/showrmui \/showfinalerror', '', SW_SHOW, ewWaitUntilTerminated, ResultCode) then\n    begin\n      Result := FmtMessage(CustomMessage('DotNetRuntimeFailedToLaunch'), [SysErrorMessage(resultCode)]);\n    end\n    else\n    begin\n      \/\/ See https:\/\/msdn.microsoft.com\/en-us\/library\/ee942965(v=vs.110).aspx#return_codes\n      case resultCode of\n        0: begin\n          \/\/ Successful\n        end;\n        1602 : begin\n          MsgBox(CustomMessage('DotNetRuntimeFailed1602'), mbInformation, MB_OK);\n        end;\n        1603: begin\n          Result := CustomMessage('DotNetRuntimeFailed1603');\n        end;\n        1641: begin\n          requiresRestart := True;\n        end;\n        3010: begin\n          requiresRestart := True;\n        end;\n        5100: begin\n          Result := CustomMessage('DotNetRuntimeFailed5100');\n        end;\n        else begin\n          MsgBox(FmtMessage(CustomMessage('DotNetRuntimeFailedOther'), [IntToStr(resultCode)]), mbError, MB_OK);\n        end;\n      end;\n    end;\n  finally\n    WizardForm.StatusLabel.Caption := StatusText;\n    WizardForm.ProgressGauge.Style := npbstNormal;\n    \n    DeleteFile(ExpandConstant('{tmp}\\NetRuntimeInstaller.exe'));\n  end;\nend;\n\nfunction PrepareToInstall(var NeedsRestart: Boolean): String;\nbegin\n  \/\/ 'NeedsRestart' only has an effect if we return a non-empty string, thus aborting the installation.\n  \/\/ If the installers indicate that they want a restart, this should be done at the end of installation.\n  \/\/ Therefore we set the global 'restartRequired' if a restart is needed, and return this from NeedRestart()\n\n  if NetRuntimeIsMissing() then\n  begin\n    Result := InstallDotNetRuntime();\n  end;\nend;\n\nfunction NeedRestart(): Boolean;\nbegin\n  Result := requiresRestart;\nend;<\/code><\/pre>\n\n\n\n
    Detecting if the desired .NET Runtime is installed<\/h2>\n\n\n\n
    Antoine Aflalo has found the registry key location<\/a> to check to see what versions of the .NET runtime are installed.<\/p>\n\n\n\n
    Check SOFTWARE\\dotnet\\Setup\\InstalledVersions\\x86\\sharedfx<\/code> on x86 or SOFTWARE\\WOW6432Node\\dotnet\\Setup\\InstalledVersions\\x64\\sharedfx<\/code> on x64. Use Microsoft.WindowsDesktop.App<\/code> for the Desktop Runtime and Microsoft.NETCore.App<\/code> for the regular runtime.<\/p>\n\n\n\n
    I am checking SOFTWARE\\WOW6432Node\\dotnet\\Setup\\InstalledVersions\\x64\\sharedfx\\Microsoft.WindowsDesktop.App<\/code> .<\/p>\n\n\n\n
    We are checking for a version installed >= 5.0.0 and < 5.1.0. Having .NET 6 installed would not run apps built for the .NET 5 Runtime.<\/p>\n\n\n\n
    Downloading the bootstrapper<\/h2>\n\n\n\n
    First you need to locate the correct download link for the installer. This will depend on if you want the x86 or x64 version, what version you’re installing, and whether you want the normal or Desktop runtime. The Inno Dependency Installer source code has a good listing of stable links<\/a>; I haven’t been able to find an official list yet.<\/p>\n\n\n\n
    You could also use the Inno Dependency Installer instead, though I like having slimmer installer code for just the framework I want to install, and I think checking the registry is more efficient than including another executable to run and check the version.<\/p>\n\n\n\n
    Now install Inno Download Plugin<\/a>. This will make the idpAddFile and idpDownloadAfter calls inside InitializeWizard work. Remember that you need #include <idp.iss><\/code> at the top of your file to bring this in.<\/p>\n\n\n\n
    You will also need to add a line to the end of C:\\Program Files (x86)\\Inno Setup 6\\ISPPBuiltins.iss<\/code> . The Inno Download Plugin installer tries to do it but hasn’t been updated in a while and is still trying to update Inno Setup 5.<\/p>\n\n\n\n
    #pragma include __INCLUDE__ + \";\" + \"C:\\Program Files (x86)\\Inno Download Plugin\"<\/code><\/pre>\n\n\n\n
    This “InitializeWizard” method is a special one that InnoSetup calls when first setting up its wizard pages. We call our helper function to detect if the framework is installed, then schedule a download step after the “Ready to install” page. We include our direct download link determined earlier, and save it in a temp folder, with a file name of “NetRuntimeInstaller.exe”. This name I picked arbitrarily; we just need to refer to it later when we’re installing and cleaning up.<\/p>\n\n\n\n
    Installing the bootstrapper<\/h2>\n\n\n\n
    Our code is activated on PrepareToInstall. When this function returns a string, that string is shown as an error message that stops the install from happening. We call into InstallDotNetRuntime and return its result.<\/p>\n\n\n\n
    Inside InstallDotNetRuntime we’re running the bootstrapper we downloaded earlier, with a flag to make the install passive (non interactive). The \/showrmui option prompts the user to close applications to avoid a system restart. \/showfinalerror tells the installer to show an error message if the install fails. <\/p>\n\n\n\n
    The .NET installer UI will show on top of the first window:<\/p>\n\n\n\n
    \"\"<\/figure>\n\n\n\n
    After running the installer, the bootstrapper is deleted (whether or not the install succeeded).<\/p>\n\n\n\n
    And now your installer is done!<\/p>\n\n\n\n
    Testing the installer<\/h2>\n\n\n\n
    I would recommend setting up a Windows 10 VM in Hyper-V to test it out. You can go to “Apps and Features” and sort by install date to uninstall your app and the .NET Runtime to repeat the testing.<\/p>\n\n\n\n
    Thanks to Antony Male<\/a> for suggesting updates to the error handling code.<\/p>\n","protected":false},"excerpt":{"rendered":"
    In this guide I will walk through how to get the .NET 5 runtime to download and install on-the-fly in an Inno Setup installer. It works in 3 steps: Detect if the desired .NET runtime is installed Download the .NET Runtime bootstrap installer with Inno Download Plugin Run the bootstrap installer in quiet mode, which … <\/p>\n
    Continue reading “Installing .NET 5 Runtime Automatically with Inno Setup”<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"spay_email":"","jetpack_publicize_message":"","jetpack_is_tweetstorm":false},"categories":[1],"tags":[],"jetpack_featured_media_url":"","jetpack_publicize_connections":[],"jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/pahBcK-2m","jetpack-related-posts":[{"id":51,"url":"https:\/\/engy.us\/blog\/2015\/07\/17\/installing-net-framework-4-5-automatically-with-inno-setup\/","url_meta":{"origin":146,"position":0},"title":"Installing .NET Framework 4.7 automatically with Inno Setup","date":"July 17, 2015","format":false,"excerpt":"In this guide I will walk through how to get the .NET framework to download and install on-the-fly in an Inno Setup installer. It works in 3 steps: Detect if the desired .NET framework is installed Download the .NET Framework bootstrap installer with Inno Download Plugin Run the bootstrap installer\u2026","rel":"","context":"In \".net framework 4.5 inno setup\"","img":{"alt_text":"","src":"https:\/\/i0.wp.com\/engy.us\/blog\/wp-content\/uploads\/2015\/07\/7028.InstallingFramework2-1.png?resize=350%2C200&ssl=1","width":350,"height":200},"classes":[]},{"id":25,"url":"https:\/\/engy.us\/blog\/2012\/04\/06\/datetime-and-datetimeoffset-in-net-good-practices-and-common-pitfalls\/","url_meta":{"origin":146,"position":1},"title":"DateTime and DateTimeOffset in .NET: Good practices and common pitfalls","date":"April 6, 2012","format":false,"excerpt":"It becomes necessary to deal with dates and times in most .NET programs. A lot of programs use DateTime but that structure is frought with potential issues when you start serializing, parsing, comparing\u00a0and displaying dates from\u00a0different time zones and cultures. In this post I will go over these issues and\u00a0the\u2026","rel":"","context":"In \".net\"","img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":174,"url":"https:\/\/engy.us\/blog\/2021\/12\/11\/aws-cognito-authentication-in-electron\/","url_meta":{"origin":146,"position":2},"title":"AWS Cognito Authentication in Electron","date":"December 11, 2021","format":false,"excerpt":"The AWS Cognito authentication service as of this writing does not officially support the Electron platform. But there is a Javascript SDK for Cognito, as part of AWS Amplify. Others have tried using it on Electron but have run into issues. I ran into several more than what are described\u2026","rel":"","context":"Similar post","img":{"alt_text":"","src":"https:\/\/i2.wp.com\/engy.us\/blog\/wp-content\/uploads\/2021\/12\/image.png?resize=350%2C200&ssl=1","width":350,"height":200},"classes":[]},{"id":165,"url":"https:\/\/engy.us\/blog\/2021\/10\/03\/efficient-svg-icons-in-web-components-with-webpack-and-svgo\/","url_meta":{"origin":146,"position":3},"title":"Efficient SVG icons in Web Components with Webpack and SVGO","date":"October 3, 2021","format":false,"excerpt":"So many ways to load them There are a lot of different ways to show an SVG on a webpage: , , ,