ขั้นตอนการ build แบบกำหนดเองสำหรับคุณลักษณะและปลั๊กอิน
สิ่งที่เกิดขึ้นใหม่ใน 3.2 คือความสามารถสำหรับคุณลักษณะหรือปลั๊กอิน
ที่ต้องการสนับสนุน ant เป้าหมายแบบกำหนดเองกับการ build ของตนเอง ขั้นตอนแบบกำหนดเองเหล่านี้
สามารถนำมาใช้กับสิ่งต่างๆ เช่น การติดตั้งเครื่องมือแบบ byte-code หลังจากการคอมไพล์
การทำดัชนีไฟล์วิธีใช้สำหรับเอกสารคู่มือ หรือการคัดลอกไฟล์เพิ่มเติมลงใน
บันเดิล
เพื่อใช้เป้าหมายแบบกำหนดเอง คุณลักษณะหรือปลั๊กอินต้องนิยามคุณสมบัติ
customBuildCallbacks ในไฟล์ build.properties
ค่าของคุณสมบัตินี้
คือตำแหน่งของไฟล์ xml ซึ่งเกี่ยวข้องกับ root
คุณลักษณะ/ปลั๊กอินที่มีเป้าหมายแบบกำหนดเอง หากไฟล์ xml ถูกวางอยู่ตำแหน่งอื่นใด ให้ใช้คุณสมบัติ
customBuildCallbacks.buildpath เพื่อตั้งค่าไดเร็กทอรีที่ต้องการใช้
เทมเพลตที่ชื่อ
customBuildCallbacks.xml
ที่มีเป้าหมายแบบกำหนดเองที่สนับสนุนถูกจัดเตรียมไว้ใน
org.eclipse.pde.build/templates/plugins และ
org.eclipse.pde.build/templates/features เทมเพลตเหล่านี้
สามารถคัดลอกไปยังคุณลักษณะ/ปลั๊กอินของุคณและปรับเปลี่ยน
ตามความต้องการ
เป้าหมายแบบกำหนดเองจะเรียกใช้งานโดยใช้ภารกิจ subant ซึ่งตามค่าดีฟอลต์ failonerror จะตั้งค่าเป็นเท็จ เพื่อเปลี่ยนค่านี้
ให้ตั้งค่าคุณสมบัติ customBuildCallbacks.failonerror เป็นจริง เช่นเดียวกับพารามิเตอร์ inheritall ที่มีค่าดีฟอลต์เป็นเท็จ ตั้งค่าคุณสมบัติ
customBuildCallbacks.inheritall เพื่อเปลี่ยนแปลงค่านี้
ปลั๊กอิน
build.xml ที่สร้างขึ้นซึ่ง builds ปลั๊กอินมีเป้าหมายต่างๆ
จำนวนมากที่ดำเนินการกับภารกิจที่ระบุไว้ PDE Build ยอมให้ปลั๊กอิน
จัดเตรียมก่อนและหลังเป้าหมายแบกำหนดเองที่จะถูกเรียกก่อน
และหลังภารกิจที่ระบุเฉพาะ นอกจากคุณสมบัติ ant ใดๆ ที่อาจถูกนิยามไว้
เป้าหมายแบบกำหนดเองแต่ละข้ออาจยังส่งผ่านคุณสมบัติที่ระบุไว้
ไม่กี่ข้อ เป้าหมายต่อไปนี้สนับสนุน
callbacks แบบกำหนดเอง:
- build.jars:
เป้าหมาย build.jars จะเรียกใช้งานในทางตรงข้ามกับแต่ละเป้าหมายการคอมไพล์
ที่จะ build สำหรับบันเดิลนี้ และสนับสนุนเป้าหมาย pre.build.jars และ post.build.jars
ที่ถูกเรียกก่อนและหลังการคอมไพล์เป้าหมายทั้งหมดจะถูกเรียก
เป้าหมายทั้งก่อนและหลังจะถูกจัดเตรียมไว้พร้อมกับคุณสมบัติ build.result.folder
ซึ่งเป็นโฟลเดอร์ที่
ผลลัพธ์ของการ
build จะถูกคัดลอก
- การคอมไพล์เป้าหมาย:
build.xml นิยามการคอมไพล์เป้าหมายสำหรับแต่ละ jar ที่ถูก build (เช่น
@dot สำหรับตัวบันเดิลเอง หรือ library.jar) แต่ละการคอมไพล์เป้าหมาย
สนับสนุน 3 callbacks แบบกำหนดเอง:
- pre.<compilation target>:
เรียกก่อนที่ไฟล์ต้นฉบับจะถูกคอมไพล์ ซึ่งจัดเตรียมไว้พร้อมกับ
คุณสมบัติต่อไปนี้:
- post.compile.<compilation
target>: เรียกหลังจากที่ซอร์สคอมไพล์แล้ว
แต่ก่อนที่ไฟล์ class จะถูก jared หรือคัดลอกลงในโฟลเดอร์
ผลลัพธ์สำหรับการ build
ซึ่งจัดเตรียมไว้พร้อมกับคุณสมบัติเดียวกันกับเป้าหมาย pre.<compilation
target>
- post.<compilation target>:
เรียก ณ จุดสิ้นสุดการคอมไพล์เป้าหมายหลังจากที่ผลลัพธ์
ถูกคัดลอกไปยังโฟลเดอร์ผลลัพธ์การ build ซึ่งจัดเตรียมไว้พร้อมกับ
คุณสมบัติต่อไปนี้:
- jar.Location: jar หรือโฟลเดอร์ที่มี
ผลลัพธ์การคอมไพล์
- <compilation target>.classpath: การอ้างถึง
โครงสร้างพาธของ ant มีคลาสพาธที่ถูกใช้ใน
การคอมไพล์
- build.sources:
เป้าหมายนี้ build ซอร์สไฟล์แบบบีบอัดสำหรับการคอมไพล์
เป้าหมายแต่ละครั้ง ซึ่งสนับสนุนเป้าหมาย pre.build.sources
และ post.build.sources ทั้งสองเป้าหมายนี้ถูกจัดเตรียมไว้ด้วยคุณสมบัติ
build.result.folder ที่เป็นโฟลเดอร์ที่ไฟล์ต้นฉบับแบบบีบอัด
จะถูกคัดลอก
- gather.bin.parts:
เป้าหมายนี้คัดลอกผลลัพธ์การ build (เช่น jars และไฟล์อื่นใด
ที่สอดแทรอยู่ในบันเดิล) ไปยังไดเร็กทอรีปลายทางสุดท้าย
และยังเป็นเป้าหมายที่เวอร์ชัน qualifiers จะถูกแทนที่ในไฟล์
manifest (โปรดดู เวอร์ชัน
Qualifiers) ซึ่งสนับสนุนเป้าหมาย pre.gather.bin.parts
และ post.gather.bin.parts สองคุณลักษณะที่ถูกจัดเตรียมไว้ให้กับเป้าหมายก่อนและหลัง:
- build.result.folder: โฟลเดอร์ที่มีผลลัพธ์
ของการ
build
- target.folder: โฟลเดอร์ปลายทาง
ที่ผลลัพธ์การ build
และเนื้อหาบันเดิลจะถูกคัดลอก
- gather.sources:
เป้าหมายนี้รวบรวมซอร์สแบบบีบอัดสำหรับบันเดิล ซึ่งสนับสนุนเป้าหมาย pre.gather.sources และ post.gather.sources
เป้าหมายทั้งก่อน
และหลังจะถูกจัดเตรียมไว้พร้อมกับคุณสมบัติ target.folder
ซึ่งเป็นโฟลเดอร์ที่ซอร์สต้องถูกคัดลอก
- gather.logs:
เป้าหมายนี้รวบรวมล็อกไฟล์จากการ build ซึ่งสนับสนุน pre.gather.logs และ post.gather.logs ทั้งเป้าหมาย
ก่อนและหลัง
จะถูกจัดเตรียมไว้พร้อมกับ destination.temp.folder ซึ่งเป็นโฟลเดอร์ชั่วคราว
ที่ล็อกไฟล์จะถูกคัดลอก
- clean: เป้าหมายนี้
ดำเนินการล้างข้อมูล ซึ่งสนับสนุนเป้าหมาย pre.clean
และ post.clean
เป้าหมายก่อนและหลังมีคุณสมบัติต่อไปนี้:
- plugin.destination: โฟลเดอร์ที่
บันเดิลสุดท้าย
จะถูกคัดลอก
- build.result.folder: โฟลเดอร์ที่ผลลัพธ์
ของการ build
จะถูกคัดลอก
- temp.folder: โฟลเดอร์ชั่วคราวที่ผลลัพธ์
จะถูกแบ่งขั้นก่อนที่จะคัดลอกไปยังปลายทางสุดท้าย
คุณลักษณะ
build.xml ที่สร้างขึ้นสำหรับคุณลักษณะเท่านั้นที่สนับสนุน build
callbacks แบบกำหนดเองสำหรับเป้าหมาย gather.bin.parts เป้าหมายนี้
จะเรียกใช้เป้าหมาย gather.bin.parts ของคุณลักษณะและปลั๊กอิน
ทั้งหมดที่สอดแทรก ซึ่งสนับสนุน pre.gather.bin.parts และ
post.gather.bin.parts ทั้งสองเป้าหมายนี้
ถูกจัดเตรียมไว้พร้อมกับคุณสมบัติต่อไปนี้:
- destination.temp.folder: ไดเร็กทอรี
ที่ปลั๊กอินจะถูกคัดลอก
- feature.directory: ไดเร็กทอรีที่ไฟล์
สำหรับคุณลักษณะนี้
จะถูกคัดลอก