งานนี้จะสร้างไฟล์ทั้งหมดที่ต้องการโดยเครื่องมือ API ภายในบันเดิลไบนารี งานนี้จะรันระหว่าง Eclipse builds หรือระหว่างการเอ็กซ์พอร์ตบันเดิลสำหรับโครงการทั้งหมดที่มีลักษณะของเครื่องมือ API
ตอนนี้ จะสร้างเฉพาะไฟล์ชื่อ .api_description
ชื่อของภารกิจ Ant คือ: apitooling.apigeneration เมื่อต้องการใช้ ไฟล์ jar apitooling-ant.jar จะต้องอยู่บน Ant classpath
<apitooling.apigeneration
projectname="..."
project="..."
binary="..."
target="..."
debug="..."
/>
| แอ็ตทริบิวต์ | คำอธิบาย | ต้องการ |
| projectname | ตั้งค่าชื่อโปรเจ็กต์ | Yes |
| project |
ตั้งค่าตำแหน่งของโปรเจ็กต์ นี่คือโฟลเดอร์ที่มีไฟล์ต้นฉบับทั้งหมดสำหรับโปรเจ็กต์ที่กำหนดไว้ ตำแหน่งถูกตั้งค่าไว้โดยใช้พาธสัมบูรณ์ |
Yes |
| ไบนารี |
ตั้งค่าตำแหน่งไบนารี นี่คือรายการของโฟลเดอร์หรือไฟล์ jar ที่มีไฟล์ .class ทั้งหมดสำหรับโปรเจ็กต์ที่กำหนดไว้ ซึ่งแยกโดยตัวคั่นพาธของแพลตฟอร์ม แต่ละรายการต้องมีอยู่ ซึ่งควรระบุไว้โดยใช้พาธสัมบูรณ์ |
Yes |
| target |
ตั้งค่าตำแหน่งเป้าหมาย นี่คือโฟลเดอร์ที่ไฟล์ที่สร้างถูกสร้างขึ้น ตำแหน่งถูกตั้งค่าไว้โดยใช้พาธสัมบูรณ์ |
Yes |
| ดีบัก |
ตั้งค่าดีบัก ค่าที่เป็นไปได้ คือ: true,
falseค่าดีฟอลต์คือ false
|
No |
| extraManifests |
ตั้งค่าตำแหน่งของไฟล์ manifest แบบพิเศษ นี่คือรายการของตำแหน่งของไฟล์ MANIFEST.MF แบบพิเศษที่สามารถตั้งค่าเพื่อจัดเตรียมแพ็กเกจ api เพิ่มเติมเพื่อสแกน ซึ่งแยกโดยตัวคั่นพาธของแพลตฟอร์ม แต่ละรายการต้องมีอยู่ หากพาธนั้นไม่ใช่พาธสัมบูรณ์ พาธจะแก้ปัญหาที่เกี่ยวข้องกับไดเร็กทอรีการทำงานปัจจุบัน ไฟล์ Jar สามารถระบุแทนไฟล์ MANIFEST.MF หากไฟล์ jar ถูกระบุไว้ ไฟล์ MANIFEST.MF จะถูกอ่านหากมีอยู่ |
No |
| extraSourceLocations |
ตั้งค่าตำแหน่งซอร์สแบบพิเศษ นี่คือรายการของตำแหน่งไฟล์ต้นฉบับที่จะถูกสแกน ซึ่งแยกโดยตัวคั่นพาธของแพลตฟอร์ม แต่ละรายการต้องมีอยู่ ซึ่งควรระบุไว้โดยใช้พาธสัมบูรณ์ |
No |
| allowNonapiproject |
อนุญาตให้งานรันบนโครงการที่เปิดใช้งานเครื่องมือที่ไม่ใช่ API ถ้างานนี้รันบนโครงการที่ไม่มีลักษณะของเครื่องมือ API จะไม่มีไฟล์ api_description ที่ถูกสร้างเมื่อจากสันนิษฐานว่าโครงการไม่สนับสนุนเครื่องมือ API ในบางกรณีมีความจำเป็นต้องสร้างไฟล์คำอธิบายบนโครงการโดยไม่มีลักษณะการทำงาน ตั้งค่าพารามิเตอร์นี้เป็น true จะทำให้งานไม่ตรวจสอบลักษณะการทำงาน |
No |
<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"
/>
ซึ่งจะสร้างไฟล์ชื่อ .api_description ภายในโฟลเดอร์ d:\plugins\org.eclipse.jdt.core ตามซอร์สที่มีอยู่ใน d:\eclipse\org.eclipse.jdt.core และไฟล์ .class ที่มีอยู่ใน d:\eclipse\org.eclipse.jdt.core\bin
ภารกิจ Ant สำหรับการวิเคราะห์
ภารกิจ Ant สำหรับ API Freeze
API ใช้ภารกิจ Ant
ภารกิจ Ant สำหรับการแปลงรายงานการวิเคราะห์
ภารกิจ Ant สำหรับการแปลงรายงาน API Freeze
ภารกิจ Ant สำหรับการไม่ยอมรับ API
ภารกิจ Ant สำหรับการแปลงรายงานการไม่ยอมรับ API
ภารกิจ Ant สำหรับการแปลงรายงานการใช้ API