Kreatory treści wtyczek
Identyfikator:
org.eclipse.pde.ui.pluginContent
Opis:
Ten punkt rozszerzenia
umożliwia dodawanie kreatorów tworzących dodatkową treść projektów wtyczek w środowisku PDE. Po utworzeniu plików manifestu i kluczy można
użyć tych kreatorów w celu dodania kolejnych plików i rozszerzeń do struktury
początkowej. Typowa implementacja tego kreatora dodaje treść na podstawie
parametryzowanego szablonu dostosowanego w oparciu o wybory użytkownika
dokonywane w kreatorze.
Celem jest napisanie wtyczki, która robi coś użytecznego bezpośrednio po utworzeniu (na przykład dodaje widok, edytor itp.).
Znaczniki konfiguracji:
<!ELEMENT extension (wizard*)>
<!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 wizard (description?)>
<!ATTLIST wizard
id CDATA #REQUIRED
name CDATA #REQUIRED
icon CDATA #IMPLIED
class CDATA #REQUIRED
category CDATA #IMPLIED
ui-content (true | false) "true"
java (true | false) "true"
rcp (true | false) "false"
pureOSGi (true | false) "false"
requiresActivator (true | false) "false">
- id - unikalna nazwa, która będzie używana do identyfikowania tego
kreatora.
- name - możliwa do przetłumaczenia nazwa, która będzie używana do prezentacji tego
kreatora w interfejsie użytkownika.
- icon - względna ścieżka do pliku ikony, która będzie wizualnie
reprezentowała kreatora.
- class - pełna nazwa klasy, która implementuje interfejs org.eclipse.pde.ui.IPluginContentWizard.
- category - opcjonalny znacznik, którego można użyć do powiązania
kreatorów treści z różnymi projektami docelowymi.
- ui-content - flaga wskazująca, czy kreator doda kod z treścią
interfejsu użytkownika. Ta flaga będzie miała wpływ na wybór klasy wtyczki, ponieważ wtyczki interfejsu użytkownika rozszerzają
klasę
AbstractUIPlugin, natomiast inne wtyczki
rozszerzają klasę podstawową Plugin. Ponieważ wiele
elementów dodanych do platformy
Eclipse rozszerza treść interfejsu użytkownika, domyślna wartość tego atrybutu
wynosi true.
- java - flaga wskazująca, że kreator doda treść Java. Ponieważ
większość wtyczek dla platformy Eclipse zawiera kod Java,
wartość domyślna tego atrybutu wynosi
true. Argumentowi należy
nadać wartość false, gdy wtyczka nie zawiera kodu Java (na
przykład pliki zawierające wyłącznie dokumentację).
- rcp - dostępne od wersji 3.1. Flaga boolowska wskazująca, czy kreator udostępnia autonomiczną, w pełni funkcjonalną aplikację pełnego klienta. Jeśli flaga jest ustawiona na wartość
true, kreator będzie wyświetlany w kreatorze Nowy projekt wtyczki tylko wtedy, gdy użytkownik wybierze opcję Aplikacja pełnego klienta.
- pureOSGi (od wersji 3.2) to flaga typ boolowskiego wskazująca, czy kreator wnosi czysty pakunek OSGi. Jeśli ustawiona wartość flagi to
true, kreator jest wyświetlany w narzędziu Nowy projekt wtyczki wyłącznie jeśli użytkownik wybrał opcję tworzenia czystego pakunku OSGi.
- requiresActivator (od wersji 3.2) to flaga typu boolowskiego wskazująca, czy kreator wnosi klasę aktywatora. Jeśli ustawiona wartość flagi to
true, kreator jest wyświetlany w kreatorze Nowy projekt wtyczki wyłącznie jeśli użytkownik wybrał opcję generowania aktywatora kontrolującego cykl życia wtyczki.
<!ELEMENT description (#PCDATA)>
Krótki opis tego kreatora.
Przykłady:
Poniżej przedstawiono przykład tego punktu rozszerzenia:
<extension point=
"org.eclipse.pde.ui.pluginContent"
>
<wizard
name=
"Example Plug-in Content Generator"
icon=
"icons/content_wizard.gif"
class=
"com.example.xyz.ContentGeneratorWizard"
id=
"com.example.xyz.ExampleContentGenerator"
>
<description>
Dodaje widok i stronę preferencji.
</description>
</wizard>
</extension>
Informacje o interfejsie API:
Kreatory podłączane do tego punktu rozszerzenia muszą implementować interfejs
org.eclipse.pde.ui.IPluginContentWizard oraz rozszerzać klasę org.eclipse.jface.wizard.Wizard.
Dostarczana implementacja:
W
środowisku PDE dostępne są interfejsy API, które służą do dodawania kreatorów
treści na podstawie szablonów, które można dostosowywać. Samo środowisko
PDE dodaje szereg konkretnych kreatorów utworzonych w oparciu o te szablony.
Copyright (c) 2004 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.