บันเดิลซอร์สเดี่ยว

รูปแบบดั้งเดิมของบันเดิลซอร์สใน Eclipse คือโฟลเดอร์ที่มี src.zip สำหรับปลั๊กอินทั้งหมดที่สอดแทรกอยู่ในคุณลักษณะที่กำหนดไว้ การเริ่มต้นใน 3.4 Eclipse จะจัดส่งมาพร้อมกับบันเดิลซอร์สเดี่ยว สำหรับบันเดิลแต่ละตัว มีบันเดิลซอร์สที่สอดคล้องกันซึ่งเป็น jar ที่มีซอร์สสำหรับบันเดิลนั้น ซึ่งยอมให้ใช้สำหรับการจัดส่งของซอร์สที่มีความยืดหยุ่นเพิ่มเติม และยังบรรเทาความกว้างของพาธบางส่วนที่แสดงซึ่งอาจเป็นประสบการณ์บนแพลตฟอร์มบางอย่าง

Eclipse-SourceBundle

บันเดิลซอร์สระบุไว้ด้วยการมีอยู่ของส่วนหัว Eclipse-SourceBundle ใน manifest รูปแบบของส่วนหัวนี้คือ:

Eclipse-SourceBundle: <bundle-id>;version=<version>;roots:="root1, root2"

id บันเดิลและเวอร์ชันบ่งชี้ถึงบันเดิลที่สอดคล้องกับซอร์สโค้ดที่สอดแทรกไว้ คำสั่ง root บ่งชี้โฟลเดอร์ภายในบันเดิลซอร์สที่มีซอร์สโค้ด หากไม่มีคำสั่ง root ที่ระบุไว้ ค่าของ "." จะถูกสมมติขึ้น

ไลบรารีไฟล์คลาสถูกแม็พกับตำแหน่งซอร์สในลักษณะที่คาดเดาได้ root ของปลั๊กอินแม็พกับ root ของบันเดิลซอร์ส นี่คือกรณีหลักสำหรับปลั๊กอิน jarred ส่วนใหญ่ หากปลั๊กอินมีไลบรารี "foo/lib.jar" เพิ่มเติม ซอร์สถูกคาดการณ์ไว้เพื่อให้สอดคล้องกับโฟลเดอร์ "foo/libsrc/" ในบันเดิลซอร์ส

การสร้างบันเดิลซอร์สเดี่ยว

PDE/Build สามารถสร้างบันเดิลซอร์สเดี่ยวแบบอัตโนมัติ แต่ใน build ที่ไม่มีส่วน headless เดี่ยว การสร้างบันเดิลซอร์สเดี่ยวสามารถเปิดโดยระบุ:

individualSourceBundles=true

ต้องระบุอยู่ในไฟล์ build.properties ระดับบนสุดของคอนฟิกูเรชันและควบคุมการสร้างซอร์สทั้งหมดสำหรับ build นั้น โปรดดู การสร้างคุณลักษณะและปลั๊กอินของซอร์ส สำหรับรายละเอียดเกี่ยวกับการสร้างปลั๊กอินและคุณลักษณะดั้งเดิม ส่วนที่เหลือของเพจนี้สมมติว่ามีความคล้ายคลึงกันด้วยการสร้างซอร์สดั้งเดิม

generate.feature

ในไฟล์ build.properties ของคุณลักษณะ คุณสมบัติ generate.feature บอกให้ pde.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 สร้างปลั๊กอินซอร์สที่อ้างอิงตามเนื้อหาของคุณลักษณะที่กำหนด เมื่อสร้างบันเดิลซอร์สเดี่ยวแล้ว บันเดิลนี้เปลี่ยนไปเป็นการอ้างอิงปลั๊กอินที่กำหนดเอง:

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

generateSourceBundle

ปลั๊กอินที่ระบุเฉพาะอาจไม่ต้องการบันเดิลซอร์สเนื่องจากปลั๊กอินเหล่านั้นไม่มีซอร์สอยู่จริง ซึ่งอาจเกิดขึ้นได้กับแพลตฟอร์มที่ระบุเฉพาะแฟรกเมนต์ที่มีไลบรารีดั้งเดิมเท่านั้น ในกรณีนี้ บันเดิลอาจถูกแยกโดยคุณลักษณะที่เป็นโครงร่างข้างต้นใน 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

ก่อนหน้านี้ เนื้อหาของไดเร็กทอรี sourceTemplatePlugin ของคุณลักษณะดั้งเดิมถูกคัดลอกไปยังปลั๊กอินของซอร์ส เมื่อสร้างบันเดิลซอร์สแต่ละตัว บันเดิลซอร์สยังคงเป็นจริงสำหรับบันเดิลซอร์สของการกำหนดแบรนด์เท่านั้น (ดูด้านบน)

สำหรับบันเดิลซอร์สอื่นๆ ทั้งหมด เนื้อหาของไดเร็กทอรี sourceTemplateBundle จะถูกคัดลอก