API Tools - Úloha Ant generování souborů

Účel

Tato úloha se spouští, aby vygenerovala všechny soubory, které vyžaduje modul API Tools v binárním balíku. Tato úloha se spouští při sestavení Eclipse nebo při exportu balíků u všech projektů, které mají charakter modulu API Tools.

V současné době se vytvoří pouze soubor s názvem .api_description.

Použití

Popis

Název úlohy Ant je: apitooling.apigeneration. Chcete-li ji použít, soubor JAR apitooling-ant.jar musí být v cestě ke třídě nástroje Ant.

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

Parametry

Atribut Popis Nezbytné
projectname Nastavte název projektu. Ano
projekt Nastavte umístění projektu.

Toto je složka, která obsahuje všechny zdrojové soubory pro daný projekt.

Umístění se nastavuje pomocí absolutní cesty.
Ano
binární Nastavte umístění binárních souborů.

Toto je seznam složek nebo souborů JAR, které obsahují všechny soubory .class pro daný projekt. Oddělují se oddělovačem cesty pro příslušnou platformu. Všechny položky musejí existovat.

Umístění by měla být určena pomocí absolutních cest.
Ano
cíl Nastavte cílové umístění.

Toto je složka, v níž se vygenerují generované soubory.

Umístění se nastavuje pomocí absolutní cesty.
Ano
ladění Nastavte hodnotu ladění.

Možné hodnoty jsou: true, false
Výchozí hodnota je false.
Ne
extraManifests Nastavte umístění dodatečných souborů typu manifest.

Toto je seznam umístění dodatečných souborů MANIFEST.MF, který lze nastavit za účelem poskytnutí více balíků API k procházení. Oddělují se oddělovačem cesty pro příslušnou platformu. Všechny položky musejí existovat.

Pokud cesta není absolutní, bude interpretována vzhledem k aktuálnímu pracovnímu adresáři.

Místo souboru MANIFEST.MF lze zadat soubory JAR. Je-li zadán soubor JAR, bude přečten jeho soubor MANIFEST.MF, pokud existuje.
Ne
extraSourceLocations Nastavte umístění dodatečných zdrojů.

Toto je seznam umístění zdrojových souborů, které budou procházeny. Oddělují se oddělovačem cesty pro příslušnou platformu. Všechny položky musejí existovat.

Umístění by měla být určena pomocí absolutních cest.
Ne
allowNonapiproject Povolte spuštění úlohy v projektech, které nemají povolený modul API Tools.

Pokud je tato úloha spuštěna v projektu, který nemá charakter modulu API Tools, negeneruje se žádný soubor api_description file, protože se předpokládá, že projekt modul API Tools nepodporuje. V některých případech je třeba vygenerovat soubor popisu i v projektech, které tento charakter nemají. Po nastavení tohoto parametru na hodnotu true úloha nebude kontrolovat charakter.
Ne

Příklady

 <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"
 />

Tímto se vytvoří soubor s názvem .api_description ve složce d:\plugins\org.eclipse.jdt.core na základě zdroje obsaženého v d:\eclipse\org.eclipse.jdt.core a souborů .class obsažených v d:\eclipse\org.eclipse.jdt.core\bin.

Související odkazy

Úloha Ant analýzy
Úloha Ant zmrazení API
Úloha Ant použití API
Úloha Ant převodu sestavy analýzy
Úloha Ant převodu sestavy zmrazení API
Úloha Ant nepřípustnosti rozhraní API
Úloha Ant převodu sestavy nepřípustnosti rozhraní API
Úloha Ant převodu sestavy využití API