Commercial Edition (C++ Builder)

Installation instructions for uniGUI (C++ Builder)

1

Download uniGUI Setup

Please 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 This is the one which will be installed on developer PC for development purpose.

  • FMSoft_uniGUI_{Edition_runtime_0.XX.0.YYYY}.exe This one is only for deployment and will be installed on server computer hosting your uniGUI apps.

clip0175
2

Enter registration information

Enter the required information. Make sure the email address is exactly the same as the email address registered in the customer portal.

clip0025
3

Accept license agreement

Accept the license agreement and press Next.

clip0026
4

Obtain license key

Starting from version 0.99.95 the license keys are directly obtained from an activation server. You can 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 click the blue link "Web link to license key..." which will open a browser page containing your key. You can paste the key in the License Key area.

After the key is acquired, 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.

clip0097
5

Select installation folder

Select an installation folder. Default installation folder is [ProgramFiles]\Fmsoft\Framework.

clip0030
6

Select IDE version(s)

Select the RAD Studio / Delphi version(s) for which you want to install uniGUI. Make sure RAD Studio/Delphi is not running while the installation is in progress. The current version of the installer will not warn you about this.

clip0029
7

Install

Press Install to start, and complete the installation process.

clip0031
clip0176
clip0177
8

Open project group in RAD Studio IDE

Start RAD Studio IDE and open the project group for your Delphi version, for example uniGUI_D10_3_Rio_PlusGroup (Delphi 10.3 Rio).

clip0032
9

Prepare and build packages

In the project group there are several Delphi packages. Before building these packages you may need to change package configuration:

Note: Starting with uniGUI version 1.90.0.1537 all packages are modified to generate all C++ related files by default. If you are installing version 1.90.0.1537 or later you can skip the Generate all C++Builder Files step.

  • For all uniGUI packages go to Options -> Linker and set "Generate all C++Builder Files".

(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 Delphi versions. Example for Delphi 10.3.2:

Confiuration for Delphi 10.3.2

Build all packages in Project Manager starting from SynEdit_Rxxxx.bpl.

Important: Do not select Clean All or Clean commands for any of the uniGUI packages. This will delete pre-compiled DCU files from the DCU folder and you will have to install uniGUI again.

clip0178

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.

List of uniGUI Runtime Packages that should be built for C++ Builder Win64 platform only:

  • uniToolsXX

  • uIndyXX

  • uniGUIXXCore

  • uniGUIXX

  • uniGUIXXChart (Starting from build 1597 this package is no longer available)

  • uniGUIXXmCore

  • uniGUIXXm

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

You can run IDE Build All command for the whole project group.

10

Install design-time packages

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

  • SynEdit_D20xx.bpl

  • uniGUIxxdcl.bpl

  • uniGUIxxChartdcl.bpl (Starting from build 1597 this package is no longer available)

  • uniGUIxxmdcl.bpl (Plus/Complete Editions only)

clip0179

Several new components will be installed:

clip0035
clip0036
clip0037
Complete/Plus Edition only

Now the installation is completed. You can proceed to running demos or creating new uniGUI projects.

Additional Notes

  • 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 that mode, then please read section Run-time Packages & C++ Builder: https://unigui.com/doc/online_help/runtime-packages--c-builder.htm

PreviousTrial Edition (C++ Builder)NextC++ Builder (Without RAD Studio)