Δομήσεις προϊόντων με p2

Ο ορισμός της νέας ιδιότητας

p2.gathering = true

θα επιφέρει μερικές αλλαγές στις δομήσεις προϊόντων. Συγκεκριμένα, η δόμηση θα παράγει σωστά εγκατεστημένα προϊόντα που υποστηρίζουν πλήρως το p2.

Ακολουθεί η λίστα με τις σχετικές ιδιότητες (παλιές και νέες):

p2.gatheringΑν οριστεί η τιμή της σε true, ενεργοποιεί τις δομήσεις που βασίζονται στη λειτουργία δημοσίευσης p2.
p2.build.repoΈνα URI για το τοπικό χώρο αποθήκευσης του p2 για χρόνους δόμησης. Η προεπιλεγμένη τιμή είναι file:${buildDirectory}/buildRepo. Θα πραγματοποιηθεί κατοπτρισμός των αποτελεσμάτων στη θέση του τελικού αρχείου αποθήκευσης.
generate.p2.metadataΑυτή η ιδιότητα αναφέρεται στην παλιά ενοποίηση της λειτουργίας δημιουργίας μετα-δεδομένων. Δεν έχει καμία επιρροή όταν p2.gathering=true.
p2.metadata.repo
p2.artifact.repo
Αυτές οι ιδιότητες πρέπει να είναι URI. Η προεπιλεγμένη ρύθμιση για όλες τις δομήσεις προϊόντων είναι τα εγκατεστημένα προϊόντα να αποτελούν τα τελικά αρχεία αποθήκευσης και τα μετα-δεδομένα και τα τεχνουργήματα να παραμένουν στο ${p2.build.repo}. Αν έχουν οριστεί οι ιδιότητες p2.metadata.repo και p2.artifact.repo, τότε τα τεχνουργήματα και τα μετα-δεδομένα για το προϊόν θα κατοπτριστούν από το χώρο αποθήκευσης της δόμησης.
p2.metadata.repo.name
p2.artifact.repo.name
Προαιρετικά, αυτές οι ιδιότητες θα χρησιμοποιηθούν για την ονομασία του τελικού αρχείου αποθήκευσης όταν χρησιμοποιούνται οι ιδιότητες p2.metadata.repo και p2.artifact.repo.
p2.compressΑν οριστεί η τιμή της σε true, συμπιέζει το xml του τελικού χώρου αποθήκευσης σε ένα αρχείο jar.
p2.flavorΗ παραλλαγή του προϊόντος που χρησιμοποιείται ως προσδιοριστικό για τα μετα-δεδομένα ρυθμίσεων του προϊόντος. Δείτε παρακάτω.
p2.product.qualifierΤο προσδιοριστικό που πρέπει να χρησιμοποιηθεί όταν αντικαθιστάτε το "1.0.0.qualifier" σε μια εκδοχή προϊόντος. Αν δεν οριστεί, το προσδιοριστικό θα βασιστεί στην ιδιότητα forceContextQualifier ή στο αποτύπωμα χρόνου.
p2.publish.artifactsΚαμία επιρροή όταν p2.gathering=true (παλιά ιδιότητα)
p2.root.name
p2.root.version
Καμία επιρροή όταν p2.gathering=true (παλιά ιδιότητα)
p2.context.reposΟρισμός χώρων αποθήκευσης περιβάλλοντος. Ανατρέξτε στην ενότητα επαναχρησιμοποίησης μετα-δεδομένων.
repoBaseLocationΈνας φάκελος που περιέχει τους χώρους αποθήκευσης που θα μετασχηματιστούν με τη χρήση της ιδιότητας <p2.repo2runnable>. Ανατρέξτε επίσης στην ενότητα επαναχρησιμοποίησης μετα-δεδομένων.
transformedRepoLocationΟ φάκελος που περιέχει την έξοδο της <p2.repo2runnable>. Ανατρέξτε επίσης στην ενότητα επαναχρησιμοποίησης μετα-δεδομένων.
p2.category.siteΜια διεύθυνση URL για ένα αρχείο site.xml που χρησιμοποιείται για τον ορισμό κατηγοριών.
p2.category.definitionΜια διεύθυνση URL για ένα αρχείο category.xml που χρησιμοποιείται για τον ορισμό κατηγοριών.
p2.category.prefixΟρισμός προθήματος για να διασφαλίσετε τη χρήση μοναδικών ταυτοτήτων για τις εγκαταστάσιμες μονάδες κατηγοριών οι οποίες δημιουργούνται από αρχεία δικτυακών τόπων/κατηγοριών που δεν χρησιμοποιούν μοναδικά ονόματα.
skipMirroringΠαράλειψη του τελικού κατοπτρισμού από το ${p2.build.repo} στο ${p2.metadata.repo}.
skipDirectorΠαράλειψη της κλήσης προς τη λειτουργία διαχείρισης. Δεν θα δημιουργηθούν εγκατεστημένα προϊόντα. Αν έχουν οριστεί οι ιδιότητες p2.metadata.repo και p2.artifact.repo, αυτοί οι χώροι αποθήκευσης θα περιέχουν τα μετα-δεδομένα και τα τεχνουργήματα των προϊόντων, αλλιώς τα αποτελέσματα θα περιέχονται στο ${p2.build.repo}.
p2.director.logΘέση του αρχείου καταγραφής των αποτελεσμάτων για την κλήση της λειτουργίας διαχείρισης.
p2.director.profileΤο όνομα που θα χρησιμοποιηθεί για το προφίλ p2 που έχει δημιουργηθεί από τη λειτουργία διαχείρισης. Σε γενικές γραμμές είναι καλή ιδέα να δίνετε ένα όνομα που να σχετίζεται κατά κάποιο τρόπο με το προϊόν σας. Η προεπιλεγμένη τιμή είναι "profile".
p2.director.extraArgsΕπιπρόσθετα ορίσματα που θα μεταβιβαστούν στον κατάλογο. Η προεπιλογή είναι "-profileProperties org.eclipse.update.install.features=true".
Ιδιότητες κατοπτρισμούΚατά τη δόμηση προϊόντων ή λειτουργιών, το PDE/Build δημιουργεί κατοπτρικά αντίγραφα των εξαρτήσεων από τους χώρους αποθήκευσης περιβάλλοντος που θα συμπεριληφθούν στη δόμηση. Αυτές οι ιδιότητες ελέγχουν τις εξαρτήσεις που θα συμπεριληφθούν στη διαδικασία. Ανατρέξτε στο θέμα εργασία ant p2.mirror για λεπτομέρειες.
p2.mirror.rawΠροεπιλεγμένη τιμή: false. Ορίστε την τιμή true ώστε να επαναχρησιμοποιούνται τα αρχεία περιγραφής τεχνουργημάτων από τους χώρους αποθήκευσης πρωτογενούς κώδικα.
p2.mirror.slicing.filterΑπό προεπιλογή, δεν έχουν οριστεί φίλτρα. Ορίστε πρόσθετες ιδιότητες φίλτρου τις οποίες πρέπει να ικανοποιούν οι εγκαταστάσιμες μονάδες προκειμένου να συμπεριληφθούν.
p2.mirror.slicing.followOnlyFilteredRequirementsΗ προεπιλεγμένη τιμή είναι false. Ορίστε την τιμή true για να αντιστρέψετε τα φίλτρα ώστε να συμπεριλαμβάνονται οι εγκαταστάσιμες μονάδες που δεν ικανοποιούν τα κριτήρια.
p2.mirror.slicing.followStrictΗ προεπιλεγμένη τιμή είναι false. Ορίστε την τιμή true ώστε να περιλαμβάνονται μόνο οι εξαρτήσεις των οποίων οι εκδοχές έχουν καθοριστεί επακριβώς.
p2.mirror.slicing.includeFeaturesΗ προεπιλεγμένη τιμή είναι true. Καθορίζει εάν θα συμπεριληφθούν λειτουργίες ή όχι.
p2.mirror.slicing.includeNonGreedyΗ προεπιλεγμένη τιμή είναι false. Καθορίζει αν θα συμπεριληφθούν οι εξαρτήσεις non-greedy.
p2.mirror.slicing.includeOptionalΗ προεπιλεγμένη τιμή είναι true. Καθορίζει αν θα συμπεριληφθούν προαιρετικές εξαρτήσεις.
p2.mirror.slicing.latestVersionOnlyΗ προεπιλεγμένη τιμή είναι false. Καθορίζει αν θα συμπεριληφθεί μόνο η πιο πρόσφατη εκδοχή μιας εξάρτησης όταν η απαίτηση είναι εύρος και υπάρχουν πολλαπλές διαθέσιμες εκδοχές.
p2.mirror.slicing.platformFilterΑπό προεπιλογή, δεν έχουν οριστεί φίλτρα. Μια τριάδα τιμών "os,ws,arch" θα οριστεί ως πλατφόρμα με την οποία θα συγκριθούν τα φίλτρα IU LDAP. Τα IU που δεν συμφωνούν με τα κριτήρια του φίλτρου δεν κατοπτρίζονται.

Παραλλαγή προϊόντος

Ως μέρος μιας δόμησης προϊόντος, το PDE/Build δημιουργεί με αυτόματο τρόπο προεπιλεγμένα μετα-δεδομένα ρυθμίσεων για τον ορισμό των επιπέδων έναρξης και της ιδιότητας config.ini. Αυτά τα μετα-δεδομένα είναι γνωστά και ως Μονάδες ρυθμίσεων (CU). Συγκεκριμένα, ο ορισμός των επιπέδων έναρξης πραγματοποιείται με τη χρήση τμημάτων CU στην εγκαταστάσιμη μονάδα για τη δέσμη που έχει εκκινηθεί. Η παραλλαγή χρησιμοποιείται ως προσδιοριστικό για τη δημιουργία του ονόματος CU βάσει της εγκαταστάσιμης μονάδας.

Για παράδειγμα, στην "p2.flavor = tooling", το όνομα της CU που ρυθμίζει τη δέσμη org.eclipse.core.runtime bundle στα Windows θα είναι 'toolingwin32.win32.x86org.eclipse.core.runtime'. Συνιστάται η χρήση μιας παραλλαγής που βασίζεται στην ταυτότητα του προϊόντος έτσι ώστε να αποφευχθούν οι διενέξεις με άλλα μετα-δεδομένα, ιδιαίτερα αν το προϊόν έχει ιδιαίτερες απαιτήσεις όσον αφορά τα επίπεδα έναρξης.

Δείτε επίσης τη σελίδα ρυθμίσεων προϊόντων.

Κλήση λειτουργίας διαχείρισης

Το PDE/Build περιλαμβάνει έναν προορισμό runDirector, ο οποίος καλείται να πραγματοποιήσει εγκαταστάσεις κατά τη διάρκεια μιας δόμησης προϊόντος. Επί του παρόντος, πρόκειται για μια διακλάδωση της εφαρμογής λειτουργίας διαχείρισης σε μια νέα διεργασία. Στα πιο σύνθετα σενάρια releng (συμπίλησης έκδοσης), είναι δυνατό να επαναχρησιμοποιηθεί αυτή η εργασία για την εκτέλεση πρόσθετων εγκαταστάσεων. Η εργασία απαιτεί τον ορισμό της θέσης του Equinox Launcher για το εργαλείο δόμησης. Ένα παράδειγμα κλήσης θα μοιάζει με το ακόλουθο:
	<property name="equinoxLauncherJar" value="/builder/eclipse/plugins/org.eclipse.equinox.launcher_1.0.200.v20090520.jar"/>
	<ant antfile="${eclipse.pdebuild.scripts}/genericTargets.xml" target="runDirector" inheritAll="true">
		<property name="ws" value="gtk"/>
		<property name="os" value="linux"/>
		<property name="arch" value="x86"/>
		<property name="p2.director.installPath" value="${installFolder}"/>
		<property name="p2.repo" value="${p2.build.repo}"/>
		<property name="p2.director.iu" value="my.rcp.product"/>
		<property name="p2.director.version" value="1.0.0"/>
	</ant>