Tworzenie projektu modułu dodatkowego

W obszarze roboczym moduł dodatkowy jest reprezentowany przez pojedynczy projekt, który zawiera cały kod i zasoby modułu dodatkowego.

Aby utworzyć projekt modułu dodatkowego, należy uruchomić kreatora Nowy projekt modułu dodatkowego, wybierając kolejno opcje:  Plik > Nowy > Projekt modułu dodatkowego.

Struktura projektu modułu dodatkowego

Zgodnie z konwencją nazwy projektów modułów dodatkowych powinny być takie same, jak identyfikatory modułów dodatkowych, jednak nie jest to konieczne.

Projekt modułu dodatkowego można utworzyć w jednej z dwóch odmian: projekt Java lub projekt prosty.  Większość modułów dodatkowych ma w domyśle zawierać wykonywalny kod Java i tym samym muszą być one osadzone w projekcie Java.  Jeśli jednak tworzony jest na przykład moduł dodatkowy dokumentacji, wystarczy dla niego utworzyć projekt prosty.

Moduł dodatkowy zawierający manifest pakunku OSGi jest zalecanym formatem modułów dodatkowych. Oprócz przyspieszenia uruchamiania i ładowania klas umożliwia on korzystanie z wielu nowych możliwości udostępnianych przez środowisko wykonawcze.

Kliknij przycisk Dalej.

Strona treści modułu dodatkowego

 

 

Strona Treść modułu dodatkowego służy do określania danych używanych do inicjowania pliku plugin.xml, w tym identyfikatora, wersji i nazwy modułu.

Zalecaną formą, w jakiej moduł dodatkowy powinien być dostarczony do wdrożenia, jest pojedynczy plik JAR zawierający wszystkie klasy i zasoby w swoim katalogu głównym. Dla tego formatu pole Ścieżka klasy może pozostać puste lub można wprowadzić znak "." (bez znaków cudzysłowu).

Klasa modułu dodatkowego to klasa Java najwyższego poziomu, która reprezentuje cały moduł dodatkowy.  Można jej używać w środowisku wykonawczym do sterowania cyklem życia modułu dodatkowego; polega to na tym, że implementacja tej klasy określa, co się stanie, gdy moduł dodatkowy zostanie uruchomiony lub zatrzymany. 

Kliknij przycisk Dalej.

Generatory kodu modułu dodatkowego

 

Na następnej stronie przedstawiono różne szablony dostępne w środowisku PDE, które generują przydatną treść, na przykład widoki, edytory, strony właściwości itp.

W tym przykładzie zostanie utworzony moduł dodatkowy na podstawie szablonu "Hello, World". Informacje o kreatorze można przeczytać w obszarze z prawej strony listy kreatorów. 

Kliknij przycisk Dalej.

Strona szablonu "Przykładowy zestaw akcji"

 

Na następnej stronie można dostosować tworzone rozszerzenie przykładowe.

Po kliknięciu przycisku Zakończ, kreator utworzy nowy projekt, wszystkie określone pliki i foldery oraz początkową ścieżkę budowania Java. Ścieżka budowania jest ważna dla poprawnej kompilacji generowanych klas Java. Kreator otworzy także edytor manifestu modułu dodatkowego.  

Po zakończeniu pracy kreatora początkowa struktura projektu będzie wyglądać następująco:

Początkowa struktura projektu modułu dodatkowego