Növekményes projekt-összeépítők
Azonosító:
org.eclipse.core.resources.builders
Leírás:
A munkaterület támogatja
a növekményes projekt-összeépítő (vagy röviden "összeépítő") fogalmát. Az
összeépítő feladata az erőforrásmódosítások egy halmazának (ezek erőforrás
megváltozásként állnak rendelkezésre) feldolgozása. Például egy Java
összeépítő újrafordítja a módosított Java fájlokat, és új osztályfájlokat
állít elő.
Az összeépítők projektenként vannak konfigurálva, és automatikusan
futtatásra kerülnek, amikor a projektjükhöz tartozó erőforrások
megváltoznak. Éppen ezért az összeépítőknek gyorsnak kell lenniük, és nem
a projektben szereplő erőforrások számától, hanem a módosítás mértékétől
függően méretezendők. Ez általában azt jelenti, hogy az összeépítők
képesek növekményesen frissíteni az "összeépítési állapotot".
Az összeépítők kiterjesztési pont segítségével az összeépítők írói egy
szimbolikus név alatt regisztrálhatják saját összeépítő megvalósításaikat,
amely azután a munkaterületen belül összeépítők keresésére és futtatására
használható. A szimbolikus név az összeépítő kiterjesztés azonosítója.
Összeépítő kiterjesztés meghatározásakor a "name" attribútumnak ajánlatos
értelemmel bíró értéket adni, amely azonosítja az adott összeépítőt, és
esetleg megjeleníthető a felhasználók számára.
Konfigurációs kód:
<!ELEMENT extension (builder)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #REQUIRED
name CDATA #IMPLIED>
- point - a cél kiterjesztési pont teljes képzésű azonosítója
- id - a kiterjesztéspéldány elhagyható azonosítója
- name - a kiterjesztéspéldány elhagyható neve
<!ELEMENT builder (run?)>
<!ATTLIST builder
hasNature (true | false)
isConfigurable (true | false) >
- hasNature - "true" vagy "false", azt jelzi, hogy az összeépítőt birtokolja-e valamelyik projektjelleg. Ha az érték "true" és a megfelelő jelleg nem található, akkor az összeépítő nem kerül futtatásra, de továbbra is megmarad a projekt összeépítési specifikációjában. Ha az attribútum nincsen megadva, akkor a feltételezett értéke "false".
- isConfigurable - "true" vagy "false", azt jelzi,
hogy az összeépítő engedélyezi-e annak a személyre szabását, amire az
összeépítési triggerek válaszolni fognak. Ha az érték "true", akkor az
ügyfelek használhatják az ICommand.setBuilding API-t annak megadására,
hogy ennek az összeépítőnek futnia kell-e egy adott összeépítési trigger
esetén. Ha az attribútum nincsen megadva, akkor a feltételezett értéke "false".
<!ELEMENT run (parameter*)>
<!ATTLIST run
class CDATA #REQUIRED>
- class - az org.eclipse.core.resources.IncrementalProjectBuilder egy alosztályának teljes képzésű neve.
<!ELEMENT parameter EMPTY>
<!ATTLIST parameter
name CDATA #REQUIRED
value CDATA #REQUIRED>
- name - a megadott összeépítő osztály példányai számára elérhetővé tett paraméter neve.
- value - az adott névhez társított tetszőleges érték, amely a megadott összeépítő osztály példányai számára elérhető.
Példák:
Az alábbi példa egy
összeépítő beállítását mutatja be:
<extension id=
"coolbuilder"
name=
"Cool Builder"
point=
"org.eclipse.core.resources.builders"
>
<builder hasNature=
"false"
>
<run class=
"com.xyz.builders.Cool"
>
<parameter name=
"optimize"
value=
"true"
/>
<parameter name=
"comment"
value=
"Produced by the Cool Builder"
/>
</run>
</builder>
</extension>
Ha ez a kiterjesztés egy "com.xyz.coolplugin" azonosítóval rendelkező
bedolgozóban lenne meghatározva, akkor ezen összeépítő teljes képzésű neve
"com.xyz.coolplugin.coolbuilder" lenne.
API-információk:
A class
attribútum értéke az
org.eclipse.core.resources.IncrementalProjectBuilder egyik
alosztálya kell, hogy legyen.
Szállított megvalósítás:
A
környezet nem rendelkezik előre meghatározott összeépítővel. Bizonyos
terméktelepítők szükség szerint tartalmazhatnak összeépítőket.
Copyright (c) 2002, 2005 IBM Corporation és mások.
Minden jog fenntartva. Jelen program és annak kísérőanyagai a csomaghoz
tartozó, illetve a
http://www.eclipse.org/legal/epl-v10.html
címen is elérhető Eclipse Public License 1.0 verziójának hatálya alatt lettek
közzétéve.