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.
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:
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.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.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:
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:
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 |
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:
${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/*