Kompilering og installation af KDevelop

Når alle krav er mødt, er du parat til at kompilere og installere KDevelop. Dette appendiks vil diskutere de nødvendige skridt til at gøre dette.

Forberedende skridt

Inden du påbegynder kompileringssekvensen, skal du sikre dig at alle biblioteker og værktøj er tilgængelige for byggesystemet. For at opnå dette, skal visse miljøvariabler indstilles rigtigt. Skridtene som skal udføres afhænger af hvilken skal du bruger i terminalen.

Bemærk

For at undgå at indtaste alle sætningerne som indstiller de nødvendige miljøvariabler hver gang du vil kompilere, kan du placere dem i filen .bashrc eller .cshrc. På den måde indstilles miljøvariablerne rigtigt hver gang du starter skallen.

Opsætning af miljøet for bash-skallen

Hvis du bruger bash-skallen, tilføjes følgende linjer:

export KDEDIR=(sti til din KDE-installation)
export QTDIR=(sti til dit Qt-bibliotek)
export LD_LIBRARY_PATH=$QTDIR/lib:$KDEDIR/lib:$LD_LIBRARY_PATH
export LIBRARY_PATH=$QTDIR/lib:$KDEDIR/lib:$LIBRARY_PATH
export PATH=$QTDIR/bin:$KDEDIR/bin:$PATH

Opsætning af miljøet for tcsh-skallen

Hvis du bruger tcsh-skallen, tilføjes følgende linjer:

setenv KDEDIR (sti til din KDE-installation)
setenv QTDIR (sti til dit Qt-bibliotek)
setenv LD_LIBRARY_PATH=$QTDIR/lib:$KDEDIR/lib:$LD_LIBRARY_PATH
setenv LIBRARY_PATH $QTDIR/lib:$KDEDIR/lib:$LIBRARY_PATH
setenv PATH $QTDIR/bin:$KDEDIR/bin:$PATH

Kompilér KDevelop

Bemærk

I følgende beskrivelse antager vi at du har placeret kildekoden for KDevelop i mappen ~/kde3src/kdevelop.

Særlige hensyn ved kompilering fra CVS

Hvis du bruger en aktuel version af KDevelop fra CVS, afhænger de første kompileringsskridt af om du netop har gjort en fuldstændig udtjekning, eller kun opdateret kildekoden.

Efter en udtjekning fra CVS

Du skal initiere byggesystemet efter en ny udtjekning. Det samme gælder hver gang du skal starte igen fra begyndelsen. Skriv:

~/kde3src/kdevelop> make -f admin/Makefile.common cvs-clean

og derefter alle følgende skridt.

Bemærk

Du har måske brug for adgang til CVS-arkivet for oprydningen hvis nogen korrupte eller manglende filer skal genkonstrueres.

Vigtigt

cvs-clean-kommandoen vil fjerne hver fil der ikke er i CVS fra mappen! Sørg for at sikkerhedskopiere al værdifuld information før du udsteder denne oprydningskommando.

Efter en opdatering fra CVS

Næste skridt afhænger af udskriften fra CVS-opdateringssekvensen. Hvis du fik noget som ligner følgende (der kan være en U eller P markering i søjlen til venstre, begge betyder at filen er blevet ændret):

U /en_mappe_sti/Makefile.am

eller hvis du netop har lavet en fuldstændig udtjekning, skal du skrive:

~/kde3src/kdevelop> make -f Makefile.cvs

inden du fortsætter med alle følgende skridt.

Grundlæggende kommandosekvens med make

Når det grundlæggende byggesystem er indstillet på denne måde, skal du bestemme dig for hvilken slags KDevelop-system du vil bruge. Det gøres med følgende indstillingsskridt, som bygger den virkelige fil med navnet Makefile, som make kommandoen vil bruge.

Bemærk

Du kan udelade flaget --prefix i følgende kommandolinjer med configure, hvis du ønsker at KDevelop skal installeres i KDE's standardmappe. Se kapitlet Nogle bemærkninger om flag til configure om dette.

En version kompileret til fejlsøgning

Hvis du vil holde styr på hvad programmet KDevelop gør når det kører, kan du bygge en version kompileret med fejlsøgning. Bed blot din configure om at gøre det:

~/kde3src/kdevelop> ./configure --enable-debug=full --prefix=(hvor-din-kde3-er)
En version kompileret til distribution

Hvis du kun vil bruge KDevelop som det er (mindre og hurtigere), er det nok med en version kompileret for distribution. Det er standarden i configure.

~/kde3src/kdevelop> ./configure --prefix=(hvor-din-kde3-er)

Bemærk

Hvis du vil lave din egen dokumentation for programmeringsgrænsefladen for KDevelop, skal du tage yderligere et flag med i kommandoen configure:

~/kde3src/kdevelop> ./configure --(tilvalg-som-ovenfor) \
--with-kdelibsdoxy-dir=$KDEDIR/share/doc/HTML/en/kdelibs-apidocs
Byg og installér KDevelop

Kommandoen configure kontrollerer systemet og bygger en Makefile ifølge hvad den finder. Kommandoen make bruger normalt denne Makefile. Altså er

~/kde3src/kdevelop> make

tilstrækkeligt. Om nødvendigt, så skaf rettigheder som systemadministrator

~/kde3src/kdevelop> su

og angive systemadministratorens kodeord. Installér derefter programmet:

~/kde3src/kdevelop> make install

Det er alt. Hvis du installerede KDevelop i KDE's standardmappe, kan du nu køre det integrerede udviklingsmiljø. Ellers er nogle yderligere skridt nødvendige, som vises i afsnittet Anden installationsmappe end standard nedenfor.

Bemærk

Faktisk er der normalt tre KDevelop-programmer installeret:

  • KDevelop integreret udviklingsmiljø — det er her du normalt kommer til at arbejde.

  • Den fritstående KDevelop Assistent dokumentationsbrowser — isolerer alle de stærke dokumentationsfunktioner fra det integrerede KDevelop udviklingsmiljø i et separat værktøj. Dette er specielt nyttigt når du vil slå noget programmeringsdokumentation op, men ikke vil starte hele udviklingsmiljøet.

  • KDevelop Designer — forbedrer Qt™-User Interface Designer med KDE specifikke kontroller og integrerer sig fint i KDevelop udviklingsmiljøet.

Nogle bemærkninger om flag til configure

Anden installationsmappe end standard

Normalt forbereder configure til at installere det grafiske udviklingsmiljø i KDE's standardmappe. Det er nødvendigt, eftersom KDevelop antager at der er direkte adgang til visse værktøjer og delprogrammer som findes der. Hvis du vil bruge din egen installationsmappe, skal du fortælle det til configure med flaget --prefix:

~/kde3src/kdevelop> ./configure --prefix=(hvor-din-kde3-er)

Der er et problem hvis du gør det. Du skal give mulighed for at KDevelop har adgang til nødvendige værktøjer og delprogrammer i KDE's mappe. (Du kan stadigvæk bruge det integrerede udviklingsmiljø uden at gøre det, men med meget begrænsede funktioner.)

Du skal bruge en skal, og følgende kommando skal køres inden du kan starte KDevelop fra skallen.

Bemærk

Husk at bruge flertal: Det er “KDEDIRS”, ikke blot “KDEDIR”)

~> export KDEDIRS=/usr/local/kde:/opt/kde3
~> kbuildsycoca
(Start nu KDevelop:)
~> kdevelop

Bemærk

KDEDIRS miljøvariablen skal sættes til listen af aktive KDE mapper på dit system. Vi bruger
/usr/local/kde:/opt/kde3
blot som et eksempel.
Mappen /usr/local/kde kan for eksempel indeholde en ufuldstændig udgave af KDE som du kompilerede til fejlretningsformål og mappen /opt/kde3 kunne derudover indeholder standardudgaven af KDE fra din distribution der bruges til hverdagsarbejde.

I en tcsh-skal skal du indstille miljøvariablerne ved at bruge:

~> setenv KDEDIRS /usr/local/kde:/opt/kde3

Kommandoen kbuildsycoca (“byg systemkontrolcache”) søger efter biblioteker og gemmer deres sted og version i en cache, så KDevelop kan finde dem. Problemet er at det tager mærkbart med tid—og skal køres hver gang du bruger skallen til at starte KDevelop med en anden installationsmappe end standardmappen. Du vil kunne indtaste ovenstående kommando i et skalscript for at reducere anstrengelserne med at indtaste det.

(Du vil også kunne indtaste linjerne i filen .bashrc eller .cshrc, men det er ikke ønskværdigt fordi så køres kbuildsycoca hver gang du bruger skallen.)

Bemærk

Kommandoen kbuildsycoca kører ikke for systemadministratoren. Du skal kalde den som en anden bruger. (Men det er ikke en særlig god idé at udvikle som systemadministrator!)