การเพิ่มไฟล์ให้กับ root ของบิลด์

ไฟล์ root คือไฟล์ที่ต้องทำเป็นแพ็กเกจด้วยการติดตั้ง Eclipse แต่ไม่ใช่คุณลักษณะหรือปลั๊กอิน ตัวอย่างทั่วไปคือโปรแกรมเรียกทำงาน eclipse และไฟล์ ini พร้อมด้วยไฟล์การออกไลเซนส์
ไฟล์ root สนับสนุนการบิลด์ตามคุณลักษณะที่มีคุณสมบัติ root ที่เหมาะสม

คุณสมบัติของไฟล์ root

root
ระบุรายการที่คั่นด้วยเครื่องหมายคอมมาของไฟล์หรือโฟลเดอร์ต่างๆ ที่ต้องรวมอยู่ในคอนฟิกูเรชันทั้งหมดที่ต้องถูกบิลด์
พาธสัมบูรณ์มีความสัมพันธ์กับคุณลักษณะที่มีอยู่ ใช้ "ไฟล์:" เพื่อระบุไฟล์และ "สัมบูรณ์" เพื่อใช้เป็นพาธสัมบูรณ์
ตัวอย่าง:
  • root=rootfiles: พาธที่สัมพันธ์กับโฟลเดอร์ นั่นคือเนื้อหาของโฟลเดอร์ที่รวมไว้
  • root=file:license.html,licenses: พาธที่สัมพันธ์กับไฟล์ "license.html" และพาธที่สัมพันธ์กับโฟลเดอร์ "licenses"
  • root=absolute:/eclipse/rootfiles: พาธสัมบูรณ์กับโฟลเดอร์ เนื้อหาของโฟลเดอร์ที่รวมไว้
  • root=absolute:file:/eclipse/about.html,file:lib/*.so*: พาธสัมบูรณ์ที่รวม "about.html" เช่นเดียวกับพาธที่สัมพันธ์กันเพื่อรวมไฟล์ *.so* ทั้งหมดภายใต้โฟลเดอร์ lib

รายการที่คั่นด้วยเครื่องหมายคอมมาแต่ละรายการจะกลายเป็นชุดไฟล์ของ ant หากการบันทึกรายการอ้างถึงโฟลเดอร์ โฟลเดอร์นั้นจะเป็นพารามิเตอร์ "dir" ของชุดไฟล์และ "**" ถูกใช้เป็นพารามิเตอร์ "includes" หากการบันทึกรายการคือไฟล์ ไดเร็กทอรีที่มีอยู่ของไฟล์จะกลายเป็นพารามิเตอร์ "dir" และไฟล์ถูกระบุอยู่ในพารามิเตอร์ "includes"

สำหรับไฟล์ที่เกี่ยวข้องทั้งหมด คุณสมบัติ ${baseDir} จะถูกใช้ในไดเร็กทอรี คุณสมบัติ ${baseDir} นี้จะเป็นไดเร็กทอรี root ของคุณลักษณะที่ไฟล์ build.xml ที่สร้างขึ้นจะถูกวางอยู่

root.<config>
ระบุรายการของไฟล์หรือโฟลเดอร์ที่ต้องรวมไว้สำหรับคอนฟิกูเรชันที่กำหนดไว้ คอนฟิกูเรชันที่ระบุไว้ที่นี่ควรสอดคล้องกับคอนฟิกูเรชันในคุณสมบัติ configs สำหรับบิลด์ พาธที่เกี่ยวข้องมีความสัมพันธ์กับคุณลักษณะที่มีอยู่ คำนำหน้า "file:" และ "absolute:" ที่ใช้ในคุณสมบัติ "root" ยังถูกใช้ที่นี่ด้วยเช่นกัน
ตัวอย่าง:
  • root.win32.win32.x86=rootfiles: พาธที่เกี่ยวข้องกับโฟลเดอร์ ซึ่งมีเนื้อหาของโฟลเดอร์ที่รวมอยู่ในคอนฟิกูเรชัน win32.win32.x86
  • root.linux.gtk.x86=absolute:file:about.html: พาธสัมบูรณ์ไปยังไฟล์ที่ต้องการรวมไว้ในคอนฟิกูเรชัน linux.gtk.x86
root.folder.<subfolder>

root.<config>.folder.<subfolder>
คล้ายกับคุณสมบัติ "root" และ "root.<config>" ยกเว้นว่า แทนที่จะคัดลอกลงใน root ของการติดตั้ง eclipse ไฟล์ และโฟลเดอร์ ให้คัดลอกไปยังโฟลเดอร์ย่อยที่กำหนดไว้
พาธสัมบูรณ์มีความสัมพันธ์กับคุณลักษณะที่มีอยู่ คำนำหน้า "file:" และ "absolute:" ที่ใช้ในคุณสมบัติ "root" ยังถูกใช้ที่นี่ด้วยเช่นกัน
ตัวอย่าง:
  • root.folder.docs/html=html_files: เนื้อหาของโฟลเดอร์ "html_files" ของคุณลักษณะที่คัดลอกไปยังโฟลเดอร์ docs/html ในการติดตั้ง eclipse
  • root.linux.gtk.x86.folder.jre=absolute:/build/jres/linux: พาธสัมบูรณ์ เนื้อหาของโฟลเดอร์ /build/jres/linux ถูกคัดลอกลงในโฟลเดอร์ jre ของการติดตั้ง eclipse
คุณสมบัติเหล่านี้ถูกใช้โดย PDE/UI เมื่อระบุ JRE ในไฟล์ .product สำหรับเอ็กซ์พอร์ต PDE/Build ไม่ได้สนับสนุนอยู่ในปัจจุบันที่รวม JRE ที่ใช้ไฟล์ .product และคุณสมบัติเหล่านี้อาจต้องการให้ระบุในคุณลักษณะเพื่อรวม JRE ในการบิลด์ผลิตภัณฑ์ที่ไม่มีส่วนหัว
root.permissions.<rights>

root.<config>.permissions.<rights>
ระบุรายการของไฟล์เพื่อรันภารกิจ ant chmod ค่าของคุณสมบัตินี้จะถูกส่งผ่านไปยังภารกิจ ant chmod เป็นพารามิเตอร์ "includes" ซึ่งหมายความว่า รูปแบบอักขระ ant สามารถนำมาใช้ได้
ตัวอย่าง:
  • root.permissions.755=eclipse: ตั้งค่าไฟล์ 'eclipse' เพื่อให้มีสิทธิที่สามารถเรียกใช้งานได้
  • root.linux.gtk.x86.permissions.755=lib/**: ตั้งค่าไฟล์ทั้งหมดภายใต้ไดเร็กทอรี lib เพื่อให้เรียกใช้งานได้

ส่วนของ <rights> ของคุณสมบัติส่งผ่านไปยังภารกิจ ant chmod เป็นพารามิเตอร์ "perm" หากรูปแบบไฟล์เก็บถาวรสุดท้ายสำหรับคอนฟิกูเรชันคือ antTar จากนั้นรูปแบบ <rights> ยังถูกส่งผ่านไปยัง ant tarfileset เป็นพารามิเตอร์ "filemode" ซึ่งคล้ายกับ antZip และ zipfileset ขณะที่ภารกิจ ant chmod สนับสนุนสิทธิในการใช้ เช่น "og-rwx" (ทำให้ผู้ที่ไม่ใช่เจ้าของไม่สามารถแตะต้องไฟล์ได้) ชุดของไฟล์ tar และ zip สนับสนุนสตริงตัวเลข 3 หลักที่เป็นเลขฐานแปด
root.link

root.<config>.link
แสดงตามคู่ (แบ่งแยกด้วยเครื่องหมายคอมมา) ไฟล์และโฟลเดอร์ที่จำเป็นต้องถูกลิงก์ด้วยสัญลักษณ์ การบันทึกรายการแรกของคู่คือเป้าหมายและการบันทึกรายการที่สองคือชื่อลิงก์
ตัวอย่าง:
  • root.macosx.carbon.ppc.link=Eclipse.app/Contents/MacOS/eclipse,eclipse: ในคอนฟิกูเรชัน macosx.carbon.ppc จะสร้างลิงก์ใน root ที่ชื่อ "eclipse" ซึ่งชี้ไปยังไฟล์ "Eclipse.app/Contents/MacOS/eclipse"

ผลลัพธ์นี้ในภารกิจ ant exec ที่เรียกใช้งานคำสั่ง "ln -sf" ค่าที่กำหนดไว้ของ "targetA, nameA, targetB, nameB, targetC, nameC" ซึ่งเป็นชุดของคำสั่ง "ln" จะถูกเรียกใช้งานในโฟลเดอร์ที่ไฟล์ root ของ eclipse ถูกเก็บรวบรวมไว้:
		ln -sf targetA nameA
ln -sf targetB nameB
ln -sf targetC nameC

การรวมไฟล์ root ลงในการบิลด์ผลิตภัณฑ์

เมื่อใช้ไฟล์ .product ที่อ้างอิงตามคุณลักษณะ ไฟล์ root สามารถเพิ่มลงในผลิตภัณฑ์ได้ โดยระบุคุณสมบัติของไฟล์ root ข้างต้นในคุณลักษณะที่รวมใดๆ

ซึ่งมีความเป็นไปได้ในการรวมคุณลักษณะเพื่อวัตถุประสงค์ของการให้การสนับสนุนไฟล์ root หากคุณลักษณะ "rootfile" นี้ไม่ได้ระบุคุณสมบัติ "bin.includes" ไว้ในไฟล์ build.properties คุณลักษณะนี้จะไม่รวมอยู่ในผลลัพธ์ของการบิลด์ครั้งสุดท้าย แต่จะให้การสนับสนุนไฟล์ root

เมื่อไฟล์ .product อ้างอิงกับปลั๊กอินแทนคุณลักษณะต่างๆ ไฟล์ root ยังสามารถเพิ่มให้กับการบิลด์ได้ ในการบิลด์ผลิตภัณฑ์ PDE/Build ที่สร้างคุณลักษณะของคอนเทนเนอร์แบบอัตโนมัติที่รวมปลั๊กอินทั้งหมดที่ระบุในไฟล์ .product (โปรดดูที่ภารกิจ eclipse.generateFeature) มีสองวิธีในการเพิ่ม root ของไฟล์ไปยังบิลด์ของผลิตภัณฑ์นี้: