Etapy procesu niestandardowego budowania składników i wtyczek

Nowością w wersji 3.2 jest możliwość dodawania niestandardowych kroków do procesu budowania przez same składniki lub wtyczki, których proces dotyczy. Kroki niestandardowe mogą być używane na przykład do instrumentacji kodu bajtowego po kompilacji, indeksowania plików pomocy w dokumentacji lub kopiowania dodatkowych plików do pakietu. 

Aby było możliwe korzystanie z celów niestandardowych, w pliku build.properties wtyczki lub składnika musi być zdefiniowana wartość właściwości customBuildCallbacks; wartość tej właściwości określa położenie (względem katalogu głównego danego składnika lub wtyczki) pliku XML zawierającego cel niestandardowy. W katalogach org.eclipse.pde.build/templates/plugins i org.eclipse.pde.build/templates/features dostarczone są szablony o nazwie customBuildCallbacks.xml odpowiednio dla wtyczek i składników. Szablony te można skopiować do katalogu danego składnika/wtyczki i zmodyfikować stosownie do potrzeb. Cele niestandardowe są wykorzystywane przez zadanie subant z parametrem failonerror="false", dzięki czemu proces budowania nie jest przerywany, jeśli dostarczony plik custom xml nie zawiera określonego celu lub zostanie stwierdzony błąd.

Wtyczki

Wygenerowany plik build.xml używany do budowania wtyczki zawiera kilka celów wykonujących określone zadania. Moduł PDE Build umożliwia wtyczkom dostarczanie niestandardowych celów wstępnych i końcowych, wykonywanych odpowiednio przed i po wykonaniu określonych zadań. Poza ewentualnymi zdefiniowanych właściwościami środowiska ant, każdemu celowi można również przekazać kilka właściwości specjalnych. Następujące cele obsługują niestandardowe wywołania zwrotne:

Składniki

Plik build.xml generowany dla składników obsługuje niestandardowe wywołania zwrotne jedynie w przypadku celu gather.bin.parts. Cel ten będzie wywoływał cel gather.bin.parts dla wszystkich dołączanych składników i wtyczek. Obsługiwane są cele pre.gather.bin.parts i post.gather.bin.parts. Oba te cele udostępniają następujące właściwości: