Είδη ρυθμίσεων εκκίνησης
Ταυτότητα:
org.eclipse.debug.core.launchConfigurationTypes
Περιγραφή:
Αυτό το σημείο επέκτασης παρέχει ένα διαμορφούμενο μηχανισμό για τις εφαρμογές εκκίνησης.
Κάθε είδος ρυθμίσεων εκκίνησης έχει ένα όνομα, υποστηρίζει μία ή περισσότερες καταστάσεις λειτουργίας (εκτέλεση ή/και εντοπισμός και διόρθωση σφαλμάτων) και προσδιορίζει έναν εκπρόσωπο, υπεύθυνο για την υλοποίηση της εκκίνησης μιας εφαρμογής.
Οπως και στην Εκδοχή 3.2, τα είδη μπορούν επίσης να ορίζουν μια ανάθεση μετάβασης
η οποία μπορεί να χρησιμοποιηθεί για τον ορισμό αντιστοιχίσεων μεταξύ έργων και τις
ρυθμίσεις εκκίνησης για την εκκίνησή τους.
Μορφοποίηση ρυθμίσεων:
<!ELEMENT extension (launchConfigurationType*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - μια πλήρως προσδιορισμένη ταυτότητα του σημείου επέκτασης προορισμού
- id - μια προαιρετική ταυτότητα για τη χρήση της επέκτασης
- name - ένα προαιρετικό όνομα για τη χρήση της επέκτασης
<!ELEMENT launchConfigurationType (fileExtension+)>
<!ATTLIST launchConfigurationType
id CDATA #REQUIRED
delegate CDATA #REQUIRED
modes CDATA #REQUIRED
name CDATA #REQUIRED
public (true | false)
category CDATA #IMPLIED
sourcePathComputerId CDATA #IMPLIED
sourceLocatorId CDATA #IMPLIED
migrationDelegate CDATA #IMPLIED>
- id - προσδιορίζει μια μοναδική ταυτότητα για το συγκεκριμένο είδος ρυθμίσεων εκκίνησης.
- delegate - προσδιορίζει το πλήρες όνομα της κλάσης Java, η οποία υλοποιεί την
ILaunchConfigurationDelegate
.
Οι χρήσεις των ρυθμίσεων εκκίνησης αυτού του είδους θα εκπροσωπούν τις χρήσεις της κλάσης για την εκτέλεση της εκκίνησης.
- modes - προσδιορίζει μια λίστα καταστάσεων λειτουργίας, που διαχωρίζονται με κόμμα, τις οποίες υποστηρίζει αυτό το είδος ρυθμίσεων εκκίνησης - "εκτέλεση" ή/και "εντοπισμός και διόρθωση σφαλμάτων".
- name - προσδιορίζει ένα αναγνώσιμο από τον άνθρωπο όνομα για αυτό το είδος ρυθμίσεων εκκίνησης.
- public - προσδιορίζει εάν αυτό το είδος ρυθμίσεων εκκίνησης είναι προσβάσιμο από τους χρήστες. Η προεπιλεγμένη τιμή είναι
true
, για την περίπτωση που δεν προσδιορίζεται.
- category - ένα προαιρετικό γνώρισμα που προσδιορίζει αυτή την κατηγορία είδους ρυθμίσεων εκκίνησης. Ως προεπιλογή, δεν προσδιορίζεται (
null
). Οι κατηγορίες ορίζονται από τον πελάτη. Το γνώρισμα αυτό προστέθηκε στην έκδοση 2.1.
- sourcePathComputerId - Η μοναδική ταυτότητα μιας επέκτασης sourcePathComputer που χρησιμοποιείται για τον υπολογισμό μιας προεπιλεγμένης διαδρομής αναζήτησης πρωτογενούς κώδικα για τις ρυθμίσεις εκκίνησης αυτού του είδους. Το γνώρισμα αυτό προστέθηκε στην έκδοση 3.0.
- sourceLocatorId - Η μοναδική ταυτότητα μιας επέκτασης sourceLocator που χρησιμοποιείται για τη δημιουργία της ρουτίνας εντοπισμού πρωτογενούς κώδικα, για συνεδρίες που ξεκινούν με τη χρήση των ρυθμίσεων εκκίνησης αυτού του είδους. Το γνώρισμα αυτό προστέθηκε στην έκδοση 3.0.
- migrationDelegate - Προαιρετική ανάθεση που χρησιμοποιείται για τη μετάβαση
ρυθμίσεων εκκίνησης αυτού του είδους έτσι ώστε να υπάρχει συμβατότητα με τα τρέχοντα
εργαλεία, από την Εκδοχή 3.2
<!ELEMENT fileExtension EMPTY>
<!ATTLIST fileExtension
extension CDATA #REQUIRED
default (true | false) >
- extension - ορίζει μια επέκταση αρχείου για την οποία μπορεί να χρησιμοποιηθεί αυτό το είδος ρυθμίσεων εκκίνησης.
- default - ορίζει αν αυτό το είδος ρυθμίσεων εκκίνησης θα πρέπει να αποτελεί την προεπιλογή, για την καθορισμένη επέκταση αρχείου. Η προεπιλεγμένη τιμή είναι
false
, για την περίπτωση που δεν προσδιορίζεται.
Παραδείγματα:
Παρακάτω δίνεται ένα παράδειγμα σημείου επέκτασης είδους ρυθμίσεων εκκίνησης.
<extension point=
"org.eclipse.debug.core.launchConfigurationTypes"
>
<launchConfigurationType
id=
"com.example.ExampleIdentifier"
delegate=
"com.example.ExampleLaunchConfigurationDelegate"
modes=
"run,debug"
name=
"Example Application"
>
<fileExtension extension=
"txt"
default=
"true"
/>
<fileExtension extension=
"gif"
default=
"false"
/>
</launchConfigurationType>
</extension>
Στο παραπάνω παράδειγμα, το καθορισμένο είδος ρυθμίσεων εκκίνησης υποστηρίζει τις καταστάσεις λειτουργίας εκτέλεσης και εντοπισμού και διόρθωσης σφαλμάτων.
Οι ρυθμίσεις εκκίνησης εφαρμόζονται σε αρχεία .txt και .gif και αποτελούν την προεπιλογή για αρχεία .txt.
Πληροφορίες API:
Η τιμή του γνωρίσματος delegate πρέπει να είναι ένα πλήρες όνομα κλάσης Java η οποία υλοποιεί τη διεπαφή org.eclipse.debug.core.model.ILaunchConfigurationDelegate.
Copyright (c) 2000, 2005 IBM Corporation και άλλων.
Με την επιφύλαξη παντός δικαιώματος. Αυτό το πρόγραμμα και τα συνοδευτικά του υλικά διατίθενται βάσει των όρων της κοινής άδειας χρήσης Eclipse Public License v1.0 που συνοδεύει αυτή τη διανομή και διατίθεται στην ακόλουθη διεύθυνση: http://www.eclipse.org/legal/epl-v10.html.