การดึงข้อมูลจากแหล่งเก็บข้อมูล

โครงสร้างพื้นฐานที่นำเสนอโดย PDE Build จัดเตรียมขั้นตอนเพื่อดึงข้อมูลซอร์สโค้ด และปลั๊กอินที่ built ล่วงหน้าจากแหล่งเก็บข้อมูลที่เป็นส่วนหนึ่งของกระบวนการ build (โปรดดูภารกิจ eclipse.fetch และ คุณสมบัติเพื่อควบคุมการดึงข้อมูล) มีความเป็นไปได้สองอย่างที่มีอยู่: อนุญาตให้ PDE build ดึงข้อมูลซอร์สโดยอัตโนมัติ หรือดึงข้อมูลซอร์สโค้ดแบบแมนวล

ขั้นตอนแรกในการทำให้เป็นอัตโนมัติ คือ ไฟล์แม็พ

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

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

<elementType>@<elementID>[,<elementVersion>] = <repo specific content>

โดยที่ elementType คือหนึ่งใน bundle, feature, plugin หรือ fragment และ elementId และ elementVersion กำหนดอิลิเมนต์ที่ระบุเฉพาะ

การบันทึกรายการไฟล์แม็พสำหรับ CVS

การบันทึกรายการรูปแบบของไฟล์แม็พที่ต้องการดึงข้อมูลเนื้อหาจาก CVS มีดังต่อไปนี้:
<key> = CVS, [,args]
โดยที่ args คือเครื่องหมายคอมมาที่คั่นรายการของคู่ คีย์/ค่าตามที่กล่าวถึงด้านล่าง: ตัวอย่าง:
plugin@com.ibm.icu,3.6.1=CVS,tag=v200704191630,cvsRoot=:pserver:anonymous@dev.eclipse.org:/cvsroot/tools,path=org.eclipse.orbit/com.ibm.icu/bin,prebuilt=true

การบันทึกรายการแม็พลักษณะแบบเก่า
ใน Eclipse 3.2 และก่อนหน้านี้ รูปแบบไฟล์แม็พสำหรับ CVS คือ:
<elementType>@<elementID> = CVS, <TAG>, <CVSROOT>[,<PASSWORD>[,<PATH>[,<CVSPASSFILE>]]]
หากอาร์กิวเมนต์ของอ็อพชันเผื่อเลือกใดๆ ไม่ได้ระบุไว้ เครื่องหมายคอมมาจะยังคงจำเป็นต้องมีเพื่อคั่นอาร์กิวเมนต์ต่อไปนี้ รูปแบบนี้ควรถูกนำมาพิจารณาว่าไม่เป็นที่ยอมรับและรูปแบบ คีย์/ค่า เป็นรูปแบบที่ต้องการ

การบันทึกรายการไฟล์แม็พสำหรับ Ant GET

รูปแบบของการบันทึกรายการไฟล์แม็พที่ต้องการดึงเนื้อหาจาก URL ใดๆ ที่ได้รับการสนับสนุนโดย Ant GET มีรูปแบบดังต่อไปนี้:

<key> = GET, <url> [,args]
โดยที่ url คือ url ที่ต้องดึงข้อมูลและ args คือรายการของคู่ คีย์/ค่า ที่คั่นด้วยเครื่องหมายคอมมาตามที่กล่าวถึงด้านล่าง: ตัวอย่าง:
plugin@com.ibm.icu,3.4.5=GET,http://download.eclipse.org/tools/orbit/downloads/drops/S200705301823/bundles/com.ibm.icu_3.4.5.jar, unpack=true

การบันทึกรายการไฟล์แม็พสำหรับการดึงข้อมูล p2

ส่วนขยายใหม่ถูกเพิ่มให้กับ PDE/Build ที่เปิดใช้งานผู้ใช้เพื่อดึงข้อมูลสิ่งที่สร้างขึ้นจากแหล่งเก็บข้อมูล p2 ถึงตอนนี้ คุณสามารถเพิ่ม การบันทึกรายการให้กับไฟล์แม็พของคุณสำหรับ build อินพุตและ PDE/Build จะเรียกคืนสิ่งที่สร้างขึ้นและสอดแทรกลงใน build การบันทึกรายการไฟล์แม็พจำเป็นต้องสอดแทรก id และเวอร์ชันของ installable unit (IU) และ URI ของแหล่งเก็บข้อมูลที่สามารถพบ IU ได้ หน่วยเก็บข้อมูลเมตาและสิ่งที่สร้างขึ้น ถูกสมมติให้อยู่ในตำแหน่งร่วมกัน

รูปแบบของการบันทึกรายการของแม็พไฟล์เพื่อดึงเนื้อหาผ่าน p2 มีดังต่อไปนี้:

<elementType>@<elementID> = p2IU, id=<id>, version=<version>, repository=<repository>
การดึงคุณลักษณะด้วย p2

ในรีลีส Helios คุณลักษณะสามารถดึงข้อมูลออกมาได้ด้วย p2 โดยระบุ Installable Unit ที่แสดงถึงคุณลักษณะของ jar โปรดดูหน้า คุณลักษณะของข้อมูลเมตา สำหรับรายละเอียดเกี่ยวกับโครงสร้างของข้อมูลเมตา p2 สำหรับคุณลักษณะ

ตัวอย่าง:
plugin@my.bundle.id,1.0.0=p2IU,id=my.bundle.id,version=1.0.0,repository=http://example.eclipse.org/repo
feature@my.feature.id = p2IU,id=my.feature.id.feature.jar, version=1.0.0,repository=http://example.eclipse.org/repo

การบันทึกรายการของไฟล์แม็พสำหรับแหล่งเก็บข้อมูลอื่น

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

การตั้งค่าสำหรับการดึงข้อมูลซอร์ส CVS

เพื่อตั้งค่าการดึงข้อมูลซอร์สของคุณจาก CVS คุณควรทำสิ่งต่อไปนี้:

การขอรับไฟล์แม็พจาก CVS

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

การดึงข้อมูลจากแหล่งเก็บข้อมูลอื่นๆ แบบอัตโนมัติ

หาก  คุณกำลังดึงข้อมูลไฟล์แม็พของคุณจากแหล่งเก็บข้อมูล คุณจะจำเป็นต้องคัดลอกไฟล์ customTarget.xml จาก org.eclipse.pde.build/templates/headless-build ลงในไดเร็กทอรี configuration   getMapFiles เป้าหมายถูกใช้เพื่อดึงข้อมูลไฟล์แม็พ ซึ่งควรปรับเปลี่ยนการดึงข้อมูลจากแหล่งเก็บข้อมูลของคุณ

การขอรับซอร์สโค้ดแบบแมนวล

คุณสามารถเขียนการดึงข้อมูลเป้าหมายแบบกำหนดเองเพื่อดึงข้อมูลปลั๊กอินของคุณ และคุณลักษณะที่สามารถเรียกใช้จากเป้าหมาย preSetup หรือ postSetup ในไฟล์ customTargets.xml  คุณลักษณะและปลั๊กอินควร ถูกดึงข้อมูลไปยัง ${buildDirectory}/features และ ${buildDirectory}/plugins ตามลำดับ