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.
- Opprett et Java-prosjekt kalt 'HW'.
- Opprett en Java-kildefil kalt 'HelloWorld' med en hovedmetode.
- Legg inn en 'System.out.println()'-setning i hovedmetoden og la den skrive
ut en hilsen du selv velger.
- Lagre endringene.
- 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>
- I en av navigeringsvisningene velger du HW-prosjektet og deretter Egenskaper
fra hurtigmenyen.
- I dialogboksen med prosjektegenskaper velger du Byggere og klikker på Ny(tt)....
- I dialogboksen Velg konfigureringstype velger du
Ant-bygging og klikker på OK.
- 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.
- 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.
- På flippen Mål velger du standardmålet.
- 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.
- Bruk endringene og klikk på OK.
- 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.
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.