Ant-skript genereras vanligtvis genom att använda PDE (Plug-in Development Environment), men det går också att generera dem för hand eller från andra skript.
I själva verket visar PDE Ant-uppgifter för att generera de olika byggskripten.
Funktioner för generering av byggskript finns i följande uppgifter. Argument anges också för varje uppgift.
| elements: |
den post som kommer att hämtas. Det förväntade formatet är type@id[,version] enligt vad som anges i katalogfilformatet; |
| buildDirectory: |
den katalog som hämtningsfilen kommer att genereras till och i vilken funktioner och projekt för insticksprogram kommer att checkas ut; |
| directory: |
sökvägen till en katalogfil; |
| children: |
valfritt, anger om skriptgenereringen för den insticksprogram och fragment som ingår ska anropas. Standard är true; |
| cvspassfile: |
valfritt, namnet på en CVS-lösenordsfil; |
| fetchTag: |
valfritt, åsidosätter det märkord som tillhandahålls i katalogfilen med givet värde; |
| configInfo: |
valfritt, en ampersandseparerad lista över konfigurationen som anger den avsedda konfigurationen. Standardinställningen är plattformsoberoende; |
| recursiveGeneration: |
valfritt, ange om hämtningsskript ska genereras för nästlade funktioner. Standard är true. |
| elements: |
den post som ska hämtas. Posten förväntas vara i formatet type@id[,version] enligt vad som anges i katalogfilformatet; |
| buildDirectory : |
den katalog där funktioner och insticksprogram som ska byggas är placerade. Insticksprogram och funktioner måste vara placerade i mapparna plugins och features; |
| children: |
valfritt, anger om skriptgenereringen för den insticksprogram och fragment som ingår ska anropas. Standard är true; |
| recursiveGeneration : |
valfritt, anger om skriptgenereringen för de funktioner som ingår ska anropas. Standard är true; |
| devEntries : |
valfritt, en kommaavgränsad lista över kataloger som ska ges till kompileringsklassökvägen; |
| buildingOSGi : |
valfritt, anger om målet är 3.x. eller 2.1. Standard är true; |
| baseLocation : |
valfritt, anger en mapp som innehåller en mål-Eclipse-installation med underkataloger för funktioner och insticksprogram; |
| configInfo: |
valfritt, en ampersandseparerad lista över konfigurationen som anger den avsedda konfigurationen. Standardinställningen är plattformsoberoende; |
| pluginPath : |
valfritt, en plattformsfilsseparatoravgränsad lista över platser där du kan hitta ytterligare insticksprogram; |
| archivesFormat : |
valfritt, en ampersandseparerad lista över konfigurationer och det förväntade utdataformatet för var och en av dem. Formatet separeras med ett tankstreck (-) från konfigurationen. De värden som kan användas är: folder, tar, zip, antZip, vilka i tur och ordning betyder arkivera inte, använd tar till att skapa arkivet, använd den version av info-zip som är tillgänglig på plattformen, använd ant-zip. Standardvärdet är antZip; |
| product : |
valfritt, '/'-separerad sökväg till platsen för en RCP-produkt som håller på att byggas. Det första segmentet i sökvägen måste referera till insticksprogram-IDt för ett insticksprogram som innehåller filen .product; |
| signJars : |
valfritt, anger om de genererade skripten måste signera jar-filer för funktioner och insticksprogram. Standardvärdet är false. Parametrarna för signeringsuppgiften styrs av följande ant-egenskaper: sign.alias, sign.keystore och sign.storepass som i tur och ordning skickas till parametrarna alias, keystore och storepass från ant-uppgiften signJar. Standardvärdet är false. |
| generateJnlp : |
valfritt, anger om en jnlp-fil ska genereras för alla funktioner som håller på att byggas; |
| outputUpdateJars : |
valfritt, genererar insticksprogram och funktioner i uppdateringplatsformatet när det anges. Standardvärdet är false. Observera att site.xml varken genereras eller uppdateras; |
| groupConfiguration
: |
valfritt, om alla konfigurationer som byggs ska grupperas i ett arkiv eller inte; |
| generateVersionsLists : |
valfritt, om egenskapsfiler som anger versionerna för funktioner och insticksprogram som skapats ska visas eller inte; |
| filteredDependencyCheck: |
valfritt, begränsar uppsättningen med insticksprogram och funktioner som ska övervägas vid bygge till de som kan nås från funktionerna; |
| filterP2Base : |
valfritt, begränsar uppsättningen insticksprogram och funktioner som ska beaktas från baseLocation till de som beaktas för installation av p2; |
| generateFeatureVersionSuffix: | valfritt, om funktionens versionssuffix ska genereras eller inte. Se även Versionskvalificerare; |
| generatedVersionLength: |
valfritt, längden för den genererade funktionsversionens suffix. Standard är 28. Se även Versionskvalificerare; |
| significantVersionDigits: |
valfritt, antalet signifikanta siffror som används vid generering av funktionsversionssuffix.
Se även Versionskvalificerare; |
| forceContextQualifier : |
valfritt, använder det givna värdet till att ersätta existensen av .qualifier med insticksprogram och funktioner. Se även Versionskvalificerare; |
| featureId : |
Det ID som ges till den genererade funktionen. |
| buildDirectory: |
den katalog där funktioner och insticksprogram (i underkatalogerna /features och /plugins) som ska inkluderas är placerade; Den genererade funktionen kommer att placeras i underkatalogen
/features. |
| baseLocation : |
valfritt, anger en mapp som innehåller installerade funktioner och insticksprogram |
| productFile : |
valfritt, en produktfil som den genererade funktionen ska baseras på. |
| verify : |
Om upplösaren ska användas för att verifiera att de
insticksprogram och funktioner som tillhandahålls är tillgängliga. Det avgör också om funktionen kommer att kunna hantera plattformsspecifika fragment och insticksprogram som är
JAR-paketerade på rätt sätt. Om alla element som ska inkluderas i funktionen är tillgängliga lokalt ska verify anges som
True. Om elementen behöver hämtas från ett lager anger du
verify som False, använder den resulterande funktionen för att hämta de insticksprogram och funktioner som krävs och genererar sedan om behållarfunktionen med
verify = True. |
| pluginPath : |
valfritt, en plattformsfilsseparatoravgränsad lista över platser där du kan hitta ytterligare insticksprogram |
| configInfo: |
valfritt, en ampersandseparerad lista över konfigurationen som anger den avsedda konfigurationen. Standardinställningen är plattformsoberoende; |
| pluginList : |
valfritt, en kommaavgränsad lista över IDn för insticksprogram som ska inkluderas i den genererade funktionen. (Attribut kan användas, se nedan) |
| featureList : |
valfritt, en kommaavgränsad lista över IDn för funktioner som ska inkluderas i den genererade funktionen. (Attribut kan användas, se nedan) |
| fragmentList : |
valfritt, en kommaavgränsad lista över IDn för fragment som ska inkluderas i den genererade funktionen. (Attribut kan användas, se nedan) |
| buildPropertiesFile : |
alternativt, platsen för en egenskapsfil vars innehåll ska användas som den genererade funktionens build.properties. |
| includeLaunchers : |
valfritt, huruvida equinox-startfunktionerna ska tas med, standardvärdet är "true". |
Argumenten pluginList, featureList och fragmentList i eclipse.generateFeature hantera attribut. Dessa argument har alla formen:
List = <element-id>[;<attribute>=<value>]* [,<element-id>[;<attribute>=<value>]*]*
Varje attribut=värde-par infogas i den genererade xml-filen som motsvarar det givna elementet. Exempel:
featureList = org.eclipse.feature;optional=true
pluginList = org.eclipse.plugin.A;unpack=true
fragmentList=org.eclipse.fragment.a;os=win32,org.eclipse.fragment.b;os=linux;ws=gtk;arch=x86
<feature ...>
...
<includes id="org.eclipse.feature" version="0.0.0" optional="true" />
...
<plugin id="org.eclipse.plugin.A" version="0.0.0" unpack="true" />
<plugin id="org.eclipse.fragment.a" version="0.0.0" os="win32" fragment="true" />
<plugin id="org.eclipse.fragment.b" version="0.0.0" os="linux" ws="gtk" arch="x86" fragment="true" />
...
</feature>
<eclipse.fetch elements="bundle@org.eclipse.osgi"
buildDirectory="c:\toBuild"
directory="directory.txt"
configInfo="win32,win32,x86 & linux, motif, x86"
/>
<eclipse.buildScript elements="bundle@org.eclipse.osgi"
buildDirectory="c:\toBuild"
archivesFormat="macosx, carbon, ppc - tar"/>
De tidigare beskrivna uppgifterna fungerar bara om Eclipse körs. I scenariot där Ant-skript körs med Eclipse-uppgifter måste skripten köras med tillämpningen Eclipse Ant Runner. Kommandoraden i det här fallet är:
java -jar plugins/org.eclipse.equinox.launcher_<version>.jar -application org.eclipse.ant.core.antRunner -buildfile build.xml
Observera att de parametrar som visas efter tillämpningen är de parametrar som skickas till Ant.