Opprette en Ant-byggefil som en 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 la den 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="."/>
             
    </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å flippen Hoved klikker du på Byggefil Bla gjennom arbeidsområdet... og definerer Plassering som byggefilen projectBuilder.xml 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å flippen Oppdater ønsker vi å sørge for at når HelloWorld.jar er opprettet ser vi det i Eclipse. Standard er at ingen oppdatering utføres når en prosjektbygger er ferdig, så du må merke av 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å flippen Mål velger du standardmålet.
  12. På flippen Byggealternativer kan du oppgi når denne prosjektbyggeren skal utføres. Standardvalget er Etter en "opprydding" og Under manuelle bygginger. Det er også mulig å kjøre prosjektbyggeren under automatiske bygginger, men dette anbefales ikke på grunn av ytelseshensyn.
    Byggealternativer-flipp i Eksterne verktøy-dialogboks
  13. Bruk endringene og klikk på OK.
  14. Tilbake i dialogboksen med prosjektegenskaper vil du se en prosjektbygger kalt 'Makejar' som skal kjøres etter standard Java Builder. Klikk på OK for å lagre prosjektbyggeren og lukke dialogboksen.
    Merk:
    Du kan endre rekkefølgen slik at Ant-byggefilen kjøres før Java Builder, men det ville vært meningsløst i dette eksempelet.
    Dialogboks med prosjektegenskaper

Java Builder kjører den interne Eclipse Java-kompilatoren, som igjen er ansvarlig for indeksering av kilden, slik at søkefunksjonen 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 Builder og styre når Java Builder skal kjøres i forhold til prosjektbyggerne du definerer.