Λειτουργίες δόμησης

Η δόμηση PDE διαθέτει υποδομή αυτοματοποίησης της δόμησης των λειτουργιών. Το μεγαλύτερο μέρος των απαραίτητων ρυθμίσεων μιας τέτοιας δόμησης μπορεί να λάβει χώρα μέσω λίγων τροποποιήσεων στο build.properties του προτύπου που παρέχεται στη δόμηση PDE. Η ακόλουθη ενότητα εστιάζει στη ρύθμιση μιας απλής δόμησης, θεωρώντας ότι όλες οι λειτουργίες και πρόσθετες λειτουργίες (που πρόκειται να δομηθούν ή είναι προ-δομημένες), στις οποίες παραπέμπει η λειτουργία που βρίσκεται σε διεργασία δόμησης, είναι ήδη τοπικά διαθέσιμες στο δίσκο.

Βασική ρύθμιση

Το πρώτο βήμα ρύθμισης της δόμησης είναι η δημιουργία του καταλόγου στον οποίο η δόμηση θα λάβει χώρα. Ο κατάλογος αυτός θα αναφέρεται ως ο κατάλογος δόμησης και θα περιέχει τις προς δόμηση λειτουργίες και πρόσθετες λειτουργίες, καθώς και όλα τα δημιουργημένα τεχνουργήματα. Κατόπιν, αντιγράψτε τις λειτουργίες και τις πρόσθετες λειτουργίες στους υποκαταλόγους "λειτουργίες" και "πρόσθετες λειτουργίες" αντίστοιχα. Ο φάκελος λειτουργιών αναμένεται να περιέχει τη λειτουργία που βρίσκεται σε διεργασία δόμησης.

Το δεύτερο βήμα ρύθμισης δόμησης είναι η αντιγραφή του αρχείου προτύπου build.properties από το org.eclipse.pde.build/templates/headless-build σε ένα νέο κατάλογο, ο οποίος θα αποτελέσει τον κατάλογο ρυθμίσεων δόμησης (αναφέρεται επίσης και ως ο κατάλογος ρυθμίσεων). Τροποποιήστε το αντιγραμμένο αρχείο build.properties και ορίστε τις ακόλουθες ιδιότητες:

Έλεγχος του τι πρόκειται να δομηθεί: allElements.xml

Αντιγράψτε το αρχείο allElements.xml από το org.eclipse.pde.build/templates/headless-build στον κατάλογο ρυθμίσεων. Αυτό είναι το αρχείο που ενημερώνει το περιβάλλον ανάπτυξης πρόσθετων λειτουργιών (PDE) σχετικά με το ποια λειτουργία δομείται.  Το αρχείο αυτό περιέχει δυο είδη προορισμών:  το allElementsDelegator, το οποίο καθορίζει τη λειτουργία που δομείται, και τους προορισμούς συγκέντρωσης που καλούνται να συγκεντρώσουν τις μεμονωμένες ρυθμίσεις.  Το allElementsDelegator για μια λειτουργία με το όνομα org.foo.Feature είναι:
 	<target name="allElementsDelegator">
<ant antfile="${genericTargets}" target="${target}">
<property name="type" value="feature" />
<property name="id" value="org.foo.Feature" />
</ant>
</target>
Οι προορισμοί συγκέντρωσης σας επιτρέπουν να ελέγξετε το όνομα του τελικού αρχείου αποθήκευσης βάσει των ρυθμίσεων.  Θα πρέπει να έχετε ένα προορισμό για κάθε ρύθμιση που δομείτε.  Για παράδειγμα, όταν δομείται η λειτουργία org.foo.Feature για windows (όταν η configs έχει ρυθμιστεί σε win32, win32, x86), θα πρέπει να έχετε τον ακόλουθο προορισμό:
<!--Target for assembling  os=win32, ws=win32, arch=x86 -->
<target name="assemble.org.foo.Feature.win32.win32.x86">
<ant antfile="${assembleScriptName}" dir="${buildDirectory}/">
</target>
Κατά τη διεργασία δόμησης μιας ρύθμισης ανεξάρτητης πλατφόρμας (όταν η configs έχει οριστεί σε *,*,*) ή δεν έχει οριστεί καθόλου), θα πρέπει να έχετε ένα προορισμό σαν τον ακόλουθο:
<!--The platform independent assemble target-->
<target name="assemble.org.foo.Feature">
<ant antfile="${assembleScriptName}" dir="${buildDirectory}"/>
</target>

Εκτέλεση δόμησης

Για την εκτέλεση της δόμησης, θα χρησιμοποιήσετε την εφαρμογή org.elipse.ant.core.antRunner. Κατά την κλήση του eclipse με αυτή την εφαρμογή προκειμένου να εκτελέσει μια δόμηση, θα χρειαστεί να ορίσετε δυο ορίσματα στη γραμμή εντολών:
Εκτελέστε την εφαρμογή antRunner χρησιμοποιώντας την ακόλουθη εντολή:
java -jar <eclipseInstall>/startup.jar -application org.eclipse.ant.core.antRunner -buildfile <<eclipseInstall>/plugins/org.eclipse.pde.build_<version>/scripts/build.xml> -Dbuilder=<path to the build configuration folder>
Μόλις η δόμηση ολοκληρωθεί, μπορείτε να λάβετε το αποτέλεσμα στον κατάλογο δόμησης, στο φάκελο με το όνομα "I.TestBuild" (το όνομα αυτό μπορεί να οριστεί μέσω της ρύθμισης της ιδιότητας "buildLabel").

Προηγμένα σενάρια

Εάν επιθυμείτε την πραγματοποίηση περισσότερων προσαρμογών στη δόμηση (για παράδειγμα, εάν επιθυμείτε την ανάκτηση από ένα χώρο αποθήκευσης), ανατρέξτε στα Προηγμένα θέματα δόμησης PDE για περισσότερες λεπτομέρειες.