Opprette en Ant-byggefil som prosjektbygger

For å vise hvordan prosjektbyggere fungerer skal vi opprette et enkelt prosjekt med én kildefil og en Ant-byggefil som lager en jar-fil av klassefilen. Dette eksempelet bruker Java, men vær oppmerksom på at prosjektbyggere er tilgjengelig for alle prosjekter, både Java-prosjekter og andre.

  1. Opprett et Java-prosjekt kalt HW.
  2. Opprett en Java-kildefil kalt HelloWorld med en hovedmetode.
  3. Legg inn en System.out.println()-setning i hovedmetoden, og få den til å skrive ut en hilsen du selv velger.
  4. Lagre endringene.
  5. Opprett en fil kalt projectBuilder.xml, åpne Ant-redigeringsprogrammet for den, legg inn følgende innhold, og lagre endringene.
    <?xml version="1.0" encoding="UTF-8"?>
    <project name="HW.makejar" default="makejar" basedir=".">
      <target name ="makejar" description="Create a jar for the HW project">
        <jar jarfile="HelloWorld.jar" includes="*.class" basedir="bin"/>
      </target>
    </project>
    
  6. I en av navigeringsvisningene velger du HW-prosjektet og deretter Egenskaper fra hurtigmenyen.
  7. I dialogboksen med prosjektegenskaper velger du Byggere og klikker på Ny(tt)....
  8. I dialogboksen Velg konfigureringstype velger du Ant-bygging og klikker på OK.
  9. Dialogboksen Eksterne verktøy blir vist. Definer navnet som Makejar. På siden Hoved klikker du på Byggefil Bla gjennom arbeidsområdet... og definerer Plassering som byggefilen projectBuilder.xml som ble opprettet ovenfor. Deretter klikker du på Hovedkatalog Bla gjennom arbeidsområdet... og definerer hovedkatalogen som HW-prosjektet.

    Hoved-flipp i Eksterne verktøy-dialogboks

  10. På siden Oppdater ønsker vi å sørge for at når HelloWorld.jar opprettes, vises det i Eclipse. Standard er at ingen oppdatering utføres når en prosjektbygger er ferdig, så du må merke av for Oppdater ressurser ved fullføring og deretter velge Prosjektet som inneholder den valgte ressursen på listen over omfangsvariabler. Siden en oppdatering kan være en dyr operasjon, bør du vanligvis bare oppdatere den minste entiteten som inneholder alle ressursene som vil bli påvirket av byggefilen.

    Oppdater-flipp i Eksterne verktøy-dialogboks

  11. På siden Mål kan du oppgi når denne prosjektbyggeren skal utføres, og på hvilke mål. Som standard defineres standardmålet til å kjøres etter en "opprydding" og en manuell bygging. Du kan oppgi andre mål og andre utløsere. Det er også mulig å kjøre prosjektbyggeren under automatiske bygginger, men dette anbefales ikke på grunn av ytelseshensyn. Du finner mer informasjon om byggetypene her.

    Mål-flipp i Eksterne verktøy-dialogboks

  12. Bruk endringene og klikk på OK.
  13. Tilbake i dialogboksen med prosjektegenskaper vil du se en prosjektbygger kalt Makejar som skal kjøres etter standard Java-bygger. Klikk på OK for å lagre prosjektbyggeren og lukke dialogboksen.
    Merk: Du kan endre rekkefølgen slik at Ant-byggefilen kjøres før Java-bygger, men det ville være meningsløst i dette tilfellet.

    Dialogboks med prosjektegenskaper

Java-bygger kjører den interne Eclipse Java-kompilatoren, som igjen er ansvarlig for indeksering av kilden, slik at søke- og refaktoriseringsfunksjonen og mange andre funksjoner er tilgjengelige. Det er derfor ikke mulig å erstatte den interne Eclipse Java-kompilatoren ved å bruke en prosjektbygger. Du kan deaktivere Java-bygger og styre når Java-bygger skal kjøres i forhold til prosjektbyggerne du definerer.

Beslektede oppgaver
Opprette Ant-byggefiler
Ant-mål for prosjektbygger
Redigere Ant-byggefiler
Lagre og gjenbruke Ant-alternativer
Kjøre Ant-byggefiler
Ant-byggefiler som prosjektbyggere
Utføre prosjektbyggere
Eksterne verktøy
Prosjektbyggere som ikke er basert på Ant
Frittstående eksterne verktøy