Ανάκτηση από χώρους αποθήκευσης
Η υποδομή που προσφέρεται από το 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 είναι
η ακόλουθη:
όπου args αποτελεί μια λίστα διαχωρισμένη με κόμματα ζευγών κλειδιού/τιμής που
περιγράφονται παρακάτω:
- tag, το προσδιοριστικό CVS προς ανάληψη ελέγχου,
- cvsRoot, μια σειρά χαρακτήρων σύνδεσης CVS.
- path, μια προαιρετική λειτουργική μονάδα και διαδρομή CVS για την λήψη του
φακέλου που περιέχει το στοιχείο. Από προεπιλογή το όνομα στοιχείου χρησιμοποιείται ως
όνομα λειτουργικής μονάδας.
- prebuilt, μια προαιρετική λογικά τιμή που δηλώνει εάν το στοιχείο που έχει
μεταφορτωθεί είναι προ-δομημένο. Από προεπιλογή αυτή είναι "false".
- cvsPassFile, μια διαδρομή επιλογής σε ένα αρχείο μεταβίβασης cvs.
- password, ένας προαιρετικός κωδικός πρόσβασης για που χρησιμοποιείται
για τη σύνδεση στο CVS;
Παράδειγμα:
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
είναι μια προαιρετική λίστα διαχωρισμένη με κόμματα ζευγών κλειδιού/τιμής που
περιγράφονται παρακάτω:
- unpack, όταν ορίζεται σε "true" δηλώνει ότι το στοιχείο μεταφόρτωσης θα
πρέπει να αποσυμπιεστεί.
- verbose, ορίστε ως "true" για την εμφάνιση της αναλυτικής προόδου των
πληροφοριών κατά τη μεταφόρτωση. Η προεπιλεγμένη τιμή είναι "false".
- ignoreerrors, ορίστε σε "true" για την καταγραφή σε αρχείο σφαλμάτων κατά
τη διάρκεια της μεταφοράς. Η προεπιλεγμένη τιμή είναι "false".
- usetimestamp, μεταφορτώνει αναλόγως της περίπτωσης ένα αρχείο βάσει
του αποτυπώματος χρόνου του τοπικού αντιγράφου (για http URL μόνο) όταν ορίζεται σε true. Η προεπιλεγμένη τιμή είναι "false".
- username, το όνομα χρήστη για "BASIC" (βασική) εξακρίβωση στοιχείων http.
- password, ο κωδικός πρόσβασης για την διενέργεια της μεταφόρτωσης.
Παράδειγμα:
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
Προστέθηκε μια νέα επέκταση στο PDE/Build η οποία επιτρέπει στους χρήστες την ανάκτηση
τεχνουργημάτων από χώρους αποθήκευσης p2. Μπορείτε να προσθέσετε μια καταχώρηση στο
αρχείο αντιστοίχισης ως είσοδο της δόμησης ώστε το PDE/Build να ανακτήσει το
τεχνούργημα και να το συμπεριλάβει στη δόμηση. Η καταχώρηση του αρχείου αντιστοίχισης πρέπει να περιλαμβάνει την ταυτότητα και την
εκδοχή της εγκαταστάσιμης μονάδας (installable unit - IU), καθώς και το URI του χώρου
αποθήκευσης στον οποίο έχει τοποθετηθεί η εγκαταστάσιμη μονάδα. Θεωρείται δεδομένο ότι οι χώροι αποθήκευσης μεταδεδομένων και τεχνουργημάτων βρίσκονται
στην ίδια θέση.
Η μορφή μιας καταχώρησης αρχείου αντιστοίχισης για την ανάκτηση περιεχομένου μέσω p2
είναι η ακόλουθη:
<elementType>@<elementID> = p2IU, id=<id>, version=<version>, repository=<repository>
- id, η ταυτότητα της εγκαταστάσιμης μονάδας,
- version, η εκδοχή του εγκαταστάσιμου στοιχείου (προαιρετικά). Αν δεν
καθοριστεί, επιστρέφεται η πιο πρόσφατη διαθέσιμη εκδοχή.
- repository, η θέση (URI) του χώρου αποθήκευσης όπου βρίσκεται η
εγκαταστάσιμη μονάδα.
Ανάκτηση λειτουργιών με το 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.exe στη διαδρομή αναζήτησης συστήματος.
(Μεταφορτώστε το CVS από εδώ).
- Δημιουργήστε ένα φάκελο με το όνομα "maps" στον κατάλογο δόμησης.
- Δημιουργήστε ένα αρχείο με την επέκταση .map στο φάκελο "maps".
- Τοποθετήστε στο αρχείο αντιστοίχισης όλα τα στοιχεία που πρέπει να ανακτηθούν από
ένα χώρο αποθήκευσης.
- Τροποποιήστε το αρχείο build.properties από το φάκελο ρυθμίσεων και προσθέστε
σχόλιο στη γραμμή skipFetch=true. Εάν αυτή η ιδιότητα έχει οριστεί, το
PDE Build θα παραλείψει ολόκληρη τη φάση ανάκτησης. Εάν επιθυμείτε να αγνοηθεί το
προσδιοριστικό που έχει οριστεί στα αρχεία αντιστοίχισης, μπορείτε να ορίσετε μια
συγκεκριμένη τιμή για την ιδιότητα fetchTag. Αυτό είναι χρήσιμο όταν γίνεται
μια δόμηση κάθε βράδυ από το HEAD αντί για τις εκδοχές με προσδιοριστικά.
Λήψη των αρχείων αντιστοίχισης από το CVS
Τα αρχεία αντιστοίχισης αποθηκεύονται συνήθως στον χώρο αποθήκευσης. Το PDE Build
προσφέρει προεπιλεγμένη δομή για τη λήψη αυτών των αρχείων αντιστοίχισης από τον χώρο
αποθήκευσης CVS.
Για να ενεργοποιήσετε αυτή τη συνάρτηση αλλάξτε τις ακόλουθες ιδιότητες
στο build.properties των ρυθμίσεών σας από τον κατάλογο ρυθμίσεων:
- skipMaps: Προσθήκη συμβόλων
σχολιασμού σε αυτήν την ιδιότητα. Εάν οριστεί αυτή η ιδιότητα, τότε το PDE Build
δεν θα ανακτήσει τα αρχεία αντιστοίχισης.
- mapsRepo =
:pserver:anonymous@example.com/path/to/repo. Ο χώρος αποθήκευσης CVS από τον
οποίο γίνεται λήψη των αρχείων αντιστοίχισης.
- mapsRoot =
/path/to/maps. Η διαδρομή στον χώρο αποθήκευσης CVS για τον κατάλογο που περιέχει τα αρχεία αντιστοίχισης.
- mapsCheckoutTag =
HEAD. Το προσδιοριστικό CVS για χρήση στην ανάληψη ελέγχου των αρχείων αντιστοίχισης.
Η ανάκτηση των αρχείων αντιστοίχισης από το CVS συμβαίνει κατά τη διάρκεια της φάσης
πριν τη δόμηση.
Σενάρια για την ανάκτηση όλων των λειτουργιών και των πρόσθετων λειτουργιών που
συμπεριλαμβάνονται στη λειτουργία που δομείτε, θα παραχθούν και θα εκτελεστούν κατά
τη διάρκεια της φάσης λήψης της δόμησης.
Αυτόματη ανάκτηση από άλλους χώρους αποθήκευσης
Εάν κάνετε αυτόματα ανάκτηση των αρχείων αντιστοίχισης από τον χώρο αποθήκευσης,
θα χρειαστεί να αντιγράψετε το αρχείο customTarget.xml από το
org.eclipse.pde.build/templates/headless-build στον κατάλογο των ρυθμίσεών σας. Ο προορισμός getMapFiles χρησιμοποιείται για την ανάκτηση των αρχείων
αντιστοίχισης, αυτό θα πρέπει να τροποποιηθεί για ανάκτηση από τον χώρο αποθήκευσης.
Λήψη πρωτογενούς κώδικα με μη αυτόματο τρόπο
Μπορείτε να γράψετε προσαρμοσμένους προορισμούς ανάκτησης για την ανάκτηση των
λειτουργιών και των πρόσθετων λειτουργιών οι οποίες μπορούν να κληθούν από τους
προορισμούς preSetup ή postSetup στο αρχείο customTargets.xml.
Η ανάκτηση των λειτουργιών και των πρόσθετων λειτουργιών πρέπει να γίνεται στο
${buildDirectory}/features
και στο
${buildDirectory}/plugins
αντίστοιχα.