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.

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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: Ustawienia widoku modułu dodatkowego
  6. 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.
  7. Na pytanie o przełączenie do perspektywy Programowanie modułów dodatkowych odpowiedz Tak.
  8. 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.