Επιλογές του μεταγλωττιστή
Το PDE/Build υποστηρίζει ένα πλήθος επιλογών για τον έλεγχο του μεταγλωττιστή
για μεμονωμένες πρόσθετες λειτουργίες. Για τις ρυθμίσεις που σχετίζονται με επίπεδα προέλευσης και προορισμού και τη διαδρομή
κλάσεων εκκίνησης, ανατρέξτε στο θέμα
"Ορισμός περιβάλλοντος μεταγλώττισης".
Προειδοποιήσεις και σφάλματα
Το PDE/Build επιτρέπει τη δημιουργία προσαρμοσμένων προειδοποιήσεων και μηνυμάτων
σφαλμάτων που αφορούν τη μεταγλώττιση στο αρχείο build.properties. Αυτά μπορούν να οριστούν ανά βιβλιοθήκη
(μία πρόσθετη λειτουργία μπορεί να περιέχει πολλές βιβλιοθήκες jar) με τις επιλογές
javacWarnings.<βιβλιοθήκη> και javacErrors.<βιβλιοθήκη>. Οι
τιμές αυτών των ιδιοτήτων παρέχονται στην ενότητα "-warn:..." της σελίδας για τη
χρήση
του μεταγλωττιστή μαζικής επεξεργασίας (από τον οδηγό ανάπτυξης εφαρμογών Java).
Παράδειγμα:
javacErrors.. = forbidden,discouraged,
javacWarnings.library.jar = deprecation,nullDereference
Προτιμήσεις για προειδοποιήσεις και σφάλματα από το έργο
Οι προτιμήσεις έργου JDT μπορούν επίσης να χρησιμοποιηθούν στο PDE/Build. Το PDE/Build δεν μπορεί να διαβάσει τα αρχεία προτιμήσεων, ωστόσο μπορεί να τα
μεταβιβάσει στο μεταγλωττιστή JDT ο οποίος μπορεί να τα χρησιμοποιήσει.
Για να χρησιμοποιήσετε αυτή τη δυνατότητα, μια πρόσθετη λειτουργία πρέπει να καθορίσει
την ιδιότητα javacProjectSettings στο αρχείο build.properties. Η τιμή πρέπει να
είναι:
- javacProjectSettings=true : Χρησιμοποιήστε τη ρύθμιση έργου που
καθορίστηκε στο προεπιλεγμένο αρχείο προτιμήσεων
.settings/org.eclipse.jdt.core.prefs.
- javacProjectSettings=path/to/jdt.prefs : Χρησιμοποιήστε το
καθορισμένο αρχείο προτιμήσεων.
Υπάρχει η δυνατότητα χρήσης διαφορετικών ρυθμίσεων προειδοποιήσεων και σφαλμάτων στο χώρο
εργασίας από ότι στη δόμηση συμπίλησης έκδοσης (releng). Με αυτόν τον τρόπο παρέχεται μια πιο εύχρηστη μέθοδος καθορισμού αυτών των
ρυθμίσεων σε σύγκριση με τη χρήση της ιδιότητας "javacWarnings.<library>".
Κωδικοποίηση αρχείων
Το PDE/Build μπορεί να αποδεχθεί προσαρμοσμένες κωδικοποιήσεις αρχείων ανά βιβλιοθήκη,
φάκελο ή αρχείο.
- javacDefaultEncoding.<βιβλιοθήκη>
- ρυθμίζει τη χρήση προεπιλεγμένης κωδικοποίησης κατά τη μεταγλώττιση της βιβλιοθήκης.
- javacCustomEncodings.<βιβλιοθήκη>
- Μια λίστα διαδρομών και κωδικοποιήσεων διαχωρισμένων με κόμμα για χρήση κατά τη
μεταγλώττιση της βιβλιοθήκης. Κατά τον καθορισμό ενός φακέλου, η κωδικοποίηση
εφαρμόζεται σε όλα τα στοιχεία που περιέχονται στο φάκελο. Κατά τον καθορισμό ενός αρχείου, η κωδικοποίηση εφαρμόζεται μόνο στο
αρχείο. Παράδειγμα:
javacCustomEncodings.library.jar = src/org/foo[US-ASCII],
src/org/foo/bar.java[utf-8]
Προσαρμοσμένα ορίσματα μεταγλωττιστή
Μπορείτε να καθορίσετε προσαρμοσμένα ορίσματα μεταγλωττιστή ανά δέσμη χρησιμοποιώντας την
ιδιότητα compilerArg στο αρχείο build.properties της δέσμης. Αυτή η ιδιότητα είναι
παρόμοια με την ιδιότητα compilerArg
στο σύνολο ρυθμίσεων του εργαλείου δόμησης με τη διαφορά ότι επηρεάζει μόνο μία πρόσθετη
λειτουργία και όχι όλες τις πρόσθετες λειτουργίες. Τα ορίσματα που χρησιμοποιούνται εξαρτώνται από το μεταγλωττιστή που χρησιμοποιείται. Μπορείτε να βρείτε τα ορίσματα μεταγλωττιστή JDT
εδώ.
Προτεραιότητα επιλογών μεταγλωττιστή
Υπάρχουν διάφοροι τρόπο καθορισμού των επιλογών του μεταγλωττιστή. Σύμφωνα με το γενικό κανόνα, η προτεραιότητα των επιλογών είναι η εξής:
- Η επιλογή javacDefaultEncoding.<βιβλιοθήκη> έχει μεγαλύτερη προτεραιότητα από
την προσαρμοσμένη επιλογή -encoding της γραμμής εντολών.
- Για τις γενικές επιλογές, στη γραμμή εντολών του
μεταγλωττιστή οι επιλογές που εμφανίζονται τελευταίες αντικαθιστούν αυτές που
εμφανίζονται πρώτες. Οι επιλογές παρέχονται στο JDT με την ακόλουθη σειρά:
- Ιδιότητα compilerArg από το σύνολο ρυθμίσεων του εργαλείου δόμησης. (Επηρεάζει
όλες τις δέσμες).
- Ιδιότητα compilerArg από το αρχείο build.properties της τρέχουσας
πρόσθετης λειτουργίας.
- Αρχείο προτιμήσεων μεταγλωττιστή που καθορίζεται με την ιδιότητα
javacProjectSettings.
- Δημιουργημένο αρχείο ορισμάτων μεταγλωττιστή
(javaCompiler.<βιβλιοθήκη>.args) που περιέχει
κωδικοποιήσεις αρχείων, το στοιχείο javacWarningsτο στοιχείο javacErrors
και κανόνες πρόσβασης.
Χρήση προσαρμοσμένου μεταγλωττιστή
Μια δέσμη μπορεί να χρησιμοποιήσει ένα προσαρμοσμένο μεταγλωττιστή ορίζοντας την ιδιότητα
compilerAdapter. Ο καθορισμένος προσαρμογέας μεταγλωττιστή πρέπει να είναι διαθέσιμος σε περιβάλλον ant. Ο προεπιλεγμένος προσαρμογέας μεταγλωττιστή JDT
είναι ο org.eclipse.jdt.core.JDTCompilerAdapter. Μία αιτία για την οποία ίσως
χρειαστεί να ορίσετε ένα εναλλακτικό μεταγλωττιστή είναι οι δέσμες Aspect J και Groovy. Οι δέσμες που καθορίζουν ένα προσαρμοσμένο προσαρμογέα μεταγλωττιστή ίσως χρειαστεί να
ορίσουν επίσης τις ακόλουθες ιδιότητες:
- sourceFileExtensions : μια λίστα επεκτάσεων που θεωρούνται πρωτογενής κώδικας. (π.χ.,
*.java, *.aj, *.groovy).
- compilerAdapter.useLog : ρύθμιση για τη μεταβίβαση του ορίσματος "-log" στον μεταγλωττιστή
- compilerAdapter.useArgFile : ρύθμιση για τη μεταβίβαση του δημιουργημένου
αρχείου ορισμάτων javaCompiler.<βιβλιοθήκη>.args. (Περιέχει κανόνες πρόσβασης,
κωδικοποιήσεις αρχείων και επίπεδα προειδοποίησης/σφαλμάτων).