Ανάκτηση από χώρους αποθήκευσης

Η υποδομή που προσφέρεται από το PDE Build παρέχει βήματα για την ανάκτηση του πρωτογενούς κώδικα και της προετοιμασίας δόμησης πρόσθετων λειτουργιών από ένα χώρο αποθήκευσης ως τμήμα της διεργασίας δόμησης (ανατρέξτε στην εργασία eclipse.fetch και στις ιδιότητες για τον έλεγχο της ανάκτησης). Διατίθενται δυο τρόποι ανάκτησης του πρωτογενούς κώδικα: α) αυτόματη ανάκτηση του πρωτογενούς κώδικα από το PDE Build και β) μη αυτόματη ανάκτηση πρωτογενούς κώδικα.

Πρώτο βήμα προς την αυτοματοποίηση: το αρχείο αντιστοίχισης

Δεδομένης της ταυτότητας μιας λειτουργίας ή πρόσθετης λειτουργίας που χρειάζεται να δομηθεί, η υποδομή της δόμησης έχει την ικανότητα να ανακτήσει από το CVS όλες τις περιεχόμενες λειτουργίες και πρόσθετες λειτουργίες.

Προκειμένου να γνωρίζει από πού θα λάβει αυτά που χρειάζεται, το PDE χρησιμοποιεί αρχεία αντιστοίχισης. Το αρχείο αντιστοίχισης είναι ένα αρχείο ιδιότητας java και αντιστοιχίζει τις ταυτότητες των λειτουργιών και των πρόσθετων λειτουργιών σε μια θέση και ένα προσδιοριστικό σε ένα χώρο αποθήκευσης. Τα αρχεία αντιστοίχισης έχουν ανοιχτή μορφή αλλά το τμήμα key ρυθμίζεται από το PDE Build:

<elementType>@<elementID>[,<elementVersion>] = <repo specific content>

όπου το elementType είναι bundle, feature, plugin ή fragment και τα elementId και elementVersion αποδίδουν τα χαρακτηριστικά του στοιχείου.

Καταχώρηση αρχείου αντιστοίχισης για CVS

Η μορφή μιας καταχώρησης αρχείου αντιστοίχισης για την ανάκτηση περιεχομένου από CVS είναι η ακόλουθη:
<key> = CVS, [,args]
όπου args αποτελεί μια λίστα διαχωρισμένη με κόμματα ζευγών κλειδιού/τιμής που περιγράφονται παρακάτω: Παράδειγμα:
plugin@com.ibm.icu,3.6.1=CVS,tag=v200704191630,cvsRoot=:pserver:anonymous@dev.eclipse.org:/cvsroot/tools,path=org.eclipse.orbit/com.ibm.icu/bin,prebuilt=true

Καταχωρήσεις αντιστοίχισης παλιάς μορφής
Στο Eclipse 3.2 και στις προγενέστερες εκδόσεις, η μορφή του αρχείου αντιστοίχισης για το CVS ήταν:
<elementType>@<elementID> = CVS, <TAG>, <CVSROOT>[,<PASSWORD>[,<PATH>[,<CVSPASSFILE>]]]
Αν κάποιο προαιρετικό όρισμα δεν καθοριστεί, τα κόμματα συνεχίζουν να είναι απαραίτητα για το διαχωρισμό των επόμενων ορισμάτων. Αυτή η μορφή έχει καταργηθεί και συνιστάται η χρήση της μορφής κλειδί/τιμή.

Καταχώρηση αρχείου αντιστοίχισης Ant GET

Η μορφή μιας καταχώρησης αρχείου αντιστοίχισης για την ανάκτηση περιεχομένου από οποιοδήποτε URL υποστηρίζεται από Ant GET είναι η ακόλουθη:

<key> = GET, <url> [,args]
όπου url είναι το url από όπου γίνεται η ανάκτηση των δεδομένων και args είναι μια προαιρετική λίστα διαχωρισμένη με κόμματα ζευγών κλειδιού/τιμής που περιγράφονται παρακάτω: Παράδειγμα:
plugin@com.ibm.icu,3.4.5=GET,http://download.eclipse.org/tools/orbit/downloads/drops/S200705301823/bundles/com.ibm.icu_3.4.5.jar, unpack=true

Καταχώρηση αρχείου αντιστοίχισης για ανάκτηση περιεχομένου μέσω p2

Προστέθηκε μια νέα επέκταση στο PDE/Build η οποία επιτρέπει στους χρήστες την ανάκτηση τεχνουργημάτων από χώρους αποθήκευσης p2. Μπορείτε να προσθέσετε μια καταχώρηση στο αρχείο αντιστοίχισης ως είσοδο της δόμησης ώστε το PDE/Build να ανακτήσει το τεχνούργημα και να το συμπεριλάβει στη δόμηση. Η καταχώρηση του αρχείου αντιστοίχισης πρέπει να περιλαμβάνει την ταυτότητα και την εκδοχή της εγκαταστάσιμης μονάδας (installable unit - IU), καθώς και το URI του χώρου αποθήκευσης στον οποίο έχει τοποθετηθεί η εγκαταστάσιμη μονάδα. Θεωρείται δεδομένο ότι οι χώροι αποθήκευσης μεταδεδομένων και τεχνουργημάτων βρίσκονται στην ίδια θέση.

Η μορφή μιας καταχώρησης αρχείου αντιστοίχισης για την ανάκτηση περιεχομένου μέσω p2 είναι η ακόλουθη:

<elementType>@<elementID> = p2IU, id=<id>, version=<version>, repository=<repository>
Ανάκτηση λειτουργιών με το p2

Στην έκδοση Helios, η ανάκτηση των λειτουργιών με το p2 μπορεί να γίνει καθορίζοντας την εγκαταστάσιμη μονάδα που αναπαριστά το αρχείο jar λειτουργιών. Ανατρέξτε στη σελίδα μεταδεδομένων λειτουργιών για λεπτομέρειες σχετικά με τη δομή των μεταδεδομένων του p2 για λειτουργίες.

Παραδείγματα:
plugin@my.bundle.id,1.0.0=p2IU,id=my.bundle.id,version=1.0.0,repository=http://example.eclipse.org/repo
feature@my.feature.id = p2IU,id=my.feature.id.feature.jar, version=1.0.0,repository=http://example.eclipse.org/repo

Καταχώρηση αρχείου αντιστοίχισης για άλλους χώρους αποθήκευσης

Το PDE Build παρέχει ένα σημείο επέκτασης όπου οι λειτουργίες δημιουργίας σεναρίων ανάκτησης για διαφορετικούς χώρους αποθήκευσης μπορούν να συνδεθούν. Όταν η εγκατάσταση του eclipse περιέχει μια δέσμη που παρέχει μια επέκταση δημιουργίας σεναρίων για ένα διαφορετικό είδος χώρου αποθήκευσης, μπορείτε να χρησιμοποιήσετε αυτόν το χώρο αποθήκευσης αν τον καθορίσετε στις καταχωρήσεις του αρχείου αντιστοίχισης και αν εμμείνετε στη μορφή που καθορίζεται από τον παροχέα επεκτάσεων.

Ρυθμίσεις για την ανάκτηση πρωτογενούς κώδικα από το CVS

Για να ρυθμίσετε την ανάκτηση πρωτογενούς κώδικα από το CVS, θα πρέπει να ακολουθήσετε τα εξής:

Λήψη των αρχείων αντιστοίχισης από το CVS

Τα αρχεία αντιστοίχισης αποθηκεύονται συνήθως στον χώρο αποθήκευσης. Το PDE Build προσφέρει προεπιλεγμένη δομή για τη λήψη αυτών των αρχείων αντιστοίχισης από τον χώρο αποθήκευσης CVS. Για να ενεργοποιήσετε αυτή τη συνάρτηση αλλάξτε τις ακόλουθες ιδιότητες στο build.properties των ρυθμίσεών σας από τον κατάλογο ρυθμίσεων: Η ανάκτηση των αρχείων αντιστοίχισης από το CVS συμβαίνει κατά τη διάρκεια της φάσης πριν τη δόμηση.  Σενάρια για την ανάκτηση όλων των λειτουργιών και των πρόσθετων λειτουργιών που συμπεριλαμβάνονται στη λειτουργία που δομείτε, θα παραχθούν και θα εκτελεστούν κατά τη διάρκεια της φάσης λήψης της δόμησης. 

Αυτόματη ανάκτηση από άλλους χώρους αποθήκευσης

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

Λήψη πρωτογενούς κώδικα με μη αυτόματο τρόπο

Μπορείτε να γράψετε προσαρμοσμένους προορισμούς ανάκτησης για την ανάκτηση των λειτουργιών και των πρόσθετων λειτουργιών οι οποίες μπορούν να κληθούν από τους προορισμούς preSetup ή postSetup στο αρχείο customTargets.xml.  Η ανάκτηση των λειτουργιών και των πρόσθετων λειτουργιών πρέπει να γίνεται στο ${buildDirectory}/features και στο ${buildDirectory}/plugins αντίστοιχα.