Installation and Getting Started

There is no installation required for the delphi.libs libraries. Simply clone the github repo to a folder in your working environment or download the latest zip version and unzip.

If you anticipate making contributions to the library code you should instead (or additionally) fork the repository into your own github workspace and clone that fork into your work environment. See Contributing to the Project for more information.

You should then add the include files folder +inc to the search path of any project using the libraries as well as the library folders themselves. It is recommended that you add the include folder to your IDE library search path and add individual library paths to your projects as needed (or explicitly add any used units to your project DPR uses list).

To simplify referencing the delphi.libs location it is strongly recommended to define and use a deltics environment variable.

$(deltics) Environment Variable

The deltics variable should be set to identify the folder into which you cloned or copied the delphi.libs repository. For example, if you cloned the repository in the folder c:\dev\libs\deltics\delphi.libs you will have a structure similar to the following in your file system:

c:\dev\libs\deltics
                  \+inc
                  \+tests
                  \bonjour
                  \rtl
                  \smoketest
                  .. etc

The deltics environment variable in this case should be set to:

c:\dev\libs\deltics

Include File and Library Paths

With the deltics environment variable correctly set, the include file location can be added to your IDE library path by simply adding the following entry:

$(deltics)\+inc

Similarly, to add a particular delphi.libs library to any project (or to the IDE library path), you can use the $(deltics) to prefix any particular library you need. For example, for a project that uses the Bonjour components you need to add the bonjour library and the rtl library:

$(deltics)\bonjour
$(deltics)\rtl

Test Projects

The included test projects assume in their settings that the deltics environment variable is defined and that the $(deltics)\+inc is on the IDE library search path.