forrigeBygge og projekthåndtering  næste

Brug af Håndtering af automake

I dette kapitel finder du en grundlæggende beskrivelse af elementerne i Håndtering af automake, og hvordan de bruges. Dette dækker:

Vinduet Håndtering af automake

  • Håndtering af automake bruger et delt vindue. Den øverste del kaldes Oversigtsvinduet og den nederste del kaldes Detaljevinduet. Mellem dem er en smal linje som kan trækkes med musen for at justere vinduestørrelserne. I IDEA-vinduestilstand kan du også trække sidekanten på det delte vinduet for at ændre bredden.

  • Ovenfor hvert vindue er der en værktøjslinje, hvor knapperne bliver aktive når et element i vinduet markeres. Dette tilbyder en måde at få adgang til handlingerne som der sørges for for dette element. Det andet sæt er sammenhængsafhængige menuer, som dukker op ved klik med højre museknap som beskrevet nedenfor.

  • I IDEA-vinduetilstand er der yderligere to små knapper til venstre i navnelisten på vinduet Håndtering af automake—en trekantformet højrepil, og en knap med en prik. Pileknappen bruges til at lukke for vinduet. Prikknappen på den anden side, holder vinduet åbent også selvom om et andet vindue vælges i KDevelop. (Ellers lukkes vinduet Håndtering af automake automatisk så snart et andet vindue får indtastningsfokus.)

Oversigtsvinduet

Oversigtsvinduet indeholder en træliste med alle mapper i projektet som indeholder programfiler, dokumentation eller data. Hver sådan mappe indeholder en fil Makefile.am og er kendt som et delprojekt i Håndtering af automake. Der er tre typiske delprojekter i et KDE-baseret projekt, som vises på billedet ovenfor:

  • src: kildekodefiler for programmet,

  • doc: brugermanualen eller håndbogen,

  • po—uddrag af strenge i dine kildekodefiler som kræver oversættelse til andre menneskelige sprog (f.eks. vinduestitler, menunavne, navne på knapper, tekst i dialoger og meddelelser af forskellige slags).

Bemærk at delprojektet doc altid har et delprojekt som hedder en, som du kan se hvis du klikker på symbolet + før ordet doc. Dette skyldes at grundsproget for al dokumentation i KDE er amerikansk engelsk (en). Hvis programmet bliver en del af KDE, kan KDE's oversættelsesgrupper oversætte din dokumentation fra engelsk til andre sprog, og oversættelserne havner så i andre delprojekter, såsom da (dansk), de (tysk) eller fr (fransk). Strengene i delprojektet po kan også oversættes og opbevares i andre filer under po, for på den måde at lade programmet bruges af personer som ikke kan engelsk.

Bemærk

Delprojekterne doc og po tjener forskellige formål. doc indeholder dokumentation, såsom en brugerhåndbog, mens po indeholder tekststrenge som kan oversættes fra brugergrænsefladen som indgår i programmets kildekode.

Oversigtsvinduet virker—blandt andet—som et navigeringsværktøj. Hvis du vælger et delprojekt i oversigtsvinduet, vises tilsvarende detaljeret information i detaljevinduet.

Detaljevinduet

Detaljevinduet indeholder en liste med alle filer i delprojektet som for øjeblikket er markeret i oversigtsvinduet, samt kompilerings-, bygge- og installationsreglerne for delprojektet. På den måde kan vinduerne tilsammen give dig mulighed for at komme til alle komponenter i programmet, og al information om hvordan det skal kompileres, bygges og installeres.

Mål

Trælisten i detaljevinduet har to niveauer. Det øverste niveau består af såkaldte mål i Håndtering af automake, og næste niveau indeholder lister med filer som bruges for at oprette hvert mål.

Dette begreb med et mål i Håndtering af automake, adskiller sig noget fra hvad et mål i en Makefile som oftest er. I korthed:

  • Definitionen af hvordan et antal filer skal kompileres, bygges eller installeres er kendt som et mål i Håndtering af automake, men som en variabel i selve Automake.

  • Et mål i make er ofte noget helt andet, eftersom det kan være en parameter til kommandoen make (f.eks. make install, make clean).

    Visse af variablerne i Makefile.am repræsenterer dog et underliggende delmål for make.

Navigering i Håndtering af automake

Både i oversigtsvinduet og detaljevinduet kan du venstreklikke på + eller - foran et delprojekt eller målnavn for at udvide eller trække trævisningen sammen. Hvis du gør dette med et delprojekt i oversigtsvinduet, vises eller skjules delprojektets næste underliggende niveau (hvis der er et sådant). Hvis du gør dette med et mål i detaljevinduet, vises eller skjules listen med filer som indgår i målet.

Åbn en fil til redigering

Hvis du venstreklikker på et filnavn i detaljevinduet, åbnes den tilsvarende fil i KDevelops redigeringsvindue.

Aktivér værktøjslinjeknapperne i Håndtering af automake

Hvis du venstreklikker på et delprojektnavn i oversigtsvinduet eller et mål i detaljevinduet, markeres navnet og visse knapper i værktøjslinjen bliver aktive længst oppe i vinduet.

Bemærk

Du anbefales at bruge højre museknap og sammenhængsafhængige menuer, i stedet for knapperne i værktøjslinjen, eftersom det så er meget nemmere at se og forstå hvad du gør.

Handlinger for delprojekter og mål har langtvirkende effekter for struktur, kompilering, bygning og installation af programmet.

Vælg handlinger og sammenhængsafhængige menuer

Hvis du højreklikker på et delprojektnavn, mål eller fil, dukker en menu op og du kan derefter vælge handlinger at udføre for delprojektet, målet eller filen, såsom at tilføje et mål til delprojektet, tilføje en fil til målet eller logisk fjerne den markerede filen fra sit mål.

Sammenhængsafhængige menuer i Håndtering af automake

Følgende afsnit forklarer kortfattet hvilke handlinger som menuerne gør tilgængelige, som dukker op ved klik med højre museknap i vinduet Håndtering af automake. Afsnittene er kun beregnet som en oversigt. Du finder detaljerede beskrivelser af de fleste handlinger i et senere kapitel.

Sammenhængsafhængig menu for en fil

Når du højreklikker på et filnavn i detaljevinduet, dukker følgende menu op som lader dig vælge en af flere handlinger at udføre med filen. I billedet nedenfor, markeredes ikonfilen hi-16app-myapp.png i målet Ikondata i kde_icon fra delprojektet myapp/src.

  • Hovedpunktet i den sammenhængsafhængige menu er at Fjerne filen fra målet (dvs. den kommer ikke længere at blive brugt til at kompilere, bygge eller installere dette mål).

  • Punktet CVS tilbyder en hel del forskellige CVS-handlinger for filen.

  • Punktet Åbn med lader dig åbne filen med et antal editorer eller med et hvilket som helst program (f.eks. kan du åbne ikonfilen i vort eksempel med Kiconedit).

  • Punktet Perforce bruges til lignende handlinger som i CVS, men med det kommercielle versionshåndteringssystem “Perforce”.

Sammenhængsafhængig menu for et mål

Når du højreklikker på et mål i detaljevinduet, dukker følgende menu op som lader dig vælge en af flere handlinger at udføre med det. I billedetnedenfor, markeredes målet myapp (Program i bin) i delprojektet myapp/src.

  • Punktet Indstillinger for et mål gælder kun kildekodefiler. I den tilsvarende dialog kan du angive linkerflag og søgestier hvor biblioteker kan findes, og du kan angive en liste med egentlige biblioteker som skal linkes med i programmet.

  • Punktet Opret ny fil viser en dialog hvor du kan angive filnavnet og filtypen som skal laves (i et dropned-felt).

  • Punktet Tilføj eksisterende filer viser en dialog hvor du kan tilføje en eksisterende fil til målet.

  • Punktet Fjern for et mål lader dig logisk fjerne målet og alle dets filer fra projektstrukturen.

  • Punktet Gør mål aktivt gælder kun for mål som indeholder kildekodefiler. Nye filer tilføjes altid til et sådant aktivt mål.

  • Punktet Byg mål kalder alle nødvendige kompilerings- og byggehandlinger for at bygge koden kun for dette mål.

Sammenhængsafhængig menu for et delprojekt

Når du højreklikker på et delprojekt i oversigtsvinduet, dukker følgende menu op som lader dig gøre udføre ændringer i projektets struktur og måden det kompileres, bygges og installeres. Du kan bruge den til at udvide eller ændre den grundlæggende projektstruktur som programguiden har oprettet.

  • Punktet Indstillinger for et delprojekt styrer måden som delprojektet kompileres, bygges og installeres. Dialogen som dukker op har fanblade for Oversætter, Deklarationsfiler, Præfiks og Byggerækkefølge.

  • Punktet Tilføj delprojekt laver en ny mappe og Makefile.am skeletfil.

  • Punktet Tilføj mål viser en dialog, hvor du kan indstille regler for kompilering, bygning eller installation for en filgruppe inde i delprojektet.

  • Tilføj tjeneste (... endnu ikke skrevet ...)

  • Tilføj program (... endnu ikke skrevet ...)

  • Tilføj eksisterende delprojekt (... endnu ikke skrevet ...)

  • Punktet Fjern delprojekt i den sammenhængsafhængige menu for et delprojekt er den rigtige måde at fjerne et delprojekt. Det justerer filerne Makefile.am på tilsvarende måde. Du tilbydes også mulighed at fjerne alle filer (eller link) i de tilsvarende undermappe. Det er klart at funktionen skal bruges med forsigtighed.

  • Punktet Byg kalder alle nødvendige kompilerings- og byggehandlinger for at bygge koden kun for dette delprojekt.

  • Påtving omredigering (... endnu ikke skrevet ...)

  • Ryd (... endnu ikke skrevet ...)

  • Installér (... endnu ikke skrevet ...)

  • Installér (som systemadministrator) (... endnu ikke skrevet ...)

forrigehjemnæste
Bygge og projekthåndtering op Automake-projekt