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.
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ä:
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.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.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ä:
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:
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 |
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:
${buildDirectory}/features/org.foo.rootfile.feature/rootfiles/*
/build.properties : root = rootfiles
${buildDirectory}/build.properties: featureList = org.foo.rootfile.feature
${buildDirectory}/build.properties: generatedBuildProperties = ${buildDirectory}/root.properties
${buildDirectory/root.properties: root = absolute:${buildDirectory}/rootfiles
${buildDirectory}/rootfiles/*