การใช้ Qualifiers เวอร์ชัน

บันเดิลและคุณลักษณะ Eclipse มีหมายเลขเวอร์ชันของรูปแบบ major.minor.micro.qualifier  เซ็กเมนต์ qualifier ของเวอร์ชันถูกใช้เพื่อบ่งชี้การ build ที่ระบุเฉพาะ  หากคุณตั้งค่า qualifier เวอร์ชันคุณลักษณะหรือปลั๊กอินของคุณ ให้เป็น "qualifier" (เช่น เวอร์ชันของ 1.0.0.qualifier) PDE build จะแทนที่ คำว่า "qualifier" แบบอัตโนมัติด้วย qualifier ที่สร้างขึ้น

การควบคุม Qualifier ที่สร้างขึ้น

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

qualifier = noneตั้งค่า qualifier ให้ว่าง (เช่น "1.2.3.qualifier" เป็น "1.2.3")
qualifier = contextตั้งค่า qualifier ให้เป็น qualifier บริบท โปรดดูด้านล่างสำหรับค่าของ qualifier บริบท
ไม่ได้ตั้งค่าหากคุณสมบัติ "qualifier" ไม่ได้ตั้งค่าไว้ นี่คือค่าที่เทียบเท่ากับค่าติดตั้ง qualifier = context
qualifier = v12345ค่าอื่นใดๆ ตั้งค่า qualifier ให้เป็นค่านั้น

Qualifier บริบท

ค่าของ qualifier บริบทที่สร้างขึ้นถูกกำหนดไว้โดยไอเท็มแรกต่อไปนี้ ที่นำไปใช้:
  1. หากคุณสมบัติ forceContextQualifier ถูกตั้งค่าในไฟล์คอนฟิกูเรชัน build.properties ของ builder ของคุณ  ค่าของคุณสมบัตินี้ จะถูกใช้เป็น qualifier  คุณสมบัตินี้ยังสามารถตั้งค่าไว้บนบรรทัดรับคำสั่ง ด้วย -D เมื่อเรียกใช้งาน ant
  2. หากคุณกำลังใช้ไฟล์แม็พเพื่อดึงบันเดิลของคุณจาก แหล่งเก็บข้อมูล จากนั้นแท็กที่ใช้เพื่อดึงบันเดิลจะถูกใช้เป็น qualifier
  3. หากไม่ได้ใช้ forceContextQualifier หรือไฟล์แม็พ qualifier จะเป็นการประทับเวลาในรูปแบบ YYYYMMDDHHMM (เช่น 200605121600)

คำต่อท้ายเวอร์ชันคุณลักษณะ

คุณสามารถเปิดการสร้างคำต่อท้าย qualifier สำหรับคุณลักษณะได้โดยตั้งค่าคุณสมบัติ generateFeatureVersionSuffix=true ในไฟล์คอนฟิกูเรชัน build.properties ของ build

แนวคิดของเวอร์ชันคือ ควรเพิ่มขึ้นในแต่ละครั้งที่มีบางสิ่งเปลี่ยนแปลงไป qualifier เวอร์ชันจะเพิ่มขึ้นและดักจับการเปลี่ยนแปลงจาก build ต่อ build  อย่างไรก็ตาม คุณลักษณะจะเปลี่ยนแปลงนานๆ ครั้ง ซึ่งมีปลั๊กอินที่อาจเปลี่ยนแปลงบ่อย  เมื่อคำต่อท้ายเวอร์ชันถูกเปิด เวอร์ชันคุณลักษณะจะมีแบบฟอร์ม major.minor.micro.qualifier-suffix   คำต่อท้ายจะมีผลต่อผลรวมของ qualifiers เวอร์ชันของคุณลักษณะ และปลั๊กอินทั้งหมดที่สอดแทรกโดยคุณลักษณะ  นั่นหมายความว่า เมื่อหนึ่งในปลั๊กอินที่สอดแทรกเพิ่มเวอร์ชัน เวอร์ชันของคุณลักษณะจะเพิ่มขึ้นแบบอัตโนมัติเช่นเดียวกัน  ซึ่งมีประโยชน์เมื่อคุณลักษณะถูกนำไปใช้งานผ่านอัพเดตไซต์

เวอร์ชันสุดท้าย

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

ไฟล์ต่างๆ จะมีชื่อ: finalPluginsVersions.properties, finalPluginsVersions.<config>.properties, finalFeaturesVersions.properties, and  finalFeaturesVersions.<config>.properties.  finalPluginsVersions.properties และ finalFeaturesVersions.properties มีเวอร์ชันสำหรับปลั๊กอินและคุณลักษณะทั้งหมดที่ถูก build  ไฟล์คุณสมบัติ <config> มีเวอร์ชันของปลั๊กอินและ คุณลักษณะสำหรับคอนฟิกูเรชัน build ที่ระบุเฉพาะ

คุณสมบัติต่างๆ ในไฟล์เหล่านี้มีรูปแบบ:

    <bundleSymbolicName> = <version>
    <bundleSymbolicName>_<first 3 segments of version> = <version>
หากมีมากกว่าหนึ่งเวอร์ชันของปลั๊กอินหรือคุณลักษณะที่มีอยู่ <bundleSymbolicName>=<version> จะอ้างถึงปลั๊กอินหรือ คุณลักษณะที่มีเวอร์ชันสูงสุด ตัวอย่าง:
    org.eclipse.pde.build = 3.3.0.v20070524
    org.eclipse.pde.build_3.3.0=3.3.0.v20070524
    org.eclipse.pde.build_3.2.1=3.2.1.r321_v20060823