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.