BerndPol Anne-MarieMahfouf Installation I det här kapitlet beskriver vi alla steg som behövs för att kompilera och installera den integrerade utvecklingsmiljön &tdevelop;: Hur man skaffar &tdevelop; koncentrerar sig på hur man laddar ner den senaste källkoden för &tdevelop; från SVN. Krav för &tdevelop; listar programmen och biblioteken som du måste ha installerade för att kompilera den integrerade utvecklingsmiljön med lyckat resultat. Kompilering och installation av &tdevelop; leder dig igenom alla steg för kompilering och installation av programmet. Hur man skaffar dokumentation av programmeringsgränssnittet för &tdevelop; talar om vad ett programmeringsgränssnitt är och hur du skaffar ett så användbart verktyg för navigering i källkoden för &tdevelop;. skaffa &tdevelop; &tdevelop; skaffa &tdevelop; är tillgänglig i binärform från många olika &Linux;-distributioner som SuSE, RedHat med flera. Binärfilerna är paketerade på något bekvämt sätt, oftast RPM, för att enkelt kunna installeras. Följ standardinstruktionerna som ges i distributionen för att installera. Du kan mycket väl skaffa källkoden för &tdevelop;, kompilera och installera den själv. Källkoden hittas via projektets hemsida på http://www.tdevelop.org eller via &kde;:s FTP-plats. SVN Om du vill ta del av aktuell utveckling, är versioner från det anonyma SVN-arkivet tillgängliga. Modulnamnet är tdevelop med svn co svn://anonsvn.kde.org/home/kde/branches/KDE/3.5/tdevelop. utcheckning &tdevelop; SVN utcheckning För att skaffa en ursprunglig version av &tdevelop; måste du ladda ner den från anonym SVN. Följ bara stegen nedan för den här så kallade utcheckningsåtgärden. Vi antar att du vill placera din kopia av &tdevelop; i underkatalogen kde3src i din hemkatalog (~). # Skapa målkatalogen, om det behövs: ~> mkdir kde3src ~> cd kde3src ~/kde3src> svn co svn://anonsvn.kde.org/home/kde/branches/KDE/3.5/tdevelop ~/kde3src> cd tdevelop När du väl har lyckats checka ut din version av &tdevelop;, kan du hänga med i ändringarna genom att använda uppdateringsproceduren som visas i nästa avsnitt. Håll serverns last nere. Var vänlig att inte checka ut varje gång du vill få en aktuell version av &tdevelop;! Använd SVN update för detta syfte. Nu kan du kompilera din version av &tdevelop; som visas i avsnittet Kompilering och installation av &tdevelop;. uppdatera &tdevelop; SVN uppdatera Efter du checkat ut &tdevelop; från SVN som visas ovan (och kompilerat med lyckat resultat), vill du hålla den aktuell för att få med alla programfixar. Följ då stegen nedan. (Återigen antar vi att du har placerat din kopia av &tdevelop; i katalogen kde3src.) Observera kommandot up (= update) istället för co (vilket betyder checkout). ~> cd kde3src ~/kde3src> cd tdevelop ~/kde3src> svn up Håll ett öga på meddelanden som SVN visar under uppdateringssekvensen. De exakta stegen i kompileringssekvensen beror på dem. Nu kan du kompilera en ny version av &tdevelop; som visas i kapitlet Särskilda hänsyn vid kompilering från SVN. krav &tdevelop; krav GNU krav För att kompilera och använda &tdevelop; med lyckat resultat, behöver du följande program och bibliotek. De är tillgängliga på de flesta plattformar som distributionspaket, och kan därigenom lätt installeras. gcc/g++ 2.95.3 eller senare (eller motsvarande) gcc krav g++ krav Tillgänglig från gcc.gnu.org &GNU; make (eller motsvarande) make krav Tillgänglig från www.gnu.org/software/make &perl; 5.004 (eller senare) Perl krav Tillgänglig från www.perl.com autoconf ≥ 2.52 (eller senare) autoconf krav Tillgänglig från www.gnu.org/software/autoconf automake ≥ 1.6 (eller senare) automake krav Tillgänglig från www.gnu.org/software/automake flex 2.5.4 (eller senare) flex krav Tillgänglig från www.gnu.org/software/flex &Qt; ≥ 3.3.0 (eller senare) Qt krav Tillgänglig från www.trolltech.com/products/qt KDE ≥ 3.4.0 (eller senare) KDE krav Tillgänglig från www.kde.org Verktyget ctags för källkodsnavigering, från http://ctags.sourceforge.net, som ger dig snabb åtkomst till deklarationer och definitioner med några få enkla klick på ett namn i editorn. ctags Kompilatorn dot för grafikspråk, från http:/www.graphviz.org. Verktyget behövs tillsammans med &doxygen; nedan, om du vill visa klassförhållanden grafiskt (vilket starkt rekommenderas). dot Dokumentationsverktyget &doxygen;, från http://www.doxygen.org, om du vill skapa koncis och kraftfull dokumentation av programmeringsgränssnittet för dina projekt. doxygen Valgrind från http://developer.kde.org/~sewardj/ hjälper dig att hitta minneshanteringsproblem i dina program. valgrind SVN från http://subversion.tigris.org/, om du vill använda versionshanteringssystemet SVN. SVN krav Eventuellt andra kompilatorer och/eller verktyg om du vill utveckla för ett annat språk eller plattform än C++/&kde;, eller använda någon annan specialfunktion. Du kan i viss utsträckning kringgå behovet av &autoconf; ≥ 2.52 och &automake; ≥ 1.6. Ta bara bort katalogen admin i installationskatalogen för &tdevelop;, och skriv: autoconf kringgå versionsbehov automake kringgå versionsbehov versionsbehov kringgå för autoconf och automake (din tdevelop-katalog)> ln -s $KDEDIR/share/apps/tdelibs/admin admin i terminalen. Det gör att &tdevelop; använder standardinställningarna i &kde;:s admin-katalog istället. Var försiktig så att du inte blandar olika versioner av &Qt;. Länka alltid &tdevelop; med samma version av &Qt; som &kde;-biblioteket kompilerades med. Annars råkar du troligen ut för mycket konstigt beteende. &tdevelop; kompilering &tdevelop; installation När alla krav väl är uppfyllda är du redo att kompilera och installera &tdevelop;. Det här appendixet beskriver nödvändiga steg för att göra det. Förberedande steg berättar hur du ställer in en riktig miljö. Kompilera &tdevelop; handlar om hur källkoden för &tdevelop; skaffas från SVN, hur den förbereds för installationsprocessen, och visar till sist stegen som är nödvändiga för att kompilera och installera &tdevelop;. Några anmärkningar om väljare till configure talar om hur man kör &tdevelop; om det har installerats på en annan plats än i &kde;-katalogen. preliminärt Installation av &tdevelop; KDEDIR QTDIR LD_LIBRARY_PATH LIBRARY_PATH PATH Innan du påbörjar kompileringssekvensen, måste du försäkra dig om att alla bibliotek och verktyg är tillgängliga för byggsystemet. För att uppnå detta, måste vissa miljövariabler ställas in riktigt. Stegen som ska utföras beror på vilket skal du använder i terminalen. För att undvika att skriva in alla satserna som ställer in nödvändiga miljövariabler varje gång du vill kompilera, kan du placera dem i filen .bashrc eller .cshrc. På så sätt ställs miljövariablerna in riktigt varje gång du startar skalet. Om du använder bash-skalet, lägg till följande rader: export KDEDIR=(sökväg till KDE-installationen) export QTDIR=(sökväg till Qt-biblioteket) 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 Om du använder tcsh-skalet, lägg till följande rader: setenv KDEDIR (sökväg till KDE-installationen) setenv QTDIR (sökväg till Qt-biblioteket) 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 make Installation av &tdevelop; kompilera &tdevelop; I följande beskrivning antar vi att du har placerat källkoden för &tdevelop; i katalogen ~/kde3src/tdevelop. Om du använder en aktuell version av &tdevelop; från SVN, beror de första kompileringsstegen på om du just gjort en fullständig utcheckning, eller bara uppdaterat källkoden. Efter en utcheckning från SVN Du måste initiera byggsystemet efter en ny utcheckning. Samma sak gäller varje gång du måste starta om från början. Skriv: ~/kde3src/tdevelop> make -f admin/Makefile.common svn-clean och därefter alla följande steg. Du kan behöva komma åt SVN-arkivet för att rensa det om några skadade eller saknade filer måste återskapas. Kommandot svn-clean tar bort alla filer som inte finns i SVN från katalogen. Försäkra dig om att säkerhetskopiera viktig information innan du använder det här rensningskommandot. Efter en uppdatering från SVN Nästa steg beror på utmatningen från SVN-uppdateringssekvensen. Om du fick något som liknar följande (markeringarna U eller P kan finnas i kolumnen längst till vänster, båda anger att filen har ändrats): U /någon_sökväg/Makefile.am eller om du precis gjort en fullständig utcheckning, måste du skriva: ~/kde3src/tdevelop> make -f Makefile.svn innan du fortsätter med alla följande steg. När det grundläggande byggsystemet har ställts in, måste du bestämma dig för vilken typ av &tdevelop;-system du vill använda. Det görs med följande konfigureringssteg, som bygger de verkliga filerna med namn Makefile, som kommandot make kommer att använda. Du kan utelämna väljaren --prefix i följande kommandorader med configure, om du vill att &tdevelop; ska installeras i &kde;:s standardkatalog. Se kapitlet Några anmärkningar om väljare till configure om detta. En version kompilerad för avlusning Om du vill hålla ordning på vad programmet &tdevelop; gör när det kör, kan du bygga en version kompilerad med avlusning. Tala bara om för configure att göra det: ~/kde3src/tdevelop> ./configure --enable-debug=full --prefix=(där din kde3 finns) En version kompilerad för distribution Om du bara vill använda &tdevelop; som det är (mindre och snabbare), räcker det med en version kompilerad för distribution. Det är förvalt i configure. ~/kde3src/tdevelop> ./configure --prefix=(där din kde3 finns) Om du vill skapa din egen dokumentation av programmeringsgränssnittet för &tdevelop;, måste du ta med ytterligare en väljare i kommandot configure: ~/kde3src/tdevelop> ./configure --(väljare enlikt ovan) \ --with-tdelibsdoxy-dir=$KDEDIR/share/doc/HTML/en/tdelibs-apidocs Bygga och installera &tdevelop; Kommandot configure kontrollerar systemet och skapar några filer vid namn Makefile enligt vad det hittar. Kommandot make använder normalt den huvudsakliga filen Makefile. Alltså är ~/kde3src/tdevelop> make tillräckligt. Om nödvändigt, skaffa rättigheter som systemadministratör genom att använda kommandot ~/kde3src/tdevelop> su och ange systemadministratörens lösenord. Installera sedan programmet: ~/kde3src/tdevelop> make install Det är allt. Om du installerade &tdevelop; i &kde;:s standardkatalog, kan du nu köra den integrerade utvecklingsmiljön. Annars är några ytterligare steg nödvändiga, som visas i avsnittet Annan installationskatalog än standard nedan. I själva verket har tre &tdevelop;-baserade program installerats: Den integrerade utvecklingsmiljön &tdevelop;: Det här är platsen där du oftast arbetar. Den fristående dokumentationsbläddraren &tdevelop; assistent: Isolerar alla kraftfulla dokumentationsfunktioner i utvecklingsmiljön &tdevelop; i ett separat verktyg. Det här är praktiskt när du vill slå upp någon programmeringsdokumentation, men inte vill starta den fullständiga utvecklingsmiljön. &tdevelop; Designer: Utökar &Qt; Designer för grafiska gränssnitt med element specifika för &kde; och integreras på ett bra sätt i utvecklingsmiljön &tdevelop;. &tdevelop; installation inte standardkatalog inte standardkatalog KDEDIRS kbuildsycoca Normalt förbereder configure för att installera den grafiska utvecklingsmiljön i &kde;:s standardkatalog. Det behövs, eftersom &tdevelop; antar att det går att direkt komma åt vissa verktyg och delprogram som finns där. Om du vill använda din egen installationskatalog, måste du tala om det för configure med väljaren --prefix: ~/kde3src/tdevelop> ./configure --prefix=(där din kde3 finns) Det finns ett problem om du gör det. Du måste ge möjlighet för &tdevelop; att komma åt nödvändiga verktyg och delprogram i &kde;:s katalog när det kör. (Du kan fortfarande använda den integrerade utvecklingsmiljön utan att göra det, men med mycket begränsade funktioner.) Starta ett skal och se till att köra följande kommandon innan du startar &tdevelop; från skalet. Försäkra dig om att använda pluralis: Det är KDEDIRS, inte bara KDEDIR. ~> export KDEDIRS=/usr/local/kde:/opt/kde3 ~> kbuildsycoca (Starta nu &tdevelop;:) ~> tdevelop Miljövariabeln KDEDIRS måste vara inställt till listan med aktiva &kde;-bibliotek i systemet. Vi använder /usr/local/kde:/opt/kde3 bara som ett exempel. Katalogen /usr/local/kde kan till exempel innehålla en ofullständig &kde;-version som du kompilerat i avlusningssyfte, och katalogen /opt/kde3 innehåller dessutom den vanliga &kde;-versionen från distributionen som används för dagligt arbete. I ett tcsh-skal måste du ställa in miljövariablerna genom att använda: ~> setenv KDEDIRS /usr/local/kde:/opt/kde3 Kommandot kbuildsycoca (bygg systemkontrollcache) söker efter bibliotek och lagrar deras plats och version i en cache, så att &tdevelop; kan hitta dem. Problemet är att det tar märkbart med tid, och måste köras varje gång du använder skalet för att starta &tdevelop; med en annan installationskatalog än standardkatalogen. Du skulle kunna skriva in ovanstående kommandon i ett skalskript för att reducera ansträngningen att skriva in det. (Du skulle också kunna skriva in raderna i filen .bashrc eller .cshrc, men det är inte önskvärt eftersom då körs kbuildsycoca varje gång du använder skalet.) Kommandot kbuildsycoca kör inte för systemadministratören. Du måste anropa det som en annan användare. (Men det är inte en särskild god idé att utveckla programvara som systemadministratör!) programmeringsgränssnitt &tdevelop; &tdevelop; programmeringsgränssnitt kompilera &tdevelop; programmeringsgränssnitt anpassa Programmeringsgränssnitt i &tdevelop; Programmeringsgränssnittet, Application Program Interface på engelska, ofta förkortat API, innehåller i själva verket en följd av beskrivningar (dvs. anropsmodeller) som ett program kan använda för att komma åt operativsystem och andra tjänster. I vårt fall har dock en mer omfattande definition använts. Programmeringsgränssnittet för ett &kde;- eller &Qt;-program är en sammanfattning av klasser och metodgränssnitt, en översikt som kan användas som uppslagsbok för navigation i källkoden. Det finns en version av det senaste programmeringsgränssnittet på KDevelops hemsida. Den uppdateras automatiskt varje dygn så att du kan hänga med. Tyvärr används den här versionen bäst för att bara läsa via Internet. Om du inte alltid är uppkopplad, kan du lika väl bygga din egen dokumentation av programmeringsgränssnittet från källkoden för &tdevelop;. För att göra det, måste du tala om det för automake-systemet var KDELIBS programmeringsgränssnitt finns på din dator. Det kan åstadkommas med den särskilda väljaren --with-tdelibsdoxy-dir i kommandot configure när du förbereder kompilering av källkoden för &tdevelop;. ~/kde3src/tdevelop> ./configure --(vanliga väljare) \ --with-tdelibsdoxy-dir=$KDEDIR/share/doc/HTML/en/tdelibs-apidocs (make ersätter den globala variabeln $KDEDIR med den verkliga inställningen av &kde;-katalogen som finns där). Utför sedan kommandot make som vanligt. Efter att den integrerade utvecklingsmiljön &tdevelop; har byggts, har du möjlighet att också bygga programmeringsgränssnittet. För att göra det måste du skriva: ~/kde3src/tdevelop> make apidocs Detta bygger en Doxyfile i baskatalogen för &tdevelop;, som i sin tur behandlas av programmet Doxygen för att skapa en hel del .html-filer för programmeringsgränssnittet. När den ganska långa byggprocessen (den kan ta mer än en timme på en långsam dator) av programmeringsgränssnittet till sist är klar, måste du installera programmeringsgränssnittet precis som du måste installera själva den integrerade utvecklingsmiljön &tdevelop;. Skaffa rättigheter som systemadministratör om det behövs med: ~/kde3src/tdevelop> su och ange systemadministratörens lösenord. Installera sedan dokumentationsfilerna: ~/kde3src/tdevelop> make install-apidox När det här väl är gjort, informerar make dig om katalogen där du till sist kan titta på innehållet i dokumentationen av programmeringsgränssnittet. Observera adressen, eftersom du kan använda den från &konqueror; samt inne i &tdevelop;, om du har ställt in den egna källkoden för &tdevelop; som projektet att arbeta med. Du ser troligen en mängd varningar och/eller felmeddelanden under tiden programmeringsgränssnittet byggs av Doxygen. Det är bäst att ignorera dem. De är bara av intresse för utvecklare av &tdevelop;. Om programmeringsgränssnittet väl skapats med lyckat resultat, blir dess .html-filer användbara.