Projektien koontitoimintona käytettävän Ant-koontitiedoston luonti

Projektien koontitoimintojen käytön havainnollistamiseksi luodaan yksinkertainen projekti, johon kuuluu yksi lähdetiedosto ja Ant-koontitiedosto, joka arkistoi luokkatiedoston. Vaikka tässä esimerkissä käytetään Java-kieltä, huomaa, että projektien koontitoimintoja voi käyttää Java-projektien lisäksi myös kaikkien muiden projektien koontiin.

  1. Luo Java-projekti "HW".
  2. Luo Java-lähdetiedosto "HelloWorld", jolla on päämetodi.
  3. Kirjoita päämetodiin lause "System.out.println()" ja tulosta sen avulla haluamasi tervehdys.
  4. Tallenna muutokset.
  5. Luo tiedosto "projectBuilder.xml" ja avaa se Ant-muokkausohjelmassa. Kirjoita sitten seuraava sisältö ja tallenna muutokset.
    <?xml version="1.0" encoding="UTF-8"?>
       <project name="HW.makejar" default="makejar" basedir=".">
       
          <target name ="makejar" description="Jar-tiedoston luonti HW-projektiin">
          
             <jar jarfile="HelloWorld.jar" includes="*.class" basedir="."/>
             
    </target>
          
    </project>
  6. Valitse HW-projekti jossakin siirtymisnäkymässä ja valitse sen pikavalikosta vaihtoehto Ominaisuudet.
  7. Valitse projektin ominaisuuksien valintaikkunassa vaihtoehto Koontitoiminnot ja napsauta sitten Uusi...-painiketta.
  8. Valitse Kokoonpanolajin valinta -valintaikkunassa vaihtoehto Ant-koonti ja napsauta OK-painiketta.
  9. Ulkoiset työkalut -valintaikkuna tulee näyttöön. Määritä nimi "Makejar". Valitse päävälilehdestä Koontitiedosto > Selaa työtilaa... ja määritä Sijainti-kenttään aiemmin luomasi koontitiedosto "projectBuilder.xml". Valitse sitten Päähakemisto > Selaa työtilaa... ja määritä päähakemistoksi HW-projekti.
    Ulkoiset työkalut -valintaikkunan päävälilehti
  10. Varmista nyt Verestys-välilehdestä, että luotu tiedosto "HelloWorld.jar" näkyy Eclipsessä. Oletusarvoisesti verestystä ei tehdä, kun projektin koontitoiminnon ajo päättyy, joten valitse vaihtoehto Verestä resurssit valmistumisen jälkeen ja valitse aluemuuttujien luettelosta vaihtoehto Valitun resurssin sisältävä projekti. Koska verestys saattaa vaatia paljon tehoa, kannattaa verestää vain sellaiset resurssit, joihin koontitiedosto vaikuttaa.
    Ulkoiset työkalut -valintaikkunan Verestys-välilehti
  11. Oletuskohteen pitäisi olla nyt valittuna Kohteet-välilehdessä.
  12. Koonnin asetukset -välilehdessä voit määrittää, milloin tämä projektien koontitoiminto ajetaan. Oletusarvoisesti valittuna ovat asetukset "Puhdistuksen" jälkeen ja Manuaalisten koontien aikana. Voit ajaa projektien koontitoiminnon automaattisten koontien aikana, mutta sitä ei suositella suoritustehorajoitteiden vuoksi.
    Ulkoiset työkalut -valintaikkunan Koonnin asetukset -välilehti
  13. Tee muutokset ja napsauta OK-painiketta.
  14. Kun olet taas projektin ominaisuuksien valintaikkunassa, näet siinä projektien koontitoiminnon "Makejar", joka on määritetty ajettavaksi oletusarvoisen Java-koontitoiminnon jälkeen. Tallenna projektien koontitoiminto napsauttamalla OK-painiketta ja sulje valintaikkuna.
    Huomautus:
    Voit muuttaa järjestystä siten, että Ant-koontitiedosto ajetaan ennen Java-koontitoimintoa, mutta se ei kannata tässä esimerkissä.
    Projektin ominaisuudet -valintaikkuna

Java-koontitoiminto ajaa sisäisen Eclipse Java -kääntäjän, joka hakemistoi lähteesi haku- ja koodinparannustoimintoja sekä monia muita toimintoja varten. Siten et voi korvata sisäistä Eclipse Java -kääntäjää projektien koontitoiminnolla. Voit poistaa Java-koontitoiminnon käytöstä ja määrätä, ajetaanko se ennen määrittämiäsi projektien koontitoimintoja vai niiden jälkeen.