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 på formen type@id[,versjon], 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. Angir om skriptgenereringen for de inkluderte plugin-modulene og fragmentene skal aktiveres. Standardverdien er sann. |
| 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 angir målkonfigurasjonen. Standardverdien er plattformuavhengig. |
| recursiveGeneration: |
Valgfritt. Angir om det skal genereres henteskript for nestede funksjoner. Standardverdien er sann. |
| elements: |
Oppføringen som skal bygges. Oppføringen forventes å ha formen type@id[,versjon], slik det er oppgitt i katalogfilformatet. |
| buildDirectory: |
Katalogen der funksjonene og plugin-modulene som skal bygges, er plassert. Plugin-moduler og funksjoner må befinne seg i mappene kalt henholdsvis plugins og features. |
| children: |
Valgfritt. Angir om skriptgenereringen for de inkluderte plugin-modulene og fragmentene skal aktiveres. Standardverdien er sann. |
| recursiveGeneration: |
Valgfritt. Angir om skriptgenereringen for inkluderte funksjoner skal aktiveres. Standardverdien er sann. |
| devEntries: |
Valgfritt. En kommadelt liste over kataloger som skal gis til kompileringsklassebanen. |
| buildingOSGi: |
Valgfritt. Angir om målet er 3.x. eller 2.1. Standardverdien er sann. |
| baseLocation: |
Valgfritt. Angir en mappe som inneholder en Eclipse-målinstallering med underkatalogene features/ og plugins/. |
| configInfo: |
Valgfritt. En liste, atskilt med et-tegn, over konfigurasjonen, som angir 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. Angir om de genererte skriptene må signere jar-filer for funksjoner og plugin-moduler. Standardverdien er usann. 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 usann (false). |
| generateJnlp: |
Valgfritt. Angir 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 usann. Vær oppmerksom på at site.xml ikke blir generert eller oppdatert. |
| groupConfiguration: |
Valgfritt. Angir om alle konfigurasjoner som blir bygd, skal grupperes i ett enkelt arkiv. |
| generateVersionsLists: |
Valgfritt. Angir om det skal genereres egenskapsfiler som lister versjonene av
funksjoner og plugin-moduler som er bygd. |
| filteredDependencyCheck: |
Valgfritt. Begrenser settet av plugin-moduler og funksjoner som skal vurderes
under byggingen, til dem som kan nås fra funksjonene. |
| filterP2Base: |
Valgfritt. Begrenser settet av plugin-moduler og funksjoner som skal vurderes fra baseLocation,
til dem som vurderes som installert av p2. |
| generateFeatureVersionSuffix: | Valgfritt. Angir om funksjonens versjonssuffiks skal genereres. Se også Versjonskvalifikatorer. |
| generatedVersionLength: |
Valgfritt. Lengden til det genererte funksjonsversjonssuffikset. Er som standard satt til 28. Se også Versjonskvalifikatorer. |
| significantVersionDigits: |
Valgfritt. Antall signifikante siffer som brukes ved generering av funksjonsversjonssuffikser.
Se også Versjonskvalifikatorer. |
| forceContextQualifier: |
Valgfritt. Bruker den oppgitte verdien til å erstatte .qualifier etter plugin-moduler og
funksjoner. Se også Versjonskvalifikatorer. |
| featureId: |
IDen
som skal gis til den genererte funksjonen. |
| buildDirectory: |
Katalogen der funksjonene og plugin-modulene
(i underkatalogene /features og /plugins) som skal inkluderes, befinner seg. Den genererte
funksjonen blir plassert i underkatalogen /features. |
| baseLocation: |
Valgfritt. Angir 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 sann (true). Hvis elementene
må hentes fra et datalager, definerer du verify til usann (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 angir målkonfigurasjonen. Standardverdien er plattformuavhengig. |
| pluginList: |
Valgfritt. En kommadelt liste over plugin-IDer som skal inkluderes i den genererte funksjonen. (Støtter attributter; se nedenfor) |
| featureList: |
Valgfritt. En kommadelt liste over funksjons-IDer som skal inkluderes i den genererte funksjonen. (Støtter attributter; se nedenfor) |
| fragmentList: |
Valgfritt. En kommadelt liste over fragment-IDer som skal inkluderes i den genererte funksjonen. (Støtter attributter; se nedenfor) |
| buildPropertiesFile : |
Valgfri. Plasseringen til en egenskapsfil hvis innhold skal brukes som den genererte funksjonens build.properties. |
| includeLaunchers: |
Valgfri, enten Equinox-oppstarterne inkluderes eller ikke, er standardverdien sann ("true"). |
Argumentene pluginList, featureList og fragmentList i oppgaven eclipse.generateFeature støtter alle attributtene. Disse argumentene har følgende form:
List = <element-id>[;<attributt>=<verdi>]* [,<element-id>[;<attributt>=<verdi>]*]*
Hvert attributt=verdi-par blir satt inn i generert XML tilsvarende gitt element. Eksempel:
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"/>
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 -jar plugins/org.eclipse.equinox.launcher_<versjon>.jar -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.