這項作業會將 apitooling.apiuse Ant 作業所建立的 XML 報告轉換成 HTML 檔案。
HTML 報告會依照產生參照的軟體組(也就是包含所參照之 api/類型的軟體組)來組織參照。
Ant 作業的名稱為:apitooling.apiuse_reportconversion。如果要能夠使用,JAR 檔 apitooling-ant.jar 必須在 Ant 類別路徑上。
<apitooling.apiuse_reportconversion
xmlfiles="..."
htmlfiles="..."
xsltfile="..."
filterpatterns="..."
tofilterpatterns="..."
debug="..."
/>
| 屬性 | 說明 | 必要 |
| xmlfiles |
這個屬性指定要轉換的 xml 檔案的位置。
這個位置是使用絕對路徑指定的。 |
是 |
| htmlfiles |
這個屬性指定要產生的 html 檔案的位置。
這個位置是使用絕對路徑指定的。 |
是 |
| xsltfile |
這個屬性指定用來依所要的順序產生參照詳細資料頁面之 XSLT 檔案的位置。
apitooling-ant.jar JAR 檔中有預設的 XSLT 檔案。
這個位置是使用絕對路徑指定的。 |
否 |
| filterpatterns |
這個屬性指定一份逗點區隔的清單,列出若干正規表示式型樣,以用來刪改符合定案報告中之名稱型樣的參照起源。
這個型樣必須是如這裡所定義,已妥善格式化的正規表示式。 |
否 |
| tofilterpatterns |
這個屬性指定一份逗點區隔的清單,列出若干正規表示式型樣,以用來刪改符合定案報告中之名稱型樣的參照目標。
這個型樣必須是如這裡所定義,已妥善格式化的正規表示式。 |
否 |
| 除錯 |
設定除錯值。
可能的值為: true、false預設值是 false。 |
否 |
<apitooling.apiuse_reportconversion
xmlfiles="/eclipse/apiuse-both/XML"
htmlfiles="/eclipse/apiuse-both/HTML"
xsltfile="/eclipse/references.xsl"
debug="true"
/>
這個範例在對應於 XML 檔案位置資料夾結構的 /eclipse/apiuse-both/HTML 資料夾內,執行建立 *.html 檔案的作業
如果已啟用除錯,部分除錯追蹤將顯示在 Ant 主控台上。
API 使用端用法報告轉換 Ant 作業
分析 Ant 作業
檔案產生 Ant 作業
API 用法 Ant 作業
API 凍結 Ant 作業
API 淘汰 Ant 作業
API 淘汰報告轉換 Ant 作業
分析報告轉換 Ant 作業