Installation instructions for uniGUI (Delphi and C++ Builder**)
•Before installing a new version, remove all design packages from Delphi and uninstall uniGUI from Windows Program Add/Remove.
•After re-compiling an application with this new version, the "ext" folder must be re-deployed to PCs running the new version of your application, or you can simply re-install the newly introduced Ext JS runtime package which can be downloaded from the Downloads page.
**Note for C++ Builder: You need RAD Studio IDE to install uniGUI for C++ Builder.
1) Download the latest uniGUI Setup from the customer portal.
You will notice that there are two Setup versions:
oThis is the one which will be installed on each developer PC for development purposes.
oThis one is only for deployment and will be installed on any server PC hosting your uniGUI apps.
2) Enter the following information. Make sure the email address is exactly the same as the email address registered in the customer portal.
3) Accept the license agreement and press next.
4) Enter your license key in the memo field as shown below.
Note: Starting from version 0.99.95 the license keys are directly obtained from an activation server. You can easily get your license key by entering your password and pressing the Get License Key button. This will fill the License Key area with an appropriate key. Alternatively you can get your license key by clicking on the blue link: Web link to license key.... This will open a browser window which will open a page containing your key. You can paste the key in License Key area.
After the key is acquired, you can press Continue... and proceed to the next step.
It is also possible to save your acquired license key in a local file and use it the next time you re-install the same edition and version of uniGUI.
5) Select an installation folder. Default installation folder is [ProgramFiles]\Fmsoft\Framework\.
6) Select the Delphi version(s) for which you want to install uniGUI. You must be sure that Delphi is not running while the installation is in progress. The current version of the installer will not warn you about this.
7) Press Install to start, and complete the installation process.
8) Start Delphi and open the project group for your Delphi version. e.g. uniGUI2016Group (Delphi XE6).
**Additional step for C++ Builder: Instead of Delphi IDE open project in the RAD Studio IDE.
9) In Project Manager there are 11 Delphi packages. Build all packages starting from SynEdit_Rxxxx.bpl.
Important: Do not select Clean All or Clean commands for any of the uniGUI packages. This will delete all pre-compiled DCU files from the DCU folder and you will have to install uniGUI again.
Additional steps for C++ Builder:
Before building packages, for all uniGUI packages please go to Options->Linker and Select/Set Generate all C++Builder Files as shown below:
(If your Delphi version supports more than one platform make sure to set the Target to All configurations - All platforms )
Additional step for C++ Builder installation only.
The configuration screen may change between different Delphi versions. For example above picture is taken from Delphi XE4 while below picture is from Delphi 10.3.2.
Confiuration for Delphi 10.3.2
Additional steps for C++ Builder (Win64 Platform):
If you plan to compile C++ Builder projects for Win64 platform, you must repeat this step for uniGUI Runtime Packages only for 64-bit Windows Platform as well.
Here is the list of uniGUI Runtime Packages that should be built for C++ Builder Win64 platform only:
Which means you need to go to each of the above packages in project manager, change the selected platform to Win64 and Build the package to generate required HPP and other C++ specific files for Win64 platform.
Note: the above steps are only needed for Win64 platform and C++ Builder.
If you are installing the Plus/Complete Edition, you will see three additional files related to Mobile development in the project group:
10) After building all packages, install the design time packages by right-clicking and selecting Install in the following order:
• uniGUIxxmdcl.bpl (Plus/Complete Editions only)
Several new components will be installed:
Complete/Plus Edition only
Additional steps for C++ Builder
•After starting a new C++ project, you must disable Linker->Dynamic RTL.
•New C++ projects are created without a resource (.RES) file. As a result, the project has no default Icon. This issue will be fixed in next releases.
•Combo VCL/ISAPI projects are not supported for C++ Builder.
•It is recommended to build your C++ Builder app without Run-Time Packages. You must statically link all libraries and create a single EXE. You can also use the default mode which uses run-time packages by default. If you want to build your application in this mode, then please read section Run-time Packages & C++ Builder.
Additional steps for C++ Builder 64-bit target (C++ Builder XE3 and later)
In order to compile your application for the 64-bit platform, some additional steps must be taken:
•Set target platform for all run-time packages to Win64.
•Once again build all packages, so all required libraries for 64-Bit compilation and linking will be generated.