Hvordan man får fat i programmeringsgrænsefladen for KDevelop

Programmeringsgrænsefladen, “Application Program Interface” på engelsk, ofte forkortet til API, er i virkeligheden en følge af beskrivelser (dvs. kaldmodeller) som et program bruger for at få adgang til operativsystem og andre tjenester. I vort tilfælde er en mere omfattende definition dog blevet anvendt. Programmeringsgrænsefladen for et KDE- eller Qt™-program er en abstraktion af klasser og metodegrænseflader, en oversigt som kan bruges som opslagsbog for navigation i kildekoden.

Der er en version af den seneste programmeringsgrænseflade på KDevelops hjemmeside. Den opdateres automatisk hvert døgn så at du kan følge med.

Desværre bruges denne version bedst kun til at læse via internettet. Du kan ligesågodt bygge din egen dokumentation af programmeringsgrænsefladen fra kildekoden for KDevelop. For at gøre det, skal du fortælle automake systemet hvor KDELIBS API findes på dit. Dette opnås med det særlige flag --with-kdelibsdoxy-dir til configure-kommandoen når du forbereder at kompilere KDevelop's kildekode:

(make erstatter den globale $KDEDIR med den egentlige KDE-mappe). Udfør derefter kommandoen make som sædvanligt. Efter at det integrerede udviklingsmiljø KDevelop er bygget, har du mulighed for også at bygge programmeringsgrænsefladen. For at gøre det skal du skrive:

Dette bygger en Doxyfile i basismappen for KDevelop, som derefter behandles af programmet doxygen for at oprette en hel del .html-filer for programmeringsgrænsefladen. Når den ganske lange byggeproces for programmeringsgrænsefladen til sidst er klar, skal du installere programmeringsgrænsefladen præcis som du skal installere selve det integrerede udviklingsmiljø KDevelop. Få rettigheder som systemadministrator om nødvendigt med:

og angive systemadministratorens kodeord. Installér derefter dokumentationsfilerne:

Når dette er gjort, informerer make dig om mappen hvor du til sidst kan kigge på indholdet i dokumentationen for programmeringsgrænsefladen. Bemærk adressen, eftersom du kan bruge den fra Konqueror samt inde i KDevelop, hvis du har indstillet den egne kildekode for KDevelop som projektet at arbejde med.