การตั้งค่าสภาวะแวดล้อมการคอมไพล์

ตามค่าดีฟอลต์ บันเดิลของคุณต้องคอมไพล์ด้วย JRE ที่ถูกใช้เพื่อรันการ build และด้วยระดับของซอร์สและเป้าหมายซึ่งตั้งค่าเป็น 1.3 และ 1.2

PDE build คือความสามารถของการกำหนดคอนฟิก JRE ที่ใช้ในระหว่างการคอมไพล์ บนพื้นฐานต่อบันเดิล  เพื่อใช้ประโยชน์จากสิ่งนี้ อันดับแรกที่ต้องทำคือ บอก PDE build ที่ JREs พร้อมใช้งาน  ในคอนฟิกูเรชัน build ของคุณ ไฟล์ build.properties ตั้งค่าคุณสมบัติเพื่อชี้ไปยัง JREs ที่ติดตั้งไว้ของคุณแต่ละรายการ  เทมเพลต build.properties ที่จัดเตรียมใน org.eclipse.pde.build/templates/headless-build มีรายการของ การยกเลิกการใส่ข้อคิดเห็นของสภาวะแวดล้อม  ยกเลิกการใส่ข้อคิดเห็นคุณสมบัติ ที่คุณมี JREs และตั้งค่าให้เป็นชุดของ jars ที่เป็นเจ้าของบนบู๊ต classpath  ตัวอย่างเช่น การตั้งค่าคุณสมบัติ:

J2SE-1.5=C:/Java/1.5/jre/lib/rt.jar;C:/Java/1.5/jre/lib/jsse.jar

จะคอมไพล์บันเดิลที่ต้องการ java 1.5 กับ rt.jar และ jsse.jar  ชื่อของคุณสมบัติควรตรงกับชื่อ ของสภาวะแวดล้อมที่ PDE Build รู้จัก   PDE Build จะตั้งค่าระดับของซอร์สและเป้าหมายแบบอัตโนมัติสำหรับ แต่ละสภาวะแวดล้อม  สภาวะแวดล้อมที่ PDE builds รู้จัก และระดับของซอร์ส/เป้าหมายที่เชื่อมโยงเป็นดังต่อไปนี้:

สภาวะแวดล้อม
ซอร์ส
เป้าหมาย
CDC-1.0/Foundation-1.0
1.3
1.1
CDC-1.1/Foundation-1.1
1.3
1.2
OSGi/Minimum-1.0
1.3
1.1
OSGi/Minimum-1.1
1.3
1.2
JRE-1.1
1.1
1.1
J2SE-1.2
1.2
1.1
J2SE-1.3
1.3
1.1
J2SE-1.4
1.3
1.2
J2SE-1.5
1.5
1.5
JavaSE-1.6
1.6
1.6
PersonalJava-1.1
1.1
1.1
PersonalJava-1.2
1.1
1.1
CDC-1.0/PersonalBasis-1.0
1.3
1.1
CDC-1.0/PersonalJava-1.0
1.3
1.1
CDC-1.1/PersonalBasis-1.1
1.3
1.2
CDC-1.1/PersonalJava-1.1
1.3
1.2

การเลือกสภาวะแวดล้อมสำหรับบันเดิลของคุณ

มีการตั้งค่าสองแบบที่มีผลต่อสภาวะแวดล้อมที่ใช้เพื่อคอมไพล์ บันเดิลของคุณ  แบบแรกคือ ส่วนหัว manifestBundle-RequiredExecutionEnvironment  ส่วนหัวนี้คือรายการของสภาวะแวดล้อมที่บันเดิลของคุณสามารถ รันได้  บันเดิลของคุณควรใช้เมธอดที่อยู่ในเซ็ตย่อยของสภาวะแวดล้อมทั้งหมด ที่แสดงไว้เท่านั้น  ซึ่งเป็นที่น่าพอใจที่จะมีสภาวะแวดล้อม การคอมไพล์ของคุณซึ่งตรงกับสภาวะแวดล้อมแบบรันไทม์ของคุณ เท่าที่จะเป็นไปได้

ค่าติดตั้งแบบที่สองคือคุณสมบัติ jre.compilation.profile จากไฟล์ build.properties ของบันเดิลของคุณ  ค่าของคุณสมบัตินี้ ควรเป็นสภาวะแวดล้อมที่ต้องการสำหรับการคอมไพล์บันเดิลนี้ หากรายการ Bundle-RequiredExecutionEnvironment ไม่เพียงพอ

ค่าติดตั้งทั้งสองแบบนี้จะอยู่ในรูปแบบของรายการสภาวะแวดล้อม jre.compilation.profile เป็นอันดับแรก แล้วตามตัวสภาวะแวดล้อมจาก Bundle-RequiredExecutionEnvironment  สภาวะแวดล้อมอันดับแรก บนรายการนี้พร้อมใช้งานในคอนฟิกูเรชัน build ของคุณ (โปรดดูส่วนที่แสดงอยู่ข้างต้น) จะถูกใช้เพื่อคอมไพล์บันเดิลของคุณ

ตัวอย่าง:
<buildDirectory>/plugins/bundleA/
META-INF/manifest.mf: Bundle-RequiredExecutionEnvironment: CDC-1.0/Foundation-1.0, J2SE-1.3
build.properties:  jre.compilation.profile=J2SE-1.4

<buildConfiguration>/
build.properties:  J2SE-1.3=C:/Java1.3/jre/lib/rt.jar;C:/Java1.3/jre/lib/i18n.jar
J2SE-1.4=C:/Java1.4/jre/lib/rt.jar;C:/Java1.4/jre/lib/jsse.jar

ในการติดตั้งข้างต้น รายการของ สภาวะแวดล้อมถูกพิจารณา (ตามลำดับ) คือ: J2SE-1.4,  CDC-1.0/Foundation-1.0, J2SE-1.3  บันเดิลสามารถรันบน CDC/Foundation และ J2SE-1.3 แต่สำหรับเหตุผลบางข้อ  ควรคอมไพล์ด้วย J2SE-1.4  ในกรณีนี้ J2SE-1.4 ถูกตั้งค่าในคอนฟิกูเรชัน build และมาเป็นอันดับแรกในรายการของสภาวะแวดล้อม ดังนั้น จึงถูกใช้เพื่อคอมไพล์บันเดิล ระดับของซอร์สและเป้าหมายที่ใช้ใน กรณีนี้คือ 1.3 และ 1.2  หากคอนฟิกูเรชัน build ที่นิยามไว้เฉพาะ J2SE-1.3 และไม่ใช่ J2SE-1.4 จากนั้น J2SE-1.3 จะเป็นสภาวะแวดล้อมบนรายการที่ JRE พร้อมใช้งาน ดังนั้น จึงถูกใช้เพื่อคอมไพล์บันเดิล  ในกรณีนี้ ระดับของซอร์สและเป้าหมาย จะเป็น 1.3 และ 1.1

ค่า Explicitly Setting Compilation

ในบางกรณี ถ้าการใช้สภาวะแวดล้อมตามเค้าร่างข้างบนไม่มีผลในการตั้งค่าที่ต้องการ ดังนั้นมีความเป็นได้สำหรับบันเดิลที่จะแสดงรายการของการตั้งค่าที่ต้องการ  ตัวอย่างเช่น หากคุณมีบันเดิลที่ใช้ J2SE-1.4 ด้วยการยืนยัน จากนั้น ระดับของซอร์สและเป้าหมายต้องการ 1.4 แทนค่าดีฟอลต์ที่เป็น 1.3 และ 1.2

เมื่อตั้งค่าซอร์ส java และระดับของเป้าหมาย บันเดิลควรตั้งคุณสมบัติ javacSource และ javacTarget ในไฟล์ build.properties ของมัน  คุณสมบัติเหล่านี้จะ override ค่าที่ได้รับจาก ค่าติดตั้งสภาวะแวดล้อม

เช่นเดียวกัน การตั้งค่าคุณสมบัติ bootClasspath ในไฟล์ build.properties ของบันเดิลจะ override ชุดของ jars ที่บันเดิลถูกคอมไพล์