Fájlok hozzáadása egy összeépítés gyökeréhez

A gyökérfájlok olyan fájlok, amelyeket együtt kell csomagolni egy Eclipse telepítéssel, de nem szolgáltatások vagy bedolgozók. Tipikus példák az Eclipse végrehajtható és ini fájlok, valamint a licenckezelési fájlok.
A gyökérfájlokat a megfelelő gyökértulajdonságokat tartalmazó szolgáltatások adják hozzá az összeépítéshez.

Gyökérfájl tulajdonságai

root
Megadja az összes fájl vagy mappa vesszővel elválasztott listáját, amelyeknek szerepelniük kell valamennyi összeépítendő konfigurációban.
A relatív útvonalak a tartalmazó szolgáltatáshoz képest vannak megadva. A "file:" elem segítségével egy fájlt, az "absolute:" elem segítségével egy abszolút útvonalat adhat meg.
Példák:
  • root=rootfiles: Egy mappa relatív útvonala, a mappa tartalmát is beleértve
  • root=file:license.html,licenses: Egy "license.html" fájl és a "licenses" mappa relatív útvonala
  • root=absolute:/eclipse/rootfiles: Egy mappa abszolút útvonala, beleértve a mappa tartalmát
  • root=absolute:file:/eclipse/about.html,file:lib/*.so*: Az "about.html" fájl abszolút útvonala, valamint egy relatív útvonal, amely tartalmazza a lib mappa alatt található összes *.so* fájlt.

Minden vesszővel elválasztott bejegyzésből készül egy ant fájlkészlet. Ha a bejegyzés egy mappára vonatkozik, akkor a mappa a fájlkészlet "dir" paramétere lesz, és az "includes" paraméter értékeként "**" lesz megadva. Ha a bejegyzés egy fájl, akkor a fájlt tartalmazó könyvtár lesz a "dir" paraméter, és a fájl lesz megadva az "includes" paraméterben.

Az összes relatív fájlhoz a ${baseDir} tulajdonság kerül felhasználásra a könyvtárban. Ez a ${baseDir} tulajdonság lesz a szolgáltatás gyökérkönyvtára, ahová az előállított build.xml fájl kerül majd.

root.<konfiguráció>
Megadja a fájlok vagy mappák vesszővel elválasztott listáját, amelyet az adott konfigurációnak tartalmaznia kell. Az itt megadott konfigurációknak meg kell felelni az összeépítés configs tulajdonságában megadott konfigurációkkal. A relatív útvonalak a tartalmazó szolgáltatáshoz képest vannak megadva. A "root" tulajdonságban használt "file:" és "absolute:" előtagok itt is érvényesek.
Példák:
  • root.win32.win32.x86=rootfiles: Egy mappa relatív útvonala; a mappa tartalmát a win32.win32.x86 konfiguráció tartalmazza
  • root.linux.gtk.x86=absolute:file:about.html: Egy fájl abszolút útvonala, amelyet a linux.gtk.x86 konfigurációnak kell tartalmaznia.
root.folder.<almappa>

root.<config>.folder.<almappa>
Hasonló a "root" és a "root.<konfiguráció>" tulajdonságokhoz, kivéve, hogy a fájlok és mappák másolása nem az Eclipse telepítés gyökérkönyvtárába történik, hanem a megadott almappába.
A relatív útvonalak a tartalmazó szolgáltatáshoz képest vannak megadva. A "root" tulajdonságban használt "file:" és "absolute:" előtagok itt is érvényesek.
Példák:
  • root.folder.docs/html=html_files: A szolgáltatás "html_files" mappája az Eclipse telepítés docs/html mappájába lesz átmásolva.
  • root.linux.gtk.x86.folder.jre=absolute:/build/jres/linux: Egy abszolút útvonal; a /build/jres/linux mappa tartalma az Eclipse telepítés gyökérkönyvtárába lesz átmásolva.
Ezeket a tulajdonságokat a PDE felhasználói felület bedolgozó használja, amikor a .product fájlban meg van jelölve exportálásra egy JRE környezet. A PDE összeépítés bedolgozó jelenleg nem támogatja egy JRE befoglalását a .product fájl segítségével, és ezeket a tulajdonságokat egy bemenő szolgáltatásban (feature-in) kell megadni, hogy tartalmazzon egy JRE környezetet egy megjelenítés nélküli összeépítésben.
root.permissions.<jogok>

root.<konfiguráció>.permissions.<jogok>
Megadja a fájlok listáját, amelyeken az ant chmod feladatot futtatni kell. A tulajdonság értéke "includes" paraméterként át lesz adva az ant chmod feladatnak. Ez azt jelenti, hogy használhatók az ant helyettesítő karakterek.
Példák:
  • root.permissions.755=eclipse: Beállítja az 'eclipse' fájlt, hogy végrehajtható jogai legyenek.
  • root.linux.gtk.x86.permissions.755=lib/**: Beállítja a lib könyvtár alatt lévő összes fájlt végrehajthatóra.

Valójában a tulajdonság <jogok> része lesz átadva az ant chmod feladatnak, a "perm" paraméterként. Ha a konfiguráció végleges archívum formátuma antTar, akkor a <jogok> formátuma át lesz adva egy ant tar fájlkészletként "filemode" paraméterként. Hasonlóképpen történik az antZip és a zip fájlkészlet esetében is. Míg az ant chmod feladat támogatja az olyan engedélyeket, mint az "og-rwx" (a fájlhoz csak a tulajdonosok férhetnek hozzá), a tar és zip fájlkészletek csak 3 számjegyből álló oktális karaktersorozatokat támogatnak.
root.link

root.<konfiguráció>.link
Felsorolja (vesszővel elválasztva) a fájl és mappa párokat, amelyeket szimbolikusan össze kell kapcsolni. A pár első bejegyzése a cél, a második bejegyzés a hivatkozás neve.
Példa:
  • root.macosx.carbon.ppc.link=Eclipse.app/Contents/MacOS/eclipse,eclipse: A macosx.carbon.ppc konfigurációban létrehoz egy szimbolikus hivatkozást az "eclipse" nevű gyökérkönyvtárban, amely az "Eclipse.app/Contents/MacOS/eclipse" fájlra mutat.

Ez egy ant exec feladatot eredményez, amely végrehajt egy "ln -sf" parancsot. Ha az érték "célA, névA, célB, névB, célC, névC", akkor az Eclipse gyökérfájlok összegyűjtésére szolgáló mappában a következő "ln" parancsok lesznek végrehajtva:
		ln -sf célA névA
ln -sf célB névB
ln -sf célC névC

Gyökérfájlok hozzáadása egy termék összeépítéshez

A szolgáltatásokon alapuló .product fájl használata esetén a gyökérprofilokat a termékhez úgy lehet hozzáadni, hogy egyszerűen megadja a fenti gyökérfájl tulajdonságokat bármely tartalmazott szolgáltatásban.

Egy szolgáltatást egyedül abból a célból is bele lehet foglalni az összeépítésbe, hogy biztosítsa a gyökérfájlokat. Ha ez a "rootfile" (gyökérfájl) szolgáltatás nem ad meg egy "bin.includes" tulajdonságot a build.properties fájljában, akkor maga nem kerül be a végleges összeépítési eredmények közé, de az általa biztosított gyökérfájlok igen.

Ha a .product fájl szolgáltatások helyett bedolgozókon alapul, a gyökérfájlokat akkor is hozzá lehet adni az összeépítéshez. Egy termék összeépítésben a PDE összeépítés bedolgozó automatikusan előállít egy tároló szolgáltatást, amely tartalmazza a .product fájlban meghatározott összes bedolgozó (lásd az eclipse.generateFeature feladatot). A termék összeépítéshez kétféleképpen lehet hozzáadni gyökérfájlokat: