การปรับแต่ง Headless Build

มีเมธอดจำนวนมากสำหรับการปรับแต่ง headless build:

รูปแบบที่แน่นอนของเนื้อหาของไฟล์เหล่านี้ทั้งหมดขึ้นอยู่กับเนื้อหาของไฟล์อื่น ดังนั้น เมื่อใช้การปรับแต่ง customTargets, allElements หรือ customAssembly ขอแนะนำให้มั่นใจว่า เทมเพลตที่ใช้สำหรับไฟล์เหล่านี้ทั้งหมดมาจากเวอร์ชันของ PDE/Build เดียวกัน เวอร์ชันใหม่ของ PDE/Build เข้ากันได้กับรุ่นที่มาก่อนด้วยเวอร์ชันเก่าของสคริปต์การปรับแต่งเหล่านี้

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

customTargets.xml

สคริปต์ customTargets.xml ใช้สำหรับการปรับแต่งระดับบนสุดของกระบวนการ build ซึ่งจัดเตรียมเป้าหมาย ant ที่ถูกเรียกระหว่างเฟสหลักของ build มีเป้าหมายก่อนและหลังซึ่งพร้อมใช้งานอยู่โดยรอบขั้นตอน build ต่อไปนี้แต่ละขั้นตอน:

เพื่อใช้สคริปต์ customTargets.xml ให้คัดลอกจากไดเร็กทอรีเทมเพลต PDE/Build ไปยังไดเร็กทอรีคอนฟิกูเรชันของ build ของคุณและแก้ไขเป้าหมาย ant ที่เหมาะสม สคริปต์จะถูกตรวจพบแบบอัตโนมัติและใช้โดย headless build

สคริปต์ customTargets.xml ยังจัดเตรียมการมอบหมายให้กับสคริปต์ allElements.xml สำหรับแต่ละเฟสของ build

allElements.xml

สคริปต์ allElements.xml คือชนิดของสคริปต์ของการมอบหมายที่ถูกใช้เพื่อรันขั้นตอนการ build ต่างๆ บนอิลิเมนต์ที่กำหนดไว้ (โดยปกติคือคุณลักษณะ) เนื่องด้วย customTargets.xml เพื่อใช้ขั้นตอนการปรับแต่งเหล่านี้ ให้คัดลอกเทมเพลตจาก PDE/Build ลงในไดเร็กทอรีคอนฟิกูเรชันของ build ของคุณ ใน Eclipse 3.4 อิลิเมนต์เป้าหมายที่จะถูก build สามารถระบุได้ในไฟล์ build.properties ของคอนฟิกูเรชัน build ระดับบนสุดโดยใช้คุณสมบัติ topLevelElementType และ topLevelElementId elementType ควรตั้งค่าเป็น คุณลักษณะ และ elementId ควรถูกตั้งค่าเป็น id คุณลักษณะที่คุณต้องการ build

 	<target name="allElementsDelegator">
 		<ant antfile="${genericTargets}" target="${target}">
	 		<property name="type" value="${topLevelElementType}" />
	 		<property name="id" value="${topLevelElementId}" />
 		</ant>
 	</target>

allElements.xml ยังจัดเตรียมเป้าหมายที่ใช้ในระหว่างการประกอบและการจัดทำแพ็กเกจของเฟสของการ build เป้าหมาย defaultAssemble จะถูกเรียกเพื่อประกอบไฟล์เก็บถาวรสำหรับแพลตฟอร์มทั้งหมด หากต้องการ เป้าหมายแบบกำหนดเองสามารถนิยามสำหรับแพลตฟอร์มเดี่ยว

เพื่อใช้เป้าหมายแบบกำหนดเองสำหรับแพลตฟอร์มที่กำหนดเอง ให้นิยามคุณสมบัติ "assemble.<element-id>[.<config>] และเป้าหมายที่สอดคล้องกัน คุณสมบัติแจ้งให้ PDE/Build ใช้เป้าหมายแบบกำหนดเองนี้แทนเป้าหมายดีฟอลต์ เป้าหมายแบบกำหนดเองนี้สามารถใช้เพื่อกำหนดชื่อแบบกำหนดเองให้กับไฟล์เก็บถาวรหรือหลังประมวลผลกับไฟลเก็บถาวร

ตัวอย่าง:

	<property name="assemble.org.foo.feature.id.linux.gtk.x86" value="true" />
 	<target name="assemble.org.foo.feature.id.linux.gtk.x86">
 		<property name="archiveName" value="acme-RCP-${buildId}-linux.gtk.x86.tar.gz" />
 		<-- custom pre assemble steps for linux.gtk.x86-->
 		<ant antfile="${assembleScriptName}" dir="${buildDirectory}"/>
 		<-- custom post assemble steps for linux.gtk.x86-->
 	</target>

customAssembly.xml

สคริปต์ customAssembly.xml คือสิ่งใหม่ใน 3.4 ซึ่งจัดเตรียมจุดการปรับแต่งที่จะถูกเรียกในระหว่างเฟสการประกอบและการจัดแพ็กเกจของ build เนื่องด้วย customTargets.xml และ allElements.xml เพื่อใช้การปรับแต่งเหล่านี้ ให้คัดลอกเทมเพลตจาก PDE/Build ในไดเร็กทอรีคอนฟิกูเรชันของ build

สคริปต์การประกอบและการจัดทำแพ็กเกจที่สร้างขึ้นโดย PDE/Build จะดำเนินการกับการดำเนินการต่อไปนี้:

สคริปต์การประกอบจะทำงานกับการรวบรวมคุณลักษณะและปลั๊กอินที่ถูกคอมไพล์ในระหว่างการ build และสคริปต์การจัดทำแพ็กเกจจะทำงานกับคุณลักษณะและปลั๊กอินแบบไบนารีที่คอมไพล์ไว้ก่อนหน้านี้ สคริปต์ customAssembly.xml จัดเตรียมเป้าหมายต่อไปนี้ก่อนหรือหลังขั้นตอนข้างต้นแต่ละขั้นตอน: