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 käsky 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="bin"/>
    </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ä nimeksi Makejar. Valitse päävälilehdestä vaihtoehdot 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 -päävälilehti

  10. Varmista nyt Verestä-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 alueen muuttujien 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 Päivitä-välilehti

  11. Kohteet-välilehdessä voit määrittää, milloin tämä projektien koontitoiminto ajetaan, ja ajon kohteet. Oletusarvon mukaan default-kohteeksi on asetettu ajo "Puhdistuksen" jälkeen ja Manuaalinen koonti. Voit määrittää muita kohteita ja muita liipaisimia. Voit ajaa projektien koontitoiminnon automaattisten koontien aikana, mutta sitä ei suositella suoritustehorajoitteiden vuoksi. Lisätietoa koontityypeistä löytyy täältä.

    Ulkoiset työkalut -valintaikkunan Kohteet-välilehti

  12. Tee muutokset ja napsauta OK-painiketta.
  13. Kun olet palannut projektin ominaisuuksien valintaikkunaan, 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ä niin, että Ant-koontitiedosto ajetaan ennen Java-koontitoimintoa, mutta se ei ole mielekästä tässä esimerkissä.

    Projektin ominaisuudet -valintaikkuna

Java-koontitoiminto ajaa sisäisen Eclipse Java -kääntäjän, joka indeksoi lähteen 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äärittää, ajetaanko se ennen määritettyjä projektien koontitoimintoja vai niiden jälkeen.

Aiheeseen liittyviä tehtäviä
Ant-koontitiedostojen luonti
Projektin koontitoiminnon Ant-kohteet
Ant-koontitiedostojen muokkaus
Ant-asetusten tallennus ja käyttö uudelleen
Ant-koontitiedostojen ajo
Projektin koontitoimintoina käytettävät Ant-koontitiedostot
Projektin koontitoimintojen suoritus
Ulkoiset työkalut
Muut projektin koontitoiminnot kuin ant-koontitiedostot
Itsenäiset ulkoiset työkalut