Μια δέσμη πρωτογενούς κώδικα αναγνωρίζεται από την παρουσία της κεφαλίδας Eclipse-SourceBundle στο αρχείο δήλωσης. Η μορφή αυτής της κεφαλίδας είναι η εξής:
Eclipse-SourceBundle: <bundle-id>;version=<version>;roots:="root1, root2"
Η ταυτότητα της δέσμης και η έκδοση δηλώνουν τη δέσμη στην οποία αντιστοιχεί ο συμπεριλαμβανόμενος πρωτογενής κώδικας. Η οδηγία "roots" δηλώνει τους φακέλους εντός της δέσμης που περιέχουν τον πρωτογενή κώδικα. Αν δεν έχει καθοριστεί οδηγία κεντρικών καταλόγων, τότε αξιώνεται η τιμή ".".
Οι βιβλιοθήκες αρχείων κλάσης αντιστοιχίζονται σε θέσεις αρχείων πρωτογενούς κώδικα με προβλέψιμο τρόπο. Ο κεντρικός κατάλογος της πρόσθετης λειτουργίας αντιστοιχίζεται στον κεντρικό κατάλογο της δέσμης πρωτογενούς κώδικα. Αυτή είναι η κύρια περίπτωση των περισσότερων πρόσθετων λειτουργιών που έχουν τοποθετηθεί σε αρχείο jar. Αν η πρόσθετη λειτουργία περιλαμβάνει επιπλέον βιβλιοθήκες "foo/lib.jar", ο πρωτογενής κώδικας πρέπει να περιέχεται στους αντίστοιχους φακέλους "foo/libsrc/" στις δέσμες πρωτογενούς κώδικα.
org.eclipse.pde.core.jar org.eclipse.pde.core.source.jar - org/**/*.class - org/**/*.java - ant_tasks/pde-ant.jar - ant_tasks/pde-antsrc/org/**/*.java
Eclipse-SourceBundle: org.eclipse.pde.core;version="3.4.0.N20071128-0010";roots:="ant_tasks/pde-antsrc,."
org.eclipse.pde.build/ org.eclipse.pde.build.source.jar - pdebuild.jar - pdebuildsrc/org/**/*.java - lib/pdebuild-ant.jar - lib/pdebuild-antsrc/org/**/*.java
Eclipse-SourceBundle: org.eclipse.pde.build;version="3.4.0.N20071128-0010";roots:="pdebuildsrc,lib/pdebuild-antsrc"
Το PDE/Build μπορεί να δημιουργήσει αυτόματα μεμονωμένες δέσμες πρωτογενούς κώδικα, αλλά μόνο σε μια δόμηση χωρίς γραφικό περιβάλλον. Η δημιουργία μεμονωμένης δέσμης πρωτογενούς κώδικα μπορεί να ενεργοποιηθεί καθορίζοντας την ακόλουθη τιμή:
individualSourceBundles=true
Πρέπει να καθοριστεί στο αρχείο ανώτερου επιπέδου build.properties των ρυθμίσεων δόμησης και ελέγχει εξ’ ολοκλήρου τη δημιουργία πρωτογενούς κώδικα για αυτή τη δόμηση. Ανατρέξτε στην ενότητα Δημιουργία λειτουργιών και πρόσθετων λειτουργιών πρωτογενούς κώδικα για λεπτομέρειες σχετικά με τη δημιουργία παραδοσιακών λειτουργιών και πρόσθετων λειτουργιών κώδικα. Τα υπόλοιπα στοιχεία αυτής της σελίδας θεωρούν ότι υπάρχει εξοικείωση με την παραδοσιακή δημιουργία πρωτογενούς κώδικα.
generate.feature@<source feature id> = <feature id> [, feature@<feature id>]* [, plugin@<plugin id>]* [, exclude@<plugin id>]*
Κατά τη δημιουργία μεμονωμένων δεσμών πρωτογενούς κώδικα, αυτή η ιδιότητα παραμένει ως έχει και υποστηρίζει τα ίδια γνωρίσματα (π.χ. εκδοχή, εξαγωγή από το πακέτο, προαιρετικά γνωρίσματα, κλπ). Η διαφορά είναι εμφανής στη λειτουργία πρωτογενούς κώδικα που προκύπτει. Στην προηγούμενη μορφή, η λειτουργία πρωτογενούς κώδικα περιελάμβανε μία πρόσθετη λειτουργία και ένα τμήμα κώδικα για κάθε πλατφόρμα της οποίας πραγματοποιούνταν η δόμηση. Στη νέα μορφή, η λειτουργία πρωτογενούς κώδικα περιλαμβάνει μία δέσμη πρωτογενούς κώδικα για κάθε πρόσθετη λειτουργία ή τμήμα κώδικα που εμφανίζεται στην αρχική λειτουργία.
Οι πρόσθετες λειτουργίες που περιλαμβάνονταν στη λειτουργία πρωτογενούς κώδικα μέσω της σύνταξης plugin@ δεν θα λάβουν αντίστοιχες δέσμες κώδικα. Αυτό είναι χρήσιμο για την προσθήκη πρόσθετων λειτουργιών εγγράφου στη λειτουργία πρωτογενούς κώδικα.
Η καταχώρηση exclude@ είναι καινούργια στη δημιουργία μεμονωμένου πρωτογενούς κώδικα. Ορισμένες πρόσθετες λειτουργίες που περιλαμβάνονταν στη λειτουργία από την οποία προέρχονται (π.χ. πρόσθετες λειτουργίες ή τμήματα κώδικα εγγράφου που περιέχουν μόνο ενσωματωμένο κώδικα) ενδεχομένως να μη διέθεταν πρωτογενή κώδικα και πρέπει να εξαιρεθούν από τη δημιουργημένη λειτουργία πρωτογενούς κώδικα. Η καταχώρηση exclude@ υποστηρίζει ένα γνώρισμα version.
Παράδειγμα:generate.feature@org.eclipse.jdt.source=org.eclipse.jdt, plugin@org.eclipse.jdt.doc.isv;unpack="false",exclude@org.eclipse.jdt.doc.user
Στην παλαιότερη μορφή, η ιδιότητα generate.plugin δημιουργεί μια πρόσθετη λειτουργία πρωτογενούς κώδικα βάσει των περιεχομένων μιας δεδομένης λειτουργίας. Κατά τη δημιουργία μεμονωμένων δεσμών πρωτογενούς κώδικα, αυτό αλλάζει και βασίζεται σε μια δεδομένη πρόσθετη λειτουργία:
generate.plugin@<source plug-in id>=<plug-in id>
Η ιδιότητα generate.plugin χρησιμοποιήθηκε από λειτουργίες για συμπερίληψη πρωτογενούς κώδικα χωρίς να υπάρχει λειτουργία πρωτογενούς κώδικα (αν και παρασκηνιακά δημιουργήθηκε μια ολόκληρη λειτουργία κώδικα). Κατά τη δημιουργία μιας μεμονωμένης δέσμης πρωτογενούς κώδικα, οι λειτουργίες πρέπει να συμπεριλάβουν μια δέσμη *.source και μια αντίστοιχη ιδιότητα generate.plugin για κάθε πρόσθετη λειτουργία.
Παράδειγμα: Η λειτουργία sdk.examples είχε την εξής μορφή:
<feature id="org.eclipse.sdk.examples" ... > .... <plugin id="org.eclipse.sdk.examples.source" version="0.0.0"/> <plugin id="org.eclipse.sdk.examples.source.win32.win32.x86" version="0.0.0"/> </feature>
generate.plugin@org.eclipse.sdk.examples.source=org.eclipse.sdk.examples
Η μορφή άλλαξε σε:
<feature id="org.eclipse.sdk.examples" ...> ... <plugin id="org.eclipse.compare.examples.source" version="0.0.0"/> <plugin id="org.eclipse.debug.examples.core.source" version="0.0.0"/> <plugin id="org.eclipse.swt.examples.source" version="0.0.0"/> </feature>
generate.plugin@org.eclipse.compare.examples.source=org.eclipse.compare.examples generate.plugin@org.eclipse.debug.examples.core.source=org.eclipse.debug.examples.core generate.plugin@org.eclipse.swt.examples.source=org.eclipse.swt.examples
Ορισμένες πρόσθετες λειτουργίες ενδεχομένως να μην απαιτούν δέσμες πρωτογενούς κώδικα, διότι στην πραγματικότητα δεν περιέχουν πρωτογενή κώδικα. Αυτό μπορεί να συμβεί με τμήματα κώδικα ειδικά για πλατφόρμες, που περιέχουν μόνο μια ενσωματωμένη βιβλιοθήκη. Σε αυτήν την περίπτωση, οι δέσμες ενδέχεται να εξαιρεθούν από τη λειτουργία όπως επισημαίνεται παραπάνω στην ιδιότητα generate.feature.
Εναλλακτικά, οι δέσμες μπορούν να καθορίσουν ρητά στο δικό τους αρχείο build.properties ότι δεν πρέπει να δημιουργηθεί καμία δέσμη πρωτογενούς κώδικα για αυτές:
generateSourceBundle=false
Πάντα είναι δυνατή η προσθήκη προσαρμοσμένου περιεχομένου στις δημιουργημένες δέσμες πρωτογενούς κώδικα χρησιμοποιώντας την προσαρμοσμένη επανάκληση post.gather.source στη δέσμη πρωτογενούς κώδικα. (Ανατρέξτε στην ενότητα Προσαρμοσμένα βήματα δόμησης λειτουργιών και πρόσθετων λειτουργιών).
Όταν πραγματοποιείτε αυτήν την ενέργεια, ορίστε την ιδιότητα "src.additionalRoots" στο αρχείο build.properties της πρόσθετης λειτουργίας, έτσι ώστε η δημιουργημένη δέσμη πρωτογενούς κώδικα να διαθέτει τη σωστή οδηγία "roots" στην κεφαλίδα Eclipse-SourceBundle.
Παράδειγμα:
org.junit4 :
build.properties
src.includes = about.html,junitsrc.zip
src.additionalRoots=junitsrc
customBuildCallbacks=customBuildCallbacks.xml
customBuildCallbacks.xml
<target name="post.gather.sources" >
<mkdir dir="${target.folder}/junitsrc"/>
<unzip src="${target.folder}/junitsrc.zip" dest="${target.folder}/junitsrc" overwrite="false"/>
<delete file="${destination.temp.folder}/junitsrc.zip" />
</target>
Σε προηγούμενες εκδόσεις, η δημιουργημένη πρόσθετη λειτουργία πρωτογενούς κώδικα εξυπηρετούσε ως πρόσθετη λειτουργία πληροφοριών εμπορικής επωνυμίας για τη λειτουργία κώδικα που είχε δημιουργηθεί. Τα αρχεία εμπορικής επωνυμίας (about.properties, eclipse32.gif, κλπ) παρέχονταν μέσω του καταλόγου sourceTemplatePlugin στην αρχική λειτουργία.
Κατά τη δημιουργία μεμονωμένων δεσμών πρωτογενούς κώδικα, η πρόσθετη λειτουργία πληροφοριών εμπορικής επωνυμίας για τη λειτουργία πρωτογενούς κώδικα είναι η δέσμη κώδικα που αντιστοιχεί στην αρχική πρόσθετη λειτουργία πληροφοριών εμπορικής επωνυμίας. Αυτό σημαίνει ότι τα αρχεία εμπορικής επωνυμίας για την πρόσθετη λειτουργία πληροφοριών εμπορικής επωνυμίας της λειτουργίας πρωτογενούς κώδικα μπορούν να συνεισφέρουν μέσω της ιδιότητας src.includes στην αρχική πρόσθετη λειτουργία πληροφοριών εμπορικής επωνυμίας.
Ο φάκελος sourceTemplatePlugin της λειτουργίας για την οποία δημιουργούμε πρωτογενή κώδικα, συνεισφέρει επίσης αρχεία στην πρόσθετη λειτουργία πληροφοριών εμπορικής επωνυμίας.
Σε προηγούμενες εκδόσεις, τα περιεχόμενα του καταλόγου sourceTemplatePlugin της αρχικής λειτουργίας αντιγράφονταν στην πρόσθετη λειτουργία πρωτογενούς κώδικα. Κατά τη δημιουργία μεμονωμένων δεσμών πρωτογενούς κώδικα, αυτό ισχύει μόνο για τη δέσμη πρωτογενούς κώδικα εμπορικής επωνυμίας (δείτε παραπάνω).
Για όλες τις άλλες δέσμες πρωτογενούς κώδικα, τα περιεχόμενα ενός καταλόγου sourceTemplateBundle θα αντικατασταθούν.