Aangepaste buildstappen voor features en plugins

Nieuw in 3.2 is de mogelijkheid voor een feature of plugin om aangepaste Ant-doelen aan de eigen build toe te voegen.  Deze aangepaste stappen kunnen worden gebruikt voor dingen als het aansturen van byte-code na compilatie, het indexeren van helpbestanden voor documentatie of het kopiëren van extra bestanden naar de bundel. 

Als u aangepaste doelen wilt gebruiken, moet een feature of plugin de eigenschap customBuildCallbacks definiëren in het bestand build.properties. De waarde van deze eigenschap is de locatie van een XML-bestand, die verwijst naar de hoofdmap van de feature/plugin, met de aangepaste doelen. Als het xml-bestand zich elders bevindt, stelt u de gewenste directory in met behulp van de eigenschap customBuildCallbacks.buildpath.

Sjablonen met de naam customBuildCallbacks.xml bevatten de ondersteunde aangepaste doelen en bevinden zich respectievelijk in org.eclipse.pde.build/templates/plugins en  org.eclipse.pde.build/templates/features.  Deze sjablonen kunnen naar uw feature/plugin worden gekopieerd en desgewenst worden gewijzigd.

De aangepaste doelen worden opgeroepen met de subant-taak; standaard is failonerror ingesteld op false. Als u dit wilt wijzigen, moet u de eigenschap customBuildCallbacks.failonerror instellen op true. Ook de parameter inheritall is standaard ingesteld op false. Als u dit wilt wijzigen, moet u de eigenschap customBuildCallbacks.inheritall instellen op true.

Plugins

De gegenereerde build.xml die een plugin opbouwt, bevat meerdere doelen die specifieke taken uitvoeren.  PDE Build biedt de plugin de mogelijkheid om pre- en postdoelen te verstrekken die voor en na specifieke taken worden aangeroepen.  Ter aanvulling op ant-eigenschappen die mogelijk al zijn gedefinieerd, kan aan elk aangepast doel ook een aantal specifieke eigenschappen worden doorgegeven.  De volgende doelen ondersteunen aangepaste callbacks:

Functies

De gegenereerde build.xml voor features ondersteunt alleen aangepaste buildcallbacks voor het doel gather.bin.parts.  Dit doel zal het doel gather.bin.parts van alle opgenomen features en plugins aanroepen.   Het ondersteunt pre.gather.bin.parts en post.gather.bin.parts.  Deze doelen worden beide geleverd met de volgende eigenschappen: