Χρήση προσδιοριστικών εκδοχής

Οι δέσμες και οι λειτουργίες του Eclipse έχουν αριθμούς εκδοχής της μορφής major.minor.micro.qualifier. Το τμήμα προσδιοριστικού της εκδοχής χρησιμοποιείται συνήθως για να δείξει μια συγκεκριμένη δόμηση. Αν ορίσετε το προσδιοριστικό εκδοχής λειτουργίας ή πρόσθετης λειτουργίας σε "qualifier" (δηλαδή σε εκδοχή 1.0.0.qualifier), τότε το PDE Build θα αντικαταστήσει τη λέξη "qualifier" με ένα δημιουργημένο προσδιοριστικό.

Έλεγχος του προσδιοριστικού που έχει δημιουργηθεί

Μια λειτουργία ή πρόσθετη λειτουργία μπορεί να ελέγξει το προσδιοριστικό της ορίζοντας την ιδιότητα "qualifier" στο αρχείο build.properties. Για την τιμή αυτής της ιδιότητας υπάρχουν μερικές διαφορετικές περιπτώσεις:

qualifier = noneΟρίζει το προσδιοριστικό να είναι κενό. (π.χ. το "1.2.3.qualifier" γίνεται "1.2.3")
qualifier = contextΟρίζει το προσδιοριστικό ως προσδιοριστικό περιβάλλοντος. Δείτε παρακάτω τις πληροφορίες σχετικά με την τιμή του προσδιοριστικού περιβάλλοντος.
not setΑν δεν έχει οριστεί η ιδιότητα "qualifier", είναι σαν να έχετε ορίσει qualifier = context.
qualifier = v12345Οποιαδήποτε άλλη τιμή ορίζει το προσδιοριστικό να λαμβάνει την αναφερόμενη τιμή.

Προσδιοριστικό περιβάλλοντος

Η τιμή του δημιουργημένου προσδιοριστικού περιβάλλοντος καθορίζεται από το πρώτο από τα ακόλουθα στοιχεία που ισχύουν:
  1. Αν η ιδιότητα forceContextQualifier έχει οριστεί στο αρχείο build.properties του συνόλου ρυθμίσεων του εργαλείου δόμησης,  τότε θα χρησιμοποιηθεί ως προσδιοριστικό η τιμή αυτής της ιδιότητας.  Αυτή η ιδιότητα μπορεί επίσης να οριστεί στη γραμμή εντολών με το -D κατά την κλήση του ant.
  2. Εάν χρησιμοποιείτε αρχεία αντιστοίχισης για ανάκτηση των δεσμών σας από χώρο αποθήκευσης, τότε το προσδιοριστικό που χρησιμοποιήθηκε για την ανάκτηση της δέσμης θα χρησιμοποιηθεί ως προσδιοριστικό της εκδοχής.
  3. Αν δεν χρησιμοποιηθούν ούτε τα αρχεία forceContextQualifier ούτε τα αρχεία αντιστοίχισης τότε το προσδιοριστικό θα είναι ένα αποτύπωμα χρόνου σε μορφή ΕΕΕΕMMΗΗΩΩΛΛ (π.χ. 200605121600)

Επιθήματα εκδοχής λειτουργίας

Μπορείτε να ενεργοποιήσετε τη δημιουργία επιθημάτων προσδιοριστικών για λειτουργίες ορίζοντας την ιδιότητα generateFeatureVersionSuffix=true στο αρχείο συνόλου ρυθμίσεων της δόμησης build.properties.

Η ιδέα μιας εκδοχής είναι ότι πρέπει να προσαυξάνει κάθε φορά που κάτι αλλάζει, το προσδιοριστικό εκδοχής προσαυξάνει και καταγράφει αλλαγές από δόμηση σε δόμηση.  Οι λειτουργίες αλλάζουν σπάνια, ωστόσο, περιέχουν πρόσθετες λειτουργίες οι οποίες μπορεί να αλλάζουν συχνά.  Όταν τα επιθήματα εκδοχής ενεργοποιούνται, μια εκδοχή λειτουργίας θα έχει τη μορφή major.minor.micro.qualifier-suffix.   Το επίθημα είναι στην ουσία το σύνολο των προσδιοριστικών έκδοσης όλων των λειτουργιών και πρόσθετων λειτουργιών που συμπεριλαμβάνονται στη λειτουργία. Αυτό σημαίνει όταν μία από τις συμπεριλαμβανόμενες πρόσθετες λειτουργίες προσαυξάνει την εκδοχή της, τότε θα προσαυξηθεί αυτόματα και η εκδοχή της λειτουργίας. Αυτό είναι ιδιαίτερα χρήσιμο όταν η λειτουργία διανέμεται μέσω ενός δικτυακού τόπου ενημέρωσης.

Τελικές εκδοχές

Περιστασιακά μπορεί να υπάρξουν προσαρμοσμένα βήματα δόμησης που ενδέχεται να απαιτούν την πραγματική τελική εκδοχή που χρησιμοποιήθηκε κατά τη δόμηση. Όταν έχει οριστεί η ιδιότητα generateVersionsLists, το PDE Build δημιουργεί αρχεία ιδιοτήτων που περιέχουν τις εκδοχές των λειτουργιών και των πρόσθετων λειτουργιών που έχουν κατασκευαστεί. Αυτά τα αρχεία ιδιοτήτων μπορούν να φορτωθούν με τη χρήση της κατάλληλης εργασίας ιδιότητας ant.

Τα αρχεία ονομάζονται: finalPluginsVersions.properties, finalPluginsVersions.<config>.properties, finalFeaturesVersions.properties, and  finalFeaturesVersions.<config>.properties.  τα finalPluginsVersions.properties και finalFeaturesVersions.properties περιέχουν τις εκδοχές για όλες τις πρόσθετες λειτουργίες και λειτουργίες που έχουν ενσωματωθεί.  Τα αρχεία ιδιοτήτων <config> περιέχουν τις εκδοχές των πρόσθετων λειτουργιών και λειτουργιών για συγκεκριμένες ρυθμίσεις δόμησης.

Οι ιδιότητες σε αυτά τα αρχεία έχουν τη μορφή:

    <bundleSymbolicName> = <version>
    <bundleSymbolicName>_<first 3 segments of version> = <version>
Εάν υπάρχουν περισσότερες από μια εκδοχές μιας πρόσθετης λειτουργίας ή λειτουργίας, τότε το <bundleSymbolicName>=<version> παραπέμπει στην πρόσθετη λειτουργία ή λειτουργία με τη μεγαλύτερη εκδοχή. Παράδειγμα:
    org.eclipse.pde.build = 3.3.0.v20070524
    org.eclipse.pde.build_3.3.0=3.3.0.v20070524
    org.eclipse.pde.build_3.2.1=3.2.1.r321_v20060823