Ant-tehtävät
Tunnus:
org.eclipse.ant.core.antTasks
Kuvaus:
Tämän laajennuspisteen avulla lisäosat voivat määrittää vapaasti Ant-tehtäviä Ant-rakennetta varten. Ant-perusrakenne sallii tehtävien vapaan
lisäämisen.
Ant-ydinlisäosan (tai sen edellytysosien) luokkapolussa ei kuitenkaan todennäköisesti
ole näiden tehtävien edellyttämiä luokkia.
Tämän takia
asiakkaiden on määritettävä tätä laajennuspistettä käyttävä laajennus,
joka määrittää tehtäviä vastaavat luokat. Näillä tiedoilla Ant-lisäosa voi pyytää esittelevää
lisäosaa lataamaan määritetyn luokan.
Merkintärakenne:
<!ELEMENT extension (antTask*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - kohteena olevan laajennuspisteen tarkennettu
tunnus
- id - laajennusilmentymän valinnainen tunnus
- name - laajennusilmentymän valinnainen nimi
<!ELEMENT antTask EMPTY>
<!ATTLIST antTask
name CDATA #REQUIRED
uri CDATA #IMPLIED
class CDATA #REQUIRED
library CDATA #REQUIRED
headless (true | false)
eclipseRuntime (true | false) >
- name - määritettävän tehtävän nimi.
- uri - tämän määritteen sijainnin uri. Sitä käytetään vain, jos käytössä on uudempi Ant-versio
kuin versio 1.6.
- class - sen Java-luokan tarkka nimi, joka toteuttaa
tehtävän. Yleensä tämä luokka on
org.apache.tools.ant.Task
-luokan aliluokka.
- library - tehtävän sisältävän kirjaston polku suhteessa lisäosan asennushakemistoon.
- headless - tämän tehtävän pääobjektittomuustilan määritys. Tämä arvo määrittää, voiko tätä tehtävää käyttää pääobjektittomassa Ant-ympäristössä. Jos suoritusympäristö on pääobjektiton ja tämän määritteen arvo on false (epätosi), tätä tehtävää ei ladata eikä määritetä. Myöskään lisäosan luokanlataustoimintoa ei lisätä Ant-luokanlataustoiminnon pääluokanlataustoiminnoksi.
Jos tälle määritteelle ei ole annettu arvoa, käytetään oletusasetusta true (tosi, lisämääritys on käytössä vain Eclipse-ympäristössä).
- eclipseRuntime - tämä arvo määrittää, edellyttääkö tämä tehtävä ajonaikaista Eclipse-ympäristöä (eli onko laji ajettava samassa VM-muistitilassa kuin Eclipse-ympäristö). Jos tälle määritteelle ei ole annettu arvoa, käytetään oletusasetusta true (tosi, lisämääritys on käytössä vain Eclipse-ympäristössä).
Esimerkkejä:
Seuraavassa on esimerkki Ant-tehtävien laajennuspisteestä:
<extension point=
"org.eclipse.ant.core.antTasks"
>
<antTask name=
"coolTask"
class=
"com.example.CoolTask"
library=
"lib/antSupport.jar"
/>
</extension>
Toimitettu toteutus:
Käyttöympäristö sisältää joitakin tehtävämäärityksiä, kuten eclipse.incrementalBuild- ja eclipse.refreshLocal-määritykset.
Copyright (c) 2000, 2006 IBM Corporation and others.
All rights reserved. This program and the accompanying materials are made
available under the terms of the Eclipse Public License v1.0 which
accompanies this distribution, and is available at
http://www.eclipse.org/legal/epl-v10.html