Opret Ant-byggefil til projektbyggeprogram
For at se, hvordan projektbyggeprogrammer fungerer, skal vi oprette et enkelt projekt med en enkelt kildefil og en Ant-byggefil, der opretter .jar-filer ud fra den enkelte klassefil. Dette eksempel bruger Java, men der er også projektbyggeprogrammer for alle andre typer projekter.
- Opret et Java-projekt, der hedder "HV".
- Opret en Java-kildefil, der hedder "HelloWorld", med en overordnet metode.
- Anbring et enkelt "System.out.println()"-udtryk i den overordnede metode, og lad det udskrive en hilsen, du selv vælger.
- Gem ændringerne.
- Opret en fil med navnet "Projektbyggeprogram.xml", åbn filen i Ant-editoren, indtast følgende indhold, og gem ændringerne.
<?xml version="1.0" encoding="UTF-8"?>
<project name="HW.makejar" default="makejar" basedir=".">
<target name ="makejar" description="Opret en jar til HW-projektet">
<jar jarfile="HelloWorld.jar" inkluderer="*.class" basedir="."/>
</target>
</project>
- Vælg HV-projektet i en af navigationsoversigterne, og vælg Egenskaber på kontekstmenuen.
- Vælg Byggeprogrammer i projektets egenskabsdialogboks, og klik derefter på Ny....
- Vælg Ant-byg i dialogboksen Vælg konfigurationstype, og klik på OK.
- Dialogboksen Eksterne værktøjer vises. Angiv navnet til "Opretjar". Klik på Byggefil på skillebladet Overordnet, klik på Gennemse arbejdsområde, og angiv Placering til den Projektbyggeprogram.xml-byggefil, du oprettede ovenfor. Klik derefter på Basisbibliotek, Gennemse arbejdsområde..., og angiv, at basisbiblioteket skal være HV-projektet.
- På skillebladet Opfrisk vil vi kontrollere, at vi kan se vores HelloWorld.jar i Eclipse, når vi har oprettet den. Som standard sker der ingen genopfriskning, når et projektbyggeprogram er udført, så markér Opfrisk ressourcer efter afslutning, og vælg derefter Projektet, der indeholder den valgte ressource på listen over omfangsvariabler. Da det kan tage lang tid at opfriske, bør du generelt kun opfriske det element, der indeholder alle de ressourcer, som påvirkes af byggefilen.
- På skillebladet Mål bør standardmålet være valgt.
- På skillebladet Indstillinger for bygning kan du angive, hvornår dette projektbyggeprogram udføres. Som standard er det angivet til Efter en "oprydning" og Under manuelle bygninger. Det er muligt at udføre projektbyggeprogrammet under automatiske bygninger, men det kan ikke anbefales, da det går langsomt.
- Anvend ændringerne, og klik på OK.
- Tilbage i dialogboksen med projektegenskaber kan du nu se et projektbyggeprogram med navnet "Opretjar", der er indstillet til at køre efter Java-standardbyggeprogrammet. Klik på OK for at gemme projektbyggeprogrammet og lukke dialogboksen.
Bemærk: Du kan ændre rækkefølgen, så Ant-byggefilen kører før Java-byggeprogrammet. Det vil dog ikke give mening i dette eksempel.
Java-byggeprogrammet udfører den interne Java-compiler i Eclipse, som er ansvarlig for indeksering af kilden, så søgning, refactoring og mange andre funktioner er tilgængelige. Det er derfor ikke muligt at erstatte den interne Java-compiler i Eclipse med et projektbyggeprogram. Du kan deaktivere Java-byggeprogrammet, og du kan styre, hvornår Java-byggeprogrammet kører i forhold til de projektbyggeprogrammer, du definerer.