Inno Setup Source Code

The UniPs component is a copy of the RemObjects Pascal Script repository, stripped of unused files and optimized for Inno Setup. When working with this component, be aware that many compiler directives found in the original source are either always true or always false due to Inno Setup's specific build environment (Delphi 10.4+ on Windows).

Key Environment Characteristics

• Compiler: Uses Delphi (not FPC).
• Platform: Windows only.
• Architecture: Supports both 32-bit (CPU32) and 64-bit (CPU64) builds.
• Unicode: Always enabled.
• Endianness: Always little-endian.

Build methods depend on whether you are using the Delphi Community Edition (which lacks command-line compilation support) or a full version of Delphi.

For Delphi Community Edition

To build all files in Release mode, run:

build-ce.bat

Note: Batch files cannot be used with the Community Edition; instead, open Projects\Projects.groupproj in the Delphi IDE.

For Full Delphi Versions

To build all files in Release mode, run:

build.bat

Specific Compilation Tasks

• 64-bit Inno Setup (Release mode): compile.bat x64
• 32-bit Inno Setup (Release mode): compile.bat x86
• Specific Project (e.g., ISCC): compile.bat x64 ISCC
• Help Files (64-bit): compile.bat x64 ISHelpGen and ISHelp\compile.bat

Note: Batch files are not compatible with the Community Edition; use Projects\Projects.groupproj for that version.

Debugging the Setup Project

1. Build the Debug64 build group.
2. Run the ISIDE project and compile the Debug.iss script (which should open automatically).
3. Open and run the Setup project. Note: Ensure the SetupArchitecture setting in the test script matches the target of the Setup project.

Debugging the SetupLdr Project

1. Build the Debug64 build group.
2. Compile the Debug.iss script with UseSetupLdr=yes (instead of no).
3. Open and run the SetupLdr project with a 32-bit or 64-bit target. Note: It will automatically use the /SELFFILENAME=Setup.exe parameter to load the Setup.exe you compiled via ISIDE.

If you intend to view or modify the forms for specific projects, you must install the required component units found in the [Components] directory using the Components.dpk file.

For the Setup project forms:

• BitmapButton
• BitmapImage
• FolderTreeView
• NewCheckListBox
• NewCtrls
• NewNotebookReg
• NewProgressBar
• NewStaticText
• PasswordEdit
• RichEditViewer

For the ISIDE project forms (additional):

• DropListBox
• NewGroupBox
• NewTabSet

If you are only editing code, you can skip this installation step.

To begin working with the Inno Setup source code, follow these steps:

1. Obtain sources: Clone the repository from GitHub.

   git clone https://github.com/jrsoftware/issrc.git issrc
   cd issrc

2. Install Embarcadero Delphi: The projects are compiled using Delphi 12.3 Athens with the May Patch. You can use the free Community Edition. After installing Delphi, you must install GetIt dependencies by running getit.bat and following the instructions.
3. Install Microsoft HTML Help Workshop: This is required only if you need to compile the help files.

To debug the uninstaller, follow these steps:

1. Run Setup.exe to completion using the /DETACHEDMSG command-line parameter.
2. Copy uninst000.dat and uninst000.msg to the [Projects\Bin] directory in your issrc path, renaming them to setup.dat and setup.msg respectively.
3. Open the Setup project.
4. Set the command-line parameters to: /UNINSTMODE /KEEPEXEDATMSG "/SECONDPHASE=<your issrc path\Projects\Bin\Setup.exe"
5. Start debugging.

When compiling units within the UniPs component, Inno Setup defines the following symbols to configure the Pascal Script behavior:

In 64-bit builds, when uPSRuntime.pas includes x64.inc, the following symbols are defined (these are specific to x64 and are not x86 symbols):

While many symbols are fixed due to the Inno Setup environment, the following symbols vary depending on the build configuration or compiler version:

The PascalScript.inc file (included in every unit) normalizes symbols based on the compiler version. The following are always true in Inno Setup:

The following symbols are not defined in the Inno Setup environment. Consequently, {$IFDEF X} blocks for these symbols are dead code, and {$IFNDEF X} blocks are active: