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 syntaksen type@id[,version], som angivet i biblioteksfilformatet. |
buildDirectory: |
Det bibliotek, fetch-kommandofiler genereres til, og hvor funktioner og plugin-projekter tjekkes ud til. |
directory: |
Stien til en biblioteksfil. |
children: |
Valgfrit. Angiver, om kommandofilgenereringen til indeholdte plugins og fragmenter skal startes. Standardværdien er true. |
cvspassfile: |
Valgfrit. Navnet på en CVS-kodeordsfil. |
fetchTag: |
Valgfrit. Overskriver koden i biblioteksfilen med den angivne værdi. |
configInfo: |
Valgfrit. Oversigt over konfigurationer, hvor elementerne er adskilt med og-tegn, og hvor målkonfigurationen er angivet. Standard er, at den er platformsuafhængig. |
recursiveGeneration: |
Valgfrit. Angiver, om der skal genereres fetch-kommandofiler til indlejrede funktioner. Standardværdien er true. |
elements: |
Den indgang, der skal bygges. Indgangen forventes at have syntaksen type@id[,version], som angivet i formatet for biblioteksfil. |
buildDirectory: |
Det bibliotek, hvor de funktioner og plugins, der skal bygges, er placeret. Plugins og funktioner skal være placeret i henholdsvis folderen plugins og folderen features. |
children: |
Valgfrit. Angiver, om kommandofilgenereringen til indeholdte plugins og fragmenter skal startes. Standardværdien er true. |
recursiveGeneration: |
Valgfrit. Angiver, om generering af kommandofiler til indeholdte funktioner skal startes. Standardværdien er true. |
devEntries: |
Valgfrit. Kommasepareret oversigt over biblioteker, der skal overgives til kompilerings-classpath. |
buildingOSGi: |
Valgfrit. Angiver, om målet er 3.x. eller 2.1.Standardværdien er true. |
baseLocation: |
Valgfrit. Angiver en folder, der indeholder et Eclipse-målinstallation med underbibliotekerne features/ og plugins/. |
configInfo: |
Valgfrit. Oversigt over konfigurationer, hvor elementerne er adskilt med og-tegn, og som angiver målkonfigurationen. Standard er, at den er platformsuafhængig. |
pluginPath: |
Valgfrit. Platformfilsepareret oversigt over placeringer, hvor der kan findes yderligere plugins. |
archivesFormat: |
Valgfrit. 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: |
Valgfrit. 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: |
Valgfrit. 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: |
Valgfrit. Angiver, om der skal genereres en jnlp-fil skal for alle de funktioner, der bliver bygget. |
outputUpdateJars: |
Valgfrit. Genererer plugins og funktioner i opdateringswebstedformatet, når den er angivet. Standardværdien er false. Bemærk, at site.xml ikke genereres eller opdateres. |
groupConfiguration: |
Valgfrit. Angiver, om alle de konfigurationer, der
bliver bygget, skal grupperes i ét enkelt arkiv. |
generateVersionsLists: |
Valgfrit, Angiver, om der skal genereres egenskabsfiler
med versionerne af de funktioner og plugins, som er blevet bygget. |
filteredDependencyCheck: |
Valgfrit. Begrænser det sæt plugins og funktioner, der
skal tages i betragtning under bygningen, til dem, der kan nås fra funktionerne. |
filterP2Base : |
Valgfrit. Begrænser det sæt plugins og funktioner, der
skal tages i betragtning fra baseLocation, til dem, der tages i betragtning ved installation af p2. |
generateFeatureVersionSuffix: | Valgfrit. Angiver, om der skal genereres suffiks for funktionsversion. Se også Versionskvalifikatorer. |
generatedVersionLength: |
Valgfrit. Længde på det genererede
funktionsversionsuffiks. Det er som standard angivet til 28. Se også Versionskvalifikatorer. |
significantVersionDigits: |
Valgfrit. Det antal signifikante cifre, der anvendes ved
generering af funktionsversionsuffikser.
Se også Versionskvalifikatorer. |
forceContextQualifier: |
Valgfrit. Benytter den angivne værdi til at erstatte den
.qualifier, som benyttes af plugins og funktioner. Se også Versionskvalifikatorer. |
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: |
Valgfrit. Angiver en folder, der indeholder de
installerede funktioner og plugins. |
productFile: |
Valgfrit. 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: |
Valgfrit. Platformfilsepareret oversigt over placeringer, hvor der kan findes yderligere plugins. |
configInfo: |
Valgfrit. Oversigt over konfigurationer, hvor elementerne er adskilt med og-tegn, og som angiver målkonfigurationen. Standard er, at den er platformsuafhængig. |
pluginList: |
Valgfrit. Kommasepareret oversigt over plugin-id'er, der
skal inkluderes i den genererede funktion. (Understøtter attributter, se nedenfor) |
featureList: |
Valgfrit. Kommasepareret oversigt over
funktions-id'er, der skal inkluderes i den genererede funktion. (Understøtter attributter, se nedenfor) |
fragmentList: |
Valgfrit. Kommasepareret oversigt over
fragment-id'er, der skal inkluderes i den genererede funktion. (Understøtter attributter, se nedenfor) |
buildPropertiesFile : |
Valgfrit. Placeringen af en egenskabsfil, hvis indhold skal bruges som den genererede funktions build.properties-fil. |
includeLaunchers : |
Valgfrit. Angiver, om Equinox-startprogrammer skal inkluderes. Standardværdien er "true". |
Der kan bruges attributter til argumenterne pluginList, featureList og fragmentList for opgaven eclipse.generateFeature. Formatet for alle argumenterne er følgende:
List = <element-id>[;<attribut>=<værdi>]* [,<element-id>[;<attribut>=<værdi>]*]*
Hvert attribut=værdi-par indsættes i den genererede XML, der svarer til det givne 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"/>
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 -jar plugins/org.eclipse.equinox.launcher_<version>.jar -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.