Tworzenie projektu wtyczki
Do budowania wtyczek produktu Eclipse można używać dowolnego środowiska
Java IDE, ale pakiet SDK środowiska Eclipse udostępnia narzędzia dostosowane do programowania wtyczek.
Poniżej omówione zostaną kolejne kroki budowania wtyczki w środowisku Eclipse SDK,
ponieważ jest to typowy przypadek. Mniej zaawansowani użytkownicy środowiska roboczego Eclipse i
środowiska Java IDE znajdą dodatkowe wyjaśnienia poruszanych tu zagadnień w Podręczniku
użytkownika środowiska Java lub w Podręczniku środowiska PDE. Na tym etapie zostanie omówiony
głównie kod, a nie sposób używania narzędzia, jednakże w kilku słowach zostanie opisana logistyka
środowiska IDE.
Tworzenie projektu wtyczki
Konieczne będzie utworzenie projektu z wynikami własnej pracy. Przy
tworzeniu szablonu stanowiącego punkt wyjścia projektu wykorzystane zostaną zalety pewnych
narzędzi do generowania kodu, które są dostępne w środowisku programowania
wtyczek (Plug-in
Development Environment - PDE). Spowoduje to utworzenie projektu na potrzeby
pisania kodu Java i wygenerowanie domyślnych plików manifestu wtyczek (opisanych dalej) oraz klasy przechowującej widok.
- Otwórz kreatora Nowy projekt (opcja
Plik > Nowy
> Projekt) i w kategorii Programowanie wtyczek wybierz opcję Projekt wtyczki, a następnie kliknij przycisk Dalej.
- Na stronie Projekt wtyczki podaj com.example.helloworld
jako nazwę projektu i użyj pola wyboru Utwórz projekt
Java (powinno być domyślnie zaznaczone).
W pozostałych ustawieniach na stronie pozostaw wartości domyślne, a następnie
kliknij przycisk Dalej, aby zaakceptować strukturę projektu domyślnej
wtyczki.
- Na stronie Treść wtyczki przyjrzyj
się ustawieniom domyślnym. Kreator ustawia nazwę
com.example.helloworld jako identyfikator wtyczki. Kreator generuje również klasę wtyczki oraz
umożliwia wprowadzenie dodatkowych informacji dotyczących jej
wniesienia do interfejsu użytkownika. Ustawienia domyślne są
akceptowalne, kliknij więc przycisk Dalej.
- Na stronie Szablony zaznacz pole wyboru
Utwórz wtyczkę, używając jednego z szablonów.
Następnie wybierz szablon Wtyczka z widokiem. Kliknij przycisk Dalej.
- Ponieważ utworzona ma zostać możliwie najprostsza wtyczka, trzeba teraz zmienić ustawienia domyślne w celu jej maksymalnego uproszczenia. Na
stronie Ustawienia widoku głównego zmień sugerowane
ustawienia domyślne w następujący sposób:
- Zmień wartość pola Nazwa pakietu Java z
com.example.helloworld.views na
com.example.helloworld (nie jest potrzebny oddzielny
pakiet dla widoku).
- Zmień wartość pola Nazwa klasy widoku na HelloWorldView.
- Zmień wartość pola Nazwa widoku na Hello
View.
- Pozostaw domyślną wartość pola Identyfikator kategorii
widoku (com.example.helloworld).
- Zmień wartość pola Nazwa kategorii widoku na Hello
Category.
- Pozostaw domyślny typ przeglądarki, czyli Przeglądarka
tabel - zostanie to zmienione w kodzie, co pozwoli na dalsze uproszczenia.
- Usuń zaznaczenie pola wyboru Dodaj widok do perspektywy zasobu.
- Kliknij przycisk Dalej, aby przejść do następnej
strony.
- Na stronie Składniki widoku usuń zaznaczenia
wszystkich pól wyboru, aby żadne dodatkowe składniki nie były
generowane dla wtyczki. Kliknij przycisk
Zakończ, aby utworzyć projekt i szkielet wtyczki.
- Na pytanie o przełączenie do perspektywy Programowanie wtyczek odpowiedz Tak.
- Przejdź do nowo utworzonego projektu i sprawdź jego treść.
Struktura projektu szkieletowego obejmuje kilka folderów, plików oraz pakiet Java. Na
tym etapie ważne są pliki manifestu plugin.xml i MANIFEST.MF
oraz kod źródłowy Java wtyczki. Na początku zostanie pokazana
implementacja widoku, a następną czynnością będzie analiza plików manifestu.