這項作業會相對於基準線來執行 API 設定檔的完整比較。
Ant 作業的名稱如下:apitooling.compare。
如果要能夠使用,JAR 檔 apitooling-ant.jar 必須在 Ant 類別路徑上。
<apitooling.compare baseline="..." profile="..." report="..." excludelist="..." includelist="..." components="..." visibility="..." debug="..." />
| 屬性 | 說明 | 必要 |
| baseline | 這個屬性指定參照基準線的位置。
它可以是 .zip、.jar、.tgz、.tar.gz 檔案,或是對應於Eclipse 安裝資料夾的目錄。您可以在這個目錄中找到 Eclipse 執行檔。 這個位置是使用絕對路徑指定的。 |
是 |
| profile | 這個屬性指定您要與參照基準線相比較的現行產品或設定檔的位置。
它可以是 .zip、.jar、.tgz、.tar.gz 檔案,或是對應於Eclipse 安裝資料夾的目錄。您可以在這個目錄中找到 Eclipse 執行檔。 這個位置是使用絕對路徑指定的。 |
是 |
| report | 設定將產生報告的輸出位置。
作業完成之後,會在這個目錄中提供稱為 "compare.xml" 的報告。 這個位置是使用絕對路徑指定的。 |
是 |
| excludelist | 設定排除清單位置。
排除清單位置指定一個文字檔,列出要從分析中排除的軟體組。 依預設,會分析設定檔中的所有軟體組。 您可以利用併入及排除清單屬性來選擇性地併入及排除軟體組。 併入清單會植入一組要分析的軟體組(省略的話,就會併入所有軟體組),然後再套用排除清單。 檔案中的每一行指定下列項目之一:
這個位置是使用絕對路徑指定的。 以下是一份範例排除清單: # 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\..* ...如果行首是 "R:",排除清單可以包含正規表示式。 |
否 |
| includelist | 設定併入清單位置。
併入清單位置指定一個文字檔,列出要併入分析中的軟體組。 依預設,會分析設定檔中的所有軟體組。 您可以利用併入及排除清單屬性來選擇性地併入及排除軟體組。 併入清單會植入一組要分析的軟體組(省略的話,就會併入所有軟體組),然後再套用排除清單。 檔案中的每一行指定下列項目之一:
這個位置是使用絕對路徑指定的。 以下是一份範例併入清單: # 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\..* ... |
否 |
| debug | 設定除錯值。
可能的值為: true、false預設值是 false。 |
否 |
| 元件 | 設定元件的清單位置。
元件的清單包含所有必須比較的元件名稱。 如果省略的話,就會比較給定基準線中的所有元件。 這個位置是使用絕對路徑指定的。 元件清單檔的格式看起來如下: # 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\..* ...如果行首是 "R:",元件清單可以包含正規表示式。 |
否 |
| 可見性 | 設定可見性值, 可能的值為: API、ALL
預設值是 API。
|
否 |
<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" />
這個範例將在 D:\reports\xml 資料夾內執行建立 compare.xml 檔的作業。
它將使用排除清單來減少要報告的問題數目。
由於已啟用除錯,部分除錯追蹤將顯示在 Ant 主控台上。

API 凍結 Ant 作業
檔案產生 Ant 作業
API 用法 Ant 作業
分析報告轉換 Ant 作業
API 凍結報告轉換 Ant 作業
API 用法報告轉換 Ant 作業
API 淘汰報告轉換 Ant 作業