• 1
  • 2
  • 3
  • 4

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:

 

FMSoft_uniGUI_{Edition_0.XX.0.YYYY}.exe

oThis is the one which will be installed on each developer PC for development purposes.

FMSoft_uniGUI_{Edition_runtime_0.XX.0.YYYY}.exe

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.

 

clip0025

 

 

3) Accept the license agreement and press next.

clip0026

 

 

4) Enter your license key in the memo field as shown below.

clip0028

 

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.

 

clip0097

 

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\.

clip0030

 

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.

 

clip0029

 

7) Press Install to start, and complete the installation process.

 

clip0031

 

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.

 

clip0032

 

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.

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

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:

 

uniToolsXX
uIndyXX
uniGUIXXCore
uniGUIXX
uniGUIXXChart
uniGUIXXmCore
uniGUIXXm

 

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.

 

 

clip0039

If you are installing the Plus/Complete Edition, you will see three additional files related to Mobile development in the project group:

 

clip0038

10) After building all packages, install the design time packages by right-clicking and selecting Install in the following order:

 

 SynEdit_D20xx.bpl

   uniGUIxxdcl.bpl

   uniGUIxxChartdcl.bpl

   uniGUIxxmdcl.bpl (Plus/Complete Editions only)

 

 

Several new components will be installed:

 

clip0035

 

clip0036

 

clip0037

 

Complete/Plus Edition only

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.