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.
- Luo Java-projekti "HW".
- Luo Java-lähdetiedosto "HelloWorld", jolla on päämetodi.
- Kirjoita päämetodiin lause "System.out.println()" ja tulosta sen avulla haluamasi tervehdys.
- Tallenna muutokset.
- 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>
- Valitse HW-projekti jossakin siirtymisnäkymässä ja valitse sen pikavalikosta vaihtoehto
Ominaisuudet.
- Valitse projektin ominaisuuksien valintaikkunassa vaihtoehto Koontitoiminnot ja napsauta
sitten Uusi...-painiketta.
- Valitse Kokoonpanolajin valinta -valintaikkunassa vaihtoehto Ant-koonti ja napsauta OK-painiketta.
- 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.
- 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.
- Oletuskohteen pitäisi olla nyt valittuna Kohteet-välilehdessä.
- 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.
- Tee muutokset ja napsauta OK-painiketta.
- 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ä.
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.