Προσαρμογή δόμησης χωρίς γραφικό περιβάλλον

Υπάρχουν πολλές μέθοδοι προσαρμογής μιας δόμησης χωρίς γραφικό περιβάλλον:

Η ακριβής μορφή των περιεχομένων αυτών των αρχείων είναι αλληλοεξαρτώμενη. Συνεπώς, κατά τη χρήση προσαρμογών σεναρίων customTargets, allElements ή customAssembly, πρέπει να εξασφαλίζετε ότι τα πρότυπα που χρησιμοποιούνται για αυτά τα αρχεία προέρχονται από την ίδια εκδοχή του PDE/Build. Οι νέες εκδοχές του PDE/Build είναι συμβατές με προηγούμενες εκδόσεις αυτών των σεναρίων προσαρμογής.

Οι εκδοχές προτύπων αυτών των σεναρίων είναι διαθέσιμες στην πρόσθετη λειτουργία org.eclipse.pde.build στο φάκελο templates/headless-build. Για τη χρήση της προσαρμογής, απλώς αντιγράψτε το πρότυπο στον κατάλογο ρυθμίσεων δόμησης και τροποποιήστε τους κατάλληλους προορισμούς.

customTargets.xml

Το σενάριο customTargets.xml χρησιμοποιείται για προσαρμογές ανώτερου επιπέδου της διεργασίας δόμησης. Παρέχει προορισμούς ant που καλούνται στις κύριες φάσεις της διεργασίας δόμησης. Υπάρχουν διαθέσιμοι προορισμοί πριν και μετά από κάθε ένα από τα ακόλουθα βήματα δόμησης:

Για τη χρήση του σεναρίου customTargets.xml, απλώς αντιγράψτε το από τον κατάλογο προτύπων PDE/Build στον κατάλογο ρυθμίσεων δόμησης και τροποποιήστε τους κατάλληλους προορισμούς ant. Θα πραγματοποιηθεί αυτόματος εντοπισμός και χρήση του σεναρίου από τη δόμηση χωρίς γραφικό περιβάλλον.

Επίσης, το σενάριο customTargets.xml παρέχει ανάθεση στο σενάριο allElements.xml για κάθε μία από τις φάσεις δόμησης.

allElements.xml

Το σενάριο allElements.xml είναι ένα είδος σεναρίου ανάθεσης που χρησιμοποιείται για την εκτέλεση των διαφόρων βημάτων δόμησης σε ένα δεδομένο στοιχείο (συνήθως μια λειτουργία). Όσον αφορά στο σενάριο customTargets.xml, για τη χρήση αυτών των βημάτων προσαρμογής, αντιγράψτε το πρότυπο από το PDE/Build στον κατάλογο ρυθμίσεων δόμησης. Στην έκδοση 3.4 του Eclipse, το στοιχείο προορισμού που θα δομηθεί, μπορεί να καθοριστεί στο αρχείο ρυθμίσεων δόμησης ανώτερου επιπέδου build.properties χρησιμοποιώντας τις ιδιότητες topLevelElementType και topLevelElementId. Το elementType πρέπει να οριστεί στο feature και το elementId πρέπει να οριστεί στην ταυτότητα λειτουργίας προς δόμηση.

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

Επίσης, το σενάριο allElements.xml παρέχει προορισμούς που χρησιμοποιούνται κατά τη διάρκεια της φάσης συγκρότησης και συσκευασίας της δόμησης. Ο προορισμός 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. Παρέχει σημεία προσαρμογής που καλούνται κατά τη διάρκεια των φάσεων συγκρότησης και συσκευασίας της δόμησης. Όσον αφορά στα σενάρια customTargets.xml και allElements.xml, για τη χρήση αυτών των βημάτων προσαρμογής, αντιγράψτε το πρότυπο από το PDE/Build στον κατάλογο ρυθμίσεων δόμησης.

Τα σενάρια συγκρότησης και συσκευασίας που δημιουργήθηκαν από το PDE/Build εκτελούν τις ακόλουθες ενέργειες:

Τα σενάρια συγκρότησης ασχολούνται με τη συλλογή λειτουργιών και πρόσθετων λειτουργιών που μεταγλωττίστηκαν κατά τη δόμηση και τα σενάρια συσκευασίας με τη συλλογή προμεταγλωττισμένων δυαδικών λειτουργιών και πρόσθετων λειτουργιών. Το σενάριο customAssembly.xml παρέχει τους ακόλουθους προορισμούς πριν και μετά από κάθε ένα από τα παραπάνω βήματα: