Tiedostojen lisäys koonnin juureen

Juuritiedostot ovat tiedostoja, jotka on pakattava Eclipse-asennuksen mukaan, mutta jotka eivät ole tuoteominaisuuksia eivätkä lisäosia. Esimerkkejä juuritiedostoista ovat eclipse-ohjelmatiedostot ja ini-tiedostot sekä lisenssitiedostot.
Juuritiedostot siirtyvät koontiin tuoteominaisuuksista, jotka sisältävät tarvittavat juuriominaisuudet.

Juuritiedostojen ominaisuudet

root
Määritä pilkuin eroteltu luettelo tiedostoista tai kansioista, jotka sisällytetään kaikkiin koottaviin kokoonpanoihin.
Suhteelliset polut liittyvät tuoteominaisuuteen, johon ne sisältyvät. Voit määrittää tiedoston käyttämällä komentoa "file:" ja käyttää absoluuttista polkua käyttämällä komentoa "absolute:".
Esimerkkejä:
  • root=rootfiles: Kansion suhteellinen polku, kansion sisältö sisällytetään
  • root=file:license.html,licenses: license.html-tiedoston suhteellinen polku ja licenses-kansion suhteellinen polku
  • root=absolute:/eclipse/rootfiles: Kansion tarkka polku, kansion sisältö sisällytetään
  • root=absolute:file:/eclipse/about.html,file:lib/*.so*: "about.html"-tiedoston sisällytyksen tarkka polku sekä lib-kansion kaikkien *.so*-tiedostojen sisällytyksen suhteellinen polku.

Jokaisesta pilkuin erotetusta merkinnästä tulee ant-tiedostoryhmä. Jos merkintä viittaa kansioon, kyseinen kansio on tiedostoryhmän dir-parametri ja includes-parametrina käytetään merkkijonoa **. Jos merkintä on tiedosto, tiedoston sisältävästä hakemistosta tulee dir-parametri ja tiedosto määritetään includes-parametrissa.

Ominaisuutta ${baseDir} käytetään hakemistossa kaikkien suhteellisten tiedostojen osalta. Tämä ${baseDir}-ominaisuus on tuoteominaisuuden juurihakemisto, johon luotu build.xml-tiedosto sijoitetaan.

root.<config>
Määritä luettelo annettuun kokoonpanoon sisällytettävistä tiedostoista tai kansioista. Tässä määritettävien kokoonpanojen on vastattava koonnin configs-ominaisuudessa olevia kokoonpanoja. Suhteelliset polut liittyvät tuoteominaisuuteen, johon ne sisältyvät. root-ominaisuudessa käytettävät file:- ja absolute:-etuliitteet pätevät myös tässä.
Esimerkkejä:
  • root.win32.win32.x86=rootfiles: Kansion suhteellinen polku, kansion sisältö sisällytetään win32.win32.x86-kokoonpanoon
  • root.linux.gtk.x86=absolute:file:about.html: Tiedoston suhteellinen polku, tiedosto sisällytetään linux.gtk.x86-kokoonpanoon.
root.folder.<subfolder>

root.<config>.folder.<subfolder>
Samankaltainen kuin ominaisuudet "root" ja "root.<config>", mutta tiedostoja ja kansioita ei kopioida eclipse-asennuksen juurihakemistoon, vaan määritettyyn alikansioon.
Suhteelliset polut liittyvät tuoteominaisuuteen, johon ne sisältyvät. root-ominaisuudessa käytettävät file:- ja absolute:-etuliitteet pätevät myös tässä.
Esimerkkejä:
  • root.folder.docs/html=html_files: Tuoteominaisuuden "html_files"-kansion sisältö kopioidaan eclipse-asennuksen docs/html-kansioon.
  • root.linux.gtk.x86.folder.jre=absolute:/build/jres/linux: Tarkka polku, /build/jres/linux-kansion sisältö kopioidaan eclipse-asennuksen jre-kansioon.
PDE/käyttöliittymä käyttää näitä ominaisuuksia, kun vietävässä .product-tiedostossa on määritetty JRE-ympäristö. PDE/koonti ei tällä hetkellä tue JRE-ympäristön sisällytystä .product-tiedostoon, ja nämä ominaisuudet olisi määritettävä tuoteominaisuudessa JRE-ympäristön sisällyttämiseksi näyttöpäätteettömään tuotekoontiin.
root.permissions.<rights>

root.<config>.permissions.<rights>
Määritä luettelo tiedostoista, joissa ant chmod -tehtävä ajetaan. Tämän ominaisuuden arvo välittyy ant chmod -tehtävälle "includes"-parametrina. Tällöin yleismerkin sisältäviä ant-malleja voi käyttää.
Esimerkkejä:
  • root.permissions.755=eclipse: Määritä eclipse-tiedostolle suoritusoikeudet.
  • root.linux.gtk.x86.permissions.755=lib/**: Määritä kaikki lib-hakemiston tiedostot suoritettaviksi

Ominaisuuden <rights>-osa välittyy ant chmod -tehtävälle "perm"-parametrina. Jos kokoonpanon lopullinen arkistomuoto on antTar, <rights>-muoto välittyy myös ant tar -tiedostoryhmälle "filemode"-parametrina. Sama koskee antZip- ja zip-tiedostoryhmiä. Vaikka ant chmod -tehtävä tukee esimerkiksi "og-rwx"-oikeuksia (muut kuin omistajat eivät voi käsitellä tiedostoa), tar- ja zip-tiedostoryhmät tukevat vain kolminumeroisia oktaalimuotoisia merkkijonoja.
root.link

root.<config>.link
Luettele pareittain (pilkuin erotettuna) symbolisesti linkitettävät tiedostot ja kansiot. Parin ensimmäinen merkintä on kohde ja toinen merkintä on linkin nimi.
Esimerkki:
  • root.macosx.carbon.ppc.link=Eclipse.app/Contents/MacOS/eclipse,eclipse: macosx.carbon.ppc-kokoonpanoon luodaan joustava linkki juureen nimeltä "eclipse", joka osoittaa "Eclipse.app/Contents/MacOS/eclipse"-tiedostoon.

Tämän tuloksena on ant exec -tehtävä, joka suorittaa "ln -sf" -komennon. Kun annetaan arvo"targetA, nameA, targetB, nameB, targetC, nameC", järjestelmä suorittaa joukon "ln"-komentoja kansiossa, johon eclipse-juuritiedostot kerätään:
		ln -sf targetA nameA
ln -sf targetB nameB
ln -sf targetC nameC

Juuritiedostojen sisällytys tuotteen koontiin

Käytettäessä tuoteominaisuuksiin perustuvaa .product-tiedostoa tuotteeseen voidaan lisätä juuritiedostoja määrittämällä edellä mainitut juuritiedostojen ominaisuudet missä tahansa sisällytetyssä tuoteominaisuudessa.

Tuoteominaisuus on mahdollista sisällyttää pelkästään juuritiedostojen takia. Jos juuritiedosto-tuoteominaisuus ei määritä bin.includes-ominaisuutta build.properties-tiedostossaan, sitä ei sisällytetä lopullisiin koontituloksiin, mutta sen tarjoamat juuritiedostot sisällytetään niihin.

Kun .product-tiedosto perustuu tuoteominaisuuksien asemesta lisäosiin, koontiin voi silti lisätä juuritiedostoja. Tuotteen koonnissa PDE/koonti muodostaa automaattisesti säilötuoteominaisuuden, joka sisältää kaikki .product-tiedostossa määritetyt lisäosat (katso eclipse.generateFeature-tehtävää). Tuotteen koontiin voi lisätä juuritiedostoja kahdella eri tavalla: