This is an old revision of the document!
Installation
We offer various ways to install Gorilla3D Addon Framework for Delphi. You can use the embedded GetIt Package Manager inside of your IDE, our installer tool or install the packages manually.
- GetIt Package Manager
- Installer-Tool
- Manual Installation
- Delphi 10.1.1 - 10.2.3
- Delphi 10.3.0 - Delphi 11.2+
GetIt Package Manager
Installer Tool
Gorilla Software provides an easy-to-use installer software doing all the work for you to download and install the packages and configure the IDE for you. The tool is able to manage Developer-Edition downloads or Commercial-Edition downloads with your individual credentials.
Download the Zip-Archive, extract it and run the “Gorilla3DInstaller.exe”. Download Installer for Windows
WARNING: Previously manually installed packages have to be uninstalled before running the installer. Otherwise path settings may be conflicting.
Select the desired IDE version you want a package to install for.
Click “Install” to start the process.
The application will download, extract and configure everything for you.
Manual Installation
To install Gorilla3D packages correctly you have to follow the instructions.
Download
You can download the latest Developer-Edition packages for your specific Delphi DX version at https://gorilla3d.de/files/
Go to the “packages” folder, choose your Delphi IDE version and download the highest version.
Latest Package for Community Edition: https://gorilla3d.de/files/packages/10.4.2/Gorilla3D_Delphi_C%2B%2B_10.4.2_1.0.0.2573.zip
The Developer-Edition is free for development purposes and max. 5 developers. When releasing your project you need to purchase the Commercial-Version!
The free developer-edition contains the same features like the commercial version, it only contains multiple visual and hardcoded watermarks.
Unpack and Configure
Unpack the downloaded zip-archive anywhere (<installation-directory>).
Inside the Delphi IDE go to:
- Menu: Components > Install packages
- Move to directory: “<installation-directory>\Win32\Release”
- Select the package files for installation:
- “Gorilla3D_Delphi_10_4_2_Alexandria.bpl”
- “Gorilla3D_DesignTime_10_4_2.bpl”
- Click “Open”
After packages were added, we need to configure compiled source-code (DCU) paths. Because IDE has changed over the years, some configurations have been moved.
Delphi 10.1.1 - 10.2.3
To insert DCU's go to:
- Menu: Tools > Options > Environmentoptions > Delphi-Options > Library
- Select “Windows 32-Bit” platform on top
- Go to “Library-Path” input field and add the “<installation-directory>\Win32\Release\”
- Repeat this analog for “Windows 64-Bit” and “Android” platforms
Delphi 10.3.0 - Delphi 11.2+
To insert DCU's go to:
- Menu: Tools > Options > Language > Delphi-Options > Library
- Select “Windows 32-Bit” platform on top
- Go to “Library-Path” input field and add the “<installation-directory>\Win32\Release\”
- Repeat this analog for “Windows 64-Bit” and “Android” platforms
Notes
By manual installation we need to take care of a few DLL files. The IDE should be able to find those files at DesignTime, because while working in Delphi, the current directory is the IDE binary folder, not your project folder:
f.e. "C:\Program Files (x86)\Embarcadero\Studio\21.0\bin\"
- Copy FMOD (audio library) DLL to BDS directory
- “<installation-directory>\lib\fmod\windows\fmodL.dll” to “C:\Program Files (x86)\Embarcadero\Studio\22.0\bin\”
- Copy OpenSSL DLL files to BDS directory or ensure the system is able to find them automatically by environment variables
- OpenSSL is needed by the embedded AssetsStore to download prefabs from web
- “libeay32.dll” and “ssleay32.dll” to “C:\Program Files (x86)\Embarcadero\Studio\22.0\bin\”
- You can download OpenSSL at: https://www.openssl.org/source/