Αυτή η εργασία εκτελείται για τη δημιουργία όλων των αρχείων που απαιτούνται από τα εργαλεία API σε μια δυαδική δέσμη. Η εκτέλεση αυτής της εργασίας γίνεται κατά τις δομήσεις του Eclipse ή κατά την εξαγωγή δεσμών για όλα τα έργα που διαθέτουν εργαλεία API.
Αυτή τη στιγμή, δημιουργείται μόνο το αρχείο με το όνομα .api_description.
Το όνομα της εργασίας Ant είναι: apitooling.apigeneration.
Προκειμένου να χρησιμοποιηθεί, το αρχείο jar apitooling-ant.jar πρέπει να
βρίσκεται στη διαδρομή κλάσεων Ant.
<apitooling.apigeneration
projectname="..."
project="..."
binary="..."
target="..."
debug="..."
/>
| Γνώρισμα | Περιγραφή | Απαιτείται |
| projectname | Ορίστε το όνομα του έργου | Ναι |
| έργο |
Ορίστε τη θέση του έργου. Αυτός είναι ο φάκελος που περιέχει όλα τα αρχεία πρωτογενούς κώδικα για το συγκεκριμένο έργο. Ο ορισμός της θέσης γίνεται με τη χρήση μιας απόλυτης διαδρομής. |
Ναι |
| δυαδικό |
Ορίστε τις θέσεις των δυαδικών αρχείων. Αυτή είναι μια λίστα φακέλων ή αρχείων jar που περιλαμβάνουν όλα τα αρχεία .class για το συγκεκριμένο έργο. Διαχωρίζονται από το διαχωριστικό διαδρομής πλατφόρμας. Πρέπει να υπάρχουν όλες οι εγγραφές. Πρέπει να ορίζονται με τη χρήση απόλυτων διαδρομών. |
Ναι |
| target |
Ορίστε τη θέση προορισμού. Αυτός είναι ο φάκελος στον οποίο δημιουργούνται τα αρχεία. Ο ορισμός της θέσης γίνεται με τη χρήση μιας απόλυτης διαδρομής. |
Ναι |
| debug |
Ορίστε την τιμή για τον εντοπισμό και τη διόρθωση σφαλμάτων. Οι πιθανές τιμές είναι: true, falseΗ προεπιλεγμένη τιμή είναι false.
|
Όχι |
| extraManifests |
Ορίστε πρόσθετες θέσεις αρχείων manifest. Αυτή είναι μια λίστα με θέσεις πρόσθετων αρχείων MANIFEST.MF που μπορούν να οριστούν για την παροχή περισσότερων πακέτων api προς ανίχνευση. Διαχωρίζονται από το διαχωριστικό διαδρομής πλατφόρμας. Πρέπει να υπάρχουν όλες οι εγγραφές. Αν η διαδρομή δεν είναι απόλυτη, θα αναλυθεί με βάση τον τρέχοντα κατάλογο εργασίας. Αντί του αρχείου MANIFEST.MF μπορείτε να καθορίσετε αρχεία JAR. Αν καθοριστεί ένα αρχείο JAR, θα γίνει ανάγνωση του αντίστοιχου αρχείου MANIFEST.MF, αν υπάρχει. |
Όχι |
| extraSourceLocations |
Ορίστε πρόσθετες θέσεις αρχείων πρωτογενούς κώδικα. Αυτή είναι μια λίστα των θέσεων αρχείων προέλευσης που θα ανιχνευθούν. Διαχωρίζονται από το διαχωριστικό διαδρομής πλατφόρμας. Πρέπει να υπάρχουν όλες οι εγγραφές. Πρέπει να ορίζονται με τη χρήση απόλυτων διαδρομών. |
Όχι |
| allowNonapiproject |
Δυνατότητα εκτέλεσης της εργασίας σε έργα χωρίς εργαλεία ΑΡΙ. Αν αυτή η εργασία εκτελείται σε ένα έργο που δεν διαθέτει εργαλεία ΑΡΙ, δεν θα δημιουργηθεί αρχείο api_description καθώς θεωρείται ότι το έργο δεν υποστηρίζει τα εργαλεία ΑΡΙ. Σε ορισμένες περιπτώσεις πρέπει να δημιουργηθεί το αρχείο περιγραφής σε έργα χωρίς εργαλεία ΑΡΙ. Αν ορίσετε την τιμή true σε αυτή την παράμετρο, η εργασία δεν θα ελέγξει αν υπάρχουν εργαλεία ΑΡΙ. |
Όχι |
<apitooling.apigeneration
projectname="org.eclipse.jdt.core_3.5.0.v_927"
project="d:\eclipse\org.eclipse.jdt.core"
binary="d:\eclipse\org.eclipse.jdt.core\bin;d:\eclipse\org.eclipse.jdt.core\antbin"
target="d:\plugins\org.eclipse.jdt.core"
debug="true"
/>
Με αυτό τον τρόπο θα δημιουργηθεί ένα αρχείο με όνομα .api_description
στο φάκελο d:\plugins\org.eclipse.jdt.core με βάση τον πρωτογενή κώδικα που περιέχεται στο
d:\eclipse\org.eclipse.jdt.core και στα αρχεία .class
που περιέχονται στο d:\eclipse\org.eclipse.jdt.core\bin.
Εργασία Ant ανάλυσης
Εργασία Ant αναστολής API
Εργασία Ant χρήσης API
Εργασία Ant μετατροπής αναφορών ανάλυσης
Εργασία Ant μετατροπής αναφορών αναστολής API
Εργασία Ant κατάργησης ΑΡΙ
Εργασία Ant μετατροπής αναφορών κατάργησης API
Εργασία Ant μετατροπής αναφορών χρήσης API