บันเดิลซอร์สระบุไว้ด้วยการมีอยู่ของส่วนหัว Eclipse-SourceBundle ใน manifest รูปแบบของส่วนหัวนี้คือ:
Eclipse-SourceBundle: <bundle-id>;version=<version>;roots:="root1, root2"
id บันเดิลและเวอร์ชันบ่งชี้ถึงบันเดิลที่สอดคล้องกับซอร์สโค้ดที่สอดแทรกไว้ คำสั่ง root บ่งชี้โฟลเดอร์ภายในบันเดิลซอร์สที่มีซอร์สโค้ด หากไม่มีคำสั่ง root ที่ระบุไว้ ค่าของ "." จะถูกสมมติขึ้น
ไลบรารีไฟล์คลาสถูกแม็พกับตำแหน่งซอร์สในลักษณะที่คาดเดาได้ root ของปลั๊กอินแม็พกับ root ของบันเดิลซอร์ส นี่คือกรณีหลักสำหรับปลั๊กอิน jarred ส่วนใหญ่ หากปลั๊กอินมีไลบรารี "foo/lib.jar" เพิ่มเติม ซอร์สถูกคาดการณ์ไว้เพื่อให้สอดคล้องกับโฟลเดอร์ "foo/libsrc/" ในบันเดิลซอร์ส
org.eclipse.pde.core.jar org.eclipse.pde.core.source.jar - org/**/*.class - org/**/*.java - ant_tasks/pde-ant.jar - ant_tasks/pde-antsrc/org/**/*.java
Eclipse-SourceBundle: org.eclipse.pde.core;version="3.4.0.N20071128-0010";roots:="ant_tasks/pde-antsrc,."
org.eclipse.pde.build/ org.eclipse.pde.build.source.jar - pdebuild.jar - pdebuildsrc/org/**/*.java - lib/pdebuild-ant.jar - lib/pdebuild-antsrc/org/**/*.java
Eclipse-SourceBundle: org.eclipse.pde.build;version="3.4.0.N20071128-0010";roots:="pdebuildsrc,lib/pdebuild-antsrc"
PDE/Build สามารถสร้างบันเดิลซอร์สเดี่ยวแบบอัตโนมัติ แต่ใน build ที่ไม่มีส่วน headless เดี่ยว การสร้างบันเดิลซอร์สเดี่ยวสามารถเปิดโดยระบุ:
individualSourceBundles=true
ต้องระบุอยู่ในไฟล์ build.properties ระดับบนสุดของคอนฟิกูเรชันและควบคุมการสร้างซอร์สทั้งหมดสำหรับ build นั้น โปรดดู การสร้างคุณลักษณะและปลั๊กอินของซอร์ส สำหรับรายละเอียดเกี่ยวกับการสร้างปลั๊กอินและคุณลักษณะดั้งเดิม ส่วนที่เหลือของเพจนี้สมมติว่ามีความคล้ายคลึงกันด้วยการสร้างซอร์สดั้งเดิม
generate.feature@<source feature id> = <feature id> [, feature@<feature id>]* [, plugin@<plugin id>]* [, exclude@<plugin id>]*
เมื่อสร้างบันเดิลซอร์สเดี่ยว คุณสมบัตินี้เหลืออยู่ก่อนและสนับสนุนแอ็ตทริบิวต์เดียวกัน (เช่น version, unpack, optional เป็นต้น) ความแตกต่างจะถูกสังเกตในผลลัพธ์ของคุณลักษณะซอร์ส ก่อนหน้านี้ คุณลักษณะซอร์สถูกสอดแทรก 1 ปลั๊กอินซอร์ส + แฟรกเมนต์ซอร์สสำหรับแพลตฟอร์มแต่ละตัวที่ถูก build ในรูปแบบใหม่ คุณลักษณะซอร์สจะสอดแทรกบันเดิลซอร์สสำหรับปลั๊กอิน/แฟรกเมนต์แต่ละตัวที่แสดงอยู่ในคุณลักษณะดั้งเดิม
ปลั๊กอินที่ถูกสอดแทรกในคุณลักษณะซอร์สผ่านไวยากรณ์ plugin@ จะไม่ได้ขอรับบันเดิลของซอร์สที่สอดคล้องกัน ซึ่งเป็นประโยชน์สำหรับการเพิ่มปลั๊กอิน doc ให้กับคุณลักษณะซอร์ส
การบันทึกรายการ exclude@ เป็นสิ่งใหม่สำหรับการสร้างซอร์สเดี่ยว ปลั๊กอินบางตัวที่ถูกสอดแทรกในการสร้างคุณลักษณะ (เช่น ปลั๊กอิน doc หรือแฟรกเมนต์ที่มีโค้ดดั้งเดิมเท่านั้น) อาจไม่มีซอร์สและควรแยกออกจากคุณลักษณะของซอร์สที่สร้างขึ้น การบันทึกรายการ exclude@ สนับสนุนแอ็ตทริบิวต์ version
ตัวอย่าง:generate.feature@org.eclipse.jdt.source=org.eclipse.jdt, plugin@org.eclipse.jdt.doc.isv;unpack="false",exclude@org.eclipse.jdt.doc.user
ในรูปแบบเก่า คุณสมบัติ generate.plugin สร้างปลั๊กอินซอร์สที่อ้างอิงตามเนื้อหาของคุณลักษณะที่กำหนด เมื่อสร้างบันเดิลซอร์สเดี่ยวแล้ว บันเดิลนี้เปลี่ยนไปเป็นการอ้างอิงปลั๊กอินที่กำหนดเอง:
generate.plugin@<source plug-in id>=<plug-in id>
คุณสมบัต generate.plugin ถูกใช้โดยคุณลักษณะเพื่อสอดแทรกซอร์สที่ไม่มีคุณลักษณะซอร์ส (แม้ว่าจะซ่อนเหตุการณ์ที่สร้างคุณลักษณะซอร์สทั้งหมด) เมื่อสร้างบันเดิลซอร์สเดี่ยว คุณลักษณะจะต้องการให้สอดแทรกบันเดิล *.source สำหรับปลั๊กอินแต่ละตัวที่มีคุณสมบัติ generate.plugin ที่สอดคล้องกันสำหรับแต่ละตัว
ตัวอย่าง: คุณลักษณะ sdk.examples ที่ใช้จะคล้ายกับที่แสดงต่อไปนี้:
<feature id="org.eclipse.sdk.examples" ... > .... <plugin id="org.eclipse.sdk.examples.source" version="0.0.0"/> <plugin id="org.eclipse.sdk.examples.source.win32.win32.x86" version="0.0.0"/> </feature>
generate.plugin@org.eclipse.sdk.examples.source=org.eclipse.sdk.examples
ซึ่งจะเปลี่ยนไปเป็น:
<feature id="org.eclipse.sdk.examples" ...> ... <plugin id="org.eclipse.compare.examples.source" version="0.0.0"/> <plugin id="org.eclipse.debug.examples.core.source" version="0.0.0"/> <plugin id="org.eclipse.swt.examples.source" version="0.0.0"/> </feature>
generate.plugin@org.eclipse.compare.examples.source=org.eclipse.compare.examples generate.plugin@org.eclipse.debug.examples.core.source=org.eclipse.debug.examples.core generate.plugin@org.eclipse.swt.examples.source=org.eclipse.swt.examples
ปลั๊กอินที่ระบุเฉพาะอาจไม่ต้องการบันเดิลซอร์สเนื่องจากปลั๊กอินเหล่านั้นไม่มีซอร์สอยู่จริง ซึ่งอาจเกิดขึ้นได้กับแพลตฟอร์มที่ระบุเฉพาะแฟรกเมนต์ที่มีไลบรารีดั้งเดิมเท่านั้น ในกรณีนี้ บันเดิลอาจถูกแยกโดยคุณลักษณะที่เป็นโครงร่างข้างต้นใน generate.feature
หรือบันเดิลสามารถระบุอยู่ในไฟล์ build.properties ของตนเองซึ่งไม่มีบันเดิลซอร์สใดๆ ที่ควรถูกสร้างขึ้น:
generateSourceBundle=false
เนื้อหาแบบกำหนดเองสามารถเพิ่มให้กับบันเดิลซอร์สที่ถูกสร้างขึ้นโดยใช้ callback post.gather.source แบบกำหนดเองในการให้กำเนิดบันเดิล (โปรดดู ขั้นตอนการ build แบบกำหนดเองของคุณลักษณะและปลั๊กอิน)
เมื่อทำสิ่งนี้ ให้ตั้งค่าคุณสมบัติ "src.additionalRoots" ในไฟล์ build.properties ของปลั๊กอิน ดังนั้นบันเดิลซอร์สที่สร้างขึ้นจะมีคำสั่ง root ที่ถูกต้องบนส่วนหัวของ Eclipse-SourceBundle
ตัวอย่าง:
org.junit4 :
build.properties
src.includes = about.html,junitsrc.zip
src.additionalRoots=junitsrc
customBuildCallbacks=customBuildCallbacks.xml
customBuildCallbacks.xml
<target name="post.gather.sources" >
<mkdir dir="${target.folder}/junitsrc"/>
<unzip src="${target.folder}/junitsrc.zip" dest="${target.folder}/junitsrc" overwrite="false"/>
<delete file="${destination.temp.folder}/junitsrc.zip" />
</target>
ก่อนหน้านี้ ปลั๊กอินที่สร้างขึ้นซึ่งใช้เป็นการกำหนดแบรนด์ของปลั๊กอินสำหรับคุณลักษณะซอร์สที่สร้างขึ้น การกำหนดแบรนด์ของไฟล์ (about.properties, eclipse32.gif เป็นต้น) ถูกจัดเตรียมไว้โดยใช้ไดเร็กทอรี sourceTemplatePlugin ในคุณลักษณะดั้งเดิม
เมื่อสร้างบันเดิลซอร์สเดี่ยว ปลั๊กอินของการกำหนดแบรนด์สำหรับคุณลักษณะซอร์สจะเป็นบันเดิลซอร์สที่สอดคล้องกับปลั๊กอินของการกำหนดแบรนด์ดั้งเดิม ซึ่งหมายความว่า ไฟล์ที่กำหนดแบรนด์สำหรับปลั๊กอินของการกำหนดแบรนด์ของคุณลักษณะซอร์สสามารถสนับสนุนการใช้คุณสมบัติ src.includes ในปลั๊กอินของการกำหนดแบรนด์ดั้งเดิม
โฟลเดอร์ sourceTemplatePlugin ของคุณลักษณะที่เรากำลังสร้างซอร์สยังสนับสนุนไฟล์กับปลั๊กอินของการกำหนดแบรนด์
ก่อนหน้านี้ เนื้อหาของไดเร็กทอรี sourceTemplatePlugin ของคุณลักษณะดั้งเดิมถูกคัดลอกไปยังปลั๊กอินของซอร์ส เมื่อสร้างบันเดิลซอร์สแต่ละตัว บันเดิลซอร์สยังคงเป็นจริงสำหรับบันเดิลซอร์สของการกำหนดแบรนด์เท่านั้น (ดูด้านบน)
สำหรับบันเดิลซอร์สอื่นๆ ทั้งหมด เนื้อหาของไดเร็กทอรี sourceTemplateBundle จะถูกคัดลอก