Libraries (bibliotheken)

Introductie

Gambas libraries (bibliotheken) zijn Gambas executables die door een project op bijna exact dezelfde manier als een component gebruikt kunnen worden.

Maar er zijn enkele verschillen en enkele heikele punten die een beetje aandacht vereisen.

Het allerbelangrijkst is het volgende: Een Gambas executable kan een library enkel gebruiken indien ze opgeslagen zijn in dezelfde directory dan het project doe de library gebruikt.

Hoe maak je een library van een project?

Creëer een normaal Gambas project.

In het dialoogvenster van de project eigenschappen ga naar de tab 'Opties' en zet 'Dit project is een component of library' op 'Ja':

Daarna kun je het dialoogvenster van de component eigenschappen openen.

Net als bij een component kun je de exported class zien en kun je de functies en componenten definiëren die de library nodig heeft.

Alleen de klassen (classes) gemarkeerd met het EXPORT keyword zullen geëxporteerd worden en zichtbaar zijn in het project dat die library gebruikt.

Vervolgens maak je een executable van het project.

Hoe gebruik je een library in een project?

Open het dialoogvenster van de project an ga naar de tab 'Libraries'.

Daar kun je alle libraries selecteren gebruikt in je project door het absolute pad naar hun executable te specificeren.

Hoe en waar installeer je een library?

Indien je een project uitvoert vanuit de IDE, worden de libraries gebruikt in het project getraceerd door hun absolute pad zoals gespecificeerd op de tab 'Libraries' van het project dialoogvenster.

Maar wanneer je de project executable uitvoert, moeten de libraries die gebruikt worden in zich in dezelfde directory als de project executable te bevinden.

Indien een library niet wordt gevonden, dan wordt er gezocht in /bin en /usr/bin als een laatste toevlucht.

Dus, in tegenstelling tot een component, dient een library precies hetzelfde gepackaged als een normaal programma, zodat deze geïnstalleerd wordt op een locatie die alle applicaties kunnen bereiken.