การทำแพ็กเกจของคอมโพเนนต์ Eclipse

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

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

เริ่มทำงานแบบด่วน

ด้านล่างคือชุดของขั้นตอนพื้นฐานในการขอรัรบการเริ่มต้นทำงานกับ ตัวทำแพ็กเกจ  ซึ่งแนะนำให้คุณ build แพ็กเกจ *nix packages บนเครื่อง *nix เพื่อมั่นใจว่าได้สงวนสิทธิในการเข้าถึงไฟล์ไว้

  1. สร้างไดเร็กทอรีคอนฟิกูเรชันการทำแพ็กเกจและคัดลอกไฟล์เทมเพลต (packager.properties, packaging.properties และ customTargets.xml) จาก org.eclipse.pde.build/templates/packager ที่นี่
  2. แก้ไขไฟล์ packager.properties ที่คัดลอกและตั้งค่าคุณสมบัติ ต่อไปนี้:
  3. ขอรับไฟล์แม็พตัวทำแพ็กเกจ  คุณสมบัติต่อไปนี้ควบคุม การดาวน์โหลดไฟล์แม็พ:
    สคริปต์ตัวสร้างแพ็กเกจจะต่อท้ายไฟล์ *.map ทั้งหมดที่พบใน ${downloadDirectory} เพื่อดาวน์โหลดมากกว่าหนึ่งไฟล์แม็พหรือเพื่อดึงไฟล์แม็พจาก CVS ให้แก้ไขไฟล์ customTargets.xml และเปลี่ยนเป้าหมาย getMapFiles
  4. รันตัวทำแพ็กเกจโดยใช้คำสั่งต่อไปนี้:
    java -jar <eclipse install>/plugins/org.eclipse.equinox.launcher_<version>.jar -application org.eclipse.ant.core.antRunner 
    -buildfile <<eclipse install>/plugins/org.eclipse.pde.build_<version>/scripts/package.xml>
    -DpackagingInfo=<พาธไปยังไดเร็กทอรีคอนฟิกูเรชันการทำแพ็กเกจของคุณ>

Packager Map File Format

ไฟล์แม็พตัวทำแพ็กเกจถูกใช้เพื่อกล่าวถึงไฟล์เก็บถาวรที่หลากหลาย เนื้อหา และตำแหน่งที่สามารถดาวน์โหลดได้  ซึ่งจะคล้ายกับไฟล์แม็พ ที่ใช้ในกระบวนการ build เพื่อดึงบันเดิลออกจาก แหล่งเก็บข้อมูล  รูปแบบของการบันทึกรายการไฟล์แม็พตัวทำแพ็กเกจ ตามที่เป็นดังต่อไปนี้:
archiveName = url | [configList] | [directory] | contentDescription | componentName

โปรดสังเกตว่า configList และไดเร็กทอรีคือตัวเลือก ซึ่งเป็นสิ่งสำคัญที่ ตัวคั่นหมายเลข "|" ที่เหมาะสมยังคงถูกนำมาใช้
ตัวอย่าง:
eclipse-SDK-3.1-win32.zip=http://download.eclipse.org/downloads/drops/R-3.1-200506271435/ | win32,win32,x86 | | sdk | eclipse
eclipse-PDE-3.1.zip=http://download.eclipse.org/downloads/drops/R-3.1-200506271435/ | | | runtime | pde

คุณสมบัติคอนฟิกูเรชันของตัวทำแพ็กเกจ

คุณสมบัติต่อไปนี้สามารถตั้งค่าได้ในไฟล์คอนฟิกูเรชันตัวทำแพ็กเกจ packager.properties:
baseDirectory
ไดเร็กทอรีที่การทำแพ็กเกจทั้งหมด ต้องเข้าแทนที่
workingDirectory
ไดเร็กทอรีที่สคริปต์ จะถูกสร้างขึ้น  ค่าในเทมเพลต คือ ${baseDirectory}/workingPlace
downloadDirectory
โฟลเดอร์ที่ไฟล์เก็บถาวร ต้องถูกดาวน์โหลด  ค่าในเทมเพลต คือ ${baseDirectory}/toPackage
tempDirectory
โฟลเดอร์ที่ไฟล์เก็บถาวร จะถูกแตก  ค่าในเทมเพลต คือ ${baseDirectory}/temp
featurePaths
ชื่อของ root ของ ไฟล์เก็บถาวรที่ดาวน์โหลด  ค่าในเทมเพลตคือ eclipse
featureList
รายการที่คั่นด้วยเครื่องหมายคอมมา ของ id คุณลักษณะที่คุณต้องการทำแพ็กเกจใหม่
componentFilter
รายการที่คั่นด้วยเครื่องหมายคอมมาของคอมโพเนนต์ ที่คุณลักษณะใน featureList สามารถพบได้  ซึ่งจะกรองไฟล์เก็บถาวรที่พร้อมใช้งานและยอมให้ตัวทำแพ็กเกจออปติไมซ์ ชุดของไฟล์ที่ดาวน์โหลด
contentFilter
รายการที่คั่นด้วยเครื่องหมายคอมมา ของชนิดเนื้อหาที่ต้องดึง  ซึ่งกรองชุดของไฟล์เก็บถาวรที่พร้อมใช้งาน และยอมให้ตัวทำแพ็กเกจออปติไมซ์ชุดของไฟล์ ที่ดาวน์โหลด
config
รายการที่คั่นด้วยเครื่องหมาย "&" ของคอนฟิก (เครื่องหมายคอมมาแยกระบบปฏิบัติการออกเป็นสามส่วน ระบบการกำหนดหน้าต่าง สถาปัตยกรรม) ที่ต้องทำแพ็กเกจใหม่  (เช่น: win32, win32, x86 & linux, gtk, x86)
archivesFormat
รูปแบบของ ไฟล์เก็บถาวร  เครื่องหมาย "&" ที่คั่นด้วยรายการขอคอนฟิก - รูปแบบ  (เช่น: win32, win32, x86 - antZip & linux, gtk, ppc - tar)  หากไม่มีรูปแบบของ ไฟล์เก็บถาวรระบุไว้สำหรับคอนฟิกที่กำหนดไว้ รูปแบบดีฟอลต์คือ antZip
zipargs
อาร์กิวเมนต์พิเศษที่ต้องส่งผ่านไปยัง การบีบอัด
unzipargs
อาร์กิวเมนต์พิเศษที่ต้องส่งผ่านไปยัง การคลาย
archivePrefix
คำนำหน้าของไฟล์เก็บถาวร ที่เป็นผลลัพธ์
collectingFolder
ชื่อของโฟลเดอร์ root ของ ไฟล์เก็บถาวรที่เป็นผลลัพธ์
buildId
ควบคุม id บิลด์ ในชื่อดีฟอลต์ของไฟล์เก็บถาวร
buildType
ชนิดของบิลด์ ที่ใช้ในการตั้งชื่อเอาต์พุตของบิลด์  โดยปกติแล้วคือหนึ่งใน I, N, M, S, ...
buildLabel
เลเบลสำหรับบิลด์  ค่าของเทมเพลต คือ ${buildType}.${buildId}
archiveNamePrefix
ควบคุมชื่อของ ไฟล์เก็บถาวรที่เป็นผลลัพธ์  ค่าดีฟอลต์ของสิ่งนี้ คือ ${buildId}
packagingProperties
พาธที่เกี่ยวข้องกับไฟล์ ที่มีไฟล์ root การทำแพ็กเกจคุณสมบัติต่างๆ  ตามค่าดีฟอลต์ จะชี้ไปยัง packaging.properties
deltaPack
ไม่ว่าจะสร้างแพ็กการเปลี่ยนแปลง หรือไม่ก็ตาม  ซึ่งจะแยกส่วนของแพลตฟอร์มอิสระ และจะจัดกลุ่มคอนฟิกทั้งหมดลงในหนึ่งไฟล์เก็บถาวร
unzipOrder
เครื่องหมายคอมมาที่คั่นรายการของคำนำหน้าไฟล์เก็บถาวรที่ตั้งค่า ลำดับที่ไฟล์เก็บถาวรควรถูกแตกออก

Packaging Root Files

ในไฟล์ packager.properties ของคอนฟิกูเรชันการทำแพ็กเกจ packagingProperties จะชี้ไปยังไฟล์คุณสมบัติที่ระบุไฟล์ root ที่จำเป็นต้องทำแพ็กเกจ  ตามค่าดีฟอลต์ นี่คือไฟล์ packaging.properties

ไฟล์คุณสมบัตินี้ควรมีคุณสมบัติที่ระบุไฟล์ root ที่จำเป็นต้องมี  โปรดดูที่หน้า คุณลักษณะที่ระบุเฉพาะ คุณสมบัติ สำหรับรายละเอียดเกี่ยวกับคุณสมบัติ root