สคริปต์ Ant ถูกสร้างขึ้นโดยใช้ Plug-in Development
Environment (PDE) แต่ยังมีความเป็นไปได้ในการสร้าง
ปลั๊กอินเหล่านี้โดยมือหรือจากสคริปต์อื่นๆ
โดยในรายละเอียด PDE จะเปิดเผยภารกิจ Ant เพื่อสร้างสคริปต์ build ต่างๆ
การสร้างสคริปต์ build จะอำนวยความสะดวก
ในภารกิจต่อไปนี้ อาร์กิวเมนต์ยังแสดงภารกิจ
แต่ละตัว
| อิลิเมนต์: |
การบันทึกรายการที่จะ ดึงข้อมูล รูปแบบที่คาดคิดไว้คือ รูปแบบ type@id[,version] ตามที่ระบุอยู่ในรูปแบบไฟล์ ไดเร็กทอรี |
| buildDirectory: |
ไดเร็กทอรีที่สคริปต์ fetch จะถูกสร้างขึ้นและคุณลักษณะและโปรเจ็กต์ปลั๊กอินจะ ถูกเช็กเอาต์ |
| directory: |
พาธไปยังไฟล์ไดเร็กทอรี |
| children: |
เป็นตัวเลือก ระบุการสร้างสคริปต์สำหรับปลั๊กอิน ที่มีอยู่และควรเรียกใช้งานแฟรกเมนต์ ค่าดีฟอลต์คือจริง |
| cvspassfile: |
เป็นตัวเลือก ชื่อของไฟล์รหัสผ่าน CVS |
| fetchTag: |
เป็นตัวเลือก override แท็กที่จัดเตรียมไว้ใน ไดเร็กทอรีไฟล์ด้วยค่าที่กำหนดไว้ |
| configInfo: |
เป็นตัวเลือก เครื่องหมายแอมเปอร์แซนด์ ที่คั่นรายการของ คอนฟิกูเรชันที่บ่งชี้คอนฟิกูเรชันที่กำหนดไว้เป็นเป้าหมาย ค่าดีฟอลต์ จะตั้งค่าให้เป็นแพลตฟอร์มอิสระ |
| recursiveGeneration: |
เป็นตัวเลือก ระบุว่า สคริปต์ fetch ควรถูกสร้างขึ้นสำหรับคุณลักษณะที่ซ้อนกันหรือไม่ ค่าดีฟอลต์มีค่าเป็น จริง |
| elements : |
การบันทึกรายการที่ต้องถูก build การบันทึกรายการที่คาดคิดไว้คือรูปแบบ type@id[,version] ตามที่ระบุอยู่ใน รูปแบบไฟล์ไดเร็กทอรี |
| buildDirectory : |
ไดเร็กทอรีที่คุณลักษณะ และปลั๊กอินที่ต้องการ build จะถูกวางอยู่ ปลั๊กอินและคุณลักษณะต้อง วางอยู่ในโฟลเดอร์ plugins และ features ตามลำดับ |
| children : |
เป็นตัวเลือก ระบุการสร้างสคริปต์สำหรับปลั๊กอิน ที่มีอยู่และควรเรียกใช้งานแฟรกเมนต์ ค่าดีฟอลต์คือจริง |
| recursiveGeneration : |
เป็นตัวเลือก ระบุว่า การสร้างสคริปต์ สำหรับคุณลักษณะที่มีควรถูกเรียกใช้งานหรือไม่ ค่าดีฟอลต์มีค่าเป็น จริง |
| devEntries : |
เป็นตัวเลือก เครื่องหมายคอมมาที่คั่นรายการของ ไดเร็กทอรีที่ต้องกำหนดให้กับคอมไพลเลอร์ classpath |
| buildingOSGi : |
เป็นตัวเลือ บ่งชี้ว่า
เป้าหมายคือ 3.x.
หรือ 2.1 ค่าดีฟอลต์คือจริง |
| baseLocation : |
เป็นตัวเลือก บ่งชี้ว่าโฟเลดอร์ มีการติดตั้ง eclipse เป้าหมายด้วยไดเร็กทอรีย่อย features/ และ plugins/ |
| configInfo : |
เป็นตัวเลือก เครื่องหมายแอมเปอร์แซนด์ที่คั่นด้วย คอนฟิกูเรชันที่บ่งชี้คอนฟิกูเรชันที่กำหนดเป้าหมายไว้ ค่าดีฟอลต์ จะตั้งค่าให้เป็นแพลตฟอร์มอิสระ |
| pluginPath : |
เป็นตัวเลือก ตัวคั่นไฟล์แพลตฟอร์มของตำแหน่งเพื่อค้นหาปลั๊กอิน เพิ่มเติม |
| archivesFormat : |
เป็นตัวเลือก เครื่องหมายแอมเปอร์แซนด์ที่คั่นรายการของคอนฟิก และรูปแบบเอาต์พุตที่กำหนดไว้สำหรับแต่ละคอนฟิกเหล่านั้น รูปแบบ ถูกคั่นด้วยเส้นปะ (-) จากคอนฟิกูเรชัน ค่าที่สนับสนุนคือ folder, tar, zip, antZip ตามลำดับซึ่งไม่ได้หมายความถึงไฟล์เก็บถาวร ใช้ tar เพื่อสร้างไฟล์เก็บถาวร ใช้เวอร์ชันของข้อมูล zip ที่พร้อมใช้งานบนแพลตฟอร์ม ใช้ ant zip ค่าดีฟอลต์คือ antZip |
| product : |
เป็นตัวเลือก ซึ่ง '/' จะคั่นพาธ ไปยังตำแหน่งผลิตภัณฑ์ RCP ที่กำลัง build เซ็กเมนต์แรกของพาธต้องอ้างถึง id ปลั๊กอินของปลั๊กอินที่มีไฟล์ .product |
| signJars : |
เป็นตัวเลือก บ่งชี้ว่าสคริปต์ที่สร้างขึ้น ต้องลงนาม jars สำหรับคุณลักษณะและปลั๊กอิน ค่าดีฟอลต์คือเท็จ พารามิเตอร์ในภารกิจการลงนามถูกควบคุมโดยคุณสมบัติ ant ต่อไปนี้: sign.alias, sign.keystore และ sign.storepass ที่ต้องส่งผ่านไปยังพารามิเตอร์ alias, keystore และ storepass ตามลำดับ จากภารกิจ ant signJar ค่าดีฟอลต์คือเท็จ |
| generateJnlp : |
เป็นตัวเลือก ซึ่งบ่งชี้ว่าไฟล์ jnlp ควรถูกสร้างขึ้นสำหรับคุณลักษณะทั้งหมดที่ถูก build |
| outputUpdateJars : |
เป็นตัวเลือก ให้สร้างปลั๊กอินและ คุณลักษณะในรูปแบบอัพเดตไซต์เมื่อตั้งค่าไว้ ค่าดีฟอลต์คือ เท็จ โปรดสังเกตว่า site.xml ไม่ได้ถูกสร้างขึ้นหรืออัพเดต |
| groupConfiguration
: |
เป็นตัวเลือก ไม่ว่าจะจัดกลุ่ม
คอนฟิกูเรชันทั้งหมดที่ build ในไฟล์เก็บถาวรเดี่ยวหรือไม่ก็ตาม |
| generateVersionsLists : |
เป็นตัวเลือก ไม่ว่าจะสร้าง
ไฟล์คุณสมบัติที่แสดงรายการเวอร์ชันของคุณลักษณะและปลั๊กอิน
ที่ถูก build หรือไม่ก็ตาม |
| filteredDependencyCheck : |
เป็นตัวเลือก ข้อจำกัดที่ชุดของปลั๊กอินและคุณสมบัติ
ที่ต้องถูกพิจารณาในระหว่าง build ที่สามารถเข้าถึงได้จากคุณลักษณะ |
| filterP2Base : |
เป็นตัวเลือก ข้อจำกัดที่ชุดของปลั๊กอินและคุณสมบัติ
ที่ต้องถูกพิจารณาจาก baseLocation กับที่ต้องพิจารณาให้ติดตั้งโดย p2 |
| generateFeatureVersionSuffix: | เป็นตัวเลือก ไม่ว่าจะสร้าง คำต่อท้ายเวอร์ชันของคุณลักษณะที่สร้างขึ้นหรือไม่ก็ตาม โปรดดู เวอร์ชัน Qualifiers |
| generatedVersionLength : |
เป็นตัวเลือก ความยาวของคำต่อท้ายเวอร์ชันของคุณลักษณะที่สร้างขึ้น ตามค่าดีฟอลต์แล้ว จะตั้งค่าเป็น 28 โปรดดู เวอร์ชัน Qualifiers |
| significantVersionDigits : |
เป็นตัวเลือก จำนวนของตัวเลขสำคัญที่ถูกนำมาใช้เมื่อสร้างคำต่อท้ายเวอร์ชันของคุณลักษณะ
โปรดดู เวอร์ชัน Qualifiers |
| forceContextQualifier : |
เป็นตัวเลือก ใช้ค่าที่กำหนดไว้
เพื่อแทนที่ .qualifier ที่ถูกใช้โดยปลั๊กอินและคุณลักษณะต่างๆ โปรดดู เวอร์ชัน Qualifiers |
| featureId : |
id เพื่อกำหนดให้กับ
คุณลักษณะที่สร้างขึ้น |
| buildDirectory: |
ไดเร็กทอรีที่คุณลักษณะ
และปลั๊กอิน (ในไดเร็กทอรีย่อย /features และ /plugins)
ที่ต้องการสอดแทรกจะถูกตั้งค่าไว้ คุณลักษณะที่สร้างขึ้นซึ่งถูกวางอยู่ใน
ไดเร็กทอรีย่อย /features |
| baseLocation : |
เป็นตัวเลือก บ่งชี้โฟลเดอร์
ซึ่งมีคุณลักษณะและปลั๊กอินที่ติดตั้งไว้ |
| productFile : |
เป็นตัวเลือก ไฟล์ผลิตภัณฑ์
ที่เป็นฐานของคุณลักษณะที่สร้างขึ้น |
| verify : |
ไม่ว่าจะใช้ตัวแก้ปัญหา
เพื่อตรวจสอบว่า ปลั๊กอินและคุณลักษณะที่จัดเตรียมไว้
พร้อมใช้งาน ซึ่งยังกำหนดว่า คุณลักษณะจะต้องสามารถจัดการ
กับแฟรกเมนต์ที่ระบุเฉพาะแพลตฟอร์มและปลั๊กอิน
จะเป็น JARed. หรือไม่ หากอิลิเมนต์ทั้งหมดที่ต้องสอดแทรกในคุณลักษณะ
พร้อมใช้งานแบบโลคัล การตรวจสอบความถูกต้องควรตั้งค่า
เป็นจริง หากอิลิเมนต์ต้องการดึงข้อมูลจากแหล่งเก็บข้อมูล
ให้ตั้งค่าการตรวจสอบเป็นเท็จ ให้ใช้คุณลักษณะของผลลัพธ์เพื่อดึงข้อมูลปลั๊กอิน
และคุณลักษณะที่ต้องการ จากนั้นสร้างคุณลักษณะคอนเทนเนอร์อีกครั้งโดยใช้
verify = True |
| pluginPath : |
เป็นตัวเลือก ตัวคั่นไฟล์แพลตฟอร์ม ที่คั่นรายการของตำแหน่งที่ต้องการค้นหา ปลั๊กอินเพิ่มเติม |
| configInfo : |
เป็นตัวเลือก เครื่องหมายแอมเปอร์แซนด์ที่คั่นด้วย คอนฟิกูเรชันที่บ่งชี้คอนฟิกูเรชันที่กำหนดเป้าหมายไว้ ค่าดีฟอลต์ จะตั้งค่าให้เป็นแพลตฟอร์มอิสระ |
| pluginList : |
เป็นตัวเลือก เครื่องหมายคอมมา
ที่คั่นรายการของ id ปลั๊กอินเพื่อสอดแทรกลงในคุณสมบัติที่สร้างขึ้น (สนับสนุนแอ็ตทริบิวต์ โปรดดูด้านล่าง) |
| featureList : |
เป็นตัวเลือก เครื่องหมายคอมมา
ที่คั่นรายการของ id คุณลักษณะในคุณลักษณะที่สร้างขึ้น (สนับสนุนแอ็ตทริบิวต์ โปรดดูด้านล่าง) |
| fragmentList : |
เป็นตัวเลือก เครื่องหมายคอมมาที่คั่นรายการของ
id แฟรกเมนต์เพื่อสอดแทรกในคุณลักษณะที่สร้างขึ้น (สนับสนุนแอ็ตทริบิวต์ โปรดดูด้านล่าง) |
| buildPropertiesFile : |
เป็นตัวเลือก ตำแหน่งของไฟล์คุณสมบัติที่มีเนื้อหาที่ควรถูกใช้เป็น build.properties ของคุณลักษณะที่สร้างขึ้น |
| includeLaunchers : |
เป็นตัวเลือก ไม่ว่าจะสอดแทรกโปรแกรมเรียกทำงาน equinox หรือไม่ก็ตาม ค่าดีฟอลต์คือ "จริง" |
อาร์กิวเมนต์ pluginList, featureList และ fragmentList ของภารกิจ eclipse.generateFeature ทั้งหมดนี้จะสนับสนุนแอ็ตทริบิวต์ต่างๆ อาร์กิวเมนต์เหล่านี้จะอยู่ในรูปแบบ:
List = <element-id>[;<attribute>=<value>]* [,<element-id>[;<attribute>=<value>]*]*
คู่ attribute=value แต่ละคู่จะแทรก xml ที่สร้างขึ้นซึ่งสอดคล้องกับอิลิเมนต์ที่กำหนดไว้ ตัวอย่าง:
featureList = org.eclipse.feature;optional=true
pluginList = org.eclipse.plugin.A;unpack=true
fragmentList=org.eclipse.fragment.a;os=win32,org.eclipse.fragment.b;os=linux;ws=gtk;arch=x86
<feature ...>
...
<includes id="org.eclipse.feature" version="0.0.0" optional="true" />
...
<plugin id="org.eclipse.plugin.A" version="0.0.0" unpack="true" />
<plugin id="org.eclipse.fragment.a" version="0.0.0" os="win32" fragment="true" />
<plugin id="org.eclipse.fragment.b" version="0.0.0" os="linux" ws="gtk" arch="x86" fragment="true" />
...
</feature>
<eclipse.fetch elements="bundle@org.eclipse.osgi"
buildDirectory="c:\toBuild"
directory="directory.txt"
configInfo="win32,win32,x86 & linux, motif, x86"
/>
<eclipse.buildScript elements="bundle@org.eclipse.osgi"
buildDirectory="c:\toBuild"
archivesFormat="macosx, carbon, ppc - tar"/>
ภารกิจที่ถูกกล่าวถึงงานก่อนหน้านี้เท่านั้นหาก Eclipse กำลังรันอยู่ ในสถานการณ์จำลองเฉพาะ ของการเรียกใช้สคริปต์ Ant โดยใช้ภารกิจ Eclipse สคริปต์ต้องถูกรันโดยใช้แอ็พพลิเคชัน Eclipse Ant Runner บรรทัดรับคำสั่งสำหรับกรณีเฉพาะ มีดังต่อไปนี้:
java -jar plugins/org.eclipse.equinox.launcher_<version>.jar -application org.eclipse.ant.core.antRunner -buildfile build.xml
โปรดสังเกตว่า พารามิเตอร์ที่ปรากฏขึ้นหลังจากที่แอ็พพลิเคชันเป็นพารามิเตอร์ ซึ่งส่งผ่านไปยัง Ant