การสร้างคุณลักษณะและปลั๊กอินของซอร์ส

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

โปรดพิจารณาคุณลักษณะ SDK ต่อไปนี:


features/
org.foo.sdk/
feature.xml: <includes id="org.foo.rcp" />
<includes id="org.foo.rcp.source" />
build.properties: generate.feature@org.foo.rcp.source = org.foo.rcp
org.foo.rcp/
feature.xml: <plugin id="org.foo.BundleA" />
<plugin id="org.foo.BundleB" />
<plugin id="org.foo.BundleB.win32" fragment="true" os="win32" />

แนวคิดของ SDK คือ การสอดแทรกคุณลักษณะพร้อมกับซอร์ส สำหรับคุณลักษณะนั้น  ข้อสังเกต คุณสมบัติ generate.feature ในไฟล์ build.properties ของคุณลักษณะ  คุณสมบัตินี้แจ้งให้ PDE Build สร้างคุณลักษณะที่ชื่อ "org.foo.rcp.source" ซึ่งอ้างอิงตามเนื้อหาของคุณลักษณะ "org.foo.rcp"  PDE build จะสร้างคุณลักษณะ org.foo.rcp.source ซึ่งเป็นปลั๊กอินที่ จะมีซอร์สโค้ดและแฟรกเมนต์ที่มีซอร์สของ บันเดิลที่ระบุเฉพาะแพลตฟอร์มใดๆ ที่จะถูกสอดแทรกในคุณลักษณะ:


features/
org.foo.rcp.source/
feature.xml: <plugin id="org.foo.rcp.source"/>
<plugin id="org.foo.rcp.source.win32" fragment="true" os="win32" />
plugins/
org.foo.rcp.source/src/
org.foo.BundleA/src.zip
org.foo.BundleB/src.zip
org.foo.rcp.source.win32/src/
org.foo.BundleB.win32/src.zip

การปรับแต่งคุณลักษณะของซอร์สที่สร้างขึ้น

คุณสมบัติ generate.feature มีรูปแบบต่อไปนี้:

generate.feature@<source feature id> = <feature id> [, feature@<feature id>[;attribute=value]*]* [, plugin@<plugin id>[;attribute=value]*]*

ใช้ plugin@ เพื่อเพิ่มปลั๊กอินเพิ่มเติมที่ไมได้เป็นส่วนของ คุณลักษณะดั้งเดิมให้กับคุณลักษณะซอร์สที่สร้างขึ้น  สิ่งนี้มีประโยชน์ สำหรับปลั๊กอินเอกสารคู่มือ  feature@ พร้อมกันกับเทมเพลตซอร์ส สามารถใช้กับคุณลักษณะซอร์สที่ซ้อนกัน (โปรดดูด้านล่าง)

เทมเพลตซอร์ส

คุณลักษณะที่มาจากคุณลักษณะซอร์สที่ถูกสร้างขึ้นสามารถ จัดเตรียมไฟล์เทมเพลตที่ต้องการสอดแทรกในคุณลักษณะซอร์สที่สร้างขึ้น:


features/
org.foo.rcp/
sourceTemplateFeature/<files to be included in generated source feature>
sourceTemplatePlugin/<files to be included in generated source plugin>
sourceTemplateFragment/<files to be included in generated platform specific fragments>

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

การซ้อนกันของคุณลักษณะซอร์สที่ขึ้น

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

features/
org.foo.sdk/
sourceTemplateFeature/
build.properties: generate.feature@org.foo.nested.source = org.foo.nested

feature.xml: <includes id="org.foo.rcp" />
<includes id="org.foo.rcp.source" />

build.properties: generate.feature@org.foo.rcp.source = org.foo.rcp, feature@org.foo.nested.source

org.foo.rcp/...
org.foo.nested/...
ในตัวอย่างข้างต้น org.foo.sdk มีคุณลักษณะซอร์สที่สร้างขึ้น ที่ชื่อ org.foo.rcp.source  คุณลักษณะซอร์สที่สร้างขึ้นนี้ จะขอรับไฟล์เทมเพลต sourceTemplateFeature/build.properties  ซึ่งจะสอดแทรก org.foo.nested.source ใน feature.xml.  ดังนั้น เมื่อ PDE build กำลังประมวลผล org.foo.rcp.source ที่สร้างขึ้น PDE build มองเห็นการรวมกันของคุณลักษณะ org.foo.nested.source และคุณสมบัติ generate.feature และจะสร้าง org.foo.nested.source

การสร้างปลั๊กอินซอร์ส

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

generate.plugin@<source plug-in id>=<feature-in id>

โปรดรับรู้ไว้ว่า ปลั๊กอินซอร์สที่มีลักษณะเก่าเหล่านั้น (หนึ่งปลั๊กอินที่มี ซอร์สทั้งหมดสำหรับปลั๊กอินทั้งหมดของคุณลักษณะ) ต้องถูกติดตั้งไว้ใน แบบฟอร์มโฟลเดอร์ ดังนั้น คุณต้องตั้งค่าแอ็ตทริบิวต์ unpack="true" ในไฟล์ feature.xml

ตัวอย่าง:
features/
org.foo.sdk/
feature.xml: <plugin id="org.foo.rcp" />
<plugin id="org.foo.sdk.source" unpack="true" />

build.properties: generate.plugin@org.foo.sdk.source = org.foo.sdk