Οδηγίες εγκατάστασης προϊόντος
Η πλατφόρμα παρέχει τυπικά εργαλεία για την ενημέρωση και την επέκταση προϊόντων. Για να συμμετάσχετε στους μηχανισμούς ενημέρωσης και επέκτασης προϊόντων της πλατφόρμας, το προϊόν που συσκευάζετε θα πρέπει να ακολουθεί τις παρακάτω οδηγίες. Εξασφαλίζετε έτσι την ομαλή συνύπαρξη, η ακόμα και τη βελτίωση, με άλλα προϊόντα που βασίζονται στο Eclipse.
Λάβετε υπόψη σας, και εδώ, το δείγμα δομής καταλόγου για το προϊόν acmeweb:
acmeweb/
acmeweb.exe
eclipse/
.eclipseproduct
eclipse.exe
startup.jar
install.ini
.config/
platform.cfg
jre/
features/
com.example.acme.acmefeature_1.0.0/
feature.xml
...
plugins/
com.example.acme.acmefeature_1.0.0/
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/
...
Από που προήλθαν αυτά τα αρχεία όμως; Ας ρίξουμε μια ματιά στο περιεχόμενο προϊόντος από την οπτική της ομάδας ανάπτυξης. Τα εγκατεστημένα αρχεία μπορούν να ομαδοποιηθούν σε πέντε βασικές κατηγορίες:
- αρχεία προϊόντος ανωτέρου επιπέδου (όπως το αρχείο acmeweb.exe)
- χαρακτηριστικά προϊόντος και πρόσθετες λειτουργίες
- την ίδια την πλατφόρμα Eclipse
- το Java runtime environment (JRE)
- αρχεία που δημιουργούνται από την ίδια τη διαδικασία εγκατάστασης
Ένα ειδικό σενάριο εγκατάστασης θα έχει ως αποτέλεσμα τη δημιουργία της κατάλληλης δομής καταλόγου ακολουθώντας τις εξής ενέργειες:
- επιτρέψτε στο χρήστη να καθορίσει τον κατάλογο ανωτέρου επιπέδου της εγκατάστασης (όπως c:\acmeweb. Για τα βήματα που υπολείπονται θα αναφέρεται ως acmeweb.)
- βεβαιωθείτε ότι δεν υπάρχει εγκατεστημένο κάποιο άλλο προϊόν στη θέση αυτή
- αντιγράψτε τα αρχεία ως εξής:
- Τα αρχεία ανωτέρου επιπέδου αντιγράφονται στο acmeweb
- Τα αρχεία Eclipse αντιγράφονται στο acmeweb/eclipse χρησιμοποιώντας τις δομές καταλόγου πρόσθετων λειτουργιών και αναμενόμενης λειτουργίας.
- Τα αρχεία JRE αντιγράφονται στο acmeweb/eclipse/jre. Αν ένα αρχείο JRE βρίσκεται ήδη σε κάποια άλλη θέση, τότε θα πρέπει να ρυθμίσετε τη συντόμευση εφαρμογής ώστε να καλεί το eclipse με το όρισμα γραμμής εντολών -vm προκειμένου η θέση του αρχείου JRE να γίνεται γνωστή στην πλατφόρμα.
- Οι λειτουργίες προϊόντος και οι πρόσθετες λειτουρίες αντιγράφονται στις διαδρομές acmeweb/eclipse/features και acmeweb/eclipse/plugins
- δημιουργήστε ένα αρχείο δείκτη, .eclipseproduct, στοacmeweb/eclipse. Το αρχείο δείκτη είναι ένα αρχείο μορφής java.io.Properties το οποίο υποδηλώνει το όνομα, την ταυτότητα και την έκδοση του προϊόντος.
- αποθηκεύστε τυχόν απαραίτητες πληροφορίες εγκατάσττασης (χρήστης, άδεια χρήσης, ημερομηνία) που θα πρέπει να εμφανίζονται στο πλαίσιο διαλόγου στη θέση acmeweb/eclipse/plugins/com.example.acmefeature_1.0.0/about.mappings
- Αν ο βασικός μηχανισμός λειτουργίας (pre R3.0) χρησιμοποιείται για τον προσδιορισμό του προϊόντος, αντικαταστήστε το αρχείο acmeweb/eclipse/install.ini με ένα άλλο αρχείο το οποίο ρυθμίζει την ιδιότητα feature.default.id στην κύρια λειτουργία του προϊόντος
- καλέστε το εκτελέσιμο αρχείο προϊόντος χρησιμοποιώντας την επιλογή-initialize. Αυτή η ενέργεια έχει ως αποτέλεσμα η πλατφόρμα να εκτελεί ομαλά οποιαδήποτε χρονοβόρα διεργασία επεξεργασίας και να αποθηκεύει στη μνήμη τα αποτελέσματα, ώστε όταν ο χρήστης ξεκινά το προϊόν, αυτό να αναπτύσσεται σύντομα σε επιχειρησιακή κατάσταση.
Θέματα πολλαπλών χρηστών
Κατά την εγκατάσταση ενός προϊόντος με σκοπό την κοινή χρήση της εγκατάστασης μεταξύ πολλαπλών χρηστών, θα πρέπει να δίνεται ιδιαίτερη προσοχή ώστε να γίνεται διαχωρισμός των δεδομένων χρήστη, (όπως ο κατάλογος χώρος εργασίας ) από τον κατάλογο εγκατάστασης του κοινόχρηστου προϊόντος.
Θέματα απεγκατάστασης
Κατά την απεγκατάσταση ενός προϊόντος, τα ακόλουθα θέματα θεωρούνται σημαντικά.
- όλα τα αρχεία στους καταλόγους eclipse/features και eclipse/plugins θα πρέπει να αφαιρούνται, ακόμα και αν δεν είχαν αρχικά εγκατασταθεί από το πρόγραμμα εγκατάστασης. Εξασφαλίζεται έτσι ότι τα αρχεία που προστίθενται από τη λειτουργία διαχείρισης ενημέρωσης της πλατφόρμας αφαιρούνται κατά την αφαίρεση του προϊόντος.
- με εξαίρεση το παραπάνω σημείο, θα πρέπει να αφαιρούνται μόνο αρχεία τα οποία έχουν εγκατασταθεί από το πρόγραμμα εγκατάστασης σε άλλους καταλόγους. Είναι σημαντικό να διατηρούνται τυχόν σημαντικά δεδομένα, όπως ο κατάλογος χώρος εργασίας, έτσι ώστε η επανεγκατάσταση του προϊόντος μετά από μια απεγκατάσταση να έχει τα αναμενόμενα αποτελέσματα.
Επανεγκατάσταση του προϊόντος
Όταν ένα πρόγραμμα έχει ήδη εγκατασταθεί, η λειτουργία εγκατάστασης επιτρέπει την ενημέρωση ή την αναβάθμιση της υπηρεσίας, εάν αυτές είναι διαθέσιμες. Η ύπαρξη του προϊόντος μπορεί να επαληθευθεί μέσω της αναζήτησης του αρχείου acmeweb/eclipse/.eclipseproduct. Οι πληροφορίες του αρχείου δείκτη μπορούν να χρησιμοποιηθούν ώστε να επαληθεύεται σε συνεργασία με το χρήστη ότι γίνεται ενημέρωση του σωστού προϊοντος. Η διαθεσιμότητα των ενημερωμένων εκδόσεων μπορεί να επαληθευθεί με αντιστοιχίες μοτίβου σε αντιπαράθεση με τα ονόματα λειτουργίας. Για παράδειγμα, η παρουσία του acmeweb/eclipse/plugins/com.example.acmefeature_1.0.1 θα υποδείκνυε ότι η ενημέρωση με έκδοση1.0.1 έχει ήδη εφαρμοστεί στο προϊόν.
Όταν επιτευχθεί η εγκυρότητα της επανεγκατάστασης, το πρόγραμμα εγκατάστασης θα πρέπει να αντιγράψει ή να αντικαταστήσει τα αρχεία ανάλογα με τις ανάγκες. Εάν η έκδοση της υποκείμενης πλατφόρμας Eclipse δεν έχει αλλάξει, τότε μπορείτε να αγνοήσετε τους πλήρεις καταλόγους. Μπορείτε να χρησιμοποιήσετε τους αριθμούς έκδοσης που προσαρτώνται στις πρόσθετες λειτουργίες και στη λειτουργία της πλατφόρμας προκειμένου να προσδιορίσετε την αναγκαιότητα εκτέλεσης αλλαγών κάτω από τον κατάλογο μιας πρόσθετης λειτουργίας ή κάποιας λειτουργίας.
Για πρόσθετες πληροφορίες σχετικά με την εγκατάσταση προϊόντων, ανατρέξτε στην τοποθεσίαΤρόπος εγγραφής μιας λειτουργίας εγκατάστασης Eclipse.