Ant-scripts genereren

Ant is een eenvoudige open-sourcescriptengine voor het uitvoeren van scripts die in de XML-indeling geschreven zijn. Ant is zeer geschikt voor het uitvoeren van taken die veel worden gebruikt bij automatisch bouwen. 

De variabelen die in de plugin, het fragment of de feature build.properties zijn ingesteld, worden gebruikt om scripts voor Ant te genereren. PDE genereert Ant-scripts voor het maken van afzonderlijke plugin- en fragmentbuildbestanden en één algemeen script voor het bouwen van het JAR-featurebestand. Dit "main"-script zorgt er ook voor dat afzonderlijke scriptbestanden worden uitgevoerd in de juiste volgorde (gedefinieerd in de plugin-dependencyhiërarchie). Elk buildbestand heeft dezelfde naam (build.xml) en wordt gemaakt als onderliggend item van het manifestbestand in het bijbehorende project.

Omdat Ant-scripts gebruikmaken van de vervangingsvariabelen in build.properties, kunt u deze zo ("as is") gebruiken zonder de gegenereerde scripts te hoeven wijzigen. Als u deze toch wijzigt, hoeft u de scripts niet steeds opnieuw te maken wanneer u de component opnieuw bouwt.

Om scripts te maken selecteert u Ant-buildbestand maken terwijl in de Navigator of in een view van de Pakketverkenner een geldig manifestbestand (plugin.xml, fragment.xml of feature.xml) is geselecteerd. Met deze opdracht wordt het buildscript gegenereerd. Wanneer u Ant uitvoeren... kiest in het voorgrondmenu terwijl het zojuist gegenereerde scriptbestand is geselecteerd, wordt de volgende wizard gestart:

Ant-uitvoeringswizard die de beschikbare doellocaties afbeeldt

U kunt de standaard Ant-wizard op twee manieren aanpassen: door de uitvoeringsargumenten op te geven en door een of meer builddoelen te selecteren.

Eigenschappen

Ant-argumenten worden meestal gebruikt om standaardwaarden te vervangen door bepaalde eigenschapswaarden en het buildproces aan te passen. De argumenten worden ingesteld met de opdracht "-Dproperty=value". De volgende eigenschappen worden herkend:

U kunt het gedrag van de compiler aanpassen met behulp van de volgende eigenschappen:

Doelen

Bij het uitvoeren van featurebuildscripts, worden de volgende doelen gebruikt om afzonderlijke doelen van plugins of fragmenten aan te roepen. Om op te geven welk doel moet worden uitgevoerd, moet u de eigenschap target instellen (bijvoorbeeld -Dtarget=refresh). Een van de doelen all.* dient als iterator, terwijl het werkelijk uit te voeren doel wordt opgegeven via de eigenschap target.