Typy konfiguracji startowej
Identyfikator:
org.eclipse.debug.core.launchConfigurationTypes
Opis:
Ten punkt rozszerzenia udostępnia konfigurowalny mechanizm umożliwiający uruchamianie aplikacji. Każdy typ konfiguracji startowej ma nazwę, obsługuje jeden lub więcej trybów (uruchamianie i/lub debugowanie) oraz określa delegata odpowiedzialnego za implementację uruchamiania aplikacji.
Znaczniki konfiguracji:
<!ELEMENT extension (launchConfigurationType*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA
#IMPLIED
name CDATA #IMPLIED>
- point - pełny identyfikator docelowego punktu rozszerzenia.
- id - opcjonalny identyfikator instancji rozszerzenia.
- name - opcjonalna nazwa instancji rozszerzenia.
<!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>
- id - określa unikalny identyfikator tego typu konfiguracji startowej.
- delegate - określa pełną nazwę klasy Java implementującej interfejs
ILaunchConfigurationDelegate
. Instancje konfiguracji startowej będą delegowane do instancji tej klasy w celu przeprowadzenia operacji uruchomienia.
- modes - określa rozdzieloną przecinkami listę trybów obsługiwanych przez ten typ konfiguracji startowej - run i/lub debug.
- name - określa czytelną dla człowieka nazwę tego typu konfiguracji startowej.
- public - określa, czy ten typ konfiguracji startowej jest dostępny dla użytkowników. Jeśli nie określono wartości atrybutu, przyjmowana jest wartość domyślna
true
.
- category - opcjonalny atrybut określający kategorię tego typu konfiguracji startowej. Domyślna
wartość atrybutu to brak ustawionej wartości (atrybut ma wartość
null
). Kategorie są definiowane przez klienta. Atrybut ten został dodany w wersji 2.1.
- sourcePathComputerId - unikalny identyfikator rozszerzenia sourcePathComputer, używanego do określenia domyślnej ścieżki wyszukiwania źródeł dla konfiguracji startowej tego typu. Atrybut ten dodano w wersji 3.0.
- sourceLocatorId - unikalny identyfikator rozszerzenia sourceLocator, używanego do tworzenia wskaźnika źródła dla sesji uruchamianych przy użyciu konfiguracji startowej tego typu. Atrybut ten dodano w wersji 3.0.
<!ELEMENT fileExtension EMPTY>
<!ATTLIST fileExtension
extension CDATA #REQUIRED
default (true | false) >
- extension - określa rozszerzenie pliku, z którym może być używany ten typ konfiguracji startowej.
- default - określa, czy ten typ konfiguracji startowej powinien być domyślnym typem konfiguracji startowej dla danego rozszerzenia pliku. Jeśli nie określono wartości atrybutu, przyjmowana jest wartość domyślna
false
.
Przykłady:
Poniżej przedstawiono przykładowy punkt rozszerzenia typu konfiguracji startowej:
<extension point=
"org.eclipse.debug.core.launchConfigurationTypes"
>
<launchConfigurationType
id=
"com.example.ExampleIdentifier"
delegate=
"com.example.ExampleLaunchConfigurationDelegate"
modes=
"run,debug"
name=
"Przykład aplikacji"
>
<fileExtension extension=
"txt"
default=
"true"
/>
<fileExtension extension=
"gif"
default=
"false"
/>
</launchConfigurationType>
</extension>
W powyższym przykładzie określony typ konfiguracji startowej obsługuje zarówno tryb uruchamiania (run), jak i debugowania (debug). Konfiguracja startowa dotyczy plików .txt i .gif. Jest ona domyślną konfiguracją startową dla plików .txt.
Informacje o interfejsie API:
Wartość atrybutu delegate musi być pełną nazwą klasy Java implementującej interfejs org.eclipse.debug.core.model.ILaunchConfigurationDelegate.
Copyright (c) 2000, 2005 IBM Corporation i inne podmioty.
Wszelkie prawa zastrzeżone. Program ten oraz towarzyszące mu materiały są udostępniane na warunkach licencji EPL (Eclipse Public License), wersja 1.0, dołączonej do nich i dostępnej pod adresem http://www.eclipse.org/legal/epl-v10.html.