Δημιουργία λειτουργιών και πρόσθετων λειτουργιών πρωτογενούς κώδικα

Αρχής γενομένης από την εκδοχή 3.4, το Eclipse περιέχει μεμονωμένες δέσμες προέλευσης που δίνουν τη δυνατότητα πιο ευέλικτης παράδοσης της προέλευσης. Για περισσότερες λεπτομέρειες, ανατρέξτε στη σελίδα "Μεμονωμένες δέσμες προέλευσης". Όπως περιγράφεται παρακάτω, μπορείτε ακόμα να δημιουργήσετε παλιές πρόσθετες λειτουργίες προέλευσης σε σχήμα φακέλου.

Λάβετε υπόψη την ακόλουθη λειτουργία SDK:


  features/
org.foo.sdk/
feature.xml: <includes id="org.foo.rcp" />
<includes id="org.foo.rcp.source" />
build.properties: generate.feature@org.foo.rcp.source = org.foo.rcp
org.foo.rcp/
feature.xml: <plugin id="org.foo.BundleA" />
<plugin id="org.foo.BundleB" />
<plugin id="org.foo.BundleB.win32" fragment="true" os="win32" />

Η ιδέα του SDK είναι ότι συμπεριλαμβάνει μια λειτουργία καθώς και τον πρωτογενή κώδικα για αυτή τη λειτουργία. Προσέξτε την ιδιότητα generate.feature στο αρχείο της λειτουργίας build.properties.  Αυτή η ιδιότητα δίνει εντολή στο PDE Build να δημιουργήσει μια λειτουργία με όνομα "org.foo.rcp.source" βάσει των περιεχομένων της λειτουργίας "org.foo.rcp". Το PDE Build θα δημιουργήσει μια λειτουργία org.foo.rcp.source, μια πρόσθετη λειτουργία που θα περιέχει πρωτογενή κώδικα, και τμήματα κώδικα που περιέχουν τον πρωτογενή κώδικα οποιωνδήποτε δεσμών που είναι συγκεκριμένες στην πλατφόρμα οι οποίες συμπεριλήφθηκαν στη λειτουργία:


  features/
org.foo.rcp.source/
feature.xml: <plugin id="org.foo.rcp.source"/>
<plugin id="org.foo.rcp.source.win32" fragment="true" os="win32" />
plugins/
org.foo.rcp.source/src/
org.foo.BundleA/src.zip
org.foo.BundleB/src.zip
org.foo.rcp.source.win32/src/
org.foo.BundleB.win32/src.zip

Προσαρμογή της λειτουργίας αρχείων πρωτογενούς κώδικα που δημιουργήθηκαν

Η ιδιότητα generate.feature έχει την ακόλουθη μορφή:

generate.feature@<source feature id> = <feature id> [, feature@<feature id>[;attribute=value]*]* [, plugin@<plugin id>[;attribute=value]*]*

Χρησιμοποιήστε το plugin@ για να προσθέσετε επιπλέον πρόσθετες λειτουργίες οι οποίες δεν ήταν μέρος της αρχικής λειτουργίας στη λειτουργία πρωτογενούς κώδικα που έχει δημιουργηθεί.  Αυτό είναι χρήσιμο για πρόσθετες λειτουργίες τεκμηρίωσης. Η λειτουργία @ μαζί με το πρότυπο πρωτογενούς κώδικα μπορούν να χρησιμοποιηθούν για την ένθεση λειτουργιών πρωτογενούς κώδικα (δείτε παρακάτω).

Πρότυπα πρωτογενούς κώδικα

Η λειτουργία από την οποία δημιουργείται η λειτουργία πρωτογενούς κώδικα μπορεί να παράσχει αρχεία προτύπων για συμπερίληψη στη λειτουργία πρωτογενούς κώδικα που δημιουργείται:


  features/
org.foo.rcp/
sourceTemplateFeature/<αρχεία που θα συμπεριληφθούν στη λειτουργία πρωτογενούς κώδικα που δημιουργείται>
sourceTemplatePlugin/<αρχεία που θα συμπεριληφθούν στην πρόσθετη λειτουργία πρωτογενούς κώδικα που δημιουργείται>
sourceTemplateFragment/<αρχεία για συμπερίληψη σε συγκεκριμένα τμήματα κώδικα συγκεκριμένης πλατφόρμας που έχουν δημιουργηθεί>

Οποιαδήποτε αρχεία βρίσκονται στο φάκελο sourceTemplate θα συμπεριληφθούν στην κατάλληλη λειτουργία/πρόσθετη λειτουργία/τμήμα κώδικα που έχει δημιουργηθεί.  Συγκεκριμένα, τα αρχεία από αυτούς τους καταλόγους θα αντικαταστήσουν αρχεία που έχουν δημιουργηθεί από το PDE Build. Αυτό μπορεί να χρησιμοποιηθεί για την παροχή ενός προσαρμοσμένου feature.xml εάν υπάρχουν απαιτήσεις για τη λειτουργία πρωτογενούς κώδικα που δεν υποστηρίζει το PDE Build.

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

Μπορείτε να ενθέσετε λειτουργίες πρωτογενούς κώδικα παρέχοντας ένα αρχείο sourceTemplateFeature/build.properties για τη λειτουργία πρωτογενούς κώδικα που έχει δημιουργηθεί που περιέχει μια ιδιότητα generate.feature για τη λειτουργία ένθετου πρωτογενούς κώδικα.  Θα χρειαστεί επίσης να βεβαιωθείτε ότι το αρχικό feature.xml πρωτογενούς κώδικα περιλαμβάνει τη λειτουργία ένθετου πρωτογενούς κώδικα, κάντε το είτε χρησιμοποιώντας το feature@ είτε παρέχοντας ένα πρότυπο feature.xml:

  features/
org.foo.sdk/
sourceTemplateFeature/
build.properties: generate.feature@org.foo.nested.source = org.foo.nested

feature.xml: <includes id="org.foo.rcp" />
<includes id="org.foo.rcp.source" />

build.properties: generate.feature@org.foo.rcp.source = org.foo.rcp, feature@org.foo.nested.source

org.foo.rcp/...
org.foo.nested/...
Στο παραπάνω παράδειγμα, το org.foo.sdk περιέχει μια λειτουργία πρωτογενούς κώδικα που έχει δημιουργηθεί που ονομάζεται org.foo.rcp.source.  Αυτή η λειτουργία πρωτογενούς κώδικα που έχει δημιουργηθεί θα ανακτήσει το αρχείο προτύπου sourceTemplateFeature/build.properties.  Θα συμπεριλάβει επίσης το org.foo.nested.source στο feature.xml.  Έτσι ώστε όταν το PDE Build επεξεργάζεται το αρχείο org.foo.rcp.source που έχει δημιουργηθεί, βλέπει τη συμπερίληψη της λειτουργίας org.foo.nested.source και της ιδιότητας generate.feature και στη συνέχεια δημιουργεί το org.foo.nested.source.

Δημιουργία μιας πρόσθετης λειτουργίας πρωτογενούς κώδικα

Μπορείτε επίσης να δημιουργήσετε μια μεμονωμένη πρόσθετη λειτουργία πρωτογενούς κώδικα που βασίζεται σε μια λειτουργία, αντί να δημιουργήσετε μια ολόκληρη λειτουργία πρωτογενούς κώδικα.  Η ιδιότητα για να το κάνετε αυτό είναι:

generate.plugin@<source plug-in id>=<feature-in id>

Έχετε υπόψη ότι αυτές οι παλιές πρόσθετες λειτουργίες προέλευσης (μία πρόσθετη λειτουργία που περιλαμβάνει την προέλευση για όλες τις πρόσθετες λειτουργίες της λειτουργίας) πρέπει να έχοπυν εγκατασταθεί με τη μορφή φακέλου. Επομένως πρέπει να ορίσετε το γνώρισμα unpack="true" στο αρχείο feature.xml.

Παράδειγμα:
  features/
org.foo.sdk/
feature.xml: <plugin id="org.foo.rcp" />
<plugin id="org.foo.sdk.source" unpack="true" />

build.properties: generate.plugin@org.foo.sdk.source = org.foo.sdk