Ant-kommandofiler genereres typisk vha. PDE (Plug-in Development Environment), men det er også muligt at generere dem manuelt eller på basis af andre kommandofiler.
PDE omfatter Ant-opgaver til generering af de forskellige byggekommandofiler. Funktionerne til generering af byggefiler er indeholdt i følgende opgaver. Der vises desuden argumenter til de enkelte opgaver.
elements: |
den indgang, der bliver hentet. Det forventede format har formen type@id som angivet i formatet for biblioteksfil. |
buildDirectory: |
det bibliotek, fetch-kommandofiler genereres til, og hvor funktioner og plugin-projekter tjekkes ud til. |
directory: |
stien til en biblioteksfil. |
children: |
valgfri, angiver, om kommandofilgenereringen til indeholdte plugins og fragmenter skal startes. Standardværdien er true. |
cvspassfile: |
valgfri, navnet på en CVS-kodeordsfil. |
fetchTag: |
valgfri, overskriver koden i biblioteksfilen med den angivne værdi. |
configInfo: |
valgfri, en oversigt over konfigurationer, hvor elementerne er adskilt med og-tegn, og hvor målkonfigurationen er angivet. Standard er, at den er platformsuafhængig. |
recursiveGeneration: |
valgfri, angiver, om der skal genereres fetch-kommandofiler til indlejrede funktioner. Standardværdien er true. |
elements: |
den indgang, der skal bygges. Indgangen forventes at have formen type@id som angivet i formatet for biblioteksfil. |
buildDirectory: |
det bibliotek, hvor de funktioner og plugins, der skal bygges, er placeret. |
children: |
valgfri, angiver, om kommandofilgenereringen til indeholdte plugins og fragmenter skal startes. Standardværdien er true. |
recursiveGeneration: |
valgfri, angiver, om generering af kommandofiler til indeholdte funktioner skal startes. Standardværdien er true. |
devEntries: |
valgfri, en kommasepareret oversigt over mapper, der skal overgives til kompilerings-classpath. |
buildingOSGi: |
valgfri, angiver, om målet er 3.x. eller 2.1. Standardværdien er true; |
baseLocation: |
valgfri, angiver en folder, der indeholder en mål-eclipse-installation med underbibliotekerne features/ og plugins/. |
configInfo: |
valgfri, en oversigt over konfigurationer, hvor elementerne er adskilt med og-tegn, og som angiver målkonfigurationen. Standard er, at den er platformsuafhængig. |
pluginPath: |
valgfri, en platformfilsepareret oversigt over placeringer, hvor der kan findes yderligere plugins. |
archivesFormat : |
valgfri, en oversigt over konfigurationer, hvor elementerne er adskilt med og-tegn, og det forventede outputformat for hver af disse. Formatet er adskilt fra konfigurationen vha. en bindestreg (-). Følgende værdier understøttes: folder, tar, zip, antZip, hvilket betyder henholdsvis undlad arkivering, brug tar til oprettelse af arkiv, brug den version af info-zip, der er tilgængelig på platformen, brug ant-zip. Standardværdien er antZip. |
product: |
valgfri, en sti separeret med '/', der angiver placeringen af et RCP-produkt, som er ved at blive bygget. Det første segment i stien skal referere til plugin-id'en for en plugin, der indeholder .product-filen. |
signJars: |
valgfri, angiver, om de genererede kommandofiler skal signere jar-filer til funktioner og plugins. Standardværdien er false. Parametrene til signeringsopgaven styres af følgende ant-egenskaber: sign.alias, sign.keystore og sign.storepass, der henholdsvis videresendes til alias-, keystore- og storepass-parametrene fra ant-signJar- opgaven. Standardværdien er false. |
generateJnlp: |
valgfri, angiver, om der skal genereres en jnlp-fil til alle de funktioner, der bygges. |
outputUpdateJars: |
valgfri, genererer plug-ins og funktioner i opdateringswebstedformatet, når den er angivet. Standardværdien er false. Bemærk, at filen site.xml ikke bliver genereret eller opdateret. |
forceContextQualifier: |
valgfri, benytter den angivne værdi til at erstatte den .qualifier, som benyttes af plugins og funktioner (se også Versionskvalifikatorer). |
generateFeatureVersionSuffix: | valgfri, angiver, om der skal genereres suffiks for funktionsversion. |
groupConfiguration: |
valgfri, angiver, om alle konfigurationer, der bygges, skal grupperes i ét arkiv. |
generateVersionsLists: |
valgfri, angiver, om der skal genereres egenskabsfiler med versionerne af de funktioner og plugins, som blev bygget. |
featureId: |
Den id, der skal gives til den genererede funktion. |
buildDirectory: |
det bibliotek, hvor de funktioner og plugins (i underbibliotekerne /features og /plugins), der skal inkluderes, er placeret. Den genererede funktion placeres i underbiblioteket /features. |
baseLocation: |
valgfri, angiver en mappe, der indeholder de installerede funktioner og plugins. |
productFile: |
valgfri, en produktfil, som den genererede funktion skal baseres på. |
verify: |
Om resolveren skal benyttes til at bekræfte, at de angivne plugins og funktioner er tilgængelige. Dette fastlægger også, om funktionen kan håndtere platformsspecifikke fragmenter og plugins, der skal JAR'es, korrekt. Hvis alle de elementer, der skal inkluderes i funktionen, er tilgængelige lokalt, skal verify angives til True. Hvis elementerne skal hentes fra et lager, skal du angive verify til False og benytte den resulterende funktion til at hente de nødvendige plugins og funktioner og derefter generere opbevaringstedsfunktionen igen ved hjælp af verify = True. |
pluginPath: |
valgfri, en platformfilsepareret oversigt over placeringer, hvor der kan findes yderligere plugins. |
configInfo: |
valgfri, en oversigt over konfigurationer, hvor elementerne er adskilt med og-tegn, og som angiver målkonfigurationen. Standard er, at den er platformsuafhængig. |
pluginList: |
valgfri, en kommasepareret oversigt over plugin-id'er, der skal inkluderes i den genererede funktion. |
featureList: |
valgfri, en kommasepareret oversigt over funktions-id'er, der skal inkluderes i den genererede funktion. |
fragmentList: |
valgfri, en kommasepareret oversigt over fragment-id'er, der skal inkluderes i den genererede funktion. |
<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 ovenfor beskrevne opgaver virker kun, hvis Eclipse kører. I det specifikke eksempel med udførelse af Ant-kommandofiler vha. Eclipse-opgaver skal kommandofilerne udføres vha. programmet Eclipse Ant Runner. I dette tilfælde er kommandolinjen følgende:
java -cp startup.jar org.eclipse.core.launcher.Main -application org.eclipse.ant.core.antRunner -buildfile build.xml
Bemærk, at de parametre, der vises efter programmet, er de parametre, der videresendes til Ant.