Η προσαρμογή προϊόντος λειτουργεί διαφορετικά όταν χρησιμοποιείτε το μηχανισμό κύριας λειτουργίας. Οι πληροφορίες εμπορικής επωνυμίας της λειτουργίας βρίσκονται σε μια πρόσθετη λειτουργία η οποία προδιορίζεται από την κύρια λειτουργία (ή την πρόσθετη λειτουργία που φέρει το ίδιο όνομα με αυτό της κύριας λειτουρίας, όταν δεν καθορίζεται καμία από τις δύο). Τα αρχεία που προσδιορίζουν και καθορίζουν τις πληροφορίες εμπορικής επωνυμίας για την υποτιθέμενη εφαρμογή acmeweb επισημαίνονται στο δείγμα της δομής καταλόγου παρακάτω:
acmeweb/ acmeweb.exe (product executable - invokes eclipse.exe and specifies the primary feature) eclipse/ .eclipseproduct eclipse.exe startup.jar install.ini .config/ platform.cfg jre/ features/ com.example.acme.acmefeature_1.0.0/ (primary feature) feature.xml plugins/ com.example.acme.acmefeature_1.0.0/ (plug-in for primary feature. Contains branding info.) plugin.xml about.ini about.html about.mappings about.properties acme.png plugin_customization.ini splash.jpg welcome.xml com.example.acme.acmewebsupport_1.0.0/ ... links/ ...
Στην πρόσθετη λειτουργία η οποία συσχετίζεται με μια κύρια λειτουργία καθορίζονται οι πληροφορίες εμπορικής επωνυμίας ενός προϊόντος. Υπάρχουν πολλές προσαρμόσιμες παράμετροι ενός προϊόντος. Οι προσαρμογές επιπέδου προϊόντος καθορίζονται με χρήση του αρχείου about.ini και άλλων αρχείων που περιγράφονται εδώ. Τα προϊόντα μπορούν επίσης να ελέγξουν τις προεπιλεγμένες τιμές προτίμησης άλλων πρόσθετων λειτουργιών. Αυτή η διαδικασία εκτελείται με χρήση του αρχείου plugin_customization.ini.
Με αναφορά για μια ακόμα φορά στο δείγμα πρόσθετης λειτουργίας της κύριας λειτουργίας προϊόντος, ας ρίξουμε μια ματιά στον τρόπο προσαρμογής του προϊόντος.
com.example.acme.acmefeature_1.0.0/ plugin.xml about.ini about.html about.mappings about.properties acme.png plugin_customization.ini plugin_customization.properties splash.bmp welcome.xml
Θα εξετάσουμε τις ίδιες προσαρμογές με αυτές που εξετάσαμε για τα προϊόντα επέκτασης και χρησιμοποιώντας το μηχανισμό κύριας λειτουργίας, θα εστιάσουμε στις διαφορές των προδιαγραφών.
Όπως αναφέρθηκε και για την προσαρμογή επιπέδου προϊόντος, όλες οι λειτουρίες και οι πρόσθετες λειτουργίες θα πρέπει να συνεισφέρουν σε ένα αρχείο about.html το οποίο θα παρέχει πληροφορίες σχετικά με αυτή την συγκεκριμένη πρόσθετη λειτουργία.
Η κύρια λειτουργία υποστηρίζει επίσης τις πληροφορίες και τα γραφικά για το συνολικό προϊόν. Για τον καθορισμό αυτών των πληροφοριών χρησιμοποιούνται πρόσθετα αρχεία.
Μπορείτε να χρησιμοποιήσετε μια έγχρωμη εικόνα 16x16 εικονοστοιχείων για να κατοχυρώσετε την εμπορική επωνυμία παραθύρων που δημιουργούνται από το προϊόν. Θα εμφανίζεται στην επάνω αριστερή γωνία των παραθύρων του προϊόντος. Καθορίζεται στο γνώρισμα windowImage στο αρχείο about.ini. Η διαδρομή θα πρέπει να καθορίζεται ως η σχετική διαδρομή μιας πρόσθετης λειτουργίας. Μια κατάλληλη καταχώρηση για τη δομή καταλόγου που εμφανίζεται παραπάνω θα πρέπει να έχει ως εξής:
windowImage=acme.png
Οι πρόσθετες λειτουργίες που χρησιμοποιούν τους μηχανισμούς Υποδοχής του Eclipse 2.1 θα πρέπει να προσδιορίζουν το αρχείο της σελίδας υποδοχής στο γνώρισμα welcomePage που βρίσκεται στο αρχείο about.ini. Η διαδρομή θα πρέπει να προσδιορίζεται ως η σχετική διαδρομή μιας πρόσθετης λειτουργίας. Μια κατάλληλη καταχώρηση για τη δομή καταλόγου που εμφανίζεται παραπάνω θα πρέπει να έχει ως εξής:
welcomePage=welcome.xml
Μπορείτε επίσης να ορίσετε την αναζήτηση μιας εθνικής γλώσσας για αυτό το αρχείο. (Για περισσότερες πληροροφίες, ανατρέξτε Τοπικά συγκεκριμένα αρχεία.)
welcomePage=$nl$/welcome.xml
Η οθόνη εκκίνησης προϊόντος υποστηρίζεται σε ένα αρχείο splash.bmp που βρίσκεται στον κατάλογο πρόσθετης λειτουργίας της κύριας λειτουργίας. Η εικόνα θα πρέπει να υποστηρίζεται σε μορφή BMP 24-bit color (μορφή RGB) και θα πρέπει να έχει μέγεθος κατά προσέγγιση 500x330 εικονοστοιχεία. Σε περίπτωση που χρειάζεται να γίνει προσαρμογή της οθόνης εκκίνησης για διαφορετικά τοπικά στοιχεία, αυτά μπορούν να τοποθετηθούν σε ένα τμήμα της πρόσθετης λειτουργίας της κύριας λειτουργίας.
Το αρχείο plugin_customization.ini χρησιμοποιείται για τη ρύθμιση των προεπιλεγμένων τιμών προτίμησης που καθορίζονται από άλλες πρόσθετες λειτουργίες. Αυτό το αρχείο είναι μορφής java.io.Properties. Συνήθως αυτό το αρχείο χρησιμοποιείται για τη ρύθμιση τιμών για προτιμήσεις που δημοσιεύονται ως τμήμα του δημόσιου API μιας πρόσθετης λειτουργίας. Δηλαδή, σε περίπτωση που αποφασίσετε να παραπέμψετε σε προτιμήσεις οι οποίες χρησιμοποιούνται από πρόσθετες λειτουργίες αλλά δεν καθορίζονται επίσημα απο το API, παίρνετε ένα ρίσκο.
Μια κοινή προσαρμογή είναι η ρύθμιση της προεπιλεγμένης προοπτικής για τον πάγκο εργασίας. Αυτή η προτίμηση προσδιορίζεται στην πρόσθετη λειτουργία org.eclipse.ui . Το παρακάτω παράδειγμα υποθέτει ότι θα πρέπει να έχει γίνει εκκίνηση του προϊόντος με προεπιλεγμένη προοπτική την προοπτική πόρου.
org.eclipse.ui/defaultPerspectiveId=org.eclipse.ui.resourcePerspective
Αν ανακαλύψετε ότι χρειάζεται να αλλάξετε την προεπιλεγμένη τιμή για μία από τις προτιμήσεις της πρόσθετης λειτουργίας, συμβουλευθείτε την τεκμηρίωση API για τη συγκεκριμένη πρόσθετη λειτουργία για να δείτε εάν η προτίμηση αυτή θεωρείται δημόσια.
Το αρχείο plugin_customization.properties περιέχει μεταφρασμένες σειρές χαρακτήρων για το αρχείο plugin_customization.ini.