Összeépítési konfiguráció
Az összeépítési mechanizmust egy összeépítési konfiguráció vezérli. Egy
egyéni bedolgozó, töredék vagy szolgáltatás összeépítési konfigurációja a megfelelő
elem build.properties fájljában található.
A PDE projektlétrehozási varázslók a bedolgozó projektek létrehozásakor
állítják elő a build.properties fájlt. A fájl arról tartalmaz
információkat, hogyan kell a forrásmappákat JAR-fájlokra fordítani. Ezeket az
információkat közvetetten frissítheti a leírásszerkesztő Futási környezet lapján. A
megfelelő szerkesztő segítségével közvetlenül is módosítható.
A PDE egy formátum- és forrásnézeteket tartalmazó egyszerű szerkesztőt biztosít a
build.properties fájlhoz.
A fájl maga a Java tulajdonságfájlok formátumát követi. Meg kell adnia néhány
kulcsot és a megfelelő értéküket. Több értéket a vessző határol el egymástól.
Általános tulajdonságok
- bin.includes - felsorolja azokat a fájlokat, amelyeket az
összeépítendő bedolgozó bináris változata tartalmazni fog.
- bin.excludes - a bináris összeépítésből kizárandó fájlokat sorolja fel;
- qualifier - ha az elem verziószámának végződése .qualifier, ez
jelzi, hogy a ".qualifier" karakterláncot milyen értékre kell cserélni. A
tulajdonság értéke context, <érték> vagy none lehet.
A context a rendszerdátumnak megfelelő dátumot hoz létre, vagy a CVS címkéket
használja, ha az összeépítés automatikus. Az érték egy tényleges érték. A none
eltávolítja a ".qualifier" karakterláncot. Ha a tulajdonság
kihagyásra kerül, akkor a context lesz használva.
- custom=true - jelzi, hogy az összeépítési parancsfájl kézzel
készült, nem pedig automatikusan jött létre. Ezért más értékek vizsgálatára
nem kerül sor.
Bedolgozó specifikus tulajdonságok
- source.<függvénytár> - felsorolja azokat a forrásmappákat,
amelyek le lesznek fordítva (például source.xyz.jar=src/, src-ant/).
Ha a függvénytár meg van adva a plugin.xml vagy manifest.mf fájlban, akkor az
értéknek egyeznie kell azzal;
- output.<függvénytár> - azt a kimeneti mappát nevezi meg,
ahová a fordítás eredménye kerül;
- source.<függvénytár> - felsorolja azokat a fájlokat,
amelyeket a fordítóprogramnak nem szabad másolnia a függvénytárból;
- extra.<függvénytár> - automatizált összeépítésekhez használt
további osztályútvonalak. Az osztályútvonal lehet relatív útvonal, vagy a fejlesztői
környezet bedolgozóira és töredékeire hivatkozó platform url-ek (például
../someplugin/xyz.jar, platform:/plugins/org.apache.ant/ant.jar). A
platform URL címeinek megadása relatív elérési úton keresztül javasoltak.
- manifest.<függvénytár> - megmutatja a függvénytár
leírójaként használt fájlt. A fájlnak az egyik jar bemenetként
használt forrásmappában kell lennie.
- src.includes - a forrás összeépítésébe foglalt fájlokat sorolja fel;
- src.excludes - a forrás összeépítéséből kizárandó fájlokat sorolja fel;
- jars.extra.classpath - (elavult) ugyanaz a hatása, mint az
extra.<függvénytár> bejegyzésnek, azzal a kivétellel, hogy a bejegyzések
minden függvénytárra vonatkoznak;
- jars.compile.order - a jar fájlok lefordítási sorrendjét határozza
meg (ha több függvénytár is van).
Az "includes" vagy "excludes" végződésű kulcsokhoz megadott értékek Ant
"mintákat" jelölnek. A szabványos formátumok a várt eredményt nyújtják.
Például "*.jar" a legfelsőbb szintű könyvtár összes jar fájlját
jelöli.A minták alapértelmezés szerint nem mélyek. Ha például az összes Java
fájlt meg szeretné adni, a "**/*.java" mintát kell használnia.
A "**" minta bármilyen számú könyvtárszintnek megfelel.
Hasonlóan, teljes részfák leírásához használja az "xyz/" mintát.
Szolgáltatás specifikus tulajdonságok
- root - felsorolja az összes fájlt és mappát, amelyeket a termék
gyökerének tartalmaznia kell. A különböző támogatott értékek:
- <folderName> - a másolni kívánt mappa relatív útvonala;
- file:<fileName> - a másolni kívánt fájl relatív útvonala;
- absolute:<folderName> - a másolni kívánt mappa abszolút útvonala;
- absolute:file:<fileName> - a másolni kívánt fájl abszolút útvonala;
- root.<config> - felsorolja a fájlokat és mappákat, amelyeket a
termék gyökerének tartalmaznia kell az összeépítéskor a megadott konfigurációhoz. A config egy konfiguráció három (3), ponttal elválasztott részéből áll;
- root.permissions.<permissionValue> - felsorolja a fájlokat és
mappákat, amelyek hozzáférését az adott értékre kell módosítani (chmod). A
mappákra hivatkozásoknak '/' karakterrel kell végződnie;
- root.permissions.<config>.<permissionValue> -
felsorolja a fájlokat és mappákat, amelyek hozzáférését egy adott
konfigurációnál a megadott értékre kell módosítani (chmod). A mappákra
hivatkozásoknak '/' karakterrel kell végződnie;
- root.link - páronként felsorolja (vesszővel elválasztva) azokat a
fájlokat és mappákat, amelyekhez szimbolikus csatolást kell létrehozni. Az első bejegyzés a forrást jelöli (unix terminológiában a cél), a második
bejegyzés pedig a csatolás nevét;
- root.link.<config> - azon fájlok és mappák vesszővel elválasztott
felsorolása, amelyekhez szimbolikus csatolást kell létrehozni egy adott konfiguráció
esetén. Az első bejegyzés a forrást jelöli (unix terminológiában a cél), a második
bejegyzés pedig a csatolás nevét;
- generate.feature@<featureId> - jelzi, hogy a featureId
forrásszolgáltatás lesz a tulajdonság értékeként megadott szolgáltatás
forrásszolgáltatása.Az első vessző után felsorolt értékek a lerakatból beolvasandó elemeket jelölik;
- generate.plugin@<pluginId> - jelzi, hogy a pluginId
forrásbedolgozó lesz a tulajdonság értékeként megadott bedolgozó
forrásbedolgozója.
A következő példát az org.eclipse.platform szolgáltatás build.properties fájljából
származik.
bin.includes=epl-v10.html,eclipse_update_120.jpg,feature.xml,feature.properties,license.html
root=rootfiles,file:../../plugins/org.eclipse.platform/startup.jar,configuration/
root.permissions.755=eclipse
root.linux.motif.x86=../../plugins/platform-launcher/bin/linux/motif,linux.motif
root.linux.motif.x86.link=libXm.so.2.1,libXm.so.2,libXm.so.2.1,libXm.so
root.linux.motif.x86.permissions.755=*.so*