Ιδιότητες λειτουργίας και πρόσθετης λειτουργίας ρύθμισης της διεργασίας δόμησης
Ο μηχανισμός δόμησης καθοδηγείται από τις ρυθμίσεις δόμησης. Οι ρυθμίσεις δόμησης για μια μεμονωμένη πρόσθετη λειτουργία, τμήμα ή λειτουργία βρίσκονται σε ένα αρχείο build.properties για το αντίστοιχο στοιχείο.
Οι οδηγοί δημιουργίας έργου PDE δημιουργούν το αρχείο build.properties κατά τη δημιουργία έργων πρόσθετων λειτουργιών. Αυτό το αρχείο περιέχει πληροφορίες σχετικά με τον τρόπο μεταγλώττισης φακέλων πρωτογενούς κώδικα μέσα σε JAR. Οι συγκεκριμένες πληροφορίες μπορούν να ενημερωθούν έμμεσα στη σελίδα "Περιβάλλον εκτέλεσης" της λειτουργίας επεξεργασίας δηλώσεων. Επίσης, μπορούν να τροποποιηθούν άμεσα μέσω της κατάλληλης λειτουργία επεξεργασίας.
Το PDE παρέχει μια απλή λειτουργία επεξεργασίας για το αρχείο build.properties, η οποία περιλαμβάνει προβολές φόρμας και πρωτογενούς κώδικα.
Το ίδιο το αρχείο ακολουθεί τη μορφή των ιδιοτήτων Java. Πρέπει να καταχωρήσετε κάποια κλειδιά και τις αντίστοιχες τιμές. Οι πολλαπλές τιμές διαχωρίζονται με κόμματα.
Κοινές ιδιότητες
- bin.includes - εμφανίζει τα αρχεία που θα συμπεριληφθούν στη δυαδική εκδοχή της πρόσθετης λειτουργίας που δομείται.
- bin.excludes - εμφανίζει τα αρχεία που θα εξαιρεθούν από τη δόμηση δυαδικών αρχείων.
- qualifier - όταν ο αριθμός της εκδοχής ενός στοιχείου τελειώνει με .qualifier, δηλώνει με ποια τιμή πρέπει να αντικατασταθεί το ".qualifier". Η τιμή της ιδιότητας μπορεί να είναι context, <value> ή none. Με την τιμή "context" θα δημιουργηθεί μια ημερομηνία σύμφωνα με την ημερομηνία συστήματος ή θα χρησιμοποιηθούν τα προσδιοριστικά CVS, αν η δόμηση γίνεται αυτόματα. Η τιμή <value> είναι μια πραγματική τιμή.
Με την τιμή "none", η ιδιότητα ".qualifier" θα αφαιρεθεί. Αν δεν οριστεί η ιδιότητα, χρησιμοποιείται η τιμή "context".
(Ανατρέξτε στο θέμα Προσδιοριστικά εκδοχής.)
- custom=true - δηλώνει ότι το σενάριο δόμησης είναι μη αυτόματο σε αντίθετη με το σενάριο που δημιουργείται αυτόματα. Για αυτό το λόγο, δεν αναζητείται καμία άλλη τιμή.
- customBuildCallbacks -
υποδεικνύει ένα αρχείο XML που περιέχει προσαρμοσμένους προορισμούς προς χρήση με τη
λειτουργία/πρόσθετη λειτουργία. (Ανατρέξτε
στο θέμα Προσαρμοσμένα βήματα δόμησης λειτουργιών και
πρόσθετων λειτουργιών.)
- customBuildCallbacks.failonerror -
ορίζει την παράμετρο "failonerror" της εργασίας subant. Η προεπιλεγμένη τιμή είναι "false".
- customBuildCallbacks.buildpath -
ορίζει τη παράμετρο "buildpath" της εργασίας subant. Χρήση όταν η θέση του προσαρμοσμένου αρχείου επανάκλησης σχετίζεται με τον κεντρικό κατάλογο της πρόσθετης λειτουργίας.
- customBuildCallbacks.inheritall -
ορίζει την παράμετρο "inheritall" της εργασίας subant. Η προεπιλεγμένη τιμή Ant είναι η
"false".
Ιδιότητες πρόσθετων λειτουργιών
- source.<library> - αναφέρει τους φακέλους πρωτογενούς κώδικα που θα μεταγλωττιστούν (π.χ. source.xyz.jar=src/, src-ant/).
Αν η βιβλιοθήκη καθορίζεται στο plug-in.xml ή το manifest.mf, η τιμή πρέπει να συμφωνεί
με αυτό.
- output.<library> - αναφέρει το φάκελο εξόδου, στον οποίο καταλήγει το αποτέλεσμα της μεταγλώττισης.
- exclude.<library> - αναφέρει τα αρχεία που δεν πρέπει να αντιγραφούν στη βιβλιοθήκη από το μεταγλωττιστή.
- extra.<library> - πρόσθετες διαδρομές κλάσεων που χρησιμοποιούνται για την εκτέλεση αυτόματης δόμησης. Οι διαδρομές κλάσεων μπορεί να είναι σχετικές διαδρομές ή URL πλατφόρμας που παραπέμπουν σε πρόσθετες λειτουργίες και τμήματα του περιβάλλοντος ανάπτυξης (π.χ. ../someplugin/xyz.jar, platform:/plugins/org.apache.ant/ant.jar).
Προτιμώνται τα URL πλατφόρμας έναντι των σχετικών διαδρομών.
- manifest.<library> - δηλώνει το αρχείο που θα χρησιμοποιηθεί ως δήλωση για τη βιβλιοθήκη. Το αρχείο πρέπει να βρίσκεται σε έναν από τους φακέλους πρωτογενούς κώδικα που χρησιμοποιούνται ως δεδομένα εισόδου για το jar.
- src.includes - αναφέρει τα αρχεία που θα συμπεριληφθούν στη δόμηση πρωτογενούς κώδικα.
- src.excludes - εμφανίζει τα αρχεία που θα εξαιρεθούν από τη δόμηση πρωτογενούς κώδικα.
- jars.extra.classpath - (καταργημένο) ίδια λειτουργία με την ιδιότητα extra.<library>, μόνο που οι εγγραφές εφαρμόζονται σε όλες τις βιβλιοθήκες.
- jars.compile.order - ορίζει τη σειρά με την οποία πρέπει να μεταγλωττιστούν τα αρχεία jar (σε περίπτωση παρουσίας πολλαπλών βιβλιοθηκών).
Επιλογές που αφορούν το μεταγλωττιστή. Εξετάστε επίσης τις σελίδες
Έλεγχος του
περιβάλλοντος μεταγλώττισης και
Επιλογές μεταγλωττιστή.
- jre.compilation.profile -
ρυθμίζει το περιβάλλον για τη μεταγλώττιση αυτής της δέσμης.
- javacSource -ρυθμίζει το επίπεδο συμβατότητας
πρωτογενούς κώδικα για τη μεταγλώττιση αυτής της δέσμης. Αντικαθιστά το
jre.compilation.profile.
- javacTarget - ρυθμίζει το επίπεδο
συμβατότητας της κλάσης στόχου για τη μεταγλώττιση αυτής της δέσμης.
Αντικαθιστά το jre.compilation.profile.
- bootClasspath - ρυθμίζει τη διαδρομή
κλάσεων εκκίνησης για τη μεταγλώττιση της δέσμης. Αντικαθιστά το
jre.compilation.profile.
- javacWarnings.<library>
- ρυθμίζει τις επιλογές προειδοποίησης προς μεταβίβαση στον μεταγλωττιστή.
(Ανατρέξτε στην επιλογή -warn στο
Χρήση
του μεταγλωττιστή μαζικής επεξεργασίας από τον οδηγό ανάπτυξης εφαρμογών Java).
- javacErrors.<library>
- ορίστε τις επιλογές σφάλματος για μεταβίβαση στο μεταγλωττιστή. (Ανατρέξτε στην
επιλογή -err στο
Χρήση
του μεταγλωττιστή μαζικής επεξεργασίας από τον οδηγό ανάπτυξης εφαρμογών Java).
- javacDefaultEncoding.<library>
- ρυθμίζει τη χρήση προεπιλεγμένης κωδικοποίησης κατά τη μεταγλώττιση της βιβλιοθήκης.
- javacCustomEncodings.<library>
- Μια λίστα διαδρομών και κωδικοποιήσεων διαχωρισμένων με κόμμα για χρήση κατά τη
μεταγλώττιση της βιβλιοθήκης. Παράδειγμα:
javacCustomEncodings.library.jar = src/org/foo[US-ASCII],
src/org/foo/bar.java[utf-8]
- javacProjectSettings - Μια σχετική διαδρομή προς ένα αρχείο προτιμήσεων που ορίζει ιδιότητες για το μεταγλωττιστή JDT. Δώστε
την τιμή true για να χρησιμοποιήσετε το προεπιλεγμένο ".settings/org.eclipse.jdt.core.prefs".
- compilerArg - ορίζει προσαρμοσμένα ορίσματα για το μεταγλωττιστή
- compilerAdapter - ορίστε έναν προσαρμοσμένο προσαρμογέα για το μεταγλωττιστή που θα χρησιμοποιηθεί αντί του προεπιλεγμένου org.eclipse.jdt.core.JDTCompilerAdapter
- compilerAdapter.useLog - true/false: ορίζει κατά πόσο ο προσαρμοσμένος προσαρμογέας μεταγλωττιστή θα πρέπει να λάβει το όρισμα -log.
- compilerAdapter.useArgFile - true/false: ορίζει κατά πόσον ο προσαρμοσμένος προσαρμογέας μεταγλωττιστή θα πρέπει να λάβει το αρχείο ορισμάτων javaCompiler.<library>.args που δημιουργήθηκε.
- sourceFileExtensions - μια λίστα με επεκτάσεις (*.java, *.aj) που θα πρέπει να ληφθούν υπόψη ως πηγή όταν χρησιμοποιείται ένας προσαρμοσμένος προσαρμογέας μεταγλωττιστή.
Οι τιμές που ορίζονται για τα κλειδιά που τελειώνουν με "includes" ή "excludes" εκφράζονται ως "μοτίβα" Ant. Από τις τυπικές μορφές προκύπτουν τα αναμενόμενα αποτελέσματα.
Για παράδειγμα, το μοτίβο "*.jar*" δηλώνει όλα τα αρχεία jar στον
κατάλογο ανώτερου επιπέδου. Τα μοτίβα δεν έχουν βάθος από προεπιλογή. Αν, για παράδειγμα, θέλετε να περιγράψετε όλα τα αρχεία Java, πρέπει να χρησιμοποιήσετε το μοτίβο "**/*.java". Το μοτίβο "**" συμφωνεί με οποιονδήποτε αριθμό επιπέδων καταλόγου. Παρομοίως, για να περιγράψετε ολόκληρες υπο-διακλαδώσεις, χρησιμοποιήστε το μοτίβο "xyz/".
Ιδιότητες λειτουργιών
- root - παραθέτει τα αρχεία και τους φακέλους που πρέπει να συμπεριληφθούν στον κεντρικό κατάλογο του προϊόντος. Ανατρέξτε στη
Σελίδα βοήθειας αρχείων κεντρικού καταλόγου
για περισσότερες λεπτομέρειες, περιλαμβάνοντας τις ακόλουθες πρόσθετες ιδιότητες:
- root.<config>: ανά αρχεία κεντρικού καταλόγου ρυθμίσεων.
- root.folder : αρχεία κεντρικού καταλόγου που βρίσκονται σε υποφακέλους.
- root.permissions : εκτέλεση ενέργειας "chmod" σε αρχεία κεντρικού καταλόγου.
- root.link : δημιουργία αρχείων-δείκτη (softlink) για αρχεία κεντρικού καταλόγου.
- root.<config> - εμφανίζει τα αρχεία και τους φακέλους που πρέπει να συμπεριληφθούν στον κεντρικό κατάλογο του προϊόντος, όταν έχει δομηθεί για τις συγκεκριμένες ρυθμίσεις. Το "config" αποτελείται από τρία (3) τμήματα ρυθμίσεων διαχωρισμένα με μια τελεία.
- root.permissions.<permissionValue> - εμφανίζει τα αρχεία και τους φακέλους στα οποία πρέπει να εκτελεστεί η ενέργεια "chmod" για να εφαρμοστεί η δεδομένη τιμή. Η παραπομπή στους φακέλους πρέπει να τελειώνει με το χαρακτήρα "/".
- root.permissions.<config>.<permissionValue> - εμφανίζει τα αρχεία και τους φακέλους στα οποία πρέπει να εκτελεστεί η ενέργεια "chmod" για να εφαρμοστεί η δεδομένη τιμή για κάποιες συγκεκριμένες ρυθμίσεις. Η παραπομπή στους φακέλους πρέπει να τελειώνει με το χαρακτήρα "/".
- root.link - εμφάνιση κατά ζεύγη (διαχωρισμένων με κόμμα) των αρχείων και των φακέλων που πρέπει να διασυνδεθούν συμβολικά. Η πρώτη εγγραφή δηλώνει την προέλευση (προορισμό στην ορολογία unix) και η δεύτερη εγγραφή το όνομα της διασύνδεσης.
- root.link.<config> - λίστα ζευγών αρχείων και φακέλων διαχωρισμένων με κόμμα, τα οποία πρέπει να διασυνδεθούν συμβολικά για συγκεκριμένες ρυθμίσεις. Η πρώτη εγγραφή δηλώνει την προέλευση (προορισμό στην ορολογία unix) και η δεύτερη εγγραφή το όνομα της διασύνδεσης.
- generate.feature@<featureId> - δηλώνει ότι η λειτουργία πρωτογενούς κώδικα featureId θα είναι η λειτουργία πρωτογενούς κώδικα για τη λειτουργία που δηλώνεται ως τιμή αυτής της ιδιότητας.
Οι τιμές που εμφανίζονται μετά το πρώτο κόμμα δηλώνουν τα στοιχεία που πρέπει να
ανακτηθούν από το χώρο αποθήκευσης. (Ανατρέξτε στο θέμα
Δημιουργία λειτουργίας και πρόσθετης
λειτουργίας πρωτογενούς κώδικα.)
- generate.plugin@<pluginId> - δηλώνει ότι η πρόσθετη λειτουργία πρωτογενούς κώδικα pluginId θα είναι η πρόσθετη λειτουργία πρωτογενούς κώδικα για τη λειτουργία που δηλώνεται ως τιμή αυτής της ιδιότητας.
- significantVersionDigits - Ο αριθμός
σημαντικών ψηφίων που χρησιμοποιείται κατά τη δημιουργία επιθημάτων εκδοχής λειτουργίας.
(Ανατρέξτε στο θέμα Προσδιοριστικά
εκδοχής.)
- generatedVersionLength -
Το μήκος επιθήματος της εκδοχής λειτουργίας που έχει δημιουργηθεί.
Το ακόλουθο παράδειγμα έχει ληφθεί από το αρχείο build.properties της λειτουργίας org.eclipse.platform.
bin.includes=epl-v10.html,eclipse_update_120.jpg,feature.xml,feature.properties,license.html
root=rootfiles,configuration/
root.permissions.755=eclipse
root.linux.motif.x86=../../plugins/platform-launcher/bin/linux/motif,linux.motif
root.linux.motif.x86.link=libXm.so.2.1,libXm.so.2,libXm.so.2.1,libXm.so
root.linux.motif.x86.permissions.755=*.so*