Λειτουργίες δόμησης
Η δόμηση PDE διαθέτει υποδομή αυτοματοποίησης της δόμησης των λειτουργιών.
Το μεγαλύτερο μέρος των απαραίτητων ρυθμίσεων μιας τέτοιας δόμησης μπορεί να λάβει
χώρα μέσω λίγων τροποποιήσεων στο build.properties του προτύπου που παρέχεται στη
δόμηση PDE. Η ακόλουθη ενότητα εστιάζει στη ρύθμιση μιας απλής δόμησης, θεωρώντας ότι
όλες οι λειτουργίες και πρόσθετες λειτουργίες (που πρόκειται να δομηθούν ή είναι
προ-δομημένες), στις οποίες παραπέμπει η λειτουργία που βρίσκεται σε διεργασία δόμησης,
είναι ήδη τοπικά διαθέσιμες στο δίσκο.
Βασική ρύθμιση
Το πρώτο βήμα ρύθμισης της δόμησης είναι η δημιουργία του καταλόγου στον οποίο η
δόμηση θα λάβει χώρα.
Ο κατάλογος αυτός θα αναφέρεται ως ο κατάλογος δόμησης και θα περιέχει τις προς
δόμηση λειτουργίες και πρόσθετες λειτουργίες, καθώς και όλα τα δημιουργημένα
τεχνουργήματα.
Κατόπιν, αντιγράψτε τις λειτουργίες και τις πρόσθετες λειτουργίες στους υποκαταλόγους
"λειτουργίες" και "πρόσθετες λειτουργίες" αντίστοιχα.
Ο φάκελος λειτουργιών αναμένεται να περιέχει τη λειτουργία που βρίσκεται σε διεργασία
δόμησης.
Το δεύτερο βήμα ρύθμισης δόμησης είναι η αντιγραφή του αρχείου προτύπου build.properties
από το org.eclipse.pde.build/templates/headless-build σε ένα νέο κατάλογο, ο οποίος θα
αποτελέσει τον κατάλογο ρυθμίσεων δόμησης (αναφέρεται επίσης και ως ο
κατάλογος ρυθμίσεων). Τροποποιήστε το αντιγραμμένο αρχείο build.properties και
ορίστε τις ακόλουθες ιδιότητες:
- baseLocation: η θέση μιας εγκατάστασης eclipse
που περιέχει όλες τις προ-δομημένες λειτουργίες και πρόσθετες λειτουργίες στους
υποκαταλόγους λειτουργίες/ και πρόσθετες λειτουργίες/.
- baseos: δηλώνει το λειτουργικό σύστημα του eclipse
όπως ορίζεται από το baseLocation.
- basews: δηλώνει το παραθυρικό σύστημα του eclipse
όπως ορίζεται από το baseLocation.
- basearch: δηλώνει την αρχιτεκτονική του eclipse
όπως ορίζεται από το baseLocation.
- buildDirectory:
ο κατάλογος στον οποίο η δόμηση θα λάβει χώρα. Ορίστε τον στην πλήρη διαδρομή του
καταλόγου δόμησης που δημιουργήσατε νωρίτερα.
- configs: λίστα των ρυθμίσεων που αφορούν
τη λειτουργία που βρίσκεται σε διεργασία δόμησης.
Μπορείτε να πραγματοποιήσετε αφαίρεση των σχολίων της ρύθμισης (ή των ρυθμίσεων) που
παρέχεται (προσοχή στις συνέχειες των γραμμών).
Εάν η λειτουργία που δομείται είναι ανεξάρτητη πλατφόρμας, η ιδιότητα αυτή δεν χρειάζεται
να ρυθμιστεί, μπορεί όμως να ρυθμιστεί σε *,*,*.
- archivePrefix: το όνομα του καταλόγου στο
δίσκο, στον οποίο η λειτουργία σας θα αποσυμπιεστεί.
Έλεγχος του τι πρόκειται να δομηθεί: 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 με αυτή την εφαρμογή προκειμένου να εκτελέσει μια δόμηση, θα
χρειαστεί να ορίσετε δυο ορίσματα στη γραμμή εντολών:
-buildfile=</path/to/build.xml>
: Πρόκειται για τη
διαδρομή στο build.xml που παρέχεται από τη δόμηση pde. Βρίσκεται στον
κατάλογο org.eclipse.pde.build/scripts direct. Πρόκειται για το αρχείο δόμησης που
καθοδηγεί ολόκληρη τη διαδικασία δόμησης.
-Dbuilder=</path/to/configuration folder>
:
Αυτή είναι η διαδρομή για το φάκελο ρυθμίσεων δόμησης.
Εκτελέστε την εφαρμογή 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 για
περισσότερες λεπτομέρειες.