Tato úloha spustí úplné porovnání profilu rozhraní API vzhledem k úrovni baseline.
Název úlohy Ant je: apitooling.compare. Chcete-li ji použít, soubor JAR apitooling-ant.jar musí být v cestě ke třídě nástroje Ant.
<apitooling.compare baseline="..." profile="..." report="..." excludelist="..." includelist="..." components="..." visibility="..." debug="..." />
| Atribut | Popis | Nezbytné |
| baseline | Tento atribut určuje umístění referenční úrovně baseline.
Může to být soubor .zip, .jar, .tgz, .tar.gz nebo adresář, který odpovídá instalačnímu adresáři Eclipse. To je adresář, v němž se nachází spustitelný soubor Eclipse. Umístění se zadává pomocí absolutní cesty. |
Ano |
| profile | Tento atribut určuje umístění aktuálního produktu nebo profilu, který chcete porovnat vůči referenční úrovni baseline.
Může to být soubor .zip, .jar, .tgz, .tar.gz nebo adresář, který odpovídá instalačnímu adresáři Eclipse. To je adresář, v němž se nachází spustitelný soubor Eclipse. Umístění se zadává pomocí absolutní cesty. |
Ano |
| report | Nastavte umístění výstupu, kam se vygeneruje sestava.
Po dokončení úlohy je v tomto adresáři k dispozici sestava s názvem "compare.xml". Umístění se zadává pomocí absolutní cesty. |
Ano |
| excludelist | Nastavte umístění vylučovacího seznamu.
Umístění vylučovacího seznamu určuje textový soubor obsahující seznam balíků, které se mají vyloučit z analýzy. Standardně se analyzují všechny balíky v profilu. Atributy zahrnovacího a vylučovacího seznamu lze použít k selektivnímu zahrnutí a vyloučení balíků. Seznam zahrnutí naplní sadu balíků, které se mají analyzovat (když je vynechán, zahrnou se všechny balíky), a poté se použije vylučovací seznam. Každý řádek souboru určuje jedno z následujících:
Umístění se zadává pomocí absolutní cesty. Následuje příklad vylučovacího seznamu: # DOC BUNDLES org.eclipse.jdt.doc.isv org.eclipse.jdt.doc.user org.eclipse.pde.doc.user org.eclipse.platform.doc.isv org.eclipse.platform.doc.user # NON-ECLIPSE BUNDLES com.ibm.icu com.jcraft.jsch javax.servlet javax.servlet.jsp # Exclude all pde bundles R:org\.eclipse\.pde\..* ...Vylučovací seznam může obsahovat regulární výrazy, pokud řádek začíná znakem "R:". |
Ne |
| includelist | Nastavte umístění seznamu zahrnutí.
Umístění seznamu zahrnutí určuje textový soubor obsahující seznam balíků, které se mají zahrnout do analýzy. Standardně se analyzují všechny balíky v profilu. Atributy zahrnovacího a vylučovacího seznamu lze použít k selektivnímu zahrnutí a vyloučení balíků. Seznam zahrnutí naplní sadu balíků, které se mají analyzovat (když je vynechán, zahrnou se všechny balíky), a poté se použije vylučovací seznam. Každý řádek souboru určuje jedno z následujících:
Umístění se zadává pomocí absolutní cesty. Následuje příklad seznamu zahrnutí: # DOC BUNDLES org.eclipse.jdt.doc.isv org.eclipse.jdt.doc.user org.eclipse.pde.doc.user org.eclipse.platform.doc.isv org.eclipse.platform.doc.user # NON-ECLIPSE BUNDLES com.ibm.icu com.jcraft.jsch javax.servlet javax.servlet.jsp # Exclude all pde bundles R:org\.eclipse\.pde\..* ... |
Ne |
| debug | Nastavte hodnotu ladění.
Možné hodnoty jsou: true, false
Výchozí hodnota je false.
|
Ne |
| components | Nastavte umístění seznamu komponent.
Seznam komponent obsahuje všechny názvy komponent, které musí být porovnány. Pokud je vynechán, jsou porovnány všechny komponenty z dané úrovně baseline. Umístění se zadává pomocí absolutní cesty. Formát souboru seznamu komponent vypadá takto: # DOC BUNDLES org.eclipse.jdt.doc.isv org.eclipse.jdt.doc.user org.eclipse.pde.doc.user org.eclipse.platform.doc.isv org.eclipse.platform.doc.user # Include all pde bundles R:org\.eclipse\.pde\..* ...Seznam komponent může obsahovat regulární výrazy, pokud řádek začíná znakem "R:". |
Ne |
| visibility | Nastavte hodnotu viditelnosti.
Možné hodnoty jsou: API, ALL
Výchozí hodnota je API.
|
Ne |
<apitooling.compare baseline="D:\eclipse\3.4.1\eclipse" profile="D:\eclipse-SDK-I20081118-0800-linux-gtk.tar.gz" report="D:\reports\xml" excludelist="D:\exclude_list_external.txt" debug="true" />
Tím se spustí úloha, která vytvoří soubory compare.xml ve složce D:\reports\xml.
Ke snížení počtu hlášených problémů se použije vylučovací seznam.
Vzhledem k tomu, že je povoleno ladění, na konzole Ant se zobrazí určitá ladicí trasování.

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