คุณสมบัติของคอนฟิกูเรชันการ build สำหรับคุณลักษณะและปลั๊กอิน
กลไกของการ build ถูกผลักดันโดยคอนฟิกูเรชันสำหรับการ build คอนฟิกูเรชันสำหรับการ
build สำหรับปลั๊กอิน แฟรกเมนต์ หรือคุณลักษณะถูกพบ
ในไฟล์
build.properties สำหรับอิลิเมนต์ที่สอดคล้องกัน
ตัวช่วยสร้างการสร้างโปรเจ็กต์ PDE จะสร้างไฟล์ build.properties
เมื่อโปรเจ็กต์
ปลั๊กอินถูกสร้างขึ้น ไฟล์จะมีข้อมูลเกี่ยวกับวิธีการคอมไพล์
โฟลเดอร์ซอร์สลงใน
JARs ข้อมูลนี้สามารถอัพเดตได้ทางอ้อมในหน้า รันไทม์
ของเอดิเตอร์
manifest ซึ่งยังสามารถปรับเปลี่ยนได้โดยตรงโดยใช้
เอดิเตอร์ที่เหมาะสม
PDE จัดเตรียมเอดิเตอร์ที่ใช้งานง่ายสำหรับ build.properties
ที่มีแบบฟอร์มและมุมมองซอร์ส
ด้วยตัวของไฟล์เองจะเป็นไปตามรูปแบบคุณสมบัติของ Java คุณจำเป็นต้องเตรียม
จำนวนของคีย์
และค่าที่สอดคล้องกัน ค่าจำนวนมาก
จะถูกคั่นด้วยเครื่องหมายคอมมา
ซึ่งเป็นตัวคั่น
คุณสมบัติทั่วไป
- bin.includes - แสดงรายการของไฟล์ที่จะสอดแทรกอยู่ในเวอร์ชันของไบนารี
ของปลั๊กอินที่สร้างขึ้น
- bin.excludes - แสดงรายการของไฟล์ที่ต้องการแยกออกจากการ
build ไบนารี
- qualifier - เมื่อหมายเลขเวอร์ชันของอิลิเมนต์ลงท้ายด้วย .qualifier
หมายเลขนี้ที่บ่งชี้โดยค่า ".qualifier" ต้องถูกแทนที่ ค่าของคุณสมบัติ
สามารถเป็น context <value> หรือ
none บริบทจะสร้างวันที่ตามวันที่ระบบ
หรือใช้แท็ก CVS เมื่อการ build ถูกทำให้เป็นแบบอัตโนมัติ ค่านั้นคือ
ค่าจริง ค่า none จะถอน ".qualifier" ออก หากคุณสมบัติถูกละเว้น
บริบทจะถูกนำมาใช้แทน (โปรดดู เวอร์ชัน Qualifiers)
- custom=true - บ่งชี้ว่าสคริปต์สำหรับ build
ที่สร้างขึ้นซึ่งตรงข้ามกับสคริปต์ที่สร้างขึ้นแบบอัตโนมัติ ดังนั้นจึงไม่มีค่า
เป็นอย่างอื่น
- customBuildCallbacks -
บ่งชี้ไฟล์ xml ที่มีเป้าหมายแบบกำหนดเองที่ต้องการใช้เมื่อใช้คุณลักษณะ
/ปลั๊กอิน (โปรดดู ขั้นตอน
การ build แบบกำหนดเองของคุณลักษณะและปลั๊ก)
- customBuildCallbacks.failonerror -
ตั้งค่าพารามิเตอร์ failonerror ของภารกิจ subant ค่าดีฟอลต์คือ "เท็จ"
- customBuildCallbacks.buildpath -
ตั้งค่าพารามิเตอร์ buildpath ของภารกิจ subant ใช้เมื่อตำแหน่งของไฟล์ callbacks แบบกำหนดเอง
ไม่เกี่ยวข้องกับ root ของปลั๊กอิน
- customBuildCallbacks.inheritall - ตั้งค่าพารามิเตอร์ inheritall ของภารกิจ subant ค่าดีฟอลต์ของ Ant คือเท็จ
คุณสมบัติที่ระบุเฉพาะปลั๊กอิน
- source.<library> - แสดงโฟลเดอร์ซอร์สที่จะถูกคอมไพล์
(เช่น source.xyz.jar=src/, src-ant/) หากระบุไลบรารีใน
plug-in.xml หรือ manifest.mf ค่านั้นจะควร
จะตรงกัน
- output.<library> - แสดงโฟลเดอร์เอาต์พุต
ที่ได้รับผลลัพธ์ของการคอมไพล์
- exclude.<library> - แสดงไฟล์ที่ไม่ควร
ถูกคัดลอกลงในไลบรารีโดยคอมไพลเลอร์
- extra.<library> - classpaths พิเศษที่ใช้เพื่อ
ดำเนินการกับการ build แบบอัตโนมัติ Classpath สามารถเป็นพาธที่เกี่ยวข้อง
หรือ url แพลตฟอร์มที่อ้างถึงปลั๊กอินและแฟรกเมนต์ของสภาวะแวดล้อมการพัฒนาของคุณ
(เช่น ../someplugin/xyz.jar, platform:/plugins/org.apache.ant/ant.jar)
urls แพลตฟอร์มถูกแนะนำผ่านพาธที่เกี่ยวข้อง
- manifest.<library> - บ่งชี้ไฟล์ที่จะถูกใช้เป็น
manifest สำหรับไลบรารี ไฟล์ต้องถูกวางอยู่ในหนึ่งในโฟลเดอร์ซอร์ส
ที่ถูกใช้เป็นอินพุตของ jar
- src.includes - แสดงไฟล์เพื่อสอดแทรใน build ซอร์ส
- src.excludes - แสดงไฟล์เพื่อแยกจาก build
ซอร์ส
- jars.extra.classpath - (ปฏิเสธ) ผลกระทบที่เหมือนกับ
extra.<library> ยกเว้นการบันทึกรายการถูกใช้กับ
ไลบรารีทั้งหมด
- jars.compile.order - นิยามการเรียงลำดับที่ jars
ควรถูกคอมไพล์ (ในกรณีที่มีไลบรารีจำนวนมาก)
คอมไพลเลอร์ที่เกี่ยวข้องกับอ็อพชัน โปรดดูหน้า การควบคุมสภาวะแวดล้อมของการคอมไพล์ และ
อ็อพชันคอมไพลเลอร์
- jre.compilation.profile -
ตั้งค่า สภาวะแวดล้อม ที่ถูกใช้เพื่อคอมไพล์บันเดิลนี้
- javacSource -
ตั้งค่าระดับความเข้ากันได้ของซอร์สสำหรับคอมไพล์บันเดิลนี้ override
jre.compilation.profile
- javacTarget -
ตั้งค่าระดับความเข้ากันได้ของ .class เป้าหมายสำหรับการคอมไพล์บันเดิลนี้
overrides jre.compilation.profile
- bootClasspath -
ตั้งค่าบู๊ต classpath เพื่อคอมไพล์บันเดิลนี้ ให้ overrides
jre.compilation.profile
- javacWarnings.<library>
- ตั้งค่าอ็อพชันการเตือนเพื่อส่งไปยังคอมไพลเลอร์ (ดูอ็อพชัน -warn ใน
การใช้แบตช์คอมไพลเลอร์
จากคู่มือผู้ใช้การพัฒนา Java)
- javacErrors.<library>
- ตั้งค่าอ็อพชันข้อผิดพลาดเพื่อส่งผ่านไปยังคอมไพลเลอร์ (ดูอ็อพชัน -err ใน
การใช้แบตช์คอมไพลเลอร์
จากคู่มือผู้ใช้การพัฒนา Java)
- javacDefaultEncoding.<library>
- ตั้งค่าการเข้ารหัสดีฟอลต์ที่ต้องการใช้เมื่อคอมไพล์ไลบรารีที่กำหนดไว้
- javacCustomEncodings.<library>
- รายการที่คั่นด้วยเครื่องหมายคอมมา
ของพาธและการเข้ารหัสทีต้องการใช้เมื่อคอมไพล์ไลบรารีที่กำหนดไว้
ตัวอย่าง:
javacCustomEncodings.library.jar = src/org/foo[US-ASCII], src/org/foo/bar.java[UTF-8]
- javacProjectSettings - พาธที่สัมพันธ์กับไฟล์การกำหนดค่าตามความชอบที่ระบุคุณสมบัติของ JDT Compiler ตั้งค่าเป็น จริง เพื่อใช้ค่าดีฟอลต์ ".settings/org.eclipse.jdt.core.prefs"
- compilerArg - ระบุอาร์กิวเมนต์คอมไพลเลอร์ที่กำหนดเอง
- compilerAdapter - ระบุอะแด็ปเตอร์สำหรับคอมไพลเลอร์แบบกำหนดเองเพื่อใช้ค่าดีฟอลต์ org.eclipse.jdt.core.JDTCompilerAdapter
- compilerAdapter.useLog - จริง/เท็จ: ไม่ว่าอะแด็ปเตอร์สำหรับคอมไพลเลอร์แบบกำหนดเองควรรับอาร์กิวเมนต์ -log หรือไม่ก็ตาม
- compilerAdapter.useArgFile - จริง/เท็จ: ไม่ว่าอะแด็ปเตอร์สำหรับคอมไพลเลอร์แบบกำหนดเองควรรับไฟล์อาร์กิวเมนต์ javaCompiler.<library>.args ที่สร้างขึ้น
- sourceFileExtensions - รายการของส่วนขยาย (*.java, *.aj) ที่ควรนำมาพิจารณาเป็นซอร์สเมื่อใช้อะแด็ปเตอร์สำหรับคอมไพลเลอร์แบบกำหนดเอง
ค่าที่นิยามไว้
สำหรับคีย์เหล่านี้จะลงท้ายด้วย "includes" หรือ "excludes"
ที่แสดงอยู่ใน "รูปแบบ" Ant รูปแบบมาตรฐานให้ผลลัพธ์
ที่คาดการณ์ไว้ ตัวอย่างเช่น "*.jar" บ่งชี้ถึงไฟล์ jar
ทั้งหมดในไดเร็กทอรีระดับบนสุด รูปแบบต่างๆ จะไม่ใช่รูปแบบที่ลึกมากตามค่าดีฟอลต์ หากคุณ
ต้องการกล่าวถึง
ไฟล์ Java ทั้งหมด คุณควรใช้รูปแบบ "**/*.java"
รูปแบบ "**" ตรงกับระดับของจำนวนของไดเร็กทอรี
เช่นเดียวกัน เพื่อกล่าวถึงทรีย่อยทั้งหมด ให้ใช้ "xyz/"
คุณสมบัติของคุณลักษณะ
ที่ระบุเฉพาะ
- root - รายการของไฟล์และโฟลเดอร์ที่ต้องรวมไว้ใน
root ของผลิตภัณฑ์ โปรดดูที่ หน้าวิธีใช้ Rootfiles สำหรับรายละเอียดเพิ่มเติม ซึ่งรวมคุณสมบัติเพิ่มเติม:
- root.<config>: ต่อคอนฟิกูเรชัน rootfiles
- root.folder : rootfiles ที่วางอยู่ในโฟลเดอร์ย่อย
- root.permissions : ดำเนินการกับ chmods บน rootfiles
- root.link : สร้าง softlinks สำหรับ rootfiles
- root.<config> - รายการของไฟล์และโฟลเดอร์ที่ต้อง
ถูกรวมไว้ใน root ของผลิตภัณฑ์เมื่อถูกบิลด์สำหรับคอนฟิกูเรชัน
ที่ระบุไว้ config ประกอบด้วยเซ็กเมนต์สาม (3) ส่วน
ของคอนฟิกูเรชันที่คั่นด้วยจุด
- root.permissions.<permissionValue> - รายการไฟล์
และโฟลเดอร์กับ chmod กับค่าที่กำหนดไว้ การอ้างถึงโฟลเดอร์ต้อง
ลงท้ายด้วย '/'
- root.permissions.<config>.<permissionValue> -
รายการของไฟล์และโฟลเดอร์กับ chmod กับค่าที่กำหนดไว้สำหรับ
คอนฟิกูเรชันที่ระบุเฉพาะ การอ้างถึงโฟลเดอร์ต้องลงท้ายด้วย '/'
- root.link - รายการตามคู่ (คั่นด้วยเครื่องหมายคอมมา)
ไฟล์และโฟลเดอร์ที่จำเป็นต้องลิงก์ด้วยสัญลักษณ์ การบันทึกรายการบ่งชี้ซอร์ส
(เป้าหมายในคำศัพท์ unix) และการบันทึกรายการที่สอง
บ่งชี้ชื่อลิงก์
- root.link.<config> - รายการที่คั่นด้วยเครื่องหมายคอมมา
ของคู่ของไฟล์และโฟลเดอร์ที่จำเป็นต้องลิงก์ด้วยสัญลักษณ์สำหรับ
คอนฟิกูเรชันที่ระบุเฉพาะ การบันทึกรายการบ่งชี้ซอร์ส (เป้าหมายในคำศัพท์ unix)
และการบันทึกรายการที่สองบ่งชี้ชื่อลิงก์
- generate.feature@<featureId> - บ่งชี้ว่า
คุณลักษณะซอร์ส featureId จะเป็นคุณลักษณะซอร์สสำหรับ
คุณลักษณะที่บ่งชี้เป็นค่าของคุณสมบัตินี้ ค่าที่แสดงรายการ
หลังเครื่องหมายคอมมาแรกบ่งชี้อิลิเมนต์ที่ต้องดึงจากแหล่งเก็บข้อมูล
(โปรดดู การสร้างปลั๊กอินซอร์ส
และคุณลักษณะ)
- generate.plugin@<pluginId> - บ่งชี้ว่า
ปลั๊กอินซอร์ส pluginId จะเป็นปลั๊กอินซอร์สสำหรับ
บ่งชี้เป็นค่าของคุณสมบัตินี้
- significantVersionDigits
- จำนวนของดิจิตที่สำคัญที่ใช้เมื่อสร้างคำต่อท้ายเวอร์ชันคุณลักษณะ
(โปรดดู เวอร์ชัน
Qualifiers)
- generatedVersionLength -
ความยาวของคำต่อท้ายเวอร์ชันคุณลักษณะที่สร้างขึ้น
ตัวอย่างต่อไปนี้ได้ถูกแตกออกจาก build.properties
ของคุณลักษณะ org.eclipse.platform
bin.includes=epl-v10.html,eclipse_update_120.jpg,feature.xml,feature.properties,license.html
root=rootfiles,configuration/
root.permissions.755=eclipse
root.linux.motif.x86=../../plugins/platform-launcher/bin/linux/motif,linux.motif
root.linux.motif.x86.link=libXm.so.2.1,libXm.so.2,libXm.so.2.1,libXm.so
root.linux.motif.x86.permissions.755=*.so*