Přírůstkoví tvůrci projektů
Identifikátor:
org.eclipse.core.resources.builders
Popis:
Pracovní prostor podporuje užitečný nástroj - přírůstkového tvůrce projektů neboli "zkráceného" tvůrce. Úlohou tvůrce je zpracovávat sadu změn prostředků (dodávanou v podobě rozdílových dat prostředků). Tvůrce Java by například znovu zkompiloval změněné soubory Java a vytvořil by nové soubory tříd.
Tvůrci jsou nakonfigurováni pro jednotlivé projekty a spouští se automaticky, pokud dojde ke změně prostředků v projektu. Jako takoví by měli být tvůrci rychlí a vytvořeni spíše s ohledem na množství změn než na počet prostředků v projektu. Toto obvykle znamená, že tvůrci jsou schopni přírůstkově aktualizovat svůj "stav sestavení".
Bod rozšíření tvůrců umožňuje zapisovačům tvůrců zaregistrovat svoji implementaci tvůrce pod symbolickým názvem, který je poté použit v pracovním prostoru k vyhledání a spuštění tvůrců. Symbolický název je ID rozšíření tvůrce. Při definování rozšíření tvůrce je doporučeno zadat jako atribut "name" hodnotu, která je člověku srozumitelná. Tato hodnota označuje svého tvůrce a potenciálně může být prezentována uživatelům.
Konfigurační markup:
<!ELEMENT extension (builder)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #REQUIRED
name CDATA #IMPLIED>
- point - Úplný identifikátor cílového bodu rozšíření.
- ID - Nepovinný identifikátor instance rozšíření.
- name - Nepovinný název instance rozšíření.
<!ELEMENT builder (run?)>
<!ATTLIST builder
hasNature (true | false)
isConfigurable (true | false) >
- hasNature - Hodnota true nebo false označuje, zda je vlastníkem tvůrce charakter projektu. Jestliže je zadána hodnota true a není nalezen odpovídající charakter, nebude tento tvůrce spuštěn, ale zůstane v zadání sestavení projektu. Pokud není atribut zadán, je předpokládána hodnota false.
- isConfigurable - Hodnota "true" nebo "false" označuje, zda tvůrce umožňuje vlastní nastavení, na co budou spouštěče sestavení reagovat. Pokud je hodnota nastavena na "true", klienti budou moci použít ICommand.setBuilding rozhraní API a určit, zda se má tento tvůrce spustit po vyvolání konkrétním spouštěčem sestavení. Pokud není atribut zadán, je předpokládána hodnota false.
<!ELEMENT run (parameter*)>
<!ATTLIST run
class CDATA #REQUIRED>
- class - Úplný název podtřídy org.eclipse.core.resources.IncrementalProjectBuilder.
<!ELEMENT parameter EMPTY>
<!ATTLIST parameter
name CDATA #REQUIRED
value CDATA #REQUIRED>
- name - Název tohoto parametru zpřístupněný instancím zadané třídy tvůrce.
- value - Libovolná hodnota přidružená k danému názvu a dostupná pro instance zadané třídy tvůrce.
Příklady:
Zde je uveden příklad konfigurace tvůrce:
<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>
Jestliže bylo toto rozšíření definováno v modulu plug-in s ID "com.xyz.coolplugin", je úplný název tohoto tvůrce "com.xyz.coolplugin.coolbuilder".
Informace rozhraní API:
Hodnota atributu třídy musí představovat podtřídu org.eclipse.core.resources.IncrementalProjectBuilder.
Dodaná implementace:
Platforma samotná neobsahuje žádné předdefinované tvůrce. Instalace konkrétních produktů mohou podle potřeby obsahovat tvůrce.
Copyright (c) 2002, 2005 IBM Corporation a další.
Všechna práva vyhrazena.
Tento program a doprovodné materiály jsou zpřístupněny za podmínek licence Eclipse Public License
v1.0, která je součástí této distribuce a je k dispozici na adrese
http://www.eclipse.org/legal/epl-v10.html