Ohjelmointirajapinnan työkalut - tiedostojen luonnin Ant-tehtävä

Käyttötarkoitus

Tämä tehtävä luo kaikki tiedostot, joita ohjelmointirajapinnan työkalut tarvitsevat binaarisessa resurssijoukossa. Järjestelmä ajaa tämän tehtävän Eclipse-koontien yhteydessä tai vietäessä resurssijoukkoa kaikista projekteista, joilla on ohjelmointirajapinnan työkalujen luonne.

Tällä hetkellä järjestelmä luo vain tiedoston nimeltä .api_description.

Käyttö

Kuvaus

Ant-tehtävän nimi on apitooling.apigeneration. Jar-tiedoston apitooling-ant.jar käyttö edellyttää, että tiedosto on Ant-tehtävän luokkapolussa.

<apitooling.apigeneration
	projectname="..."
	project="..."
	binary="..."
	target="..."
			debug="..."
/>

Parametrit

Määrite Kuvaus Pakollinen
projectname Määrittää projektin nimen Kyllä
projekti Määrittää projektin sijainnin.

Tämä kansio sisältää annetun projektin kaikki lähdetiedostot.

Sijainti määritetään absoluuttisen polun avulla.
Kyllä
binaarinen Määrittää binaariset sijainnit.

Tämä on luettelo kansioista tai jar-tiedostoista, jotka sisältävät kaikki annetun projektin .class-tiedostot. Ne on erotettu toisistaan käyttöympäristön polun erottimella. Jokaisen merkinnän on oltava järjestelmässä.

Merkinnät on määritettävä absoluuttisten polkujen avulla.
Kyllä
kohde Määrittää kohdesijainnin.

Tämä on kansio, johon tiedostot luodaan.

Sijainti määritetään absoluuttisen polun avulla.
Kyllä
vianmääritys Määrittää vianmääritysarvon.

Mahdolliset arvot ovat seuraavat: true, false
Oletusarvo on false.
Ei
extraManifests Määrittää ylimääräisten manifest-tiedostojen sijainnit.

Tämä on luettelo niiden ylimääräisten MANIFEST.MF-tiedostojen sijainneista, joiden avulla voidaan määrittää lisää ohjelmointirajapintapaketteja etsintää varten. Ne on erotettu toisistaan käyttöympäristön polun erottimella. Jokaisen merkinnän on oltava järjestelmässä.

Jos polku ei ole absoluuttinen, se ratkaistaan suhteessa nykyiseen työhakemistoon.

MANIFEST.MF-tiedoston sijaan voidaan määrittää Jar-tiedostoja. Jos Jar-tiedosto on määritetty, sen MANIFEST.MF-tiedosto luetaan, jos tiedosto on olemassa.
Ei
extraSourceLocations Määrittää ylimääräiset lähdesijainnit.

Tämä on luettelo etsittävien lähdetiedostojen sijainneista. Ne on erotettu toisistaan käyttöympäristön polun erottimella. Jokaisen merkinnän on oltava järjestelmässä.

Merkinnät on määritettävä absoluuttisten polkujen avulla.
Ei
allowNonapiproject Salli tehtävän suorittaminen projekteissa, joissa ohjelmointirajapinnan työkalut eivät ole käytössä.

Jos tehtävä suoritetaan projektissa, joka ei ole ohjelmointirajapinnan työkalun kaltainen, api_description-tiedostoa ei muodosteta, koska on oletettavissa, että projekti ei tue ohjelmointirajapinnan työkaluja. Joissain tapauksissa on kuitenkin tarve muodostaa kuvaustiedosto myös tällaisissa projekteissa. Jos tälle parametrille asetetaan true-arvo, tehtävä ei tarkista ohjelmointirajapinnan työkalun kaltaisuutta.
Ei

Esimerkit

 <apitooling.apigeneration
  projectname="org.eclipse.jdt.core_3.5.0.v_927"
  project="d:\eclipse\org.eclipse.jdt.core"

  binary="d:\eclipse\org.eclipse.jdt.core\bin;d:\eclipse\org.eclipse.jdt.core\antbin"
  target="d:\plugins\org.eclipse.jdt.core"
  debug="true"
 />

Järjestelmä luo tiedoston .api_description kansioon d:\plugins\org.eclipse.jdt.core kohdassa d:\eclipse\org.eclipse.jdt.core olevan lähteen ja kohdassa d:\eclipse\org.eclipse.jdt.core\bin olevien .class-tiedostojen perusteella.

Aiheeseen liittyviä ohjeita

Analyysin Ant-tehtävä
Ohjelmointirajapinnan jäädytyksen Ant-tehtävä
Ohjelmointirajapinnan käytön Ant-tehtävä
Analyysiraportin muunnon Ant-tehtävä
Ohjelmointirajapinnan jäädytysraportin muunnon Ant-tehtävä
Ohjelmointirajapinnan vanhentumisen Ant-tehtävä
Ohjelmointirajapinnan vanhentumisraportin muunnon Ant-tehtävä
Ohjelmointirajapinnan käyttöraportin muunnon Ant-tehtävä