-
04/23/2025 (Version 2.8)
- Implemented Ini-File Section handling based on the Delphi Version, so now it's possible to have separate sections for different Delphi versions. Check the Example 2 below for the implementation of this feature
-
04/22/2025 (Version 2.7)
- New ini property
General-AutoUpdateIniFile - Raised IniVersion to 3
- Implemented Automatic Update of INI File after GitHub Download
- Added
BuildConfigin Package config to switch between Release/Debug or else - Added
RegisterNamein Package to set a different bpl file name than the package name - Updated General and Package Section in below documentation accordingly
- New ini property
-
02/20/2024 (Version 2.6)
- Delphi 12 support.
- New ini properties: IniVersion, OutputPath and Package\Path
- PublishFiles now supports sub-folder.
- Clear all files and sub-folders when updating from GitHub.
- Detect unsupported compiler.
Click here to view the entire changelog
-
09/12/2021 (Version 2.5)
- Delphi 11 support.
-
03/25/2021 (Version 2.4)
- As it is not a good practice to embed the Component Installer EXE in the GitHub component sources, the update of the GitHub repository has been modified to not update the Component Installer EXE, but only the configured component sources.
- Removed backup functionality in GitHub auto-update.
-
02/01/2021 (Version 2.3)
- Fixed sub-folders creation (missing) when extracting files on GitHub update.
- New backup folder on GitHub update (actual folder will be renamed using date and time sufix).
-
12/18/2020 (Version 2.2)
- Fixed call to rsvars.bat when Delphi is installed in a path containing spaces characters.
-
10/31/2020 (Version 2.1)
- Included Delphi 10.4 Sydney support.
- Implemented verification of the 64-bit Delphi compiler existence when the 64-bit flag was set.
-
10/26/2020 (Version 2.0)
- Compilation process now uses thread.
- GitHub auto-update supporting.
-
05/03/2020 (Version 1.2)
- Fixed RegisterBPL method because Delphi XE5 or below use "RAD Studio" public folder instead "Embarcadero\Studio".
-
02/15/2019 (Version 1.1)
- Removed Allow64bit parameter in the General section. The app will detect this parameter automatically when appears at any package parameter.
This app allows you to distribute your Delphi component without having to do a long task list to manually install the component into IDE (when you are providing component sources, of course).
In addition, if the component is hosted on GitHub, you can indicate the path of the repository and the application will check for updates directly in the repository's Releases.
- Detects all Delphi versions installed and allows programmer to choose which IDE to install.
- Compiles packages generating BPL files.
- Installs packages into IDE.
- Registers paths into Library Path.
- Copies required resource files to compiled folder (.dfm, .res, ...).
- Updates component hosted at GitHub automatically.
- Supports 32 bits and 64 bits compilation.
You need only to create an Ini file called CompInstall.ini and write parameters to the app.
Then put the CompInstall.exe and CompInstall.ini into your component package directory and be happy. 😉
Note: This app requires MSBUILD, which is present at .NET Framework 2.0, 3.5 and 4.0. When the app launch, it will verify if any MSBUILD is available.
[Template] section
IniVersion (required) = Version of ini structure (Current version = 2)
If ini version is higher than current app supported version, the app will display an error message and block installation.
[General] section
Name (required) = Component name displayed at install form and registered into Delphi Packages.
Version (required) = Component version displayed at install form and used by GitHub auto-update control (if enabled).
DelphiVersions (required) = It's a list splitted by ";" with all Delphi versions supported by the component. According to Delphi versions installed in Windows and combining with this parameter, a combobox in the install form will list all possible Delphi versions.
Supported values: 2005;2006;2007;2009;2010;XE;XE2;XE3;XE4;XE5;XE6;XE7;XE8;10;10.1;10.2;10.3;10.4;11;12
Packages (required) = It's a list splitted by ";" with packages to be compiled, in correct order. Just type the package name without the file extension.
AddLibrary (optional) = 0 or 1. When 1, the path of release folders of component will be registered into Delphi library path.
OutputPath (optional) = Relative folder where compiled files are stored (must be the same configured in package settings). You can use {PLATFORM} and {CONFIG} variables. Default value is: {PLATFORM}\{CONFIG} (By now, {CONFIG} is always "Release").
AutoUpdateIniFile (optional) = 0 or 1. When 1, the new version tag of the downloaded version is updated in the ini file. This prevents re-downloading the same updated version on every start.
Package section
To specify package parameters, create a section with the name of the package with the P_ prefix, like:
[P_MyPackage]
Path (optional) = Relative folder where package file is. If blank, package must be at component root folder.
Allow64bit (optional) = 0 or 1. When 1, specify this package to be compiled twice, with 32-bit and 64-bit versions. Remember to create this platform at Delphi Project Manager, otherwise the 64-bit compilation will fail.
If any package has this option enabled, it will be display a checkbox allowing install 64-bit version of component (the checkbox starts checked by default).
PublishFiles (optional) = It's a list splitted by ";" with all files you want to copy into release folders (usually DFM form files used at runtime and resource files).
Install (optional) = 0 or 1. When 1, this package will be installed into Delphi IDE. You need to set this option for design-time packages when you want to register components into Delphi IDE.
BuildConfig (optional, default Release) = Set to Release or Debug or any other existing BuildConfig as needed
RegisterName(optional) = Set a different RegisterName then the Package name. In some cases the package has a generic name and the bpl file includes a version string. E.g. MyPackage.dproj and MyPackage180.bpl
[GitHub] section
Repository (optional) = Allows you to specify a GitHub repository (syntax: GitHub account/Repository name), so when app starts, it will check for component update using GitHub API, reading the latest existing release and comparing its version with current version. If the versions don't match, a dialog will be displayed asking if you want to auto-update files.
In this example, there are two Delphi packages (DamPackage and DamDesignPackage). The design-time package (DamDesignPackage) is configured to install into Delphi IDE. The runtime package (DamPackage) is configured to copy dfm form file and resource file to release folder.
[Template]
IniVersion=2
[General]
Name=Dam Component
Version=1.0
DelphiVersions=XE2;XE3;XE4;XE5;XE6;XE7;XE8;10;10.1;10.2;10.3;10.4
Packages=DamPackage;DamDesignPackage
AddLibrary=1
OutputPath=Library\{PLATFORM}\{CONFIG}
[P_DamPackage]
Path=Source\Code
Allow64bit=1
PublishFiles=DamDialog.dfm;Resources\Dam_Resource.res
[P_DamDesignPackage]
Install=1
Sample Packages using the RegisterName Property to distinguish between different Delphi Versions
It's a stripped down config just for documentation purpose.
[Template]
IniVersion=3
[General]
Name=Zeos Component Sample
Version=8.0-patches
DelphiVersions=XE8;10.4;11;12
Packages=ZCore;ZComponentDesign
AddLibrary=1
OutputPath=Library\{PLATFORM}\{CONFIG}
AutoUpdateIniFile`=1
# Runtime Package
[P_ZCore]
Path=Packages\Delphi12
Allow64bit=1
Install=0
# Designtime Package for Delphi 11
[P_ZComponentDesign_11]
Path=Packages\Delphi11
# Compile for 32 and 64 bit
Allow64bit=0
Install=1
BuildConfig=Debug
RegisterName=ZComponentDesign270
[P_ZComponentDesign_12]
Path=Packages\Delphi12
# Compile for 32 and 64 bit
Allow64bit=0
Install=1
BuildConfig=Debug
RegisterName=ZComponentDesign280
Check my Delphi components here at GitHub and find CompInstall.ini file to see others usage examples.