A feladat egy teljes API profil összehasonlítást hajt végre egy alapsorral.
Az Ant feladat neve: apitooling.compare. A
használatához az apitooling-ant.jar fájlnak szerepelnie kell
az Ant osztályútvonalon.
<apitooling.compare baseline="..." profile="..." report="..." excludelist="..." includelist="..." components="..." visibility="..." debug="..." />
| Attribútum | Leírás | Kötelező |
| baseline | Ez az attribútum adja meg a referencia alapsor helyét.
Ez lehet egy .zip, .jar, .tgz, .tar.gz fájl, vagy egy könyvtár, amely megfelel az Eclipse telepítési könyvtárnak. Ez az a könyvtár, ahol az Eclipse végrehajtható fájl található. A helyet abszolút útvonalként kell megadni. |
Igen |
| profile | Ez az attribútum adja meg az aktuális termék vagy profil
helyét, amelyet össze kíván hasonlítani a referencia alapsorral.
Ez lehet egy .zip, .jar, .tgz, .tar.gz fájl, vagy egy könyvtár, amely megfelel az Eclipse telepítési könyvtárnak. Ez az a könyvtár, ahol az Eclipse végrehajtható fájl található. A helyet abszolút útvonalként kell megadni. |
Igen |
| report | Itt állíthatja be a kimeneti helyet, ahová a jelentés
elő lesz állítva.
A feladat befejeződése után a "compare.xml" jelentés ebben a könyvtárban érhető el. A helyet abszolút útvonalként kell megadni. |
Igen |
| excludelist | Itt állíthatja be a kizárási lista helyét.
A kizárási lista helye egy szövegfájlt ad meg, amely az elemzésből kizárandó kötegek listáját tartalmazza. Alapértelmezésben a profilban lévő összes köteg elemezve lesz. A tartalmazási és kizárási lista attribútumok használatával egyenként megadhatja a tartalmazni és kizárni kívánt kötegeket. A tartalmazási lista adja meg az elemezni kívánt kötegek alap készletét (ha nincs megadva, akkor az összes köteg), és ezután kerül alkalmazásra a kizárási lista. A fájl minden sora a következők egyikét adja meg:
A helyet abszolút útvonalként kell megadni. Íme egy példa a kizárási listára: # DOC KÖTEGEK 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 # NEM ECLIPSE KÖTEGEK com.ibm.icu com.jcraft.jsch javax.servlet javax.servlet.jsp # Összes pde köteg kizárása R:org\.eclipse\.pde\..* ...Ha a sor az "R:" előtaggal kezdődik, a kizárási lista tartalmazhat reguláris kifejezéseket. |
Nem |
| includelist | Itt állíthatja be a tartalmazási lista helyét.
A tartalmazási lista helye egy szövegfájlt ad meg, amely az elemzésbe belefoglalni kívánt kötegek listáját tartalmazza. Alapértelmezésben a profilban lévő összes köteg elemezve lesz. A tartalmazási és kizárási lista attribútumok használatával egyenként megadhatja a tartalmazni és kizárni kívánt kötegeket. A tartalmazási lista adja meg az elemezni kívánt kötegek alap készletét (ha nincs megadva, akkor az összes köteg), és ezután kerül alkalmazásra a kizárási lista. A fájl minden sora a következők egyikét adja meg:
A helyet abszolút útvonalként kell megadni. Íme egy példa a tartalmazási listára: # DOC KÖTEGEK 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 # NEM ECLIPSE KÖTEGEK com.ibm.icu com.jcraft.jsch javax.servlet javax.servlet.jsp # Összes pde köteg kizárása R:org\.eclipse\.pde\..* ... |
Nem |
| debug | Itt állíthatja be a hibakeresési értéket.
Lehetséges értékek: true vagy false
Az alapértelmezett érték a false.
|
Nem |
| components | Beállítja a komponensek listájának helyét.
A komponensek listája az összes összehasonlítandó komponens nevét tartalmazza. Ha nincs megadva, akkor az adott alapsorban lévő összes komponens össze lesz hasonlítva. A helyet abszolút útvonalként kell megadni. A komponenslista formátuma a következőhöz hasonló: # DOC KÖTEGEK 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\..* ...Ha a sor az "R:" előtaggal kezdődik, a komponenslista tartalmazhat reguláris kifejezéseket. |
Nem |
| visibility | Itt állíthatja be a láthatóság értékét.
A lehetséges értékek: API,
ALL
Az alapértelmezés API.
|
Nem |
<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" />
Ez lefuttatja a feladatot és létrehozza a compare.xml
fájlokat a D:\reports\xml mappában.
A jelentendő problémák számának csökkentése érdekében a
kizárási listát fogja használni.
Mivel engedélyezve van a hibakeresés, az Ant konzolon hibakeresési nyomkövetési információk is megjelennek.

API befagyasztás Ant feladat
Fájl előállítása Ant feladat
API használat Ant feladat
Elemzési jelentés átalakítása Ant feladat
API befagyasztási jelentés átalakítása Ant feladat
API használat jelentés átalakítása Ant feladat
API elavulás jelentés átalakítása Ant feladat