Tworzenie projektu modułu dodatkowego
Do budowania modułów dodatkowych produktu Eclipse można używać dowolnego środowiska
Java IDE, ale pakiet SDK środowiska Eclipse udostępnia narzędzia dostosowane do programowania modułów dodatkowych.
Poniżej omówione zostaną kolejne kroki budowania modułu dodatkowego 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 modułu dodatkowego
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
modułów dodatkowych (Plug-in
Development Environment - PDE). Spowoduje to utworzenie projektu na potrzeby
pisania kodu Java i wygenerowanie domyślnych plików manifestu modułów
dodatkowych (opisanych dalej) oraz klasy przechowującej widok.
- Otwórz kreatora Nowy projekt (opcja Plik > Nowy
> Projekt) i w kategorii Programowanie modułów dodatkowych wybierz opcję Projekt modułu
dodatkowego, a następnie kliknij przycisk Dalej.
- Na stronie Projekt modułu dodatkowego 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ślnego
modułu dodatkowego.
- Na stronie Treść modułu dodatkowego przyjrzyj
się ustawieniom domyślnym. Kreator ustawia nazwę
com.example.helloworld jako identyfikator modułu
dodatkowego. Kreator generuje również klasę modułu dodatkowego 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 moduł dodatkowy, używając jednego z szablonów.
Następnie wybierz szablon Moduł dodatkowy z widokiem. Kliknij przycisk Dalej.
- Ponieważ utworzony ma zostać możliwie najprostszy moduł dodatkowy, trzeba teraz zmienić ustawienia domyślne w celu jego 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 modułu dodatkowego. Kliknij przycisk
Zakończ, aby utworzyć projekt i szkielet modułu
dodatkowego.
- Na pytanie o przełączenie do perspektywy Programowanie modułów
dodatkowych 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 modułu dodatkowego. Na początku zostanie pokazana
implementacja widoku, a następną czynnością będzie analiza plików manifestu.