Etapy niestandardowego budowania składników i wtyczek

Nowością w wersji 3.2 jest możliwość dostarczania przez składnik lub wtyczkę niestandardowych celów narzędzia Ant do własnej kompilacji.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. Jeśli plik XML znajduje się gdzie indziej, należy ustawić katalog, który ma zostać użyty, za pomocą właściwości customBuildCallbacks.buildpath.

Szablony o nazwach customBuildCallbacks.xml zawierające obsługiwane cele niestandardowe są dostarczane w katalogach org.eclipse.pde.build/templates/plugins i org.eclipse.pde.build/templates/features.Szablony te można skopiować do katalogu danego składnika/wtyczki i zmodyfikować stosownie do potrzeb.

Niestandardowe elementy docelowe będą wywoływane przy użyciu zadania subant; ustawieniem domyślnym parametru failonerror jest false. Aby zmienić to ustawienie, należy zmienić wartość właściwości customBuildCallbacks.failonerror na true. Analogicznie, parametr inheritall domyślnie przyjmuje wartość false. Można to zmienić przez ustawienie właściwości customBuildCallbacks.inheritall.

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: