Ant-skript blir vanligvis generert
ved hjelp av PDE (Plug-in Development Environment), men det er også mulig å generere dem
for hånd eller fra andre skript.
PDE eksponerer Ant-oppgaver for å generere de ulike byggeskriptene.
Hjelpemidlene for generering av
skript ligger i de følgende oppgavene. Det blir også vist argumenter for hver oppgave.
| elements: |
oppføringen som skal hentes. Det forventede formatet er i formen type@id, slik det er oppgitt i katalogfilformatet. |
| buildDirectory: |
katalogen som henteskriptene skal genereres til, og som funksjoner og plugin-prosjekter skal hentes ut til. |
| directory: |
banen til en katalogfil. |
| children: |
valgfritt, oppgir om skriptgenereringen for de inkluderte plugin-modulene og fragmentene skal aktiveres. Standardverdien er true. |
| cvspassfile: |
valgfritt, navnet på en CVS-passordfil. |
| fetchTag: |
valgfritt, overstyrer koden som er oppgitt i katalogfilen, med den oppgitte verdien. |
| configInfo: |
valgfritt, en liste, atskilt med et-tegn, over konfigurasjonen, som oppgir målkonfigurasjonen. Standardverdien er plattformuavhengig. |
| recursiveGeneration: |
valgfritt, oppgi om det skal genereres henteskript for nestede funksjoner. Standardverdien er true. |
| elements: |
oppføringen som skal bygges. Enheten forventes å være i formen type@id slik det er oppgitt i katalogfilformatet. |
| buildDirectory: |
katalogen der funksjonene og plugin-modulene som skal bygges, er plassert. |
| children: |
valgfritt, oppgir om skriptgenereringen for de inkluderte plugin-modulene og fragmentene skal aktiveres. Standardverdien er true. |
| recursiveGeneration: |
valgfritt, oppgir om skriptgenereringen for inkluderte funksjoner skal aktiveres. Standardverdien er true. |
| devEntries: |
valgfritt, en kommadelt liste over kataloger som skal gis til kompileringsklassebanen. |
| buildingOSGi: |
valgfritt,
oppgir om målet er 3.x. eller 2.1. Standardverdien er true. |
| baseLocation: |
valgfritt, oppgir en mappe som inneholder en mål-Eclipse-installasjon med underkatalogene features/ og plugins/. |
| configInfo: |
valgfritt, en liste, atskilt med et-tegn, over konfigurasjonen, som oppgir målkonfigurasjonen. Standardverdien er plattformuavhengig. |
| pluginPath: |
valgfritt, en plattformfilskilletegndelt liste over plasseringer der det er mulig å finne flere plugin-moduler. |
| archivesFormat: |
valgfritt, en liste, atskilt med et-tegn, over konfigureringer og det forventede utdataformatet for hver av dem. Formatet er atskilt fra konfigurasjonen med en bindestrek (-). Støttede verdier er folder, tar, zip og antZip, som henholdsvis betyr ikke arkiver, bruk tar til å opprette arkivet, bruk den versjonen av info zip som er tilgjengelig på plattformen, bruk ant-zip. Standardverdien er antZip. |
| product: |
valgfritt, bane, atskilt med '/', til plasseringen av et RCP-produkt som blir bygd. Det første segmentet av banen må referere til plugin-IDen for en plugin-modul som inneholder .product-filen. |
| signJars: |
valgfritt, oppgir om de genererte skriptene må signere jar-filer for funksjoner og plugin-moduler. Standardverdien er false. Parameteren for signeringsoppgaven styres av de følgende ant-egenskapene: sign.alias, sign.keystore og sign.storepass, som henholdsvis sendes til parameterne alias, keystore and storepass fra signJar-oppgaven i Ant. Standardverdien er false. |
| generateJnlp: |
valgfritt, oppgir om det skal genereres en jnlp-fil for alle funksjonene som blir bygd. |
| outputUpdateJars: |
valgfritt, genererer plugin-moduler og funksjoner i oppdateringsstedets format når det er definert. Standardverdien er false. Vær oppmerksom på at site.xml ikke blir generert eller oppdatert. |
| forceContextQualifier: |
valgfritt,
bruker den oppgitte verdien til å erstatte .qualifier etter plugin-moduler og
funksjoner. (Se også Versjonskvalifikatorer.) |
| generateFeatureVersionSuffix: | valgfritt, oppgir om funksjonens versjonssuffiks skal genereres. |
| groupConfiguration: |
valgfritt,
oppgir om alle konfigurasjoner som blir bygd, skal grupperes i ett enkelt arkiv. |
| generateVersionsLists: |
valgfritt,
oppgir om det skal genereres egenskapsfiler som lister versjonene av
funksjoner og plugin-moduler som er bygd. |
| featureId: |
IDen
som skal gis til den genererte funksjonen. |
| buildDirectory: |
katalogen
der funksjonene og plugin-modulene (i underkatalogene /features og /plugins)
som skal inkluderes, er plassert. Den genererte
funksjonen blir plassert i underkatalogen /features. |
| baseLocation: |
valgfritt,
oppgir en mappe som inneholder installerte funksjoner og plugin-moduler. |
| productFile: |
valgfritt,
en produktfil som den genererte funksjonen skal baseres på. |
| verify: |
Om behandleren
skal brukes til å verifisere at de oppgitte plugin-modulene og funksjonene, er
tilgjengelig. Dette fastsetter
også om funksjonen skal være i stand til å håndtere plattformspesifikke fragmenter og plugin-moduler
som skal legges i JAR-filer. Hvis alle elementene som skal inkluderes i funksjonen, er
tilgjengelige lokalt, må verify defineres til True. Hvis elementene
må hentes fra et datalager, definerer du verify til False, bruker resultatfunksjonen til å hente de nødvendige
plugin-modulene og funksjonene, og deretter regenererer du containerfunksjonen ved å bruke verify = True. |
| pluginPath: |
valgfritt, en plattformfilskilletegndelt liste over plasseringer der det er mulig å finne flere plugin-moduler. |
| configInfo: |
valgfritt, en liste, atskilt med et-tegn, over konfigurasjonen, som oppgir målkonfigurasjonen. Standardverdien er plattformuavhengig. |
| pluginList: |
valgfritt,
en kommadelt liste over plugin-IDer som skal inkluderes i den genererte funksjonen. |
| featureList: |
valgfritt,
en kommadelt liste over funksjons-IDer som skal inkluderes i den genererte funksjonen. |
| fragmentList: |
valgfritt,
en kommadelt liste over fragment-IDer som skal inkluderes i den genererte funksjonen. |
<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"/>
Målene som ble beskrevet tidligere, fungerer bare hvis Eclipse kjører. I det spesielle scenariet der Ant-skript blir utført ved hjelp av Eclipse-oppgaver, må skriptene kjøres ved hjelp av applikasjonen Eclipse Ant Runner. Kommandolinjen for dette bestemte tilfellet er slik:
java -cp startup.jar org.eclipse.core.launcher.Main -application org.eclipse.ant.core.antRunner -buildfile build.xml
Vær oppmerksom på at parameterne som vises etter applikasjonen, er de parameterne som sendes til Ant.