การดึงข้อมูลจากแหล่งเก็บข้อมูล
โครงสร้างพื้นฐานที่นำเสนอโดย 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 มีดังต่อไปนี้:
โดยที่ args คือเครื่องหมายคอมมาที่คั่นรายการของคู่ คีย์/ค่าตามที่กล่าวถึงด้านล่าง:
- tag แท็ก CVS เพื่อเช็กเอาต์
- cvsRoot สตริงการเชื่อมต่อ CVS
- path โมดูล CVS เผื่อเลือกและพาธที่ต้องการขอรับโฟลเดอร์ที่มีอิลิเมนต์ ตามค่าดีฟอลต์แล้ว ชื่ออิลิเมนต์ถูกใช้เป็นชื่อโมดูล
- prebuilt บูลีนเผื่อเลือกจะบ่งชี้ถึงหากอิลิเมนต์ที่ดาวน์โหลดถูก build ไว้ก่อนหน้านี้ ตามค่าดีฟอลต์แล้ว นี่คือค่าเท็จ
- cvsPassFile พาธของอ็อพชันไปยังไฟล์ส่งผ่าน cvs
- password รหัสผ่านเผื่อเลือกที่ต้องการใช้เพื่อเชื่อมต่อกับ CVS
ตัวอย่าง:
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 คือรายการของคู่ คีย์/ค่า ที่คั่นด้วยเครื่องหมายคอมมาตามที่กล่าวถึงด้านล่าง:
- unpack ตั้งค่าเป็นจริง ซึ่งบ่งชี้ว่า อิลิเมนต์ที่ดาวน์โหลดควรถูกคลาย
- verbose ตั้งค่าเป็นจริง เพื่อแสดงข้อมูลความคืบหน้าของ verbose เมื่อกำลังดาวน์โหลด ค่าดีฟอลต์คือเท็จ
- ignoreerrors ตั้งค่าเป็นจริง เพื่อบันทึกข้อผิดพลาดในระหว่างการส่งค่า ค่าดีฟอลต์คือเท็จ
- usetimestamp ดาวน์โหลดไฟล์แบบมีเงื่อนไขซึ่งอ้างอิงตามการประทับเวลาของสำเนาโลคัล (สำหรับ http URLs เท่านั้น) เมื่อตั้งค่าเป็นจริง ค่าดีฟอลต์คือเท็จ
- username ชื่อผู้ใช้การพิสูจน์ตัวตน "BASIC" http
- password, รหัสผ่านที่ต้องใช้ดำเนินการดาวน์โหลด
ตัวอย่าง:
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
ส่วนขยายใหม่ถูกเพิ่มให้กับ PDE/Build ที่เปิดใช้งานผู้ใช้เพื่อดึงข้อมูลสิ่งที่สร้างขึ้นจากแหล่งเก็บข้อมูล p2 ถึงตอนนี้ คุณสามารถเพิ่ม
การบันทึกรายการให้กับไฟล์แม็พของคุณสำหรับ build อินพุตและ PDE/Build จะเรียกคืนสิ่งที่สร้างขึ้นและสอดแทรกลงใน build การบันทึกรายการไฟล์แม็พจำเป็นต้องสอดแทรก
id และเวอร์ชันของ installable unit (IU) และ URI ของแหล่งเก็บข้อมูลที่สามารถพบ IU ได้ หน่วยเก็บข้อมูลเมตาและสิ่งที่สร้างขึ้น
ถูกสมมติให้อยู่ในตำแหน่งร่วมกัน
รูปแบบของการบันทึกรายการของแม็พไฟล์เพื่อดึงเนื้อหาผ่าน p2 มีดังต่อไปนี้:
<elementType>@<elementID> = p2IU, id=<id>, version=<version>, repository=<repository>
- id ตัวระบุของ Installable Unit
- version เวอร์ชันของ Installable (เป็นตัวเลือก) หากไม่ได้ระบุไว้ เวอร์ชันสูงสุดที่มีอยู่จะถูกดึงออกมา
- repository ตำแหน่ง (URI) ของแหล่งเก็บข้อมูลที่จะพบ IU
การดึงคุณลักษณะด้วย 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.exe บนพาธการค้นหาของระบบของคุณ
(ดาวน์โหลด CVS จาก ที่นี่)
- สร้างโฟลเดอร์ที่เรียกแม็พในไดเร็กทอรี build
- สร้างไฟล์ที่มีส่วนขยาย .map ในโฟลเดอร์ maps
- กรอกข้อมูลไฟล์แม็พนี้ด้วยอิลิเมนต์ทั้งหมดที่จำเป็นต้องดึงข้อมูลจาก
แหล่งเก็บข้อมูล
- แก้ไขไฟล์ build.properties จากโฟลเดอร์ configuration
และถอนข้อคิดเห็นที่บรรทัด skipFetch=true หากตั้งค่า
คุณสมบัตินั้นไว้ ดังนั้น PDE build จะข้ามเฟสการดึงข้อมูลทั้งหมด
หากคุณต้องการระบุแท็กในไฟล์แม็พที่ต้องละเว้น คุณสามารถตั้งค่าคุณสมบัติ
fetchTag ให้เป็นค่าที่ระบุเฉพาะ การทำเช่นนี้มีประโยชน์
เมื่อทำการ build จาก HEAD แทนเวอร์ชันที่แท็กไว้
การขอรับไฟล์แม็พจาก CVS
ไฟล์แม็พจะถูกเก็บอยู่ในแหล่งเก็บข้อมูล PDE Build นำเสนอ
โครงสร้างพื้นฐานดีฟอลต์เพื่อขอรับไฟล์แม็พจากแหล่งเก็บข้อมูล CVS
เพื่อเปิดใช้งานฟังก์ชันนี้ ให้เปลี่ยนคุณสมบัติต่อไปนี้ใน
build.properties ของคอนฟิกูเรชันของคุณจากไดเร็กทอรีคอนฟิกูเรชันของคุณ:
- skipMaps: ยกเลิกการใส่
ข้อคิดเห็นคุณสมบัตินี้ หากตั้งค่าคุณสมบัตินี้ไว้ PDE build
จะไม่ดึงข้อมูลไฟล์แม็พต่างๆ ไว้
- mapsRepo =
:pserver:anonymous@example.com/path/to/repo. แหล่งเก็บข้อมูล CVS
ที่ขอรับไฟล์แม็พ
- mapsRoot =
/path/to/maps. พาธในแหล่งเก็บข้อมูล CVS ไปยังไดเร็กทอรี
ที่มีไฟล์แม็พ
- mapsCheckoutTag =
HEAD. แท็ก CVS ที่ใช้เพื่อเช็กเอาต์ไฟล์แม็พ
การดึงข้อมูลไฟล์แม็พจาก 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
ตามลำดับ