Προσαρμοσμένα βήματα δόμησης λειτουργιών και πρόσθετων λειτουργιών

Στο 3.2, υπάρχει η νέα δυνατότητα για μια λειτουργία ή πρόσθετη λειτουργία συνεισφοράς προσαρμοσμένων προορισμών Ant στη δική του δόμηση. Αυτά τα προσαρμοσμένα βήματα μπορούν να χρησιμοποιηθούν για λειτουργίες όπως ενοργάνωση byte-code μετά τη μεταγλώττιση, ευρετηριοποίηση αρχείων βοήθειας για τεκμηρίωση ή αντιγραφή πρόσθετων αρχείων στη δέσμη. 

Για να χρησιμοποιήσετε προσαρμοσμένους προορισμούς, μια λειτουργία ή πρόσθετη λειτουργία πρέπει να ορίσει την ιδιότητα customBuildCallbacks στο αρχείο build.properties. Η τιμή αυτής της ιδιότητας είναι η θέση ενός αρχείου xml, σχετική με τον κεντρικό κατάλογο της λειτουργίας/πρόσθετης λειτουργίας που περιέχει τους προσαρμοσμένους προορισμούς. Αν το αρχείο xml βρίσκεται σε άλλη θέση, χρησιμοποιήστε την ιδιότητα customBuildCallbacks.buildpath για να ορίσετε τον κατάλογο που θα χρησιμοποιηθεί.

Tα πρότυπα με το όνομα customBuildCallbacks.xml που περιέχουν τους υποστηριζόμενους προσαρμοσμένους προορισμούς παρέχονται στο org.eclipse.pde.build/templates/plugins και το org.eclipse.pde.build/templates/features.  Αυτά τα πρότυπα μπορούν να αντιγραφούν στη λειτουργία/πρόσθετη λειτουργία σας και να τροποποιηθούν όπως χρειάζεται.

Οι προσαρμοσμένοι προορισμοί θα κληθούν με χρήση της εργασίας subant. Από προεπιλογή, το failonerror ορίζεται σε false. Για να το αλλάξετε ορίστε την ιδιότητα customBuildCallbacks.failonerror σε true. Παρόμοια, η παράμετρος inheritall έχει ως προεπιλογή την τιμή false. Ρυθμίστε την ιδιότητα customBuildCallbacks.inheritall για να την αλλάξετε.

Πρόσθετες λειτουργίες

Το δημιουργημένο build.xml που δημιουργεί μια πρόσθετη λειτουργία περιέχει πολλούς προορισμούς που εκτελούν συγκεκριμένες εργασίες. Το PDE Build επιτρέπει στην πρόσθετη λειτουργία να παρέχει προσαρμοσμένους προ- και μετα- προορισμούς που θα καλούνται πριν και μετά από συγκεκριμένες εργασίες. Μαζί με άλλες ιδιότητες ant που μπορεί ήδη να έχουν καθοριστεί, σε κάθε προσαρμοσμένο προορισμό μπορούν επίσης να μεταβιβαστούν κάποιες συγκεκριμένες ιδιότητες. Οι ακόλουθοι προορισμοί υποστηρίζουν προσαρμοσμένες επανακλήσεις:

Λειτουργίες

Το δημιουργημένο build.xml για λειτουργίες υποστηρίζει μόνο ανακλήσεις προσαρμοσμένης δόμησης για τον προορισμό gather.bin.parts.  Αυτός ο προορισμός θα καλέσει τον προορισμό gather.bin.parts όλων των συμπεριλαμβανομένων λειτουργιών και πρόσθετων λειτουργιών.  Υποστηρίζει pre.gather.bin.parts και post.gather.bin.parts. Και οι δύο αυτοί προορισμοί παρέχονται με τις ακόλουθες ιδιότητες: