Czynności narzędzia Ant
Identyfikator:
org.eclipse.ant.core.antTasks
Opis:
Umożliwia modułom dodatkowym
definiowanie czynności narzędzia Ant do użycia przez infrastrukturę
narzędzia Ant. Standardowa infrastruktura narzędzia Ant umożliwia dodawanie
dowolnych czynności. Niestety, mało prawdopodobne jest, aby podstawowy moduł
dodatkowy narzędzia Ant miał w swojej ścieżce klasy wymagane przez
te czynności klasy (lub klasy określone w dowolnym z wymagań wstępnych). W tym
celu klienci powinni zdefiniować rozszerzenie podłączane do tego punktu
rozszerzenia i odwzorować nazwę czynności na klasę. Wówczas moduł dodatkowy
narzędzia Ant będzie mógł zażądać, aby deklarujący moduł dodatkowy załadował
określoną klasę.
Znaczniki konfiguracji:
<!ELEMENT extension (antTask*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA
#IMPLIED
name CDATA #IMPLIED>
- point - pełny identyfikator docelowego punktu rozszerzenia.
- id - opcjonalny identyfikator instancji rozszerzenia.
- name - opcjonalna nazwa instancji rozszerzenia.
<!ELEMENT antTask EMPTY>
<!ATTLIST antTask
name CDATA #REQUIRED
class CDATA #REQUIRED
library CDATA #REQUIRED
headless (true | false)
eclipseRuntime (true | false) >
- name - nazwa czynności do zdefiniowania.
- class - pełna nazwa klasy Java implementującej daną czynność. Ogólnie
klasa ta musi być podklasą klasy
org.apache.tools.ant.Task
.
- library - ścieżka względna wobec miejsca instalacji modułu
dodatkowego dla biblioteki zawierającej daną czynność.
- headless - wskazuje, czy ta czynność jest odpowiednia do stosowania
w nienadzorowanym środowisku Ant. W przypadku nienadzorowanego wykonywania, gdy atrybut ma wartość false, czynność ta nie zostanie załadowana ani
zdefiniowana. Podobnie program ładujący klasy modułów dodatkowych nie zostanie
dodany do programu ładującego klasy narzędzia Ant jako nadrzędny program
ładujący klasy. Jeśli nie określono wartości atrybutu, przyjmowana jest wartość true.
- eclipseRuntime - wskazuje, czy dana czynność wymaga środowiska
wykonawczego Eclipse (tj. musi być wykonywana na tej samej maszynie VM, co
Eclipse). Jeśli nie określono wartości atrybutu, przyjmowana jest wartość true.
Przykłady:
Poniżej przedstawiono
przykładowy punkt rozszerzenia czynności narzędzia Ant:
<extension point=
"org.eclipse.ant.core.antTasks"
>
<antTask name=
"coolTask"
class=
"com.example.CoolTask"
library=
"lib/antSupport.jar"
/>
</extension>
Dostarczana implementacja:
Sama
platforma obsługuje wiele czynności, w tym eclipse.incrementalBuild i eclipse.refreshLocal.
Copyright (c) 2000, 2005 IBM Corporation i inne podmioty.
Wszelkie prawa zastrzeżone. Program ten oraz towarzyszące mu materiały są udostępniane na warunkach licencji EPL (Eclipse Public License), wersja 1.0, dołączonej do nich i dostępnej pod adresem http://www.eclipse.org/legal/epl-v10.html.