Μεμονωμένες δέσμες πρωτογενούς κώδικα

Η κλασική μορφή των δεσμών πρωτογενούς κώδικα στο Eclipse ήταν ένας φάκελος που περιείχε το αρχείο src.zip για όλες τις πρόσθετες λειτουργίες που περιλαμβάνονταν σε μια δεδομένη λειτουργία. Από την έκδοση 3.4, το Eclipse περιλαμβάνει μεμονωμένες δέσμες πρωτογενούς κώδικα. Για κάθε δέσμη υπάρχει μία αντίστοιχη δέσμη πρωτογενούς κώδικα, δηλαδή ένα αρχείο jar το οποίο περιέχει τον κώδικα για αυτήν τη δέσμη. Το γεγονός αυτό επιτρέπει την πιο ευέλικτη παράδοση του κώδικα και τη διευθέτηση ορισμένων ζητημάτων αναφορικά με το μήκος της διαδρομής που μπορεί να προκύψουν σε ορισμένες πλατφόρμες.

Eclipse-SourceBundle

Μια δέσμη πρωτογενούς κώδικα αναγνωρίζεται από την παρουσία της κεφαλίδας Eclipse-SourceBundle στο αρχείο δήλωσης. Η μορφή αυτής της κεφαλίδας είναι η εξής:

Eclipse-SourceBundle: <bundle-id>;version=<version>;roots:="root1, root2"

Η ταυτότητα της δέσμης και η έκδοση δηλώνουν τη δέσμη στην οποία αντιστοιχεί ο συμπεριλαμβανόμενος πρωτογενής κώδικας. Η οδηγία "roots" δηλώνει τους φακέλους εντός της δέσμης που περιέχουν τον πρωτογενή κώδικα. Αν δεν έχει καθοριστεί οδηγία κεντρικών καταλόγων, τότε αξιώνεται η τιμή ".".

Οι βιβλιοθήκες αρχείων κλάσης αντιστοιχίζονται σε θέσεις αρχείων πρωτογενούς κώδικα με προβλέψιμο τρόπο. Ο κεντρικός κατάλογος της πρόσθετης λειτουργίας αντιστοιχίζεται στον κεντρικό κατάλογο της δέσμης πρωτογενούς κώδικα. Αυτή είναι η κύρια περίπτωση των περισσότερων πρόσθετων λειτουργιών που έχουν τοποθετηθεί σε αρχείο jar. Αν η πρόσθετη λειτουργία περιλαμβάνει επιπλέον βιβλιοθήκες "foo/lib.jar", ο πρωτογενής κώδικας πρέπει να περιέχεται στους αντίστοιχους φακέλους "foo/libsrc/" στις δέσμες πρωτογενούς κώδικα.

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

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

individualSourceBundles=true

Πρέπει να καθοριστεί στο αρχείο ανώτερου επιπέδου build.properties των ρυθμίσεων δόμησης και ελέγχει εξ’ ολοκλήρου τη δημιουργία πρωτογενούς κώδικα για αυτή τη δόμηση. Ανατρέξτε στην ενότητα Δημιουργία λειτουργιών και πρόσθετων λειτουργιών πρωτογενούς κώδικα για λεπτομέρειες σχετικά με τη δημιουργία παραδοσιακών λειτουργιών και πρόσθετων λειτουργιών κώδικα. Τα υπόλοιπα στοιχεία αυτής της σελίδας θεωρούν ότι υπάρχει εξοικείωση με την παραδοσιακή δημιουργία πρωτογενούς κώδικα.

generate.feature

Σε ένα αρχείο build.properties μιας λειτουργίας, η ιδιότητα generate.feature ζητά από το pde.build να δημιουργήσει μια λειτουργία πρωτογενούς κώδικα.
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 δημιουργεί μια πρόσθετη λειτουργία πρωτογενούς κώδικα βάσει των περιεχομένων μιας δεδομένης λειτουργίας. Κατά τη δημιουργία μεμονωμένων δεσμών πρωτογενούς κώδικα, αυτό αλλάζει και βασίζεται σε μια δεδομένη πρόσθετη λειτουργία:

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

generateSourceBundle

Ορισμένες πρόσθετες λειτουργίες ενδεχομένως να μην απαιτούν δέσμες πρωτογενούς κώδικα, διότι στην πραγματικότητα δεν περιέχουν πρωτογενή κώδικα. Αυτό μπορεί να συμβεί με τμήματα κώδικα ειδικά για πλατφόρμες, που περιέχουν μόνο μια ενσωματωμένη βιβλιοθήκη. Σε αυτήν την περίπτωση, οι δέσμες ενδέχεται να εξαιρεθούν από τη λειτουργία όπως επισημαίνεται παραπάνω στην ιδιότητα 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

Σε προηγούμενες εκδόσεις, τα περιεχόμενα του καταλόγου sourceTemplatePlugin της αρχικής λειτουργίας αντιγράφονταν στην πρόσθετη λειτουργία πρωτογενούς κώδικα. Κατά τη δημιουργία μεμονωμένων δεσμών πρωτογενούς κώδικα, αυτό ισχύει μόνο για τη δέσμη πρωτογενούς κώδικα εμπορικής επωνυμίας (δείτε παραπάνω).

Για όλες τις άλλες δέσμες πρωτογενούς κώδικα, τα περιεχόμενα ενός καταλόγου sourceTemplateBundle θα αντικατασταθούν.