Skip to main content
.NETStandard2.0

InnoSetup Script Builder

Published
Nov 29, 2021
4y ago
Total Downloads
76.9K
76,861

Install

dotnet add package InnoSetup.ScriptBuilder --version 0.1.4-rc02
ProductVersions
.NET Standard
netstandard2.0

README

InnoSetup.ScriptBuilder

This package is intended to build Inno Setup script files (*.iss) using C# fluent API. You can find the official Inno Setup documentation on Inno Setup web site.

CI Release Latest

Examples

Create builder

To get the script looking like this

[Setup]
AppName="BimTools.Support"
AppVersion="1.2.5.1634640046"
DefaultDirName="{userappdata}\SupportTools"
PrivilegesRequired=lowest
OutputBaseFilename="Tools.Support_2021_1.2.5.1634640046"
SetupIconFile="ToolsIcon.ico"
UninstallDisplayIcon="ToolsIcon.ico"
DisableDirPage=yes

[Files]
Source: "bin\*"; DestDir: "{app}"; Flags: ignoreversion recursesubdirs; 
Source: "SupportTools.addin"; DestDir: "{userappdata}\Autodesk\Revit\Addins\2019"; 
Source: "bin\Fonts\GraphikLCG-Medium.ttf"; DestDir: "{autofonts}"; Flags: onlyifdestfileexists uninsneveruninstall; FontInstall: "Graphik LCG"; 
Source: "bin\Fonts\GraphikLCG-Regular.ttf"; DestDir: "{autofonts}"; Flags: onlyifdestfileexists uninsneveruninstall; FontInstall: "Graphik LCG";

inherit your builder class from IssBuilder base class

public class DemoBuilder : IssBuilder
{
    public DemoBuilder()
    {
        Setup.Create("BimTools.Support")
            .AppVersion("1.2.5.1634640046")
            .DefaultDirName(@"{userappdata}\SupportTools")
            .PrivilegesRequired(PrivilegesRequired.Lowest)
            .OutputBaseFilename("Tools.Support_2021_1.2.5.1634640046")
            .SetupIconFile("ToolsIcon.ico")
            .UninstallDisplayIcon("ToolsIcon.ico")
            .DisableDirPage(YesNo.Yes);
    
        Files.CreateEntry(source: @"bin\*", destDir: InnoConstants.App)
            .Flags(FileFlags.IgnoreVersion | FileFlags.RecurseSubdirs);
        Files.CreateEntry(source: "SupportTools.addin", destDir: @"{userappdata}\Autodesk\Revit\Addins\2019");
        Files.CreateEntry(source: @"bin\Fonts\GraphikLCG-Medium.ttf", destDir: @"{autofonts}")
            .FontInstall("Graphik LCG")
            .Flags(FileFlags.OnlyIfDestFileExists | FileFlags.UninsNeverUninstall);
        Files.CreateEntry(source: @"bin\Fonts\GraphikLCG-Regular.ttf", destDir: @"{autofonts}")
            .FontInstall("Graphik LCG")
            .Flags(FileFlags.OnlyIfDestFileExists | FileFlags.UninsNeverUninstall);
    }
}

or use BuilderUtils.CreateBuilder()

var builder = BuilderUtils.CreateBuilder(builder =>
{
    builder.Setup.Create("BimTools.Support")
        .AppVersion("1.2.5.1634640046")
        .DefaultDirName(@"{userappdata}\SupportTools")
        .PrivilegesRequired(PrivilegesRequired.Lowest)
        .OutputBaseFilename("Tools.Support_2021_1.2.5.1634640046")
        .SetupIconFile("ToolsIcon.ico")
        .UninstallDisplayIcon("ToolsIcon.ico")
        .DisableDirPage(YesNo.Yes);
        
    builder.Files.CreateEntry(source: @"bin\*", destDir: InnoConstants.App)
        .Flags(FileFlags.IgnoreVersion | FileFlags.RecurseSubdirs);
    builder.Files.CreateEntry(source: "SupportTools.addin", destDir: @"{userappdata}\Autodesk\Revit\Addins\2019");
    builder.Files.CreateEntry(source: @"bin\Fonts\GraphikLCG-Medium.ttf", destDir: @"{autofonts}")
        .FontInstall("Graphik LCG")
        .Flags(FileFlags.OnlyIfDestFileExists | FileFlags.UninsNeverUninstall);
    builder.Files.CreateEntry(source: @"bin\Fonts\GraphikLCG-Regular.ttf", destDir: @"{autofonts}")
        .FontInstall("Graphik LCG")
        .Flags(FileFlags.OnlyIfDestFileExists | FileFlags.UninsNeverUninstall);
);

Getting results

String result

var builder = new DemoBuilder();
var result = builder.ToString();

Script file

var builder = new DemoBuilder();
builder.Build("demo.iss");

// or

BuilderUtils.Build<DemoBuilder>("demo.iss");

// or

BuilderUtils.Build(
    builder =>
    {
        builder.Setup.Create("BimTools.Support")
            .AppVersion("1.2.5.1634640046")
            .DefaultDirName(@"{userappdata}\SupportTools");
        builder.Files.CreateEntry(@"bin\*", InnoConstants.App)
            .Flags(FileFlags.IgnoreVersion | FileFlags.RecurseSubdirs);
    }, 
    "demo.iss");

Not implemented sections and parameters

If the section you want to insert is not implemented you can use either Sections.CreateKeyValueSection() or Sections.CreateParameterSection() methods. To insert not implemented parameters/directives of any kind of section use Parameter() method.

// for key-value sections
Sections.CreateKeyValueSection("Messages")
    .CreateEntry()
    .Parameter("BeveledLabel", @"Inno Setup")
    .Parameter("HelpTextNote", @"/PORTABLE=1%nEnable portable mode.");
    
// for parameter sections
Sections.CreateParameterSection("Registry")
    .CreateEntry()
        .Parameter("Root", RegistryKeys.HKU)
        .Parameter("Subkey", @"Software\My Company\My Program")
        .Parameter("ValueName", "Name")
        .Parameter("ValueType", ValueTypes.String)
        .Parameter("ValueData", "Test app");

Changes from Previous Version

No structural changes between v0.1.4-rc01 and v0.1.4-rc02.

Adoption Assessment

Assess this package against its supported frameworks, license, maintenance signals and dependency graph before making it a project standard.

This version is marked prerelease. Validate its API and upgrade path before production use.No SPDX license expression is published. Review the license text and your organisation's policy before redistribution.Compatibility metadata lists 1 target framework; confirm the exact target used by your application.

Related Guides & Workflows

Learn how to evaluate, integrate, or audit this package in your .NET project.